ALL is Well！

Hessian是一个轻量级的remoting onhttp工具，使用简单的方法提供了RMI的功能. 相比WebService，Hessian更简单、快捷。
采用的是二进制RPC协议，因为采用的是二进制协议，所以它很适合于发送二进制数据。

本文将分为以下几个内容：
一、一个简单的Hessian调用例子
二、Spring+Hessian的例子
三、使我们的调用变得通用

第一部分：一个简单的Hessian调用例子
建立web工程HessianService。
这里为了简单起见，我将远程接口类、接口实现类都定义在此web工程下。

个人觉得一个比较好的做法是将web工程分开，此web工程只定义对外的接口并提供服务，而实现类新建一个Java工程存放。
这样web工程依赖此Java工程，且客户端也依赖此Java工程。

1) 远程接口类 ServiceRemote.java

package com.al;

import java.util.Map;

@SuppressWarnings("unchecked")
public interface ServiceRemote  {
    public Map callService(Map inputMap) ;
}

2) 实现类 Service.java

package com.al;

import java.util.HashMap;
import java.util.Map;

@SuppressWarnings("unchecked")
public class Service implements ServiceRemote {

    public Map callService(Map inputMap) {
        if(inputMap == null) {
            inputMap = new HashMap();
        }
        // do something
        // 
        inputMap.put("NAME", "Hessian");
        return inputMap;
    }
}

3) web.xml配置

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
 http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
    <servlet>
        <servlet-name>hessianService</servlet-name>
        <servlet-class>com.caucho.hessian.server.HessianServlet</servlet-class>
        <init-param>
            <param-name>service-class</param-name>
            <param-value>com.al.Service</param-value>
        </init-param>
    </servlet>
    <servlet-mapping>
        <servlet-name>hessianService</servlet-name>
        <url-pattern>/hessianService</url-pattern>
    </servlet-mapping>
</web-app>

经过以上3步，hessian服务部署算是完成了，在tomcat下发布。

4) 调用方代码

package com.ai.client;

import com.al.ServiceRemote;
import com.caucho.hessian.client.HessianProxyFactory;

public class ClientTest {
    public static void main(String[] args) throws Exception {
        String url = "http://localhost:8080/HessianService/hessianService";
        HessianProxyFactory factory = new HessianProxyFactory();
        ServiceRemote rmt = (ServiceRemote) factory.create(ServiceRemote.class, url);
        System.out.println(rmt.callService(null));
    }
}

执行代码，结果如下：
{NAME=Hessian}
说明调用远程代码成功了。

二、Spring+Hessian的例子
1) web工程HessianService 的ServiceRemote 和Service类不变。对web.xml进行修改：

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
    http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
    <context-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>/WEB-INF/dispatcher-servlet.xml</param-value>
    </context-param>
    <servlet>
        <servlet-name>dispatcher</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>dispatcher</servlet-name>
        <url-pattern>/remote/*</url-pattern>
    </servlet-mapping>
    <welcome-file-list>
        <welcome-file>index.jsp</welcome-file>
    </welcome-file-list>
</web-app>

这里要注意的是:
a)dispatcher-servlet.xml这个文件的命名。servlet配置为dispatcher，则此文件定义规则为****-servlet.xml.

b)另外就是Spring和hessian的版本问题。
spring版本是2.5.6，需要在此web工程下引入：spring-2.5.6.jar、spring-webmvc-2.5.6.jar、commons-logging-1.1.1.jar。
hessian的版本是hessian-3.1.6.jar，hessian的低版本如 hessian-3.0.13和此Spring版本不合。（我试验了是配置不成功的。）

2) dispatcher-servlet.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans>
    <description>hessian server properties</description>
    <bean id="serviceImpl" class="com.al.Service" />
    <bean name="/service" class="org.springframework.remoting.caucho.HessianServiceExporter">
        <property name="service">
            <ref bean="serviceImpl" />
        </property>
        <property name="serviceInterface">
            <value>com.al.ServiceRemote</value>
        </property>
    </bean>
</beans>

3) 客户端代码可以保持原样不变，把调用hessian服务的url变换一下即可：
http://localhost:8080/HessianService/remote/service
http://IP:port/发布工程名/web.xml中配置的url-pattern/****-servlet.xml bean的ID。

三、使我们的调用变得通用 将在下一篇中介绍。