手撕SPI扩展机制

[任程鹏]

## URL适配规则： 1.方法中有注解@Adaptive，注解内没有值，以该接口的名称作为URL（dubbo内部自定义的URL,封装了protocol，host，username , password ,path, parameters,port=0）的参数key，然后在调用方法时候，获取URL中的该参数对应的值，值作为配置文件中的key，来匹配到对应的实现类。如果URL中没有该参数，则分为下面两种 a) SPI注解有值，以该值作为配置文件中的key，来匹配到对应的实现类 b)SPI注解没有值，则抛异常throw new IllegalStateException，Fail to get extension(%s) name from url 如果恰巧该接口的名称为protocol，则按照协议的规则去匹配实现类，就是获取URL的协议，如果有协议且协议是配置文件中的key，则找出对应的实现类。否则抛出异常throw new IllegalStateException，Fail to get extension(%s) name from url 2.方法中有注解@Adaptive，注解内有值，以该值作为URL的参数key, 然后在调用方法时候，获取URL中的该参数对应的值，值作为配置文件中的key，来匹配到对应的实现类。如果URL中没有该参数，则分为下面两种 a) SPI注解有值，以该值作为配置文件中的key，来匹配到对应的实现类 b)SPI注解没有值，则抛异常throw new IllegalStateException，Fail to get extension(%s) name from url 如果该值为protocol，则按照协议的规则去匹配实现类，就是获取URL的协议，如果有协议且协议是配置文件中的key，则找出对应的实现类。否则抛出异常throw new IllegalStateException，Fail to get extension(%s) name from url 3.方法中没有注解@Adaptive的方法是不能调用的，否则throw new UnsupportedOperationException ###### 总结：新增接口扩展时候SPI注解最好有值，Adaptive注解的值不要写protocol，因为dubbo内部已经扩展了protocol。 ## 适配扩展点规则： 1.如果某个实现类中有注解@Adaptive（只能有一个实现类有，否则throw new IllegalStateException （More than 1 adaptive class found）），则直接适配该实现类（该种方案不能动态进行适配，不太好） 2.如果实现类中都没有注解@Adaptive，则会创建适配扩展点classCode的字符串，然后默认通过AdaptiveCompiler 编译class字符串生成反向代理。 创建适配类;，要求接口中的方法至少有一个含有注解@Adaptive，否则hrow new IllegalStateException("No adaptive method on extension，创建不了适配类。 而且必须要求该方法中的参数必须含有URL类型的或者参数列表中有参数的类型的方法里面的返回值是URL类型的---但是对改方法有下面要求： Modifier.isPublic(m.getModifiers()) && !Modifier.isStatic(m.getModifiers() && m.getParameterTypes().length == 0 && m.getReturnType() == URL.class 否则 throw new IllegalStateException("fail to create adative class for interface ###### 总结：尽量使用方法添加注解适配，动态适配