org.apache.dubbo.rpc

类 RpcContext

java.lang.Object

org.apache.dubbo.rpc.RpcContext

public class RpcContext
extends Object

Thread local context. (API, ThreadLocal, ThreadSafe)

Note: RpcContext is a temporary state holder. States in RpcContext changes every time when request is sent or received. For example: A invokes B, then B invokes C. On service B, RpcContext saves invocation info from A to B before B starts invoking C, and saves invocation info from B to C after B invokes C.

另请参阅:

ContextFilter

方法概要

限定符和类型	方法和说明
<T> CompletableFuture<T>	asyncCall(Callable<T> callable) Async invocation.
void	asyncCall(Runnable runnable) one way async call, send request only, and result is not required
boolean	canRemove()
void	clearAfterEachInvoke(boolean remove)
void	clearAttachments()
Map<String,Object>	get() get values.
Object	get(String key) get value.
Object[]	getArguments() get arguments.
AsyncContext	getAsyncContext()
String	getAttachment(String key) also see getObjectAttachment(String).
Map<String,String>	getAttachments() 已过时。
<T> CompletableFuture<T>	getCompletableFuture() get CompletableFuture.
URL	getConsumerUrl()
static RpcContext	getContext() get context.
<T> Future<T>	getFuture() get future.
String	getGroup()
String	getInterfaceName()
Invocation	getInvocation() 已过时。 Replace to getMethodName(), getParameterTypes(), getArguments()
Invoker<?>	getInvoker() 已过时。 Replace to getUrl()
List<Invoker<?>>	getInvokers() 已过时。 Replace to getUrls()
InetSocketAddress	getLocalAddress() get local address.
String	getLocalAddressString()
String	getLocalHost() get local host.
String	getLocalHostName() get local host name.
int	getLocalPort() get local port.
String	getMethodName() get method name.
Object	getObjectAttachment(String key) get attachment.
Map<String,Object>	getObjectAttachments() get attachments.
Class<?>[]	getParameterTypes() get parameter types.
String	getProtocol()
String	getProtocolServiceKey()
InetSocketAddress	getRemoteAddress() get remote address.
String	getRemoteAddressString() get remote address string.
String	getRemoteApplicationName()
String	getRemoteHost() get remote host.
String	getRemoteHostName() get remote host name.
int	getRemotePort() get remote port.
Object	getRequest() Get the request object of the underlying RPC protocol, e.g.
<T> T	getRequest(Class<T> clazz) Get the request object of the underlying RPC protocol, e.g.
Object	getResponse() Get the response object of the underlying RPC protocol, e.g.
<T> T	getResponse(Class<T> clazz) Get the response object of the underlying RPC protocol, e.g.
static RpcContext	getServerContext() get server side context.
String	getServiceKey()
URL	getUrl()
List<URL>	getUrls()
String	getVersion()
boolean	isAsyncStarted()
boolean	isClientSide() 已过时。 Replace to isConsumerSide()
boolean	isConsumerSide() is consumer side.
boolean	isProviderSide() is provider side.
boolean	isServerSide() 已过时。 Replace to isProviderSide()
RpcContext	remove(String key) remove value.
RpcContext	removeAttachment(String key) remove attachment.
static void	removeContext() remove context.
static void	removeContext(boolean checkCanRemove) customized for internal use.
static void	removeServerContext() remove server side context.
static void	restoreContext(RpcContext oldContext)
static void	restoreServerContext(RpcContext oldServerContext)
RpcContext	set(String key, Object value) set value.
void	setArguments(Object[] arguments)
RpcContext	setAttachment(String key, Object value)
RpcContext	setAttachment(String key, String value) set attachment.
RpcContext	setAttachments(Map<String,String> attachment) set attachments
void	setConsumerUrl(URL consumerUrl)
void	setFuture(CompletableFuture<?> future) set future.
RpcContext	setInvocation(Invocation invocation)
RpcContext	setInvoker(Invoker<?> invoker)
RpcContext	setInvokers(List<Invoker<?>> invokers)
RpcContext	setLocalAddress(InetSocketAddress address) set local address.
RpcContext	setLocalAddress(String host, int port) set local address.
void	setMethodName(String methodName)
RpcContext	setObjectAttachment(String key, Object value)
RpcContext	setObjectAttachments(Map<String,Object> attachment) set attachments
void	setParameterTypes(Class<?>[] parameterTypes)
RpcContext	setRemoteAddress(InetSocketAddress address) set remote address.
RpcContext	setRemoteAddress(String host, int port) set remote address.
RpcContext	setRemoteApplicationName(String remoteApplicationName)
void	setRequest(Object request)
void	setResponse(Object response)
static void	setRpcContext(URL url)
void	setUrl(URL url)
void	setUrls(List<URL> urls)
static AsyncContext	startAsync()
boolean	stopAsync()

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

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

