Protocol
- Exporter export(Invoker invoker) throws RpcException;
暴露远程服务:
- 协议在接收请求时,应记录请求来源方地址信息:RpcContext.getContext().setRemoteAddress();
- export()必须是幂等的,也就是暴露同一个URL的Invoker两次,和暴露一次没有区别。
- export()传入的Invoker由框架实现并传入,协议不需要关心。
Invoker refer(Class type, URL url) throws RpcException;
引用远程服务:- 当用户调用refer()所返回的Invoker对象的invoke()方法时,协议需相应执行同URL远端export()传入的Invoker对象的invoke()方法。
- refer()返回的Invoker由协议实现,协议通常需要在此Invoker中发送远程请求。
- 当url中有设置check=false时,连接失败不能抛出异常,并内部自动恢复。
void destroy();
释放协议:- 取消该协议所有已经暴露和引用的服务。
- 释放协议所占用的所有资源,比如连接和端口。
Invoker
- Class getInterface(); get service interface.
- Result invoke(Invocation invocation) throws RpcException;
- extends Node method:
- URL getUrl();
- boolean isAvailable();
- void destroy();
Invocation
String getMethodName();
Class<?>[] getParameterTypes();
Object[] getArguments();
Map<String, String> getAttachments();
String getAttachment(String key);
String getAttachment(String key, String defaultValue);
Invoker<?> getInvoker();
Exporter
- Invoker getInvoker();
- void unexport();
RpcInvocation
public RpcInvocation(Invocation invocation, Invoker<?> invoker) {
this(invocation.getMethodName(), invocation.getParameterTypes(),
invocation.getArguments(), new HashMap<String, String>(invocation.getAttachments()),
invocation.getInvoker());
if (invoker != null) {
URL url = invoker.getUrl();
setAttachment(Constants.PATH_KEY, url.getPath());
if (url.hasParameter(Constants.INTERFACE_KEY)) {
setAttachment(Constants.INTERFACE_KEY, url.getParameter(Constants.INTERFACE_KEY));
}
if (url.hasParameter(Constants.GROUP_KEY)) {
setAttachment(Constants.GROUP_KEY, url.getParameter(Constants.GROUP_KEY));
}
if (url.hasParameter(Constants.VERSION_KEY)) {
setAttachment(Constants.VERSION_KEY, url.getParameter(Constants.VERSION_KEY, "0.0.0"));
}
if (url.hasParameter(Constants.TIMEOUT_KEY)) {
setAttachment(Constants.TIMEOUT_KEY, url.getParameter(Constants.TIMEOUT_KEY));
}
if (url.hasParameter(Constants.TOKEN_KEY)) {
setAttachment(Constants.TOKEN_KEY, url.getParameter(Constants.TOKEN_KEY));
}
if (url.hasParameter(Constants.APPLICATION_KEY)) {
setAttachment(Constants.APPLICATION_KEY, url.getParameter(Constants.APPLICATION_KEY));
}
}
}
public RpcInvocation(String methodName, Class<?>[] parameterTypes, Object[] arguments, Map<String, String> attachments, Invoker<?> invoker) {
this.methodName = methodName;
this.parameterTypes = parameterTypes == null ? new Class<?>[0] : parameterTypes;
this.arguments = arguments == null ? new Object[0] : arguments;
this.attachments = attachments == null ? new HashMap<String, String>() : attachments;
this.invoker = invoker;
}
ProtocolFilterWrapper
依次执行每个filter
private static <T> Invoker<T> buildInvokerChain(final Invoker<T> invoker, String key, String group) {
Invoker<T> last = invoker;
List<Filter> filters = ExtensionLoader.getExtensionLoader(Filter.class).getActivateExtension(invoker.getUrl(), key, group);
if (filters.size() > 0) {
for (int i = filters.size() - 1; i >= 0; i--) {
final Filter filter = filters.get(i);
final Invoker<T> next = last;
last = new Invoker<T>() {
public Class<T> getInterface() {
return invoker.getInterface();
}
public URL getUrl() {
return invoker.getUrl();
}
public boolean isAvailable() {
return invoker.isAvailable();
}
public Result invoke(Invocation invocation) throws RpcException {
return filter.invoke(next, invocation);
}
public void destroy() {
invoker.destroy();
}
@Override
public String toString() {
return invoker.toString();
}
};
}
}
return last;
}