java调用hessian配置

简介

因为公司的新项目不使用dubbo进行接口调用，为了复用dubbo部分的代码，将dubbo的接口改为hession接口。
本教程使用hession-4.0.33实现java远程过程调用，并和spring进行集成，记录使用过程中出现的问题和解决方法。

服务端

提供hession服务需要定义接口和实现，然后通过spring暴露引用。

pom

<!-- hessian -->
<dependency>
    <groupId>com.caucho</groupId>
    <artifactId>hessian</artifactId>
    <version>4.0.38</version>
</dependency>

从maven库中下载的hession包缺少相关序列化和反序列化的配置，实际使用中BigDecimal会丢失精度，可以从Hessian-4.0.37jar包中获取，文件位于\META-INF\hessian，将其粘贴到本地库的jar包中，即可修复此bug。

服务端api

将hessian接口、实体bean和异常类放入同一个工程中，方便客户端引用。api工程pom不引用任何其他依赖包，然后发布到公司maven库中，供客户端引用。
我采用的结构如下：
![api工程结构](https://img-blog.csdn.net/20170505091044733?watermark/2/text/aHR0cDovL2Jsb2cuY3Nkbi5uZXQvemgzNTAyMjkzMTk=/font/5a6L5L2T/fontsize/400/fill/I0JBQkFCMA==/dissolve/70/gravity/SouthEast)
dto包：放入自定义的实体类，继承Serializable接口
exception：异常类，因为是从dubbo移植过来，异常类都继承了RuntimeException
service：接口定义
base.pojo：数据库实体bean，因为有时接口需要直接使用数据库实体bean，为了不影响mybaties的调用，必须将类移植到api工程中，并且不修改其所在包名，但需要继承Serializable接口。

Service接口

hession对List、Map、BigDecimal等非基础类型进行了特殊处理，不能直接使用自定义泛型、使用继承List、Map的自定义类在传输过程中会丢失额外增加的字段数据。但可以参考BigDecimalDeserializer和StringValueSerializer等进行实现，然后在\META-INF\hessian进行配置。
hessian支持的数据类型请参考hessian java 类型
接口定义实例如下

public interface ZcpayService {

    /**
     * 获取菜单信息
     * @return 菜单信息集合
     */
    List<ZcpayMenu> getMenus();
}

hessian接口实现

需要实现spring的@Service接口，托管到spring中

@Service
public class ZcpayServiceImpl implements ZcpayService {

    @Autowired
    private ZcpayMenuService zcpayMenuService;
    @Override
    public List<ZcpayMenu> getMenus() {
        return zcpayMenuService.selectByExample(null);
    }

暴露服务

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.xsd"
    default-lazy-init="false">
    <description>Spring Hession 服务端配置</description>

    <bean name="/zcpay" class="org.springframework.remoting.caucho.HessianServiceExporter">
        <property name="service" ref="zcpayServiceImpl"/>
        <property name="serviceInterface" value="com.bwjf.zcpay.api.service.ZcpayService"/>
    </bean>

</beans>

web.xml配置

    <servlet>
        <servlet-name>hessian-servlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath*:/spring-hessian-server.xml</param-value>
        </init-param>
        <load-on-startup>2</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>hessian-servlet</servlet-name>
        <url-pattern>/hessian/*</url-pattern>
    </servlet-mapping>

PS：如果系统使用了shiro或其他权限过滤，需要将/hessian/**地址设置为不校验权限。shiro配置如下

<!-- shiroFilter其他配置省略 -->
<bean id="shiroFilter" class="org.apache.shiro.spring.web.ShiroFilterFactoryBean">
    .......
    <property name="filterChainDefinitions">
        <value>
        /hessian/**=anon
        </value>
    </property>
</bean>

客户端

需要引用服务端API的maven依赖和hessian

<!-- hessian -->
<dependency>
    <groupId>com.caucho</groupId>
    <artifactId>hessian</artifactId>
    <version>4.0.38</version>
</dependency>
<!-- 服务端api -->
<dependency>
    <groupId>com.whty</groupId>
    <artifactId>zcpay-api</artifactId>
    <version>1.0.0.zc</version>
</dependency>

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.xsd"
    default-lazy-init="false">
    <description>Spring hessian配置</description>

    <bean id="zcpayService" class="org.springframework.remoting.caucho.HessianProxyFactoryBean">
        <property name="serviceUrl">
            <!-- 配置文件zcpay_url=http://localhost:8094/zcpay -->
            <value>${zcpay_url}/zcpay/hessian/pgsm</value>
        </property>
        <property name="serviceInterface">
            <value>com.whty.pgsm.api.service.PgsmService</value>
        </property>
    </bean>

</beans>

以上配置完成后，即可在客户端使用@Autowired进行注入后使用

@Autowired
private ZcpayService zcpayService;