net.hasor.rsf.rpc.caller

类 RsfCaller

java.lang.Object

net.hasor.rsf.rpc.caller.RsfRequestManager

net.hasor.rsf.rpc.caller.RsfCaller

直接已知子类:

RemoteRsfCaller

public class RsfCaller
extends RsfRequestManager

通过包装RSF请求响应，提供（同步、异步、回调、接口代理）四种远程调用方式的实现。

版本:

: 2015年12月8日

作者:

赵永春 (zyc@hasor.net)

字段概要

从类继承的字段 net.hasor.rsf.rpc.caller.RsfRequestManager

invLogger, logger

构造器概要

构造器

构造器和说明
RsfCaller(RsfContext rsfContext, RsfBeanContainer rsfBeanContainer, SenderListener senderListener)

方法概要

限定符和类型	方法和说明
RsfFuture	asyncInvoke(AddressProvider target, RsfBindInfo<?> bindInfo, String methodName, Class<?>[] parameterTypes, Object[] parameterObjects) 异步方式调用远程服务。
void	callBackInvoke(AddressProvider target, RsfBindInfo<?> bindInfo, String methodName, Class<?>[] parameterTypes, Object[] parameterObjects, net.hasor.utils.future.FutureCallback<Object> listener) 回调方式调用远程服务，回调中返回的是结果。
void	callBackRequest(AddressProvider target, RsfBindInfo<?> bindInfo, String methodName, Class<?>[] parameterTypes, Object[] parameterObjects, net.hasor.utils.future.FutureCallback<RsfResponse> listener) 回调方式调用远程服务，回调中返回的是RsfResponse。
RsfBeanContainer	getContainer() 获取RsfBeanContainer。
<T> T	getRemote(AddressProvider target, RsfBindInfo<T> bindInfo) 根据服务注册的类型，将远程服务提供者包装成该类型表示的一个接口代理。
Object	getRemote(AddressProvider target, String group, String name, String version) 根据服务注册的类型，将远程服务提供者包装成该类型表示的一个接口代理。
Object	getRemoteByID(AddressProvider target, String serviceID) 根据服务注册的类型，将远程服务提供者包装成该类型表示的一个接口代理。
Object	syncInvoke(AddressProvider target, RsfBindInfo<?> bindInfo, String methodName, Class<?>[] parameterTypes, Object[] parameterObjects) 同步方式调用远程服务。
<T> T	wrapper(AddressProvider target, Class<T> interFace) 忽略服务元信息上对接口类型的定义，使用指定的接口类型包装远程服务提供者。
<T> T	wrapper(AddressProvider target, RsfBindInfo<?> bindInfo, Class<T> interFace)
<T> T	wrapper(AddressProvider target, String group, String name, String version, Class<T> interFace) 忽略服务元信息上对接口类型的定义，使用指定的接口类型包装远程服务提供者。
<T> T	wrapperByID(AddressProvider target, String serviceID, Class<T> interFace) 忽略服务元信息上对接口类型的定义，使用指定的接口类型包装远程服务提供者。

从类继承的方法 net.hasor.rsf.rpc.caller.RsfRequestManager

doSendRequest, getContext, getRequest, putResponse, putResponse

从类继承的方法 java.lang.Object

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

构造器详细资料

RsfCaller

public RsfCaller(RsfContext rsfContext,
                 RsfBeanContainer rsfBeanContainer,
                 SenderListener senderListener)

方法详细资料

getContainer

public RsfBeanContainer getContainer()

从类复制的说明: RsfRequestManager

获取RsfBeanContainer。

指定者:

getContainer 在类中 RsfRequestManager

getRemoteByID

public Object getRemoteByID(AddressProvider target,
                            String serviceID)
                     throws RsfException

根据服务注册的类型，将远程服务提供者包装成该类型表示的一个接口代理。
所有接口方法调用都映射为一个RPC请求响应。

参数:

target - 目标RSF服务提供者地址。

serviceID - 服务ID

抛出:

RsfException

另请参阅:

RsfBindInfo.getBindType()

getRemote

public Object getRemote(AddressProvider target,
                        String group,
                        String name,
                        String version)
                 throws RsfException

根据服务注册的类型，将远程服务提供者包装成该类型表示的一个接口代理。
所有接口方法调用都映射为一个RPC请求响应。

参数:

target - 目标RSF服务提供者地址。

group - 服务分组

name - 服务名

version - 服务版本。

抛出:

RsfException

另请参阅:

RsfBindInfo.getBindType()

getRemote

