本节介绍dubbo-common,dubbo-common是公共逻辑模块,包含Util类、通用模型,是其他模块的基础。
扩展机制
SPI
SPI是扩展点的注解。标注在类型上。全部的扩展点须要通过SPI来标注。
约定:
在扩展类的jar包内。放置扩展点配置文件:META-INF/dubbo/接口全限定名,内容为:配置名=扩展实现类全限定名,多个实现类用换行符分隔。
1) 自己主动Wrap扩展点的Wrapper类
ExtensionLoader会在载入扩展点时(通过扩展点配置文件里内容)。假设该实现有拷贝构造函数。则判定为扩展点Wrapper类。
2) 自己主动注入关联扩展点
载入扩展点时,扩展点实现类的成员假设为其他扩展点类型,ExtensionLoader在会自己主动注入依赖的扩展点。
3) 缺省获得的的扩展点是一个Adaptive Instance
假设ExtensionLoader注入的依赖扩展点是一个Adaptive实例,直到扩展点方法运行时才决定调用是一个扩展点实现。
Adaptive
实现扩展点的自适应,能够标注在类型和方法上。在ExtensionLoader生成Extension的Adaptive Instance时。为ExtensionLoader提供扩展点信息。
以下是Dubbo的Transporter扩展点的代码:
@SPI("netty")
publicinterfaceTransporter{
/**
* Bind a server.
*
* @seecom.alibaba.dubbo.remoting.Transporters#bind(URL, Receiver, ChannelHandler)
* @param url serverurl
* @param handler
* @return server
* @throws RemotingException
*/
@Adaptive({Constants.SERVER_KEY, Constants.TRANSPORTER_KEY})
Server bind(URL url, ChannelHandlerhandler)throws RemotingException;
/**
* Connect to a server.
*
* @seecom.alibaba.dubbo.remoting.Transporters#connect(URL, Receiver, ChannelListener)
* @param url serverurl
* @param handler
* @return client
* @throws RemotingException
*/
@Adaptive({Constants.CLIENT_KEY, Constants.TRANSPORTER_KEY})
Client connect(URL url, ChannelHandlerhandler)throws RemotingException;
}
对于bind方法,Adaptive实现先查找"server"key,假设该Key没有值则找"transport"key值。来决定代理到哪个实际扩展点。
ExtensionFactory
ExtensionFactory本身也是一种SPI。属于扩展点本身的载入容器,可从不同容器载入扩展点。
当中AdaptiveExtensionFactory标注为Adaptive,支持扩展点的自己主动激活。当例如以下所看到的没有參数时。属于无条件自己主动激活。
@Adaptive
publicclass AdaptiveExtensionFactoryimplementsExtensionFactory
当有參数时,为有条件激活。
Logger
Logger也是一种扩展。
当中LoggerAdapter适配接口是一种SPI。
在Dubbo中,实现了JCL、JDK、Log4J和Slf4J的多种实现。
例如以下图所看到的我们经常使用的两种。
ThreadPool
ThreadPool也是一种扩展SPI。
服务提供方线程实现策略。当server收到一个请求时。须要在线程池中创建一个线程去运行服务提供方业务逻辑。
@SPI("fixed")
publicinterfaceThreadPool{
/**
* 线程池
*
* @param url线程參数
* @return线程池
*/
@Adaptive({Constants.THREADPOOL_KEY})
Executor getExecutor(URL url);
}
如上SPI的參数作为默认的线程池类型,getExecutor方法中,通过"threadpool"的key来做到自适应扩展。
在Dubbo中实现了Fixed、Cached和Limited多种线程池的实现。
Serialize
Serialize是这里的核心接口。将对象转成字节流。用于网络传输,以及将字节流转为对象,用于在收到字节流数据后还原成对象。
下图是Dubbo中定义的接口。
下图是Dubbo中定义的扩展实现。各自是:
- NativeJavaSerialization:原生java序列化实现。
- CompactedJavaSerialization:压缩java序列化,主要是在原生java序列化基础上,实现了自己定义的类描写叙述符写入和读取。写Object类型的类描写叙述符仅仅写入类名称,而不是类的完整信息。这样有非常多Object类型的情况下能够降低序列化后的size。
- JavaSerialization:仅仅是对原生java序列化和压缩java序列化的封装。
- JsonSerialization:原生JSON序列化实现。
- FastJsonSerialization:使用阿里的FastJson实现的序列化。
- Hessian2Serialization:使用Hessian2的IO机制实现的序列化。
- DubboSerialization:Dubbo自己定义的序列化实现。
Compiler
Compiler是SPI。Java代码编译器。用于动态生成字节码,加速调用。
实现了JDK和Javassist的实现。当中使用的Javassist是一个开源的分析、编辑和创建Java字节码的类库。Javassist是JBoss的一个子项目,其基本的长处,在于简单。并且高速。