界首网站优化公司,asp网站上传,江苏省现代化示范校建设网站,上海优化网站方法默认情况下#xff0c;Sentinel会将controller中的方法作为被保护资源#xff0c;Sentinel中的资源用Entry来表示。
Sentinel中Entry可以理解为每次进入资源的一个凭证#xff0c;如果调用SphO.entry()或者SphU.entry()能获取Entry对象#xff0c;代表获取了凭证#xff…默认情况下Sentinel会将controller中的方法作为被保护资源Sentinel中的资源用Entry来表示。
Sentinel中Entry可以理解为每次进入资源的一个凭证如果调用SphO.entry()或者SphU.entry()能获取Entry对象代表获取了凭证没有被限流否则抛出一个BlockException。
Entry是一个抽象的类在Sentinel中真正创建的Entry是CtEntry。
Entry
createTime当前entry的创建时间毫秒值用来计算响应时间rt。curNode当前Entry所关联的node会在NodeSelectorSlot插槽中设置主要是记录了当前Context下的统计信息。originNodecontext的请求源节点通常是服务的消费端如果存在的话在ClusterBuilderSlot的entry方法中设置resourceWrapper当前Entry所关联的资源包装器
CtEntry
CtEntry 是 Entry的子类主要保存了实体之间的关系、调用链、上下文信息。
parententry的父entry用于在同一个context上下文中多次调用entry方法保存entry之间的关系。childentry的子entry与parent相反chainentry中的插槽链contextentry的上下文 Sentinel中的资源用Entry来表示。声明Entry的API示例
// 资源名可使用任意有业务语义的字符串比如方法名、接口名或其它可唯一标识的字符串。
try (Entry entry SphU.entry(resourceName)) {// 被保护的业务逻辑// do something here...
} catch (BlockException ex) {// 资源访问阻止被限流或被降级// 在此处进行相应的处理操作
}
Sentinel 提供了 SentinelResource 注解用于定义资源并提供了 AspectJ 的扩展用于自动定义资源、处理 BlockException 等 。
SentinelResource属性
参数描述value资源名称必需项不能为空entryType资源调用方向可选项默认为EntryType.OUTresourceType资源的分类blockHandler对应处理BlockException的函数名称blockHandlerClass处理类的Class对象函数必需为static函数fallback用于在抛出异常的时候提供fallback处理逻辑defaultFallback用作默认的回退的方法fallbackClass异常类的Class对象函数必需为static函数exceptionsToTrace异常类跟踪列表默认为Throwable.classexceptionsToIgnore排除掉的异常类型 SentinelResource 用于定义资源并提供可选的异常处理和 fallback 配置项。 SentinelResource 注解包含以下属性
value 资源名称必需项不能为空 entryType entry 类型资源调用方向可选项默认为EntryType.OUT blockHandler / blockHandlerClass: blockHandler 对应处理 BlockException 的函数名称可选项。blockHandler 函数访问范围需要是 public返回类型需要与原方法相匹配参数类型需要和原方法相匹配并且最后加一个额外的参数类型为 BlockException。blockHandler 函数默认需要和原方法在同一个类中。若希望使用其他类的函数则可以指定 blockHandlerClass 为对应的类的 Class 对象注意对应的函数必需为 static 函数否则无法解析。 fallback / fallbackClass
fallback 函数名称可选项用于在抛出异常的时候提供 fallback 处理逻辑。fallback 函数可以针对所有类型的异常除了 exceptionsToIgnore 里面排除掉的异常类型进行处理。fallback 函数签名和位置要求 返回值类型必须与原函数返回值类型一致方法参数列表需要和原函数一致或者可以额外多一个 Throwable 类型的参数用于接收对应的异常。fallback 函数默认需要和原方法在同一个类中。若希望使用其他类的函数则可以指定 fallbackClass 为对应的类的 Class 对象注意对应的函数必需为 static 函数否则无法解析。
defaultFallback
默认的 fallback 函数名称可选项通常用于通用的 fallback 逻辑即可以用于很多服务或方法。默认 fallback 函数可以针对所有类型的异常除了 exceptionsToIgnore 里面排除掉的异常类型进行处理。若同时配置了 fallback 和 defaultFallback则只有 fallback 会生效 返回值类型必须与原函数返回值类型一致方法参数列表需要为空或者可以额外多一个 Throwable 类型的参数用于接收对应的异常。defaultFallback 函数默认需要和原方法在同一个类中。若希望使用其他类的函数则可以指定 fallbackClass 为对应的类的 Class 对象注意对应的函数必需为 static 函数否则无法解析。 exceptionsToIgnore
用于指定哪些异常被排除掉不会计入异常统计中也不会进入 fallback 逻辑中而是会原样抛出。 1.8.0 版本开始defaultFallback 支持在类级别进行配置。 注1.6.0 之前的版本 fallback 函数只针对降级异常DegradeException进行处理不能针对业务异常进行处理。 特别地若 blockHandler 和 fallback 都进行了配置则被限流降级而抛出 BlockException 时只会进入 blockHandler 处理逻辑。若未配置 blockHandler、fallback 和 defaultFallback则被限流降级时会将 BlockException 直接抛出若方法本身未定义 throws BlockException 则会被 JVM 包装一层 UndeclaredThrowableException。 public class TestService {// 原函数SentinelResource(value hello, blockHandler exceptionHandler, fallback helloFallback)public String hello(long s) {return String.format(Hello at %d, s);}// Fallback 函数函数签名与原函数一致或加一个 Throwable 类型的参数.public String helloFallback(long s) {return String.format(Halooooo %d, s);}// Block 异常处理函数参数最后多一个 BlockException其余与原函数一致.public String exceptionHandler(long s, BlockException ex) {// Do some log here.ex.printStackTrace();return Oops, error occurred at s;}// 这里单独演示 blockHandlerClass 的配置.// 对应的 handleException 函数需要位于 ExceptionUtil 类中并且必须为 public static 函数.SentinelResource(value test, blockHandler handleException, blockHandlerClass {ExceptionUtil.class})public void test() {System.out.println(Test);}
}
