网络传输扩展

网络传输扩展

扩展说明

远程通讯的服务器及客户端传输实现。

扩展接口

  • org.apache.dubbo.remoting.Transporter
  • org.apache.dubbo.remoting.Server
  • org.apache.dubbo.remoting.Client

扩展配置

  1. <!-- 服务器和客户端使用相同的传输实现 -->
  2. <dubbo:protocol transporter="xxx" /> 
  3. <!-- 服务器和客户端使用不同的传输实现 -->
  4. <dubbo:protocol server="xxx" client="xxx" /> 
  5. <!-- 缺省值设置，当<dubbo:protocol>没有配置transporter/server/client属性时，使用此配置 -->
  6. <dubbo:provider transporter="xxx" server="xxx" client="xxx" />

已知扩展

  • org.apache.dubbo.remoting.transport.transporter.netty.NettyTransporter
  • org.apache.dubbo.remoting.transport.transporter.mina.MinaTransporter
  • org.apache.dubbo.remoting.transport.transporter.grizzly.GrizzlyTransporter

扩展示例

Maven 项目结构：

  1. src
  2.  |-main
  3.     |-java
  4.         |-com
  5.             |-xxx
  6.                 |-XxxTransporter.java (实现Transporter接口)
  7.                 |-XxxServer.java (实现Server接口)
  8.                 |-XxxClient.java (实现Client接口)
  9.     |-resources
  10.         |-META-INF
  11.             |-dubbo
  12.                 |-org.apache.dubbo.remoting.Transporter (纯文本文件，内容为：xxx=com.xxx.XxxTransporter)

XxxTransporter.java：

  1. package com.xxx;
  3. import org.apache.dubbo.remoting.Transporter;
  5. public class XxxTransporter implements Transporter {
  6.     public Server bind(URL url, ChannelHandler handler) throws RemotingException {
  7.         return new XxxServer(url, handler);
  8.     }
  9.     public Client connect(URL url, ChannelHandler handler) throws RemotingException {
  10.         return new XxxClient(url, handler);
  11.     }
  12. }

XxxServer.java：

  1. package com.xxx;
  3. import org.apache.dubbo.remoting.transport.transporter.AbstractServer;
  5. public class XxxServer extends AbstractServer {
  6.     public XxxServer(URL url, ChannelHandler handler) throws RemotingException{
  7.         super(url, handler);
  8.     }
  9.     protected void doOpen() throws Throwable {
  10.         // ...
  11.     }
  12.     protected void doClose() throws Throwable {
  13.         // ...
  14.     }
  15.     public Collection<Channel> getChannels() {
  16.         // ...
  17.     }
  18.     public Channel getChannel(InetSocketAddress remoteAddress) {
  19.         // ...
  20.     }
  21. }

XxxClient.java：

  1. package com.xxx;
  3. import org.apache.dubbo.remoting.transport.transporter.AbstractClient;
  5. public class XxxClient extends AbstractClient {
  6.     public XxxServer(URL url, ChannelHandler handler) throws RemotingException{
  7.         super(url, handler);
  8.     }
  9.     protected void doOpen() throws Throwable {
  10.         // ...
  11.     }
  12.     protected void doClose() throws Throwable {
  13.         // ...
  14.     }
  15.     protected void doConnect() throws Throwable {
  16.         // ...
  17.     }
  18.     public Channel getChannel() {
  19.         // ...
  20.     }
  21. }

META-INF/dubbo/org.apache.dubbo.remoting.Transporter：

  1. xxx=com.xxx.XxxTransporter

最后修改 March 2, 2023: Fix alias forward in docs3-v2 (#2342) (f16c1535592)