方法详细资料

getServerContext

public static RpcContext getServerContext()

get server side context.

返回:

server context

restoreServerContext

public static void restoreServerContext(RpcContext oldServerContext)

removeServerContext

public static void removeServerContext()

remove server side context.

另请参阅:

ContextFilter

getContext

public static RpcContext getContext()

get context.

返回:

context

canRemove

public boolean canRemove()

clearAfterEachInvoke

public void clearAfterEachInvoke(boolean remove)

restoreContext

public static void restoreContext(RpcContext oldContext)

removeContext

public static void removeContext()

remove context.

另请参阅:

ContextFilter

removeContext

public static void removeContext(boolean checkCanRemove)

customized for internal use.

参数:

checkCanRemove - if need check before remove

getRequest

public Object getRequest()

Get the request object of the underlying RPC protocol, e.g. HttpServletRequest

返回:

null if the underlying protocol doesn't provide support for getting request

setRequest

public void setRequest(Object request)

getRequest

public <T> T getRequest(Class<T> clazz)

Get the request object of the underlying RPC protocol, e.g. HttpServletRequest

返回:

null if the underlying protocol doesn't provide support for getting request or the request is not of the specified type

getResponse

public Object getResponse()

Get the response object of the underlying RPC protocol, e.g. HttpServletResponse

返回:

null if the underlying protocol doesn't provide support for getting response

setResponse

public void setResponse(Object response)

getResponse

public <T> T getResponse(Class<T> clazz)

Get the response object of the underlying RPC protocol, e.g. HttpServletResponse

返回:

null if the underlying protocol doesn't provide support for getting response or the response is not of the specified type

isProviderSide

public boolean isProviderSide()

is provider side.

返回:

provider side.

isConsumerSide

public boolean isConsumerSide()

is consumer side.

返回:

consumer side.

getCompletableFuture

public <T> CompletableFuture<T> getCompletableFuture()

get CompletableFuture.

类型参数:

T -

返回:

future

getFuture

public <T> Future<T> getFuture()

get future.

类型参数:

T -

返回:

future

setFuture

public void setFuture(CompletableFuture<?> future)

set future.

参数:

future -

getUrls

public List<URL> getUrls()

setUrls

public void setUrls(List<URL> urls)

getUrl

public URL getUrl()

setUrl

public void setUrl(URL url)

getMethodName

public String getMethodName()

get method name.

返回:

method name.

setMethodName

public void setMethodName(String methodName)

getParameterTypes

public Class<?>[] getParameterTypes()

get parameter types.

setParameterTypes

public void setParameterTypes(Class<?>[] parameterTypes)

getArguments

public Object[] getArguments()

get arguments.

返回:

arguments.

setArguments

public void setArguments(Object[] arguments)

setLocalAddress

public RpcContext setLocalAddress(String host,
                                  int port)

set local address.

参数:

host -

port -

返回:

context

getLocalAddress

public InetSocketAddress getLocalAddress()

get local address.

返回:

local address

setLocalAddress

public RpcContext setLocalAddress(InetSocketAddress address)

set local address.

参数:

address -

返回:

context

getLocalAddressString

public String getLocalAddressString()

getLocalHostName

public String getLocalHostName()

get local host name.

返回:

local host name

setRemoteAddress

public RpcContext setRemoteAddress(String host,
                                   int port)

set remote address.

参数:

host -

port -

返回:

context

getRemoteAddress

public InetSocketAddress getRemoteAddress()

get remote address.

返回:

remote address

setRemoteAddress

