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.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_PORT
static String	NAME

Constructor Summary

Constructors

Constructor and Description
DubboProtocol()

Method Summary

Methods

Modifier and Type	Method and Description
void	destroy() Destroy protocol: 1.
<T> Exporter<T>	export(Invoker<T> invoker) Export service for remote invocation: 1.
int	getDefaultPort() Get default port when user doesn't config the port.
static DubboProtocol	getDubboProtocol()
Collection<Exporter<?>>	getExporters()
Collection<Invoker<?>>	getInvokers()
Collection<ExchangeServer>	getServers()
<T> Invoker<T>	refer(Class<T> serviceType, URL url) Refer a remote service: 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

DEFAULT_PORT

public static final int DEFAULT_PORT

See Also:

Constant Field Values

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

Get default port when user doesn't config the port.

Returns:

default port

export

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

Description copied from interface: Protocol

Export service for remote invocation:
1. Protocol should record request source address after receive a request: RpcContext.getContext().setRemoteAddress();
2. export() must be idempotent, that is, there's no difference between invoking once and invoking twice when export the same URL
3. Invoker instance is passed in by the framework, protocol needs not to care

Type Parameters:

T - Service type

Parameters:

invoker - Service invoker

Returns:

exporter reference for exported service, useful for unexport the service later

Throws:

RpcException - thrown when error occurs during export the service, for example: port is occupied

refer

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

Description copied from interface: Protocol

Refer a remote service:
1. When user calls `invoke()` method of `Invoker` object which's returned from `refer()` call, the protocol needs to correspondingly execute `invoke()` method of `Invoker` object
2. It's protocol's responsibility to implement `Invoker` which's returned from `refer()`. Generally speaking, protocol sends remote request in the `Invoker` implementation.
3. When there's check=false set in URL, the implementation must not throw exception but try to recover when connection fails.

Type Parameters:

T - Service type

Parameters:

serviceType - Service class

url - URL address for the remote service

Returns:

invoker service's local proxy

Throws:

RpcException - when there's any error while connecting to the service provider

destroy

public void destroy()

Description copied from interface: Protocol

Destroy protocol:
1. Cancel all services this protocol exports and refers
2. Release all occupied resources, for example: connection, port, etc.
3. Protocol can continue to export and refer new service even after it's destroyed.

Specified by:

destroy in interface Protocol

Overrides:

destroy in class AbstractProtocol