spring RMI 实用分享

   spring封装的RMI能方便的帮我们实现远程方法调用。在一些场景下，使用spring RMI能以较少的代码量实现功能需求。一般来讲，使用spring RMI建议分四步进行：
   一、编写服务契约实体和接口
   二、编写服务实现类
   三、通过spring发布服务
   四、通过spring配置client端
  
   一、编写服务契约实体和接口
   代码示例：
    实体类：

package example;

import java.io.Serializable;

public class User implements Serializable {

    private static final long serialVersionUID = 6219857853122278761L;

    private int id;

    private String username;

    private String password;

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getUsername() {
        return username;
    }

    public void setUsername(String username) {
        this.username = username;
    }

    public String getPassword() {
        return password;
    }

    public void setPassword(String password) {
        this.password = password;
    }
}

    接口：

package example;

public interface HelloService {

    String getGreeting(String name);

    User getUserById(int id);
}

   注意事项：
   

    在创建契约实体时要实现Serializable接口（包括接口的参数和返回值）。
   

   二、编写服务实现类
    代码示例：

package example;

import org.springframework.stereotype.Component;

/**
 * @author Kevin
 *
 * @date 2014年10月14日 下午5:32:35
 */
@Component("helloServiceImpl")
public class HelloServiceImpl implements HelloService {

    @Override
    public String getGreeting(String name) {
        return "name=" + name;
    }

    @Override
    public User getUserById(int id) {
        return new User();
    }

}

    三、通过spring发布部署
    代码示例：

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans    
        http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-3.1.xsd">

    <context:component-scan base-package="example"/>
        
    <bean class="org.springframework.remoting.rmi.RmiServiceExporter">
    	<!-- 服务名称 -->
    	<property name="serviceName" value="helloService"/>
    	<!-- 服务实现类 -->
    	<property name="service" ref="helloServiceImpl"/>
    	<!-- 服务契约接口 -->
    	<property name="serviceInterface" value="example.HelloService"/>
    	<!-- 注册端口 -->
    	<property name="registryPort" value="1088"/>
    	<!-- 服务端口 -->
    	<property name="servicePort" value="1077"/>
    </bean>
</beans>

   注意事项：
  

   1、若RMI server和RMI client在同一台机器上，则servicePort可以不配置，spring的RMI实现会分配一个匿名端口；若RMI server和RMI client在不同的机器上，建议配置上servicePort，显示指定一个端口，Linux环境下请打开registryPort和servicePort的防火墙开关。
   2、若RMI server和RMI client在不同的机器上时，在启动RMI server的JAVA_OPTS中要加上"-Djava.rmi.server.hostname=HOST"，这个HOST为对外提供服务的IP地址或者域名。
  

   四、通过spring配置client端
   代码示例：

<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:context="http://www.springframework.org/schema/context"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="
        http://www.springframework.org/schema/beans    
        http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
        http://www.springframework.org/schema/context
        http://www.springframework.org/schema/context/spring-context-3.1.xsd">
	
	<bean id="helloService" class="org.springframework.remoting.rmi.RmiProxyFactoryBean">
		<!--服务请求地址-->
		<property name="serviceUrl" value="rmi://HOST:PORT/helloService"/>
		<!--服务契约接口-->
		<property name="serviceInterface" value="example.HelloService"/>
		<!--是否启动client时就寻找存根-->  
        <property name="lookupStubOnStartup" value="false"/>  
        <!--是否在连接RMI server失败时刷新存根-->  
        <property name="refreshStubOnConnectFailure" value="true"/>
	</bean>
</beans>

    注意事项：
   

    1、若RMI server和RMI client在同一台机器上serviceUrl中的HOST为localhost或本机IP地址；
    2、若RMI server和RMI client在不同的机器上serviceUrl中的HOST为RMI server启动时JAVA_OPTS中-Djava.rmi.server.hostname指定的HOST。
    3、PORT保持与RMI server中的registryPort一致即可。
    4、lookupStubOnStartup 该配置项默认为true，表示启动RMI client时就要lookup 存根，这在RMI server和RMI client的启动顺序未知的情况下，极为有用，只要配置为false，就不会受server和client的启动顺序影响导致client无法启动。
    5、refreshStubOnConnectFailure 该配置项默认为false，表示在连接server失败时不刷新存根，直接抛出异常，在实际应用中，将该配置设置而为true，就类似于打开了网络连接中的失败重连机制，在client连接server失败的时候，会自动刷新存根。
   

    代码示例参见附件。
    更多使用过程中的异常会逐步整理更新，谢谢！