9.5.3 远程服务协议-Mina协议

Mina协议一种高效的网络通讯协议，远程服务框架通过mina协议实现传统的client-server远程服务调用风格。

 

具体mina协议的介绍请参考官方网站【http://mina.apache.org/】

1.1.1.1             Mina协议配置

Mina协议的配置文件为：org/frameworkset/spi/manager-rpc-mina.xml

被导入在rpc基础配置文件manager-rpc-service.xml中:

<managerimport file="org/frameworkset/spi/manager-rpc-jms.xml" /> 

下面具体介绍mina配置：

1.1.1.1.1       mina服务请求和响应处理类

   

    <property name="rpc.mina.RPCServerIoHandler" singlable="true"

       class="org.frameworkset.spi.remote.mina.server.RPCServerIoHandler">

       <construction>

           <property name="name" value="RPCServerIoHandler" class="String" />

           <property name="request_handler" refid="attr:rpc.request_handler" />        

       </construction>

    </property>  

1.1.1.1.2       Mina服务器组件

    <property name="rpc.mina.server" singlable="true"

       class="org.frameworkset.spi.remote.mina.server.MinaRPCServer">

       <construction>

           <property name="mina.params" refid="attr:rpc.protocol.mina.params" />       

       </construction>

    </property>  

      

        

1.1.1.1.3      mina的链接参数配置

      

    <property name="rpc.protocol.mina.params">

       <map>

              <!—客服端连接超时时间，默认值60秒，单位：秒 -->

           <property name="connection.timeout" value="60" />

             

              <!--

                  服务器绑定端口

               -->

           <property name="connection.bind.port" value="12347" />

              <!--

                  服务器绑定ip

               -->

           <property name="connection.bind.ip" value="172.16.17.216" />

          

       </map>

    </property>

1.1.1.2             Mina协议使用方法

 

1.1.1.2.1       服务组件配置

客服端和服务器端配置组件：

<property name="rpc.test" singlable="true" class="org.frameworkset.spi.remote.RPCTest"/>

 

1.1.1.2.2       启动服务器

先在配置服务器上配置好以下参数：

    <!--

                  服务器绑定端口

               -->

           <property name="connection.bind.port" value="12347" />

              <!--

                  服务器绑定ip

               -->

           <property name="connection.bind.ip" value="172.16.17.216" />

 

在服务器端启动mina服务器协议，启动后客服端即可进行远程服务调用。启动mina服务器方法如下：

org.frameworkset.spi.remote.RPCHelper.getRPCHelper().startMinaServer();

 

1.1.1.2.3       获取远程组件实例

         单点调用

RPCTestInf testInf = (RPCTestInf)BaseSPIManager.getBeanObject("(mina::172.16.17.216:1186)/rpc.test");

         多点调用

RPCTestInf testInf = (RPCTestInf)BaseSPIManager.getBeanObject("(mina::192.168.11.102:1186;192.168.11.102:12346)/rpc.test");

         组播调用

RPCTestInf testInf = (RPCTestInf)BaseSPIManager.getBeanObject("(mina::all)/rpc.test");

 

         单点调用-传递认证信息

RPCTestInf testInf = (RPCTestInf)BaseSPIManager.getBeanObject("(mina::172.16.17.216:1186)/rpc.test?user=admin&password=123456");

         多点调用-传递认证信息

RPCTestInf testInf = (RPCTestInf)BaseSPIManager.getBeanObject("(mina::192.168.11.102:1186;192.168.11.102:12346)/rpc.test?user=admin&password=123456");

         组播调用-传递认证信息

RPCTestInf testInf = (RPCTestInf)BaseSPIManager.getBeanObject("(mina::all)/rpc.test?user=admin&password=123456");

1.1.1.2.4       远程方法调用

Object count = testInf.getCount();

1.1.1.2.5       调用结果处理

单点调用的结果就是服务接口返回的值，无需处理。如果方法调用失败，系统将抛出具体的远程异常。

多点调用和组播调用的结果处理方法一样，以多点调用为例：

RPCTestInf testInf = (RPCTestInf)BaseSPIManager.getBeanObject("(mina::192.168.11.102:1186;192.168.11.102:12346)/rpc.test?User=admin&password=123456");

Object count = testInf.getCount();

Object count = testInf.getCount();

获取192.168.11.102:1186返回的结果：

Object count_1186 = BaseSPIManager.getRPCResult("192.168.11.102", "1186", count);如果返回值是异常，那么直接抛出该异常。

或者

Object count_1186 = BaseSPIManager.getMinaRPCResult

 ("192.168.11.102:1186", count);如果返回值是异常，那么直接抛出该异常。

或者

Object count_1186 =

    BaseSPIManager.getRPCResult("192.168.11.102:1186", count,

org.frameworkset.remote.Target.BROADCAST_TYPE_MINA);  如果返回值是异常，那么直接抛出该异常。

获取192.168.11.102:12346返回的结果：

Object count_12346 = BaseSPIManager.getRPCResult("192.168.11.102", "12346", count); 如果返回值是异常，那么直接抛出该异常。

或者

Object count_12346 = BaseSPIManager.getMinaRPCResult

 ("192.168.11.102:12346", count);

或者

Object count_12346 =

    BaseSPIManager.getRPCResult("192.168.11.102:12346", count,

org.frameworkset.remote.Target.BROADCAST_TYPE_MINA);  如果返回值是异常，那么直接抛出该异常。