上下文信息
上下文中存放的是当前调用过程中所需的环境信息。首先RpcContext是线程级的,每个线程一份。
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.getContext().isConsumerSide();
5 // 获取最后一次调用的提供方IP地址
6 String serverIP = RpcContext.getContext().getRemoteHost();
7 // 获取当前服务配置信息,所有配置信息都将转换为URL的参数
8 String application = RpcContext.getContext().getUrl().getParameter("application");
9 // 注意:每发起RPC调用,上下文状态会变化
10 yyyService.yyy();
服务提供方
1 public class XxxServiceImpl implements XxxService {
2
3 public void xxx() {
4 // 本端是否为提供端,这里会返回true
5 boolean isProviderSide = RpcContext.getContext().isProviderSide();
6 // 获取调用方IP地址
7 String clientIP = RpcContext.getContext().getRemoteHost();
8 // 获取当前服务配置信息,所有配置信息都将转换为URL的参数
9 String application = RpcContext.getContext().getUrl().getParameter("application");
10 // 注意:每发起RPC调用,上下文状态会变化
11 yyyService.yyy();
12 // 此时本端变成消费端,这里会返回false
13 boolean isProviderSide = RpcContext.getContext().isProviderSide();
14 }
15 }
隐式参数传递
可以通过 RpcContext
上的 setAttachment
和 getAttachment
在服务消费方和提供方之间进行参数的隐式传递。
在服务消费方端设置隐式参数
setAttachment
设置的 KV 对,在完成下面一次远程调用会被清空,即多次远程调用要多次设置。
RpcContext.getContext().setAttachment("index", "1"); // 隐式传参,后面的远程调用都会隐式将这些参数发送到服务器端,类似cookie,用于框架集成,不建议常规业务使用
xxxService.xxx(); // 远程调用
// ...
在服务提供方端获取隐式参数
public class XxxServiceImpl implements XxxService {
public void xxx() {
// 获取客户端隐式传入的参数,用于框架集成,不建议常规业务使用
String index = RpcContext.getContext().getAttachment("index");
}
}
总结:可以通过dubbo上下游调用获取上下文参数信息,一般可以结合过滤器等一起使用,传递用户id、租户id、cookie等信息。