RPC调用上下文

通过上下文存放当前调用过程中所需的环境信息

特性说明

上下文中存放的是当前调用过程中所需的环境信息。所有配置信息都将转换为 URL 的参数,参见 schema 配置参考手册 中的对应URL参数一列。

RpcContext 是一个 ThreadLocal 的临时状态记录器,当接收到 RPC 请求,或发起 RPC 请求时,RpcContext 的状态都会变化。比如:A 调 B,B 再调 C,则 B 机器上,在 B 调 C 之前,RpcContext 记录的是 A 调 B 的信息,在 B 调 C 之后,RpcContext 记录的是 B 调 C 的信息。

使用场景

全局链路追踪和隐藏参数。

使用方式

服务消费方

  1. // 远程调用
  2. xxxService.xxx();
  3. // 本端是否为消费端,这里会返回true
  4. boolean isConsumerSide = RpcContext.getServiceContext().isConsumerSide();
  5. // 获取最后一次调用的提供方IP地址
  6. String serverIP = RpcContext.getServiceContext().getRemoteHost();
  7. // 获取当前服务配置信息,所有配置信息都将转换为URL的参数
  8. String application = RpcContext.getServiceContext().getUrl().getParameter("application");
  9. // 注意:每发起RPC调用,上下文状态会变化
  10. yyyService.yyy();

服务提供方

  1. public class XxxServiceImpl implements XxxService {
  2. public void xxx() {
  3. // 本端是否为提供端,这里会返回true
  4. boolean isProviderSide = RpcContext.getServiceContext().isProviderSide();
  5. // 获取调用方IP地址
  6. String clientIP = RpcContext.getServiceContext().getRemoteHost();
  7. // 获取当前服务配置信息,所有配置信息都将转换为URL的参数
  8. String application = RpcContext.getServiceContext().getUrl().getParameter("application");
  9. // 注意:每发起RPC调用,上下文状态会变化
  10. yyyService.yyy();
  11. // 此时本端变成消费端,这里会返回false
  12. boolean isProviderSide = RpcContext.getServiceContext().isProviderSide();
  13. }
  14. }

最后修改 December 16, 2022: Fix check (#1736) (97972c1)