public <T> T getRemote(AddressProvider target,
                       RsfBindInfo<T> bindInfo)
                throws RsfException

根据服务注册的类型，将远程服务提供者包装成该类型表示的一个接口代理。
所有接口方法调用都映射为一个RPC请求响应。

参数:

target - 目标RSF服务提供者地址。

bindInfo - 服务元信息。

抛出:

RsfException

另请参阅:

RsfBindInfo.getBindType()

wrapperByID

public <T> T wrapperByID(AddressProvider target,
                         String serviceID,
                         Class<T> interFace)
                  throws RsfException

忽略服务元信息上对接口类型的定义，使用指定的接口类型包装远程服务提供者。
请注意：当出现调用远程不存在的方法时会引发异常。虽然如此，但是该方法仍然有着自己的魅力。

参数:

target - 目标RSF服务提供者地址。

serviceID - 服务ID

interFace - 要包装成为的那个接口。

抛出:

RsfException

另请参阅:

RsfBindInfo.getBindType()

wrapper

public <T> T wrapper(AddressProvider target,
                     Class<T> interFace)
              throws RsfException

忽略服务元信息上对接口类型的定义，使用指定的接口类型包装远程服务提供者。
请注意：当出现调用远程不存在的方法时会引发异常。虽然如此，但是该方法仍然有着自己的魅力。

参数:

target - 目标RSF服务提供者地址。

interFace - 要包装成为的那个接口，需要配合@RsfService注解一起使用。

抛出:

RsfException

另请参阅:

RsfBindInfo.getBindType()

wrapper

public <T> T wrapper(AddressProvider target,
                     String group,
                     String name,
                     String version,
                     Class<T> interFace)
              throws RsfException

忽略服务元信息上对接口类型的定义，使用指定的接口类型包装远程服务提供者。
请注意：当出现调用远程不存在的方法时会引发异常。虽然如此，但是该方法仍然有着自己的魅力。

参数:

target - 目标RSF服务提供者地址。

group - 服务分组

name - 服务名称

version - 服务版本

interFace - 要包装成为的那个接口。

抛出:

RsfException

另请参阅:

RsfBindInfo.getBindType()

wrapper

public <T> T wrapper(AddressProvider target,
                     RsfBindInfo<?> bindInfo,
                     Class<T> interFace)
              throws RsfException

抛出:

RsfException

syncInvoke

public Object syncInvoke(AddressProvider target,
                         RsfBindInfo<?> bindInfo,
                         String methodName,
                         Class<?>[] parameterTypes,
                         Object[] parameterObjects)
                  throws InterruptedException,
                         ExecutionException,
                         TimeoutException

同步方式调用远程服务。

参数:

target - 目标RSF服务提供者地址。

bindInfo - 服务元信息。

methodName - 远程服务方法名

parameterTypes - 远程方法参数列表。

parameterObjects - 参数值

抛出:

TimeoutException

ExecutionException

InterruptedException

asyncInvoke

public RsfFuture asyncInvoke(AddressProvider target,
                             RsfBindInfo<?> bindInfo,
                             String methodName,
                             Class<?>[] parameterTypes,
                             Object[] parameterObjects)

异步方式调用远程服务。

参数:

target - 目标RSF服务提供者地址。

bindInfo - 服务元信息。

methodName - 远程服务方法名

parameterTypes - 远程方法参数列表。

parameterObjects - 参数值

callBackInvoke

public void callBackInvoke(AddressProvider target,
                           RsfBindInfo<?> bindInfo,
                           String methodName,
                           Class<?>[] parameterTypes,
                           Object[] parameterObjects,
                           net.hasor.utils.future.FutureCallback<Object> listener)

回调方式调用远程服务，回调中返回的是结果。

参数:

target - 目标RSF服务提供者地址。

bindInfo - 服务元信息。

methodName - 远程服务方法名

parameterTypes - 远程方法参数列表。

parameterObjects - 参数值

listener - 回调接口。

callBackRequest

public void callBackRequest(AddressProvider target,
                            RsfBindInfo<?> bindInfo,
                            String methodName,
                            Class<?>[] parameterTypes,
                            Object[] parameterObjects,
                            net.hasor.utils.future.FutureCallback<RsfResponse> listener)

回调方式调用远程服务，回调中返回的是RsfResponse。

参数:

target - 目标RSF服务提供者地址。

bindInfo - 服务元信息。

methodName - 远程服务方法名

parameterTypes - 远程方法参数列表。

parameterObjects - 参数值

listener - 回调接口。