com.alibaba.dubbo.rpc

Interface Protocol

All Superinterfaces:

Protocol

Deprecated.

@Deprecated
public interface Protocol
extends Protocol

Method Summary

Modifier and Type	Method and Description
<T> Exporter<T>	export(Invoker<T> invoker) Deprecated.
default <T> Exporter<T>	export(Invoker<T> invoker) Deprecated. Export service for remote invocation: 1.
default List<ProtocolServer>	getServers() Deprecated. Get all servers serving this protocol
<T> Invoker<T>	refer(Class<T> aClass, URL url) Deprecated.
default <T> Invoker<T>	refer(Class<T> aClass, URL url) Deprecated. Refer a remote service: 1.

Methods inherited from interface org.apache.dubbo.rpc.Protocol

destroy, getDefaultPort

Method Detail

export

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

Deprecated.

Throws:

RpcException

refer

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

Deprecated.

Throws:

RpcException

export

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

Deprecated.

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

Specified by:

export in interface Protocol

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

RpcException

refer

default <T> Invoker<T> refer(Class<T> aClass,
                             URL url)
                      throws RpcException

Deprecated.

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.

Specified by:

refer in interface Protocol

Type Parameters:

T - Service type

Parameters:

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

RpcException

getServers

default List<ProtocolServer> getServers()

Deprecated.

Description copied from interface: Protocol

Get all servers serving this protocol

Specified by:

getServers in interface Protocol

Returns: