SOFARPC —— SPI 解析

一、前言

我之前研究过微博的Motan框架（当时接触的第一个RPC框架），当时懵懵懂懂，现在，上手SOFARPC框架，感觉比较轻松，事物的本质都是相通的。以前写博文，会逐行分析源码，慢慢地发现，源码其实就是作者的思想。看完源码后，弄懂作者的意图，可能类似读书的过程，书由厚读到薄，随着眼界的开阔，再看源码时，会带着评判的眼光，看出哪里写的好与不好，这也就是读书又由薄到厚的下一个阶段吧！废话结束，开始正文。

二、特点

SPI多应用于框架的建设中，方便解耦，利于扩展。SOFARPC的SPI，与原生的SPI相比，有如下特点：

★按需加载
★单例设置
★别名
★设置扩展类的优先级，可进行覆盖
★指定扩展类位置
★解耦
SOFARPC的SPI流程图如下（记住这张图）：

三、示例

好的框架，离不开好的示例。看一下SOFARPC给我们提供的SPI示例。

public class ExtensionMain {
    public static void main(String[] args) {
        Person person = ExtensionLoaderFactory.getExtensionLoader(Person.class).getExtension("A");
        // 上面这行，大家自己debug跟一下就好，代码很简单，记住上面流程图，一步步跟踪代码，之后，会有一个更深刻的认识的！
        person.getName();
    }
}

@Extensible          // 这个注解表示它是一个扩展点
public interface Person {
    void getName();
}

@Extension("A")     // 这个注解表示它是一个扩展类，它的别名是A
public class PersonA implements Person {
    private final static Logger LOGGER = LoggerFactory.getLogger(PersonA.class);
    @Override
    public void getName() {
        LOGGER.info("li wei");
    }
}

在上方示例的基础上，配置META-INF下的扩展描述文件，我们便可以实现自由扩展。

这里，贴上了扩展的注解类。

 /**
  * <p>代表这个类或者接口是可扩展的，默认单例、不需要编码</p>
  */
 @Documented
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ ElementType.TYPE })
 public @interface Extensible {

     /**
      * 指定自定义扩展文件名称，默认就是全类名
      *
      * @return 自定义扩展文件名称
      */
     String file() default "";

     /**
      * 扩展类是否使用单例，默认使用
      *
      * @return 是否使用单例
      */
     boolean singleton() default true;

     /**
      * 扩展类是否需要编码，默认不需要
      *
      * @return 是否需要编码
      */
     boolean coded() default false;
 }

 /**
  * 扩展点
  *
  * @author <a href=mailto:zhanggeng.zg@antfin.com>GengZhang</a>
  * @see Extensible
  */
 @Documented
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ ElementType.TYPE })
 public @interface Extension {
     /**
      * 扩展点名字
      *
      * @return 扩展点名字
      */
     String value();

     /**
      * 扩展点编码，默认不需要，当接口需要编码的时候需要
      *
      * @return 扩展点编码
      * @see Extensible#coded()
      */
     byte code() default -1;

     /**
      * 优先级排序，默认不需要，大的优先级高
      *
      * @return 排序
      */
     int order() default 0;

     /**
      * 是否覆盖其它低{@link #order()}的同名扩展
      *
      * @return 是否覆盖其它低排序的同名扩展
      * @since 5.2.0
      */
     boolean override() default false;

     /**
      * 排斥其它扩展，可以排斥掉其它低{@link #order()}的扩展
      *
      * @return 排斥其它扩展
      * @since 5.2.0
      */
     String[] rejection() default {};
 }