小試Hessian實(shí)現(xiàn)Webservice

作者：sjsky 2011-04-26 09:13:15

Hessian是一個(gè)輕量級(jí)的remoting on http工具,采用的是Binary RPC協(xié)議，所以它很適合于發(fā)送二進(jìn)制數(shù)據(jù),同時(shí)又具有防火墻穿透能力。

Hessian是一個(gè)輕量級(jí)的remoting on http工具,采用的是Binary RPC協(xié)議，所以它很適合于發(fā)送二進(jìn)制數(shù)據(jù),同時(shí)又具有防火墻穿透能力。Hessian一般是通過(guò)Web應(yīng)用來(lái)提供服務(wù)，因此非常類(lèi)似于平時(shí)我們用的WebService。只是它不使用SOAP協(xié)議,但相比webservice而言更簡(jiǎn)單、快捷。

Hessian官網(wǎng)：http://hessian.caucho.com/

Hessian可通過(guò)Servlet提供遠(yuǎn)程服務(wù)，需要將匹配某個(gè)模式的請(qǐng)求映射到Hessian服務(wù)。也可Spring框架整合，通過(guò)它的DispatcherServlet可以完成該功能，DispatcherServlet可將匹配模式的請(qǐng)求轉(zhuǎn)發(fā)到Hessian服務(wù)。Hessian的server端提供一個(gè)servlet基類(lèi), 用來(lái)處理發(fā)送的請(qǐng)求，而Hessian的這個(gè)遠(yuǎn)程過(guò)程調(diào)用，完全使用動(dòng)態(tài)代理來(lái)實(shí)現(xiàn)的,，建議采用面向接口編程，Hessian服務(wù)通過(guò)接口暴露。

Hessian處理過(guò)程示意圖：

客戶端——>序列化寫(xiě)到輸出流——>遠(yuǎn)程方法(服務(wù)器端)——>序列化寫(xiě)到輸出流 ——>客戶端讀取輸入流——>輸出結(jié)果

下面詳細(xì)介紹最常用的兩種方式實(shí)現(xiàn)Hessian提供webservice：

純Hessian實(shí)現(xiàn)

配合Spring框架實(shí)現(xiàn)

在開(kāi)始之前當(dāng)然需要到官網(wǎng)上下載相關(guān)的lib包，放入項(xiàng)目的/WEB-INF/lib/下

【一】、純Hessian實(shí)現(xiàn)步驟：

1.基本代碼

首先編寫(xiě)一個(gè)服務(wù)的接口類(lèi)：HelloHessian.java

Java代碼

package michael.hessian;     
import java.util.List;     
import java.util.Map;     
    
/**    
 * @author michael    
 *     
 */    
public interface HelloHessian {     
    
    String sayHello();     
    
    MyCar getMyCar();     
    
    List myLoveFruit();     
    
    Map myBabays();     
    
}

一個(gè)java bean文件MyCar.java:

Java代碼

package michael.hessian;     
    
import java.io.Serializable;     
    
/**    
 * @author michael    
 *     
 */    
public class MyCar implements Serializable {     
    
    /**    
     *     
     */    
    private static final long serialVersionUID = 4736905401908455439L;     
    
    private String carName;     
    
    private String carModel;     
    
    /**    
     * @return the carName    
     */    
    public String getCarName() {     
        return carName;     
    }     
    
    /**    
     * @return the carModel    
     */    
    public String getCarModel() {     
        return carModel;     
    }     
    
    /**    
     * @param pCarName the carName to set    
     */    
    public void setCarName(String pCarName) {     
        carName = pCarName;     
    }     
    
    /**    
     * @param pCarModel the carModel to set    
     */    
    public void setCarModel(String pCarModel) {     
        carModel = pCarModel;     
    }     
    
    /**    
     * @see java.lang.Object#toString()    
     * @return    
     */    
    @Override    
    public String toString() {     
        return "my car name:[" + this.carName + "] model:[" + this.carModel     
                + "].";     
    }     
    
}

服務(wù)端接口的實(shí)現(xiàn)類(lèi)：HelloHessianImpl.java

Java代碼

package michael.hessian.impl;     
    
import java.util.ArrayList;     
import java.util.HashMap;     
import java.util.List;     
import java.util.Map;     
    
