# @Limit >[success] 核心`v1.16.0`增加 有时候，你可能不希望你的某个监听函数被别人频繁的触发，可能这个监听你只希望它5秒内、10秒内、甚至1分钟内只会触发一次。 如果你有这种需求，那么你可能会用得到`@Limit`注解。 此注解代表"限流"，被其标注的监听函数会在指定时间段内只被触发一次。 ## **使用** ```java @OnPrivate @Limit(value = 5) public void listen(PrivateMsg msg, MsgSender sender){ sender.SENDER.sendPrivateMsg(msg, msg.getMsg()); } ``` 上述的监听函数的含义是：listen监听函数每次触发都会冷却5秒。 ## **参数** `@Limit`注解的参数及其含义如下： | 参数名 | 类型 | 含义 | 默认值 | | --- | --- | --- |--- | | value | long | 冷却时长 | 无，必填项 | | timeUnit | TimeUnit | 冷却时长的时间类型 | TimeUnit.SECONDS，即“秒” | | code | boolean | 是否区分送信人 | true | | group | boolean | 是否区分群 | true | | bot | boolean | 是否区分bot | false | 其中，“是否区分XXX”的选项即为如果区分对象不同，则单独计算冷却时间。 例如value为10的时候，如果code和group都为true，则不同的人时间计算是不同的，而如果code为false，则一个人触发了监听，开启了监听冷却，其他人也无法触发监听了。 ## **实现** 此功能通过内部实现的监听函数拦截器`LimitIntercept`实现，此拦截器的优先级为`PriorityConstant.THIRD`，即为`3`。 # 施工中