com.alibaba.dubbo.rpc.protocol.dubbo
Class DubboProtocol

java.lang.Object
  com.alibaba.dubbo.rpc.protocol.AbstractProtocol
      com.alibaba.dubbo.rpc.protocol.dubbo.DubboProtocol

All Implemented Interfaces:

Protocol

public class DubboProtocol
extends AbstractProtocol

dubbo protocol support.

Author:

qian.lei, william.liangf, chao.liuc

Field Summary

static String	COMPATIBLE_CODEC_NAME
static int	DEFAULT_PORT
ReentrantLock	lock
static String	NAME

Constructor Summary

DubboProtocol()

Method Summary

void	destroy() 释放协议： 1.
<T> Exporter<T>	export(Invoker<T> invoker) 暴露远程服务： 1.
int	getDefaultPort() 获取缺省端口，当用户没有配置端口时使用。
static DubboProtocol	getDubboProtocol()
Collection<Exporter<?>>	getExporters()
Collection<Invoker<?>>	getInvokers()
Collection<ExchangeServer>	getServers()
<T> Invoker<T>	refer(Class<T> serviceType, URL url) 引用远程服务： 1.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

NAME

public static final String NAME

See Also:

Constant Field Values

COMPATIBLE_CODEC_NAME

public static final String COMPATIBLE_CODEC_NAME

See Also:

Constant Field Values

DEFAULT_PORT

public static final int DEFAULT_PORT

See Also:

Constant Field Values

lock

public final ReentrantLock lock

Constructor Detail

DubboProtocol

public DubboProtocol()

Method Detail

getDubboProtocol

public static DubboProtocol getDubboProtocol()

getServers

public Collection<ExchangeServer> getServers()

getExporters

public Collection<Exporter<?>> getExporters()

getInvokers

public Collection<Invoker<?>> getInvokers()

getDefaultPort

public int getDefaultPort()

Description copied from interface: Protocol

获取缺省端口，当用户没有配置端口时使用。

Returns:

缺省端口

export

public <T> Exporter<T> export(Invoker<T> invoker)
                   throws RpcException

Description copied from interface: Protocol

暴露远程服务：
1. 协议在接收请求时，应记录请求来源方地址信息：RpcContext.getContext().setRemoteAddress();
2. export()必须是幂等的，也就是暴露同一个URL的Invoker两次，和暴露一次没有区别。
3. export()传入的Invoker由框架实现并传入，协议不需要关心。

Type Parameters:

T - 服务的类型

Parameters:

invoker - 服务的执行体

Returns:

exporter 暴露服务的引用，用于取消暴露

Throws:

RpcException - 当暴露服务出错时抛出，比如端口已占用

refer

public <T> Invoker<T> refer(Class<T> serviceType,
                            URL url)
                 throws RpcException

Description copied from interface: Protocol

引用远程服务：
1. 当用户调用refer()所返回的Invoker对象的invoke()方法时，协议需相应执行同URL远端export()传入的Invoker对象的invoke()方法。
2. refer()返回的Invoker由协议实现，协议通常需要在此Invoker中发送远程请求。
3. 当url中有设置check=false时，连接失败不能抛出异常，并内部自动恢复。

Type Parameters:

T - 服务的类型

Parameters:

serviceType - 服务的类型

url - 远程服务的URL地址

Returns:

invoker 服务的本地代理

Throws:

RpcException - 当连接服务提供方失败时抛出

destroy

public void destroy()

Description copied from interface: Protocol

释放协议：
1. 取消该协议所有已经暴露和引用的服务。
2. 释放协议所占用的所有资源，比如连接和端口。
3. 协议在释放后，依然能暴露和引用新的服务。

Specified by:

destroy in interface Protocol

Overrides:

destroy in class AbstractProtocol