com.alibaba.dubbo.rpc.protocol

Class AbstractProxyProtocol

java.lang.Object

com.alibaba.dubbo.rpc.protocol.AbstractProtocol

com.alibaba.dubbo.rpc.protocol.AbstractProxyProtocol

All Implemented Interfaces:

Protocol

Direct Known Subclasses:

HessianProtocol, HttpProtocol, RestProtocol, RmiProtocol, WebServiceProtocol

public abstract class AbstractProxyProtocol
extends AbstractProtocol

AbstractProxyProtocol

Constructor Summary

Constructors

Constructor and Description
AbstractProxyProtocol()
AbstractProxyProtocol(Class<?>... exceptions)

Method Summary

Modifier and Type	Method and Description
void	addRpcException(Class<?> exception)
<T> Exporter<T>	export(Invoker<T> invoker) Export service for remote invocation: 1.
ProxyFactory	getProxyFactory()
<T> Invoker<T>	refer(Class<T> type, URL url) Refer a remote service: 1.
void	setProxyFactory(ProxyFactory proxyFactory)

Methods inherited from class com.alibaba.dubbo.rpc.protocol.AbstractProtocol

destroy

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.alibaba.dubbo.rpc.Protocol

getDefaultPort

Constructor Detail

AbstractProxyProtocol

public AbstractProxyProtocol()

AbstractProxyProtocol

public AbstractProxyProtocol(Class<?>... exceptions)

Method Detail

addRpcException

public void addRpcException(Class<?> exception)

getProxyFactory

public ProxyFactory getProxyFactory()

setProxyFactory

public void setProxyFactory(ProxyFactory proxyFactory)

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> type,
                            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:

type - 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