Transporter Extension
Summary
Transportation extension for communication between server and client.
Extension Interface
org.apache.dubbo.remoting.Transporter
org.apache.dubbo.remoting.Server
org.apache.dubbo.remoting.Client
Extension Configuration
<!-- server and client use the same transporter -->
<dubbo:protocol transporter="xxx" />
<!-- server and client use the different transporter -->
<dubbo:protocol server="xxx" client="xxx" />
<!-- default configuration, will take effect when transport/server/client attribute is not set in <dubbo:protocol> -->
<dubbo:provider transporter="xxx" server="xxx" client="xxx" />
Existing Extension
org.apache.dubbo.remoting.transport.transporter.netty.NettyTransporter
org.apache.dubbo.remoting.transport.transporter.mina.MinaTransporter
org.apache.dubbo.remoting.transport.transporter.grizzly.GrizzlyTransporter
Extension Guide
Directory layout:
src
|-main
|-java
|-com
|-xxx
|-XxxTransporter.java (Transporter implementation)
|-XxxServer.java (Server implementation)
|-XxxClient.java (Client implementation)
|-resources
|-META-INF
|-dubbo
|-org.apache.dubbo.remoting.Transporter (plain text file with the content: xxx=com.xxx.XxxTransporter)
XxxTransporter.java:
package com.xxx;
import org.apache.dubbo.remoting.Transporter;
public class XxxTransporter implements Transporter {
public Server bind(URL url, ChannelHandler handler) throws RemotingException {
return new XxxServer(url, handler);
}
public Client connect(URL url, ChannelHandler handler) throws RemotingException {
return new XxxClient(url, handler);
}
}
XxxServer.java:
package com.xxx;
import org.apache.dubbo.remoting.transport.transporter.AbstractServer;
public class XxxServer extends AbstractServer {
public XxxServer(URL url, ChannelHandler handler) throws RemotingException{
super(url, handler);
}
protected void doOpen() throws Throwable {
// ...
}
protected void doClose() throws Throwable {
// ...
}
public Collection<Channel> getChannels() {
// ...
}
public Channel getChannel(InetSocketAddress remoteAddress) {
// ...
}
}
XxxClient.java:
package com.xxx;
import org.apache.dubbo.remoting.transport.transporter.AbstractClient;
public class XxxClient extends AbstractClient {
public XxxServer(URL url, ChannelHandler handler) throws RemotingException{
super(url, handler);
}
protected void doOpen() throws Throwable {
// ...
}
protected void doClose() throws Throwable {
// ...
}
protected void doConnect() throws Throwable {
// ...
}
public Channel getChannel() {
// ...
}
}
META-INF/dubbo/org.apache.dubbo.remoting.Transporter:
xxx=com.xxx.XxxTransporter
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.
Last modified January 22, 2021: Merge branch 'master' of https://github.com/apache/dubbo-website (f48eac9)