dubbo本质是一个RPC框架,我们首先讨论这个骨干中的骨干,dubbo-rpc模块。
主要讨论一下几部分内容:
一、此模块在dubbo整体框架中的作用;
二、此模块需要完成的需求功能点及接口定义;
三、DubboProtocol实现细节;
四、其他协议实现;
一、此模块在dubbo整体框架中的作用
Protocol 是框架中的核心层,也就是只要有 Protocol + Invoker + Exporter 就可以完成非透明的 RPC 调用,然后在 Invoker 的主过程上 Filter 拦截点。它抽象了动态代理,只包含一对一的调用,不关心集群的管理。
二、此模块需要完成的需求功能点及接口定义
远程调用层:封装 RPC 调用,以 Invocation
, Result
为中心,扩展接口为 Protocol
,Invoker
, Exporter。
远程调用模块实现Protocol,Invoker, Exporter等上层协议接口定义,实现DubboProtocol协议的上层实现,以及DubboCodec类(dubbo编码)实现;封装了Hession协议、RMI协议、Http协议、WebService协议、Rest协议、Thrift等协议的实现;抽象了动态代理,只包含一对一的调用,不关心集群的管理。
核心接口定义有:
协议接口:Protocol
1 package com.alibaba.dubbo.rpc; 2 3 import com.alibaba.dubbo.common.URL; 4 import com.alibaba.dubbo.common.extension.Adaptive; 5 import com.alibaba.dubbo.common.extension.SPI; 6 7 /** 8 * Protocol. (API/SPI, Singleton, ThreadSafe) 9 */ 10 @SPI("dubbo") 11 public interface Protocol { 12 13 /** 14 * Get default port when user doesn't config the port. 15 * 16 * @return default port 17 */ 18 int getDefaultPort(); 19 20 /** 21 * Export service for remote invocation: <br> 22 * 1. Protocol should record request source address after receive a request: 23 * RpcContext.getContext().setRemoteAddress();<br> 24 * 2. export() must be idempotent, that is, there's no difference between invoking once and invoking twice when 25 * export the same URL<br> 26 * 3. Invoker instance is passed in by the framework, protocol needs not to care <br> 27 * 28 * @param <T> Service type 29 * @param invoker Service invoker 30 * @return exporter reference for exported service, useful for unexport the service later 31 * @throws RpcException thrown when error occurs during export the service, for example: port is occupied 32 */ 33 @Adaptive 34 <T> Exporter<T> export(Invoker<T> invoker) throws RpcException; 35 36 /** 37 * Refer a remote service: <br> 38 * 1. When user calls `invoke()` method of `Invoker` object which's returned from `refer()` call, the protocol 39 * needs to correspondingly execute `invoke()` method of `Invoker` object <br> 40 * 2. It's protocol's responsibility to implement `Invoker` which's returned from `refer()`. Generally speaking, 41 * protocol sends remote request in the `Invoker` implementation. <br> 42 * 3. When there's check=false set in URL, the implementation must not throw exception but try to recover when 43 * connection fails. 44 * 45 * @param <T> Service type 46 * @param type Service class 47 * @param url URL address for the remote service 48 * @return invoker service's local proxy 49 * @throws RpcException when there's any error while connecting to the service provider 50 */ 51 @Adaptive 52 <T> Invoker<T> refer(Class<T> type, URL url) throws RpcException; 53 54 /** 55 * Destroy protocol: <br> 56 * 1. Cancel all services this protocol exports and refers <br> 57 * 2. Release all occupied resources, for example: connection, port, etc. <br> 58 * 3. Protocol can continue to export and refer new service even after it's destroyed. 59 */ 60 void destroy(); 61 62 }
调用者接口Invoker:
1 package com.alibaba.dubbo.rpc; 2 3 import com.alibaba.dubbo.common.Node; 4 5 /** 6 * Invoker. (API/SPI, Prototype, ThreadSafe) 7 * 8 * @see com.alibaba.dubbo.rpc.Protocol#refer(Class, com.alibaba.dubbo.common.URL) 9 * @see com.alibaba.dubbo.rpc.InvokerListener 10 * @see com.alibaba.dubbo.rpc.protocol.AbstractInvoker 11 */ 12 public interface Invoker<T> extends Node { 13 14 /** 15 * get service interface. 16 * 17 * @return service interface. 18 */ 19 Class<T> getInterface(); 20 21 /** 22 * invoke. 23 * 24 * @param invocation 25 * @return result 26 * @throws RpcException 27 */ 28 Result invoke(Invocation invocation) throws RpcException; 29 30 }
发布者接口Exporter:
package com.alibaba.dubbo.rpc; /** * Exporter. (API/SPI, Prototype, ThreadSafe) * * @see com.alibaba.dubbo.rpc.Protocol#export(Invoker) * @see com.alibaba.dubbo.rpc.ExporterListener * @see com.alibaba.dubbo.rpc.protocol.AbstractExporter */ public interface Exporter<T> { /** * get invoker. * * @return invoker */ Invoker<T> getInvoker(); /** * unexport. * <p> * <code> * getInvoker().destroy(); * </code> */ void unexport(); }
请求调用上下文接口Invocation:
package com.alibaba.dubbo.rpc; import java.util.Map; /** * Invocation. (API, Prototype, NonThreadSafe) * * @serial Don't change the class name and package name. * @see com.alibaba.dubbo.rpc.Invoker#invoke(Invocation) * @see com.alibaba.dubbo.rpc.RpcInvocation */ public interface Invocation { /** * get method name. * * @return method name. * @serial */ String getMethodName(); /** * get parameter types. * * @return parameter types. * @serial */ Class<?>[] getParameterTypes(); /** * get arguments. * * @return arguments. * @serial */ Object[] getArguments(); /** * get attachments. * * @return attachments. * @serial */ Map<String, String> getAttachments(); /** * get attachment by key. * * @return attachment value. * @serial */ String getAttachment(String key); /** * get attachment by key with default value. * * @return attachment value. * @serial */ String getAttachment(String key, String defaultValue); /** * get the invoker in current context. * * @return invoker. * @transient */ Invoker<?> getInvoker(); }
dubbo-rpc-api模块定义了基本接口,给出了默认实现类:
Protocol接口的默认实现为AbstractProtocol,AbstractProxyProtocol类
(1)AbstractProtocol实现了destory()方法,主要逻辑为:循环销毁invoker、exporter。
(2)AbstractProxyProtocol给出了export()和refer()的默认实现,分别返回AbstractExport和AbstractInvoker实例。
三、DubboProtocol实现细节(dubbo-rpc-default);
Dubbo 缺省协议采用单一长连接和 NIO 异步通讯,适合于小数据量大并发的服务调用,以及服务消费者机器数远大于服务提供者机器数的情况。
反之,Dubbo 缺省协议不适合传送大数据量的服务,比如传文件,传视频等,除非请求量很低。
特性
缺省协议,使用基于 mina 1.1.7
和 hessian 3.2.1
的 tbremoting 交互。
- 连接个数:单连接
- 连接方式:长连接
- 传输协议:TCP
- 传输方式:NIO 异步传输(默认netty)
- 序列化:Hessian2 二进制序列化
- 适用范围:传入传出参数数据包较小(建议小于100K),消费者比提供者个数多,单一消费者无法压满提供者,尽量不要用 dubbo 协议传输大文件或超大字符串。
- 适用场景:常规远程服务方法调用
核心类:DubboProtocol
1、实现了export()方法,此方法实现了服务提供者接口的对外发布,返回Exporter对象,用于得到invoker并调用,以及销毁exporter对象。
实现逻辑为:
(1)判断是否需要创建stub支持,需要则在stubServiceMethodsMap缓存中存储dubbo.stub.event.methods方法名;
Stub本地存根:远程服务后,客户端通常只剩下接口,而实现全在服务器端,但提供方有些时候想在客户端也执行部分逻辑,比如:做 ThreadLocal 缓存,提前验证参数,调用失败后伪造容错数据等等,此时就需要在 API 中带上 Stub,客户端生成 Proxy 实例,会把 Proxy 通过构造函数传给 Stub 1,然后把 Stub 暴露给用户,Stub 可以决定要不要去调 Proxy。
(2)创建或更新(reset)远程服务,并放到serverMap缓存中;创建远程服务逻辑为:给传入的URL设置默认属性,包括:当服务通道关闭时发送只读事件(channel.readonly.sent),开启心跳检测(维护长连接),设置默认编码方式为dubbo,创建绑定url和请求处理类requestHandler的ExchangeServer并返回;
1 public <T> Exporter<T> export(Invoker<T> invoker) throws RpcException { 2 URL url = invoker.getUrl(); 3 4 // export service. 5 String key = serviceKey(url); 6 DubboExporter<T> exporter = new DubboExporter<T>(invoker, key, exporterMap); 7 exporterMap.put(key, exporter); 8 9 //发布一个本地存根服务,用于分发事件(猜测,不确定) 10 Boolean isStubSupportEvent = url.getParameter(Constants.STUB_EVENT_KEY, Constants.DEFAULT_STUB_EVENT); 11 Boolean isCallbackservice = url.getParameter(Constants.IS_CALLBACK_SERVICE, false); 12 if (isStubSupportEvent && !isCallbackservice) { 13 String stubServiceMethods = url.getParameter(Constants.STUB_EVENT_METHODS_KEY); 14 if (stubServiceMethods == null || stubServiceMethods.length() == 0) { 15 if (logger.isWarnEnabled()) { 16 logger.warn(new IllegalStateException("consumer [" + url.getParameter(Constants.INTERFACE_KEY) + 17 "], has set stubproxy support event ,but no stub methods founded.")); 18 } 19 } else { 20 stubServiceMethodsMap.put(url.getServiceKey(), stubServiceMethods); 21 } 22 } 23 24 openServer(url); 25 optimizeSerialization(url); 26 return exporter; 27 } 28 29 private void openServer(URL url) { 30 // find server. 31 String key = url.getAddress(); 32 //client can export a service which's only for server to invoke 33 boolean isServer = url.getParameter(Constants.IS_SERVER_KEY, true); 34 if (isServer) { 35 ExchangeServer server = serverMap.get(key); 36 if (server == null) { 37 serverMap.put(key, createServer(url)); 38 } else { 39 // server supports reset, use together with override 40 server.reset(url); 41 } 42 } 43 } 44 45 private ExchangeServer createServer(URL url) { 46 // 当服务通道关闭时,发送只读事件,默认为True 47 url = url.addParameterIfAbsent(Constants.CHANNEL_READONLYEVENT_SENT_KEY, Boolean.TRUE.toString()); 48 // 默认开启心跳检测 49 url = url.addParameterIfAbsent(Constants.HEARTBEAT_KEY, String.valueOf(Constants.DEFAULT_HEARTBEAT)); 50 //约定传输服务为netty实现 51 String str = url.getParameter(Constants.SERVER_KEY, Constants.DEFAULT_REMOTING_SERVER); 52 53 if (str != null && str.length() > 0 && !ExtensionLoader.getExtensionLoader(Transporter.class).hasExtension(str)) 54 throw new RpcException("Unsupported server type: " + str + ", url: " + url); 55 //默认使用dubbo序列化 56 url = url.addParameter(Constants.CODEC_KEY, DubboCodec.NAME); 57 ExchangeServer server; 58 try { 59 //创建信息交换接口实现类,默认为HeaderExchanger类实例, 60 server = Exchangers.bind(url, requestHandler); 61 } catch (RemotingException e) { 62 throw new RpcException("Fail to start server(url: " + url + ") " + e.getMessage(), e); 63 } 64 str = url.getParameter(Constants.CLIENT_KEY); 65 if (str != null && str.length() > 0) { 66 Set<String> supportedTypes = ExtensionLoader.getExtensionLoader(Transporter.class).getSupportedExtensions(); 67 if (!supportedTypes.contains(str)) { 68 throw new RpcException("Unsupported client type: " + str); 69 } 70 } 71 return server; 72 } 73 74 private void optimizeSerialization(URL url) throws RpcException { 75 //得到序列化优化参数,通常为kryo或fst,将序列化实现设置为制定类实例 76 String className = url.getParameter(Constants.OPTIMIZER_KEY, ""); 77 if (StringUtils.isEmpty(className) || optimizers.contains(className)) { 78 return; 79 } 80 81 logger.info("Optimizing the serialization process for Kryo, FST, etc..."); 82 83 try { 84 Class clazz = Thread.currentThread().getContextClassLoader().loadClass(className); 85 if (!SerializationOptimizer.class.isAssignableFrom(clazz)) { 86 throw new RpcException("The serialization optimizer " + className + " isn't an instance of " + SerializationOptimizer.class.getName()); 87 } 88 89 SerializationOptimizer optimizer = (SerializationOptimizer) clazz.newInstance(); 90 91 if (optimizer.getSerializableClasses() == null) { 92 return; 93 } 94 95 for (Class c : optimizer.getSerializableClasses()) { 96 SerializableClassRegistry.registerClass(c); 97 } 98 99 optimizers.add(className); 100 } catch (ClassNotFoundException e) { 101 throw new RpcException("Cannot find the serialization optimizer class: " + className, e); 102 } catch (InstantiationException e) { 103 throw new RpcException("Cannot instantiate the serialization optimizer class: " + className, e); 104 } catch (IllegalAccessException e) { 105 throw new RpcException("Cannot instantiate the serialization optimizer class: " + className, e); 106 } 107 }
(3)加载指定的序列化类
调用optimizeSerialization(URL url)方法,将指定的序列化类加载到缓存,通常配置kryo, fst序列化,不配置,默认用hessian2序列化。
2、实现refer()方法,此方法实现了服务消费者指向一个远程地址的代理接口(invoker,可能是一个伪装的集群或本地调用),返回Invoker对象,用于服务调用。
实现逻辑为:
(1)加载指定的序列化类
调用optimizeSerialization(URL url)方法,将指定的序列化类加载到缓存,通常配置kryo, fst序列化,不配置,默认用hessian2序列化。
(2)创建DubboInvoker对象,加入invokers内存缓存,返回dubboInvoker对象,结束。
1 public <T> Invoker<T> refer(Class<T> serviceType, URL url) throws RpcException { 2 optimizeSerialization(url); 3 // create rpc invoker. 4 DubboInvoker<T> invoker = new DubboInvoker<T>(serviceType, url, getClients(url), invokers); 5 invokers.add(invoker); 6 return invoker; 7 }
(3)下面我们来分析创建DubboInvoker对象的过程。
创建时调用如下语句:new DubboInvoker<T>(serviceType, url, getClients(url), invokers)。原始构造方法定义如下:
1 public DubboInvoker(Class<T> serviceType, URL url, ExchangeClient[] clients, Set<Invoker<?>> invokers) { 2 super(serviceType, url, new String[]{Constants.INTERFACE_KEY, Constants.GROUP_KEY, Constants.TOKEN_KEY, Constants.TIMEOUT_KEY}); 3 this.clients = clients; 4 // get version. 5 this.version = url.getParameter(Constants.VERSION_KEY, "0.0.0"); 6 this.invokers = invokers; 7 }
传入四个参数:
serviceType:要调用的服务接口;
url:根据消费端声明确定的调用url;
clients:用于底层远程通讯信息交换的客户端数组;
invokers:DubboProtocol创建的所有invoker集合,此时共享给DubboInvoker对象;
clients数组由DubboProtocol.refer()中使用getClients(url)得到,我们看看实现逻辑:
1 private ExchangeClient[] getClients(URL url) { 2 // 此变量用于判断是否是共享连接 3 boolean service_share_connect = false;
//得到url中的connections数量,默认为0,此设置的意义为限制客户端连接数量,具体含义见下面标注 4 int connections = url.getParameter(Constants.CONNECTIONS_KEY, 0); 5 // if not configured, connection is shared, otherwise, one connection for one service 6 if (connections == 0) { 7 service_share_connect = true; 8 connections = 1; 9 } 10 11 ExchangeClient[] clients = new ExchangeClient[connections]; 12 for (int i = 0; i < clients.length; i++) { 13 if (service_share_connect) { 14 clients[i] = getSharedClient(url); 15 } else { 16 clients[i] = initClient(url); 17 } 18 } 19 return clients; 20 }
连接控制,此服务如果调用非常频繁,可以启用连接池,指定最大长连接数。 客户端连接控制:限制客户端服务使用连接不能超过 10 个 <dubbo:reference interface="com.foo.BarService" connections="10" /> 或<dubbo:service interface="com.foo.BarService" connections="10" /> 服务端连接控制:限制服务器端接受的连接不能超过 10 个 <dubbo:provider protocol="dubbo" accepts="10" /> 或<dubbo:protocol name="dubbo" accepts="10" /> 如果是长连接,比如 Dubbo 协议,connections 表示该服务对每个提供者建立的长连接数,如果服务提供方和消费方都设置了,默认用覆盖策略,reference覆盖provider。
getSharedClient(url)是得到共享客户端的方法,代码如下:
1 /** 2 * Get shared connection 3 */ 4 private ExchangeClient getSharedClient(URL url) { 5 String key = url.getAddress(); 6 ReferenceCountExchangeClient client = referenceClientMap.get(key); 7 if (client != null) { 8 if (!client.isClosed()) { 9 client.incrementAndGetCount(); 10 return client; 11 } else { 12 referenceClientMap.remove(key); 13 } 14 } 15 synchronized (key.intern()) { 16 ExchangeClient exchangeClient = initClient(url); 17 client = new ReferenceCountExchangeClient(exchangeClient, ghostClientMap); 18 referenceClientMap.put(key, client); 19 ghostClientMap.remove(key); 20 return client; 21 } 22 }
initClient(url)是根据传入的url初始化连接客户端,代码如下:
1 /** 2 * Create new connection 3 */ 4 private ExchangeClient initClient(URL url) { 5 6 // client type setting.默认用netty 7 String str = url.getParameter(Constants.CLIENT_KEY, url.getParameter(Constants.SERVER_KEY, Constants.DEFAULT_REMOTING_CLIENT)); 8 9 String version = url.getParameter(Constants.DUBBO_VERSION_KEY); 10 boolean compatible = (version != null && version.startsWith("1.0.")); 11 url = url.addParameter(Constants.CODEC_KEY, DubboCodec.NAME); 12 // enable heartbeat by default 13 url = url.addParameterIfAbsent(Constants.HEARTBEAT_KEY, String.valueOf(Constants.DEFAULT_HEARTBEAT)); 14 15 // BIO is not allowed since it has severe performance issue. 16 if (str != null && str.length() > 0 && !ExtensionLoader.getExtensionLoader(Transporter.class).hasExtension(str)) { 17 throw new RpcException("Unsupported client type: " + str + "," + 18 " supported client type is " + StringUtils.join(ExtensionLoader.getExtensionLoader(Transporter.class).getSupportedExtensions(), " ")); 19 } 20 21 ExchangeClient client; 22 try { 23 // connection should be lazy,创建可延迟连接的客户端 24 if (url.getParameter(Constants.LAZY_CONNECT_KEY, false)) { 25 client = new LazyConnectExchangeClient(url, requestHandler); 26 } else { 27 client = Exchangers.connect(url, requestHandler); 28 } 29 } catch (RemotingException e) { 30 throw new RpcException("Fail to create remoting client for service(" + url + "): " + e.getMessage(), e); 31 } 32 return client; 33 }
3、 下面我们分析DubboProtocol对ExchangeHandler接口的实现逻辑,就是建立连接用到的requestHandler对象,它是对request处理的接口对象。以下代码把实现代码隐藏了。
1 private ExchangeHandler requestHandler = new ExchangeHandlerAdapter() { 2 //核心方法,对request传来的message(即Invocation)的回复,即调用相应invoker的invoke(invocation)方法,返回调用结果 3 public Object reply(ExchangeChannel channel, Object message) throws RemotingException {} 32 //接受请求,如果message是一个Invocation,则调用reply()不返回结果,否则调用父类received(),其实什么也不干
34 public void received(Channel channel, Object message) throws RemotingException {} 41 //调用onconnect设置的方法,即当连接成功时触发的方法
43 public void connected(Channel channel) throws RemotingException {} 46 //调用disconnect设置的方法,即当连接关闭时触发的方法
48 public void disconnected(Channel channel) throws RemotingException {} 54 //调用方法的实现,内部根据methodKey调用createInvocation()创建Invocation对象,调用received()方法 55 private void invoke(Channel channel, String methodKey) {} 65 //创建Invocation对象并返回,其中根据URL的属性和methedKey初始化Invocation对象 66 private Invocation createInvocation(Channel channel, URL url, String methodKey) {} 81 };
1 public Object reply(ExchangeChannel channel, Object message) throws RemotingException { 2 if (message instanceof Invocation) { 3 Invocation inv = (Invocation) message;
//从缓存中得到invoker对象 4 Invoker<?> invoker = getInvoker(channel, inv); 5 // 如果设置了回调服务方法,比较设置的回调方法在invoker对象中是否声明了该方法 6 if (Boolean.TRUE.toString().equals(inv.getAttachments().get(IS_CALLBACK_SERVICE_INVOKE))) { 7 String methodsStr = invoker.getUrl().getParameters().get("methods"); 8 boolean hasMethod = false; 9 if (methodsStr == null || methodsStr.indexOf(",") == -1) { 10 hasMethod = inv.getMethodName().equals(methodsStr); 11 } else { 12 String[] methods = methodsStr.split(","); 13 for (String method : methods) { 14 if (inv.getMethodName().equals(method)) { 15 hasMethod = true; 16 break; 17 } 18 } 19 } 20 if (!hasMethod) { 21 logger.warn(new IllegalStateException("The methodName " + inv.getMethodName() + " not found in callback service interface ,invoke will be ignored. please update the api interface. url is:" + invoker.getUrl()) + " ,invocation is :" + inv); 22 return null; 23 } 24 } 25 RpcContext.getContext().setRemoteAddress(channel.getRemoteAddress());
//调用invoke并返回结果 26 return invoker.invoke(inv); 27 } 28 throw new RemotingException(channel, "Unsupported request: " + message == null ? null : (message.getClass().getName() + ": " + message) + ", channel: consumer: " + channel.getRemoteAddress() + " --> provider: " + channel.getLocalAddress()); 29 }
代码实现中经常看见ExtensionLoader.getExtensionLoader(Protocol.class).getExtension(DubboProtocol.NAME)类似的语句,这是Dubbo默认的类动态加载实例化的方式SPI,替代了SpringBean管理机制,实现了IOC和AOP的功能。以后的章节会详细讨论。
最后,我们分析一下实际的方法调用实现,即DubboInvoker.doInvoke()
1 protected Result doInvoke(final Invocation invocation) throws Throwable { 2 RpcInvocation inv = (RpcInvocation) invocation; 3 final String methodName = RpcUtils.getMethodName(invocation); 4 inv.setAttachment(Constants.PATH_KEY, getUrl().getPath()); 5 inv.setAttachment(Constants.VERSION_KEY, version); 6 7 ExchangeClient currentClient; 8 if (clients.length == 1) { 9 currentClient = clients[0]; 10 } else { 11 currentClient = clients[index.getAndIncrement() % clients.length]; 12 } 13 try { 14 boolean isAsync = RpcUtils.isAsync(getUrl(), invocation); 15 boolean isOneway = RpcUtils.isOneway(getUrl(), invocation); 16 int timeout = getUrl().getMethodParameter(methodName, Constants.TIMEOUT_KEY, Constants.DEFAULT_TIMEOUT); 17 if (isOneway) { //不需要返回值,返回空的RpcResult对象 18 boolean isSent = getUrl().getMethodParameter(methodName, Constants.SENT_KEY, false); 19 currentClient.send(inv, isSent); 20 RpcContext.getContext().setFuture(null); 21 return new RpcResult(); 22 } else if (isAsync) { //异步调用,调用后可以用RpcContext.getFuture()异步获取返回结果 23 ResponseFuture future = currentClient.request(inv, timeout); 24 RpcContext.getContext().setFuture(new FutureAdapter<Object>(future)); 25 return new RpcResult(); 26 } else { //默认是同步调用,需要有返回结果,此时要清空Future 27 RpcContext.getContext().setFuture(null); 28 return (Result) currentClient.request(inv, timeout).get(); 29 } 30 } catch (TimeoutException e) { 31 throw new RpcException(RpcException.TIMEOUT_EXCEPTION, "Invoke remote method timeout. method: " + invocation.getMethodName() + ", provider: " + getUrl() + ", cause: " + e.getMessage(), e); 32 } catch (RemotingException e) { 33 throw new RpcException(RpcException.NETWORK_EXCEPTION, "Failed to invoke remote method: " + invocation.getMethodName() + ", provider: " + getUrl() + ", cause: " + e.getMessage(), e); 34 } 35 }
四、其他协议实现
1、HessianProtocol实现
以HTTP、HessianSkeleton为底层实现,实现了doExport()和doRefer()方法。
Hessian协议用于集成 Hessian 的服务,Hessian 底层采用 Http 通讯,采用 Servlet 暴露服务,Dubbo 缺省内嵌 Jetty 作为服务器实现。
Dubbo 的 Hessian 协议可以和原生 Hessian 服务互操作,即:
- 提供者用 Dubbo 的 Hessian 协议暴露服务,消费者直接用标准 Hessian 接口调用
- 或者提供方用标准 Hessian 暴露服务,消费方用 Dubbo 的 Hessian 协议调用。
特性
- 连接个数:多连接
- 连接方式:短连接
- 传输协议:HTTP
- 传输方式:同步传输
- 序列化:Hessian二进制序列化
- 适用范围:传入传出参数数据包较大,提供者比消费者个数多,提供者压力较大,可传文件。
- 适用场景:页面传输,文件传输,或与原生hessian服务互操作
约束
- 参数及返回值需实现
Serializable
接口 - 参数及返回值不能自定义实现
List
,Map
,Number
,Date
,Calendar
等接口,只能用 JDK 自带的实现,因为 hessian 会做特殊处理,自定义实现类中的属性值都会丢失。
配置
<dubbo:protocol name="hessian" port="8080" server="jetty" />
2、RmiProtocol实现
以spring的Rmi框架为底层实现,实现了doExport()和doRefer()方法。
RMI 协议采用 JDK 标准的 java.rmi.* 实现,采用阻塞式短连接和 JDK 标准序列化方式。
注意:如果正在使用 RMI 提供服务给外部访问 1,同时应用里依赖了老的 common-collections 包 2 的情况下,存在反序列化安全风险 3。
特性
连接个数:多连接
连接方式:短连接
传输协议:TCP
传输方式:同步传输
序列化:Java 标准二进制序列化
适用范围:传入传出参数数据包大小混合,消费者与提供者个数差不多,可传文件。
适用场景:常规远程服务方法调用,与原生RMI服务互操作
约束
参数及返回值需实现 Serializable 接口
dubbo 配置中的超时时间对 RMI 无效,需使用 java 启动参数设置:-Dsun.rmi.transport.tcp.responseTimeout=3000,参见下面的 RMI 配置
3、其他协议实现
还实现了http协议,webservice协议,rest协议,thrift协议等,协议说明详见dubbo用户手册