一、ExtensionLoader 插件化
属性:
1、String cachedDefaultName 默认的扩展名
2、Map<String, Class<?>> cachedClasses 比如[{'dubbo',DubboProtocol.class},{'registry',RegistryProtocol.class}]
3、ConcurrentMap<String, Holder<Object>> cachedInstances 值是具体扩展的对象的Holder
比如[{'dubbo',dubboProtocol},{'registry',registryProtocol}]
4、ConcurrentMap<Class<?>, Object> EXTENSION_INSTANCES key为class,value是具体对象
比如[{DubboProtocol.class,dubboProtocol},{RegistryProtocol.class,registryProtocol}]
5、Set<Class<?>> cachedWrapperClasses保存着,是扩展类型,并且有一个属性是扩展类型,一般是包装类,比如ProtocolFilterWrapper
6、Map<String, Activate> cachedActivates保存着,带有@Activate注解的扩展类型,比如EchoFilter
方法:
1、public T getDefaultExtension() 返回默认的扩展,会以@SPI注解的值作为key的扩展
cachedDefaultName
Map<String, Class<?>> loadExtensionClasses()设置了cachedDefaultName,
读取META-INF所有的配置文件,设置到Map<String, Class<?>> cachedClasses
loadFile方法设置了cachedAdaptiveClass 即已@Adaptive注解的,自适应的扩展
设置了cachedWrapperClasses,还有cachedActivates
2、public T getExtension(String name)返回指定名字的扩展,没有抛异常
在createExtension设置缓存EXTENSION_INSTANCES 然后设置缓存cachedInstances
3、createExtension中
injectExtension(instance):如果对象有set方法,且只有一个参数,是扩展类型的,
一般会注入adaptive类型的扩展类型
Set<Class<?>> wrapperClasses = cachedWrapperClasses;
if (wrapperClasses != null && wrapperClasses.size() > 0) {
for (Class<?> wrapperClass : wrapperClasses) {
instance = injectExtension((T) wrapperClass.getConstructor(type).newInstance(instance));
}
}
装配wrapper类,比如ProtocolListenerWrapper->ProtocolFilterWrapper->RegistryProtocol
4、public List<T> getActivateExtension(URL url, String[] values, String group)
激活的所有扩展点,并且经过过滤条件的。比如filter,listener。两种方法可以配置,一是使用@Activate注解,
二是显示配置的,比如<dubbo:service filter='xx'/>
public List<T> getActivateExtension(URL url, String[] values, String group) {
List<T> exts = new ArrayList<T>();
List<String> names = values == null ? new ArrayList<String>(0) : Arrays.asList(values);
if (! names.contains(Constants.REMOVE_VALUE_PREFIX + Constants.DEFAULT_KEY)) {
getExtensionClasses();
//拿到所有的@Activate注解的,并且过滤group和-开头的名称
for (Map.Entry<String, Activate> entry : cachedActivates.entrySet()) {
String name = entry.getKey();
Activate activate = entry.getValue();
if (isMatchGroup(group, activate.group())) {
T ext = getExtension(name);
if (! names.contains(name)
&& ! names.contains(Constants.REMOVE_VALUE_PREFIX + name)
&& isActive(activate, url)) {
exts.add(ext);
}
}
}
Collections.sort(exts, ActivateComparator.COMPARATOR);
}
//用户配置的,依次取出,最后合并
List<T> usrs = new ArrayList<T>();
for (int i = 0; i < names.size(); i ++) {
String name = names.get(i);
if (! name.startsWith(Constants.REMOVE_VALUE_PREFIX)
&& ! names.contains(Constants.REMOVE_VALUE_PREFIX + name)) {
if (Constants.DEFAULT_KEY.equals(name)) {
if (usrs.size() > 0) {
exts.addAll(0, usrs);
usrs.clear();
}
} else {
T ext = getExtension(name);
usrs.add(ext);
}
}
}
if (usrs.size() > 0) {
exts.addAll(usrs);
}
return exts;
}
5、public T getAdaptiveExtension() 自适应的扩展,如果有已@Adaptive注解的直接返回,
否则代码模板生成,比如Protocol$Adpative,最终会以URL的protocol去得到指定名称的扩展
package com.alibaba.dubbo.rpc;
import com.alibaba.dubbo.common.extension.ExtensionLoader;
public class Protocol$Adpative implements com.alibaba.dubbo.rpc.Protocol {
public void destroy() {throw new UnsupportedOperationException("method public abstract void com.alibaba.dubbo.rpc.Protocol.destroy() of interface com.alibaba.dubbo.rpc.Protocol is not adaptive method!");
}
public int getDefaultPort() {throw new UnsupportedOperationException("method public abstract int com.alibaba.dubbo.rpc.Protocol.getDefaultPort() of interface com.alibaba.dubbo.rpc.Protocol is not adaptive method!");
}
public com.alibaba.dubbo.rpc.Invoker refer(java.lang.Class arg0, com.alibaba.dubbo.common.URL arg1) throws java.lang.Class {
if (arg1 == null) throw new IllegalArgumentException("url == null");
com.alibaba.dubbo.common.URL url = arg1;
String extName = ( url.getProtocol() == null ? "dubbo" : url.getProtocol() );
if(extName == null) throw new IllegalStateException("Fail to get extension(com.alibaba.dubbo.rpc.Protocol) name from url(" + url.toString() + ") use keys([protocol])");
com.alibaba.dubbo.rpc.Protocol extension = (com.alibaba.dubbo.rpc.Protocol)ExtensionLoader.getExtensionLoader(com.alibaba.dubbo.rpc.Protocol.class).getExtension(extName);
return extension.refer(arg0, arg1);
}
public com.alibaba.dubbo.rpc.Exporter export(com.alibaba.dubbo.rpc.Invoker arg0) throws com.alibaba.dubbo.rpc.Invoker {
if (arg0 == null) throw new IllegalArgumentException("com.alibaba.dubbo.rpc.Invoker argument == null");
if (arg0.getUrl() == null) throw new IllegalArgumentException("com.alibaba.dubbo.rpc.Invoker argument getUrl() == null");com.alibaba.dubbo.common.URL url = arg0.getUrl();
String extName = ( url.getProtocol() == null ? "dubbo" : url.getProtocol() );
if(extName == null) throw new IllegalStateException("Fail to get extension(com.alibaba.dubbo.rpc.Protocol) name from url(" + url.toString() + ") use keys([protocol])");
com.alibaba.dubbo.rpc.Protocol extension = (com.alibaba.dubbo.rpc.Protocol)ExtensionLoader.getExtensionLoader(com.alibaba.dubbo.rpc.Protocol.class).getExtension(extName);
return extension.export(arg0);
}
}
属性:
1、String cachedDefaultName 默认的扩展名
2、Map<String, Class<?>> cachedClasses 比如[{'dubbo',DubboProtocol.class},{'registry',RegistryProtocol.class}]
3、ConcurrentMap<String, Holder<Object>> cachedInstances 值是具体扩展的对象的Holder
比如[{'dubbo',dubboProtocol},{'registry',registryProtocol}]
4、ConcurrentMap<Class<?>, Object> EXTENSION_INSTANCES key为class,value是具体对象
比如[{DubboProtocol.class,dubboProtocol},{RegistryProtocol.class,registryProtocol}]
5、Set<Class<?>> cachedWrapperClasses保存着,是扩展类型,并且有一个属性是扩展类型,一般是包装类,比如ProtocolFilterWrapper
6、Map<String, Activate> cachedActivates保存着,带有@Activate注解的扩展类型,比如EchoFilter
方法:
1、public T getDefaultExtension() 返回默认的扩展,会以@SPI注解的值作为key的扩展
cachedDefaultName
Map<String, Class<?>> loadExtensionClasses()设置了cachedDefaultName,
读取META-INF所有的配置文件,设置到Map<String, Class<?>> cachedClasses
loadFile方法设置了cachedAdaptiveClass 即已@Adaptive注解的,自适应的扩展
设置了cachedWrapperClasses,还有cachedActivates
2、public T getExtension(String name)返回指定名字的扩展,没有抛异常
在createExtension设置缓存EXTENSION_INSTANCES 然后设置缓存cachedInstances
3、createExtension中
injectExtension(instance):如果对象有set方法,且只有一个参数,是扩展类型的,
一般会注入adaptive类型的扩展类型
Set<Class<?>> wrapperClasses = cachedWrapperClasses;
if (wrapperClasses != null && wrapperClasses.size() > 0) {
for (Class<?> wrapperClass : wrapperClasses) {
instance = injectExtension((T) wrapperClass.getConstructor(type).newInstance(instance));
}
}
装配wrapper类,比如ProtocolListenerWrapper->ProtocolFilterWrapper->RegistryProtocol
4、public List<T> getActivateExtension(URL url, String[] values, String group)
激活的所有扩展点,并且经过过滤条件的。比如filter,listener。两种方法可以配置,一是使用@Activate注解,
二是显示配置的,比如<dubbo:service filter='xx'/>
public List<T> getActivateExtension(URL url, String[] values, String group) {
List<T> exts = new ArrayList<T>();
List<String> names = values == null ? new ArrayList<String>(0) : Arrays.asList(values);
if (! names.contains(Constants.REMOVE_VALUE_PREFIX + Constants.DEFAULT_KEY)) {
getExtensionClasses();
//拿到所有的@Activate注解的,并且过滤group和-开头的名称
for (Map.Entry<String, Activate> entry : cachedActivates.entrySet()) {
String name = entry.getKey();
Activate activate = entry.getValue();
if (isMatchGroup(group, activate.group())) {
T ext = getExtension(name);
if (! names.contains(name)
&& ! names.contains(Constants.REMOVE_VALUE_PREFIX + name)
&& isActive(activate, url)) {
exts.add(ext);
}
}
}
Collections.sort(exts, ActivateComparator.COMPARATOR);
}
//用户配置的,依次取出,最后合并
List<T> usrs = new ArrayList<T>();
for (int i = 0; i < names.size(); i ++) {
String name = names.get(i);
if (! name.startsWith(Constants.REMOVE_VALUE_PREFIX)
&& ! names.contains(Constants.REMOVE_VALUE_PREFIX + name)) {
if (Constants.DEFAULT_KEY.equals(name)) {
if (usrs.size() > 0) {
exts.addAll(0, usrs);
usrs.clear();
}
} else {
T ext = getExtension(name);
usrs.add(ext);
}
}
}
if (usrs.size() > 0) {
exts.addAll(usrs);
}
return exts;
}
5、public T getAdaptiveExtension() 自适应的扩展,如果有已@Adaptive注解的直接返回,
否则代码模板生成,比如Protocol$Adpative,最终会以URL的protocol去得到指定名称的扩展
package com.alibaba.dubbo.rpc;
import com.alibaba.dubbo.common.extension.ExtensionLoader;
public class Protocol$Adpative implements com.alibaba.dubbo.rpc.Protocol {
public void destroy() {throw new UnsupportedOperationException("method public abstract void com.alibaba.dubbo.rpc.Protocol.destroy() of interface com.alibaba.dubbo.rpc.Protocol is not adaptive method!");
}
public int getDefaultPort() {throw new UnsupportedOperationException("method public abstract int com.alibaba.dubbo.rpc.Protocol.getDefaultPort() of interface com.alibaba.dubbo.rpc.Protocol is not adaptive method!");
}
public com.alibaba.dubbo.rpc.Invoker refer(java.lang.Class arg0, com.alibaba.dubbo.common.URL arg1) throws java.lang.Class {
if (arg1 == null) throw new IllegalArgumentException("url == null");
com.alibaba.dubbo.common.URL url = arg1;
String extName = ( url.getProtocol() == null ? "dubbo" : url.getProtocol() );
if(extName == null) throw new IllegalStateException("Fail to get extension(com.alibaba.dubbo.rpc.Protocol) name from url(" + url.toString() + ") use keys([protocol])");
com.alibaba.dubbo.rpc.Protocol extension = (com.alibaba.dubbo.rpc.Protocol)ExtensionLoader.getExtensionLoader(com.alibaba.dubbo.rpc.Protocol.class).getExtension(extName);
return extension.refer(arg0, arg1);
}
public com.alibaba.dubbo.rpc.Exporter export(com.alibaba.dubbo.rpc.Invoker arg0) throws com.alibaba.dubbo.rpc.Invoker {
if (arg0 == null) throw new IllegalArgumentException("com.alibaba.dubbo.rpc.Invoker argument == null");
if (arg0.getUrl() == null) throw new IllegalArgumentException("com.alibaba.dubbo.rpc.Invoker argument getUrl() == null");com.alibaba.dubbo.common.URL url = arg0.getUrl();
String extName = ( url.getProtocol() == null ? "dubbo" : url.getProtocol() );
if(extName == null) throw new IllegalStateException("Fail to get extension(com.alibaba.dubbo.rpc.Protocol) name from url(" + url.toString() + ") use keys([protocol])");
com.alibaba.dubbo.rpc.Protocol extension = (com.alibaba.dubbo.rpc.Protocol)ExtensionLoader.getExtensionLoader(com.alibaba.dubbo.rpc.Protocol.class).getExtension(extName);
return extension.export(arg0);
}
}