import michael.hessian.HelloHessian;     
import michael.hessian.MyCar;     
    
/**    
 * @author michael    
 *     
 */    
public class HelloHessianImpl extends HessianServlet implements HelloHessian {     
    
    public MyCar getMyCar() {     
        MyCar car = new MyCar();     
        car.setCarName("阿斯頓·馬丁");     
        car.setCarModel("One-77");     
        return car;     
    }     
    
    public Map myBabays() {     
        Map map = new HashMap();     
        map.put("son", "孫吳空");     
        map.put("daughter", "孫小美");     
        return map;     
    }     
    
    public List myLoveFruit() {     
        List list = new ArrayList();     
        list.add("apple");     
        list.add("kiwi");     
        list.add("orange");     
        return list;     
    }     
    
    public String sayHello() {     
        return "welcom to Hessian";     
    }     
    
}

2.配置文件web.xml修改

在web.xml配置文件里增加如下信息：

Xml代碼

<servlet>    
        <servlet-name>HelloHessianservlet-name>    
        <servlet-class>    
            com.caucho.hessian.server.HessianServlet     
        servlet-class>    
        <init-param>    
            <param-name>home-classparam-name>    
            <param-value>michael.hessian.impl.HelloHessianImplparam-value>    
        init-param>    
        <init-param>    
            <param-name>home-apiparam-name>    
            <param-value>michael.hessian.HelloHessianparam-value>    
        init-param>    
        <load-on-startup>1load-on-startup>    
    servlet>    
    <servlet-mapping>    
        <servlet-name>HelloHessianservlet-name>    
        <url-pattern>/HessianServiceurl-pattern>    
    servlet-mapping>    
    <servlet-mapping>

3.java客戶端驗(yàn)證

Java代碼

package michael.hessian.client;     
    
import java.net.MalformedURLException;     
import java.util.Map;     
    
import michael.hessian.HelloHessian;     
import michael.hessian.MyCar;     
    
import com.caucho.hessian.client.HessianProxyFactory;     
    
/**    
 * @author michael    
 *    
 */    
public class HessianClientTest {     
    
    /**    
     * @param args    
     */    
    public static void main(String[] args) {     
        String url = "http://localhost:8082/J2EE_sjsky/HessianService";     
        HessianProxyFactory factory = new HessianProxyFactory();     
        try {     
            HelloHessian hello = (HelloHessian) factory.create(     
                    HelloHessian.class, url);     
            System.out.println(hello.sayHello());     
    
            MyCar car = hello.getMyCar();     
            System.out.println(car.toString());     
    
            for (Map.Entry entry : hello.myBabays().entrySet()) {     
                System.out.println(entry.getKey() + "   " + entry.getValue());     
            }     
    
            for (String str : hello.myLoveFruit()) {     
                System.out.println(str);     
            }     
    
        } catch (MalformedURLException e) {     
            e.printStackTrace();     
        }     
    
    }     
    
}

運(yùn)行結(jié)果如下：

Java代碼

welcom to Hessian     
my car name:[阿斯頓·馬丁] model:[One-77].     
daughter   孫小美     
son   孫吳空     
apple     
kiwi     
orange

【二】、spring+hessian 實(shí)現(xiàn)服務(wù)端：

1.基本代碼見(jiàn)上面的demo

2.修改配置文件

在web.xml，增加內(nèi)容如下：

Xml代碼

<servlet>    
        <servlet-name>springhessianservlet-name>    
        <servlet-class>    
            org.springframework.web.servlet.DispatcherServlet     
        servlet-class>    
            
    <bean name="/helloHessianService"    
        class="org.springframework.remoting.caucho.HessianServiceExporter">    
            
        <property name="service" ref="helloHessianImpl" />    
            
        <property name="serviceInterface"    
            value="michael.hessian.HelloHessian" />    
    bean>    
beans>

3.java客戶端驗(yàn)證

和上面的例子相似，只需要把訪問(wèn)的url替換成新的即可如下：

Java代碼

String url=http://localhost:8082/J2EE_sjsky/springhessian/helloHessianService

運(yùn)行結(jié)果和上面例子一樣。

4.spring配置客戶端

增加一個(gè)spring的bean配置文件hessian-client.xml

