一、基于SentinelResource注解
目前的代码结构:
框选部分为本章新增和修改的类。
1、新增一个处理sentinel自定义返回的类,编写自定义返回方法,如下:
2、 新增测试接口
使用sentinel的注解sentinelresource,他有如下参数:
value:定义sentinel的资源名称。(ps:一定要注意,sentinelresource的名字不要相同,controller下面的方法,sentinel他会默认加载成sentinel资源,名字为mapping映射注解的值,所以若在方法上新增一个sentinelresource注解,一定记得不能重名,否则会失效。!!!!!)。
entryType:资源调用的流量类型,默认是出口流量(OUT),可以设置为入口流量(IN),注意系统规则只对 IN 生效(没用过)。
resourceType:资源类型,默认是0,(1:web,2:prc,3:gateway,4:sql)。
blockHandler:自定义流控处理方法的方法名(只能处理BlockException异常)。
blockHandlerClass:自定义流控处理方法的所在的类名。
allback:可以处理所有类型的异常,值是处理异常的方法名,配合fallbackClass使用。
defaultFallback:设置默认的异常处理,值是处理异常的方法名,配合fallbackClass使用,若同时设置了allback的值,则不会走默认的defaultfallback指定的方法名所在方法,而是走allback设置的方法。
fallbackClass:配合defaultFallback或者allback使用,值为处理异常的方法所在的类的类名。
exceptionsToTrace:sentinel默认会有可以处理的异常类型但不是所有都能处理,若需要处理其他异常,通过该属性设置异常类型的值,进行一个类似追加的操作,追加sentinel可以操作的异常列表数据。
exceptionsToIgnore:值为异常类,表示指定的异常类不会走自定义的异常处理方法(allback或者defaultfallback或者blockhandler),而是走他自己默认的处理。
3、新增流控规则
ps:流控规则加到sentinelresouce注解设置的value值对应的资源上,而不是加到mapping映射注解名称自动生成的sentinel资源上,如上加到test33上而不是test3上!!。
4、演示(只使用了blockHandler和blockHandlerClass属性)
不再是返回默认的Blocked by Sentinel (flow limiting)。
二、全局处理
1、BlockException异常类
先了解一下BlockException:他是Sentinel里面的一个父异常类,集成了Exception异常类,有多个子类,FlowException(流控),ParamFlowException(热点),DegradeException(熔断),AuthorityException(授权),SystemBlockException(系统),对应了Sentinel功能列表的各个功能对应的处理依据异常。一旦超过设定的值,就会触发sentinel机制(例如:流控效果),都会抛出一个BlockException。所以,可以通过重写sentinel提供的BlockException异常的BlockExceptionHandler接口或者UrlBlockHandler接口去重写BlockException抛出前的处理逻辑,进行针对BlockException异常的细分化的全局异常处理。
2、自定义全局异常类处理BlockException
这里需要提到一点,此处我使用的是2.1.1版本的sentinel,所以通过实现UrlBlockHandler的方式。
alibaba sentinel版本 | 全局异常实现方式 |
2.2.0以下版本 | 需要实现UrlBlockHandler接口 |
2.2.0以上 | 实现 BlockExceptionHandler接口 |
实现(新增配置文件):
注意:加上Component注解,重写UrlBlockHandler接口的blocked方法。
3、演示
测试test2接口资源,设置流控规则,由于是流控,所以会在产生流控时,new一个 FlowException异常出来,上面有提到,所以会走
这一步,启动jmeter的测试计划,查看结果,如下:
http请求返回指定的500错误码, 相应的信息为“被限流”,全局异常处理设置成功。
2022.3.21修改:使用全局处理不能使用sentinelresource注解,否则失效。