Sentinel源码（二）入口方法分析

我们在上篇文中章已经分析了Sentinel是怎么让SentinelResource注解生效的，保留了一个疑问，每个被SentinelResource注解的方法都会在环绕通知中先调用一下如下代码

entry = SphU.entry(resourceName, resourceType, entryType, pjp.getArgs())

，本篇继续分析这个entry方法，分析这个方法之前，首先要了解这几个概念

resource是sentinel中最重要的一个概念，sentinel通过资源来保护具体的业务代码或其他后方服务。

sentinel把复杂的逻辑给屏蔽掉了，用户只需要为受保护的代码或服务定义一个资源，然后定义规则就可以了，剩下的通通交给sentinel来处理了。并且资源和规则是解耦的，规则甚至可以在运行时动态修改。定义完资源后，就可以通过在程序中埋点来保护你自己的服务了，埋点的方式有两种

try-catch 方式（通过 SphU.entry(…)），当 catch 到BlockException时执行异常处理(或fallback)

if-else 方式（通过 SphO.entry(…)），当返回 false 时执行异常处理(或fallback)

以上这两种方式都是通过硬编码的形式定义资源然后进行资源埋点的，对业务代码的侵入太大，从0.1.1版本开始，sentinel加入了注解的支持，可以通过注解来定义资源，具体的注解为：SentinelResource 。通过注解除了可以定义资源外，还可以指定 blockHandler 和 fallback 方法。

看一下ResourceWrapper的结构

protected final String name;

    protected final EntryType entryType;
    protected final int resourceType;

    public ResourceWrapper(String name, EntryType entryType, int resourceType) {
        AssertUtil.notEmpty(name, "resource name cannot be empty");
        AssertUtil.notNull(entryType, "entryType cannot be null");
        this.name = name;
        this.entryType = entryType;
        this.resourceType = resourceType;
    }

其中在SentinelResource中entryType默认是OUTEntryType entryType() default EntryType.OUT;，区别是当entryType为IN时，在StatisticSlot中会被统计到全局流量

resourType默认为0int resourceType() default 0;表示资源分类

public final class ResourceTypeConstants {

    public static final int COMMON = 0;
    public static final int COMMON_WEB = 1;
    public static final int COMMON_RPC = 2;
    public static final int COMMON_API_GATEWAY = 3;
    public static final int COMMON_DB_SQL = 4;

    private ResourceTypeConstants() {}
}

围绕资源的实时状态设定的规则，可以包括流量控制规则、熔断降级规则以及系统保护规则。所有规则可以动态实时调整。

Context是对资源操作时的上下文环境，每个资源操作(针对Resource进行的entry/exit)必须属于一个Context，如果程序中未指定Context，会创建name为"sentinel_default_context"的默认Context。一个Context生命周期内可能有多个资源操作，Context生命周期内的最后一个资源exit时会清理该Context，这也预示这整个Context生命周期的结束。Context主要属性如下：

    
    private final String name;

    
    private DefaultNode entranceNode;

    
    private Entry curEntry;

    
    private String origin = "";

    private final boolean async;

如果想在调用 SphU.entry() 或 SphO.entry() 前，自定义一个context，则通过ContextUtil.enter()方法来创建。当Entry执行exit方法时，如果entry的parent节点为null，表示是当前Context中最外层的Entry了，此时将ThreadLocal中的context清空。

刚才在Context身影中也看到了Entry的出现，现在就谈谈Entry。每次执行 SphU.entry() 或 SphO.entry() 都会返回一个Entry，Entry表示一次资源操作，内部会保存当前invocation信息。在一个Context生命周期中多次资源操作，也就是对应多个Entry，这些Entry形成parent/child结构保存在Entry实例中（举个列子，resourceA中调用了resourceB，那么B返回的entry的parent就是
A返回的entry），entry类CtEntry结构如下：

CtEntry(ResourceWrapper resourceWrapper, ProcessorSlot