Nepxion Discovery学习笔记4 Sentinel流量防卫兵/服务容错综合方案

ゞ浴缸里的玫瑰 2022-12-17 08:56 168阅读 0赞

# 笔记1: #

## **@SentinelResource:** ##

@SentinelResource 用于**定义资源**，并提供可选的**异常处理**和**fallback** 配置项。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td> 
    <div> 
     <span style="color:#333333;"><strong>属性</strong></span> 
    </div> </td> 
   <td>作用</td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="color:#333333;">value</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="color:#333333;">资源名称 </span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="color:#333333;">entryType</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="color:#333333;">entry</span> 
     <span style="color:#333333;">类型，标记流量的方向，取值</span> 
     <span style="color:#333333;">IN/OUT</span> 
     <span style="color:#333333;">，默认是</span> 
     <span style="color:#333333;">OUT</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="color:#333333;">blockHandler</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="color:#333333;">处理</span> 
     <span style="color:#333333;">BlockException</span> 
     <span style="color:#333333;">的函数名称</span> 
     <span style="color:#333333;">,</span> 
     <span style="color:#333333;">函数要求： </span> 
    </div> 
    <div> 
     <span style="color:#333333;">1. </span> 
     <span style="color:#333333;">必须是 </span> 
     <span style="color:#333333;">public </span> 
    </div> 
    <div> 
     <span style="color:#333333;">2.</span> 
     <span style="color:#333333;">返回类型 参数与原方法一致 </span> 
    </div> 
    <div> 
     <span style="color:#333333;">3. 默认需和原方法在同一个类中。若希望使用其他类的函数，可配置 blockHandlerClass </span> 
     <span style="color:#333333;">，并指定</span> 
     <span style="color:#333333;">blockHandlerClass</span> 
     <span style="color:#333333;">里面的方法。</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="color:#333333;">blockHandlerClass </span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="color:#333333;">存放</span> 
     <span style="color:#333333;">blockHandler</span> 
     <span style="color:#333333;">的类</span> 
     <span style="color:#333333;">,</span> 
     <span style="color:#333333;">对应的处理函数必须</span> 
     <span style="color:#333333;">static</span> 
     <span style="color:#333333;">修饰。 </span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="color:#333333;">fallback</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="color:#333333;">用于在抛出异常的时候提供</span> 
     <span style="color:#333333;">fallback</span> 
     <span style="color:#333333;">处理逻辑。</span> 
     <span style="color:#333333;">fallback函数可以针对所 有类型的异常（除了 </span> 
     <span style="color:#333333;">exceptionsToIgnore 里面排除掉的异常类型）进 行处理。函数要求： </span> 
    </div> 
    <div> 
     <span style="color:#333333;">1. </span> 
     <span style="color:#333333;">返回类型与原方法一致 </span> 
    </div> 
    <div> 
     <span style="color:#333333;">2. </span> 
     <span style="color:#333333;">参数类型需要和原方法相匹配 </span> 
    </div> 
    <div> 
     <span style="color:#333333;">3. 默认需和原方法在同一个类中。若希望使用其他类的函数，可配置 fallbackClass </span> 
     <span style="color:#333333;">，并指定</span> 
     <span style="color:#333333;">fallbackClass</span> 
     <span style="color:#333333;">里面的方法。</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="color:#333333;">fallbackClass </span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="color:#333333;">存放</span> 
     <span style="color:#333333;">fallback</span> 
     <span style="color:#333333;">的类。对应的处理函数必须</span> 
     <span style="color:#333333;">static</span> 
     <span style="color:#333333;">修饰。 </span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="color:#333333;">defaultFallback</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="color:#333333;">用于通用的</span> 
     <span style="color:#333333;"> fallback </span> 
     <span style="color:#333333;">逻辑。默认</span> 
     <span style="color:#333333;">fallback函数可以针对所有类型的异常进 行处理。若同时配置了</span> 
     <span style="color:#333333;"> fallback </span> 
     <span style="color:#333333;">和</span> 
     <span style="color:#333333;"> defaultFallback</span> 
     <span style="color:#333333;">，以</span> 
     <span style="color:#333333;">fallback为准。函 数要求： </span> 
    </div> 
    <div> 
     <span style="color:#333333;">1. </span> 
     <span style="color:#333333;">返回类型与原方法一致 </span> 
    </div> 
    <div> 
     <span style="color:#333333;">2. </span> 
     <span style="color:#333333;">方法参数列表为空，或者有一个 </span> 
     <span style="color:#333333;">Throwable </span> 
     <span style="color:#333333;">类型的参数。 </span> 
    </div> 
    <div> 
     <span style="color:#333333;">3. 默认需要和原方法在同一个类中。若希望使用其他类的函数，可配置 fallbackClass </span> 
     <span style="color:#333333;">，并指定 </span> 
     <span style="color:#333333;">fallbackClass </span> 
     <span style="color:#333333;">里面的方法。</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="color:#333333;">exceptionsToIgnore</span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="color:#333333;">指定排除掉哪些异常。排除的异常不会计入异常统计，也不会进入 fallback</span> 
     <span style="color:#333333;">逻辑，而是原样抛出。</span> 
    </div> </td> 
  </tr> 
  <tr> 
   <td> 
    <div> 
     <span style="color:#333333;">exceptionsToTrace </span> 
    </div> </td> 
   <td> 
    <div> 
     <span style="color:#333333;">需要</span> 
     <span style="color:#333333;">trace</span> 
     <span style="color:#333333;">的异常 </span> 
    </div> </td> 
  </tr> 
 </tbody> 