Xml代碼

xml version="1.0" encoding="UTF-8"?>    
>    
<beans>    
    <bean id="helloHessianClient"    
        class="org.springframework.remoting.caucho.HessianProxyFactoryBean">    
        <property name="serviceUrl">    
            <value>    
                http://localhost:8082/J2EE_sjsky/springhessian/helloHessianService     
            value>    
        property>    
        <property name="serviceInterface"    
            value="michael.hessian.HelloHessian" />    
    bean>    
beans>

測(cè)試代碼HessianSpringClient.java：

Java代碼

package michael.hessian.client;     
    
import java.util.Map;     
    
import michael.hessian.HelloHessian;     
import michael.hessian.MyCar;     
    
import org.springframework.context.ApplicationContext;     
import org.springframework.context.support.ClassPathXmlApplicationContext;     
    
/**    
 * @author michael    
 *     
 */    
public class HessianSpringClient {     
    
    /**    
     * @param args    
     */    
    public static void main(String[] args) {     
        try {     
            ApplicationContext context = new ClassPathXmlApplicationContext(     
                    "hessian-client.xml");     
    
            HelloHessian hello = (HelloHessian) context     
                    .getBean("helloHessianClient");     
    
            System.out.println(hello.sayHello());     
    
            MyCar car = hello.getMyCar();     
            System.out.println(car.toString());     
    
            for (Map.Entry entry : hello.myBabays().entrySet()) {     
                System.out.println(entry.getKey() + "   " + entry.getValue());     
            }     
    
            for (String str : hello.myLoveFruit()) {     
                System.out.println(str);     
            }     
        } catch (Exception e) {     
            e.printStackTrace();     
        }     
    
    }     
    
}

運(yùn)行結(jié)果和上面完全一致。

5.com.caucho.hessian.io.HessianProtocolException: expected string at 0x6d異常處理

我在spring+hessian整合測(cè)試過(guò)程中，客戶端調(diào)用時(shí)，發(fā)生了異常，而服務(wù)端錯(cuò)誤內(nèi)容如下：

Java代碼

2011-4-25 16:14:44 org.apache.catalina.core.StandardWrapperValve invoke     
嚴(yán)重: Servlet.service() for servlet remoting threw exception     
com.caucho.hessian.io.HessianProtocolException: expected string at 0x6d    
    at com.caucho.hessian.io.Hessian2Input.error(Hessian2Input.java:2882)     
    at com.caucho.hessian.io.Hessian2Input.expect(Hessian2Input.java:2830)     
    at com.caucho.hessian.io.Hessian2Input.readString(Hessian2Input.java:1362)     
    at com.caucho.hessian.io.Hessian2Input.readMethod(Hessian2Input.java:272)     
    at com.caucho.hessian.server.HessianSkeleton.invoke(HessianSkeleton.java:249)     
    at com.caucho.hessian.server.HessianSkeleton.invoke(HessianSkeleton.java:221)     
    at org.springframework.remoting.caucho.Hessian2SkeletonInvoker.invoke(Hessian2SkeletonInvoker.java:67)     
    at org.springframework.remoting.caucho.HessianServiceExporter.handleRequest(HessianServiceExporter.java:147)     
    at org.springframework.web.servlet.mvc.HttpRequestHandlerAdapter.handle(HttpRequestHandlerAdapter.java:49)     
    at org.springframework.web.servlet.DispatcherServlet.doDispatch(DispatcherServlet.java:819)     
    at org.springframework.web.servlet.DispatcherServlet.doService(DispatcherServlet.java:754)     
    at org.springframework.web.servlet.FrameworkServlet.processRequest(FrameworkServlet.java:399)     
    at org.springframework.web.servlet.FrameworkServlet.doPost(FrameworkServlet.java:364)     
    at javax.servlet.http.HttpServlet.service(HttpServlet.java:710)     
    at javax.servlet.http.HttpServlet.service(HttpServlet.java:803)     
    at org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:290)     
    at org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)     
    at org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:230)     
    at org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:175)     
    at org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:128)     
    at org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:104)     
    at org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)     
    at org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:261)     
    at org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:844)     
    at org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:581)     
    at org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:447)     
    at java.lang.Thread.run(Thread.java:619)