在使用Missian时,spring是可选的,但是作者本人强烈推荐和Spring配合使用。Spring是一个伟大的项目,并且它不会对程序在运行时的效率带来任何损耗。
Missian在服务器端依赖与Mina,Missian只是提供一个Codec(协议编码解码,兼容TCP和HTTP)和一个Handler(调用Hessian序列化机制来反序列化数据、使用BeanLocator来定位这次调用的Bean)。熟悉Mina的朋友会很清楚Codec和Handler的概念;不熟悉的朋友也没关系,按照这个教程一样可以创建一个高效的服务来。对Mina没有兴趣的朋友可以直接跳到第七步:)
步骤一:创建一个spring配置文件。
<?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" 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.0.xsd"> </beans>
步骤二:配置文件中加入:
<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer"> <property name="customEditors"> <map> <entry key="java.net.SocketAddress"> <bean class="org.apache.mina.integration.beans.InetSocketAddressEditor" /> </entry> </map> </property> </bean>
这个是最后绑定端口时,用来将10.1.23.1:125转换成SocketAddress的,不用太关注。
步骤三:配置各个Mina的Filter
注意ExecutorFitler是使用的默认构造函数,要指定线程数,或者将已有的线程池传入,可以使用其它的构造函数;LoggingFilter中除了Exception之外的时间的Log级别已经全部设为DEBUG;CodecFilter是关键,这里引入了Missian的编码解码器。
<bean id="executorFilter" class="org.apache.mina.filter.executor.ExecutorFilter" />
<bean id="codecFilter" class="org.apache.mina.filter.codec.ProtocolCodecFilter">
<constructor-arg>
<bean class="com.missian.server.codec.MissianCodecFactory" />
</constructor-arg>
</bean>
<bean id="loggingFilter" class="org.apache.mina.filter.logging.LoggingFilter">
<property name="messageReceivedLogLevel" value="DEBUG"/>
<property name="messageSentLogLevel" value="DEBUG"/>
<property name="sessionCreatedLogLevel" value="DEBUG"/>
<property name="sessionClosedLogLevel" value="DEBUG"/>
<property name="sessionIdleLogLevel" value="DEBUG"/>
<property name="sessionOpenedLogLevel" value="DEBUG"/>
</bean>
步骤四:构建FilterChian
这里我把Codec放在线程池之前,因为编码解码是CPU密集型的操作,使用线程池并不能提高效率。当然了,有兴趣的朋友可以自己调整顺序做一下测试。
<bean id="filterChainBuilder"
class="org.apache.mina.core.filterchain.DefaultIoFilterChainBuilder">
<property name="filters">
<map>
<entry key="codecFilter" value-ref="codecFilter" />
<entry key="executor" value-ref="executorFilter" />
<entry key="loggingFilter" value-ref="loggingFilter" />
</map>
</property>
</bean>
步骤五:创建IoHandler。
这一步也很重要,引入了Missian的处理器,就是在这里调用了Hessian的序列化机制,并完成对相应的Bean的调用。
<bean id="minaHandler" class="com.missian.server.handler.MissianHandler"> <constructor-arg> <bean class="com.missian.common.beanlocate.SpringLocator" /> </constructor-arg> </bean>
MissianHandler接受一个BeanLocator的构造菜熟,注意这里直接给MissianHandler注入了一个SpringLocator,使得Missian有能力去Spring去寻找相应的Bean。
这里是一个很好的扩展点,有需要的话可以在BeanLocator上做做文章。
步骤六:创建一个Acceptor,监听端口
<bean id="minaAcceptor" class="org.apache.mina.transport.socket.nio.NioSocketAcceptor"
init-method="bind" destroy-method="unbind">
<property name="defaultLocalAddress" value=":1235" />
<property name="handler" ref="minaHandler" />
<property name="reuseAddress" value="true" />
<property name="filterChainBuilder" ref="filterChainBuilder" />
</bean>
到此位置,missian服务配置完毕。接下来配置一下业务逻辑的Bean。
步骤七:配置一个业务逻辑Bean,供Missian客户端调用
<bean id="hello" class="com.missian.example.bean.HelloImpl"></bean>
上一篇指南里面创建的这个类第一次出境了,鼓掌……
注意bean的id叫做‘hello’,missian客户端就是通过‘hello’这个名称找到这个bean的,例如:http://www.abc.cn/hello。
值得一提的是如果客户端想通过http://www.abc.cn/p/hello来访问这个bean,那么这个bean的配置应该如此:
<bean name="p/hello" class="com.missian.example.bean.HelloImpl"></bean>
ID属性是不能出现斜杠的,所以通过name来定义这个bean。
步骤八:启动服务器
public class ServerWithSpring {
/**
* @param args
*/
public static void main(String[] args) {
new ClassPathXmlApplicationContext("com/missian/example/server/withspring/applicationContext-*.xml");
}
}
运行ServerWithSpring即启动了整个服务了。服务将监听1235端口,接受HTTP协议和TCP协议格式的请求。
步骤九:用Hessian来调用此服务
由于Missian服务器是兼容Hessian的,所以,在创建Missian客户端之前,让我们用Hessian客户端来测试一下这个服务吧。
HessianProxyFactory factory = new HessianProxyFactory();
Hello hello = (Hello) factory.create(Hello.class, "http://localhost:1235/hello");
System.out.println(hello.hello("test", 27));
是的,你会发现调用成功了。
完整的配置文件如下 :
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
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.0.xsd">
<bean class="org.springframework.beans.factory.config.CustomEditorConfigurer">
<property name="customEditors">
<map>
<entry key="java.net.SocketAddress">
<bean class="org.apache.mina.integration.beans.InetSocketAddressEditor" />
</entry>
</map>
</property>
</bean>
<!-- The IoHandler implementation -->
<bean id="minaHandler" class="com.missian.server.handler.MissianHandler">
<constructor-arg>
<bean class="com.missian.common.beanlocate.SpringLocator" />
</constructor-arg>
</bean>
<!-- the IoFilters -->
<bean id="executorFilter" class="org.apache.mina.filter.executor.ExecutorFilter" />
<bean id="codecFilter" class="org.apache.mina.filter.codec.ProtocolCodecFilter">
<constructor-arg>
<bean class="com.missian.server.codec.MissianCodecFactory" />
</constructor-arg>
</bean>
<bean id="loggingFilter" class="org.apache.mina.filter.logging.LoggingFilter">
<property name="messageReceivedLogLevel" value="DEBUG"/>
<property name="messageSentLogLevel" value="DEBUG"/>
<property name="sessionCreatedLogLevel" value="DEBUG"/>
<property name="sessionClosedLogLevel" value="DEBUG"/>
<property name="sessionIdleLogLevel" value="DEBUG"/>
<property name="sessionOpenedLogLevel" value="DEBUG"/>
</bean>
<!-- The non-SSL filter chain. -->
<bean id="filterChainBuilder"
class="org.apache.mina.core.filterchain.DefaultIoFilterChainBuilder">
<property name="filters">
<map>
<entry key="codecFilter" value-ref="codecFilter" />
<entry key="executor" value-ref="executorFilter" />
<entry key="loggingFilter" value-ref="loggingFilter" />
</map>
</property>
</bean>
<!-- The IoAcceptor which binds to port 1235 server side -->
<bean id="minaAcceptor" class="org.apache.mina.transport.socket.nio.NioSocketAcceptor"
init-method="bind" destroy-method="unbind">
<property name="defaultLocalAddress" value=":1235" />
<property name="handler" ref="minaHandler" />
<property name="reuseAddress" value="true" />
<property name="filterChainBuilder" ref="filterChainBuilder" />
</bean>
<!-- your business bean, missian client will call this bean by 'hello' -->
<bean id="hello" class="com.missian.example.bean.HelloImpl"></bean>
</beans>