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();

}

这个接口主要是发布接口的描述