</table>

### **定义限流和降级后的处理类和方法:** ###

**注意:**虽然可以直接在当前类写方法,但**复用性低(不建议)!**

定义处理类可以提高复用性,但方法必须加上**static(很重要)!**

在接口或方法上用 **@SentinelResource** 标识为资源,并配置** value , blockHandlerClass , blockHandler , fallbackClass , fallback 属性.**

新建OrderServiceImpl3BlockHandlerClass类:

// BlockException 异常接口，其子类为Sentinel五种规则异常的实现类:
    	// AuthorityException 授权异常
    	// DegradeException 降级异常
    	// FlowException 限流异常
    	// ParamFlowException 参数限流异常
    	// SystemBlockException 系统负载异常
    @Slf4j
    public class OrderServiceImpl3BlockHandlerClass {//定义BlockException处理类
    	//注意:必须加上static修饰
    	public static String blockHandler(BlockException ex) {
    		log.error("{}", ex);
    		return "接口被限流或者降级了...";
    	}
    }

新建OrderServiceImpl3FallbackClass类:

@Slf4j
    public class OrderServiceImpl3FallbackClass {//定义Throwable处理类
    
    	//Throwable时进入的方法
    	public static String fallback(Throwable throwable) {
    		log.error("{}", throwable);
    		return "接口发生异常了...";
    	}
    }

OrderServiceImpl3类:

@Service
    @Slf4j
    public class OrderServiceImpl3 {
    
        int i = 0;
    	/*
    	@SentinelResource("资源名")注解: 用于指定本地资源(接口)并配置相应的流控规则.
    	 */
    	@SentinelResource(value = "/message5",//资源名
    			blockHandlerClass = OrderServiceImpl3BlockHandlerClass.class,//可以指定外部类
    			blockHandler = "blockHandler",//发生BlockException时调用,本类没有则须指定blockHandlerClass
    			fallbackClass = OrderServiceImpl3FallbackClass.class,//可以指定外部类
    			fallback = "fallback")//发生Throwable时调用,本类没有则须指定fallbackClass
    	public String message5() {
    		i++; //每次调用接口i就+1;所以i从1,2,3,4递增,每次递增1
    		if ( i % 3 == 0 ) {
    			throw new RuntimeException();
    		}//每过3次就触发一次异常,接口就会调用失败
    		return "message5";
    	}
    
    //	//直接在本类定义发生BlockException时进入的方法(复用性低,不建议)
    //	public String blockHandler(BlockException ex) {
    //		log.error("{}", ex);
    //		return "接口被限流或者降级了...";
    //	}
    //	//直接在本类定义发生Throwable时进入的方法(复用性低,不建议)
    //	public String fallback(Throwable throwable) {
    //		log.error("{}", throwable);
    //		return "接口发生异常了...";
    //	}
    }