public RpcContext setRemoteAddress(InetSocketAddress address)

set remote address.

参数:

address -

返回:

context

getRemoteApplicationName

public String getRemoteApplicationName()

setRemoteApplicationName

public RpcContext setRemoteApplicationName(String remoteApplicationName)

getRemoteAddressString

public String getRemoteAddressString()

get remote address string.

返回:

remote address string.

getRemoteHostName

public String getRemoteHostName()

get remote host name.

返回:

remote host name

getLocalHost

public String getLocalHost()

get local host.

返回:

local host

getLocalPort

public int getLocalPort()

get local port.

返回:

port

getRemoteHost

public String getRemoteHost()

get remote host.

返回:

remote host

getRemotePort

public int getRemotePort()

get remote port.

返回:

remote port

getAttachment

public String getAttachment(String key)

also see getObjectAttachment(String).

参数:

key -

返回:

attachment

getObjectAttachment

public Object getObjectAttachment(String key)

get attachment.

参数:

key -

返回:

attachment

setAttachment

public RpcContext setAttachment(String key,
                                String value)

set attachment.

参数:

key -

value -

返回:

context

setAttachment

public RpcContext setAttachment(String key,
                                Object value)

setObjectAttachment

public RpcContext setObjectAttachment(String key,
                                      Object value)

removeAttachment

public RpcContext removeAttachment(String key)

remove attachment.

参数:

key -

返回:

context

getAttachments

@Deprecated
public Map<String,String> getAttachments()

已过时。

get String type attachments. Best to use {getObjectAttachments()}

返回:

attachments

getObjectAttachments

public Map<String,Object> getObjectAttachments()

get attachments.

返回:

attachments

setAttachments

public RpcContext setAttachments(Map<String,String> attachment)

set attachments

参数:

attachment -

返回:

context

setObjectAttachments

public RpcContext setObjectAttachments(Map<String,Object> attachment)

set attachments

参数:

attachment -

返回:

context

clearAttachments

public void clearAttachments()

get

public Map<String,Object> get()

get values.

返回:

values

set

public RpcContext set(String key,
                      Object value)

set value.

参数:

key -

value -

返回:

context

remove

public RpcContext remove(String key)

remove value.

参数:

key -

返回:

value

get

public Object get(String key)

get value.

参数:

key -

返回:

value

isServerSide

@Deprecated
public boolean isServerSide()

已过时。 Replace to isProviderSide()

isClientSide

@Deprecated
public boolean isClientSide()

已过时。 Replace to isConsumerSide()

getInvokers

@Deprecated
public List<Invoker<?>> getInvokers()

已过时。 Replace to getUrls()

setInvokers

public RpcContext setInvokers(List<Invoker<?>> invokers)

getInvoker

@Deprecated
public Invoker<?> getInvoker()

已过时。 Replace to getUrl()

setInvoker

public RpcContext setInvoker(Invoker<?> invoker)

getInvocation

@Deprecated
public Invocation getInvocation()

已过时。 Replace to getMethodName(), getParameterTypes(), getArguments()

setInvocation

public RpcContext setInvocation(Invocation invocation)

asyncCall

public <T> CompletableFuture<T> asyncCall(Callable<T> callable)

Async invocation. Timeout will be handled even if Future.get() is not called.

参数:

callable -

返回:

get the return result from future.get()

asyncCall

public void asyncCall(Runnable runnable)

one way async call, send request only, and result is not required

参数:

runnable -

startAsync

public static AsyncContext startAsync()
                               throws IllegalStateException

返回:

抛出:

IllegalStateException

isAsyncStarted

public boolean isAsyncStarted()

stopAsync

public boolean stopAsync()

getAsyncContext

public AsyncContext getAsyncContext()

getGroup

public String getGroup()

getVersion

public String getVersion()

getInterfaceName

public String getInterfaceName()

getProtocol

public String getProtocol()

getServiceKey

public String getServiceKey()

getProtocolServiceKey

public String getProtocolServiceKey()

getConsumerUrl

public URL getConsumerUrl()

setConsumerUrl

public void setConsumerUrl(URL consumerUrl)

setRpcContext

public static void setRpcContext(URL url)