dubbo源码解析(四) 几个重要接口
协议接口:Protocol 调用远端接口和暴露本地接口
接口导出接口:Exporter 主要用于存放invoker
接口执行:Invoker 具体要被执行的对象或者代理对象
具体接口描述:Invocation 描述接口的方法名称,参数等信息
看一下这几个接口的定义
public interface Protocol { /** * 获取缺省端口,当用户没有配置端口时使用。 * * @return 缺省端口 */ int getDefaultPort(); /** * 暴露远程服务:<br> * 1. 协议在接收请求时,应记录请求来源方地址信息:RpcContext.getContext().setRemoteAddress();<br> * 2. export()必须是幂等的,也就是暴露同一个URL的Invoker两次,和暴露一次没有区别。<br> * 3. export()传入的Invoker由框架实现并传入,协议不需要关心。<br> * * @param <T> 服务的类型 * @param invoker 服务的执行体 * @return exporter 暴露服务的引用,用于取消暴露 * @throws RpcException 当暴露服务出错时抛出,比如端口已占用 */ @Adaptive <T> Exporter<T> export(Invoker<T> invoker) throws RpcException; /** * 引用远程服务:<br> * 1. 当用户调用refer()所返回的Invoker对象的invoke()方法时,协议需相应执行同URL远端export()传入的Invoker对象的invoke()方法。<br> * 2. refer()返回的Invoker由协议实现,协议通常需要在此Invoker中发送远程请求。<br> * 3. 当url中有设置check=false时,连接失败不能抛出异常,并内部自动恢复。<br> * * @param <T> 服务的类型 * @param type 服务的类型 * @param url 远程服务的URL地址 * @return invoker 服务的本地代理 * @throws RpcException 当连接服务提供方失败时抛出 */ @Adaptive <T> Invoker<T> refer(Class<T> type, URL url) throws RpcException; /** * 释放协议:<br> * 1. 取消该协议所有已经暴露和引用的服务。<br> * 2. 释放协议所占用的所有资源,比如连接和端口。<br> * 3. 协议在释放后,依然能暴露和引用新的服务。<br> */ void destroy(); }
这个接口里面我们最关注的是export和refer,一个是暴露本地接口,一个是引用远程接口。
export暴露本地接口时需要传入Invoker,这样就可以通过调用invoker.invoke方法执行本地方法了
refer远程调用接口时需要传入服务类型和远程服务的url,返回生成的本地代理对象,这样当发起请求调用远程接口时首先调用本地的代理对象,本地代理对象再发送请求到远端。
public interface Invoker<T> extends Node { Class<T> getInterface(); Result invoke(Invocation invocation) throws RpcException; }
这个接口就两个方法,一个invoke,一个getInterface.还有几个从Node继承来的getUrl、isAvailable、destroy
public interface Exporter<T> { Invoker<T> getInvoker(); void unexport(); }
主要就是getInvoker()方法
public interface Invocation { /** * get method name. * * @serial * @return method name. */ String getMethodName(); /** * get parameter types. * * @serial * @return parameter types. */ Class<?>[] getParameterTypes(); /** * get arguments. * * @serial * @return arguments. */ Object[] getArguments(); /** * get attachments. * * @serial * @return attachments. */ Map<String, String> getAttachments(); /** * get attachment by key. * * @serial * @return attachment value. */ String getAttachment(String key); /** * get attachment by key with default value. * * @serial * @return attachment value. */ String getAttachment(String key, String defaultValue); /** * get the invoker in current context. * * @transient * @return invoker. */ Invoker<?> getInvoker(); }
这个接口主要是发布接口的描述
posted on 2018-12-21 11:48 liguangming 阅读(233) 评论(0) 编辑 收藏 举报