Hessian是一个用于连接网络服务的二进制协议,是Resin的开源产品。Hessian是一个非常简单的协议,使用了J2ME的设备如移动电话都可以使用它连接到Resin服务,因为它的协议简单、使用方便性及功能的强大,它也可以使用到EJB服务中。
Hessian简单使用介绍,下面的本篇文章的目录结构:
1、Hessian客户端
2、Hessian服务端
1)、在Hessian 3.0中配置依赖性注入
2)、在标准的web.xml中配置
3、Hessian序列化
4、Hessian与大二进制数据
5、Hessian的调试
6、Hessian流
7、用于移动电话的Hessian客户端
下面分别对它进行介绍:
1、Hessian客户端
在JAVA客户端中使用Hessian就相当于是调用JAVA本地方法一样,HessianProxyFactory创建代理协议的过程就像是调用一个普通的JAVA对象,如果远程连接失败,会抛出协议连接失败的异常,要使用HessianProxyFactory,要求JDK版本在1.3及以上。
每一个服务,都要求有一个普通的JAVA接口,用来描述这个服务。以下的JAVA片断代码hello返回的是一个字符串String类型,Hessian本身是支持序列化,因而任何JAVA类型都可以返回。
Basic服务代码:
以下是一个标准的Hessian客户端示例,客户中创建了一个HessianProxyFactory工厂,客户端使用这个工厂,根据提供的目标URL及为这个接口提供的API,创建客户端Stubs,返回的对象就是一个引用了接口API的Stub.
用于Basic服务的客户端代码:
就是这么简单,使用客户端并不会增加程序的复杂程度,服务端的方法可以使用任何JAVA类型的参数以及任意类型的返回结果。
2、Hessian服务端
目前很多的Hessian服务端,都会使用Resin-CMP或者是Resin-EJB,因为使用这些可以使用EJB本身的优点,Hessian序列化后的二进制,使得他们可以通过扩展HessianServlet得以实现。
任何的public方法,都被认为是一个服务方法,因而在Hessian服务端中增加方法,就相当于是在一个普通的JAVA类中增加一个方法一样简单。
因为服务是作为一个Servlet引用,它可以ServletContext中你所熟悉的一些servlet数据,就像使用一个普通的servlet一样。
Hello Service源码:
1)、在Hessian 3.0中配置依赖性注入
resin-web.xml:
2)、在标准的web.xml中配置
既然HessianServlet是一个标准的servlet,那么他就可以配置到标准的servlet配置中。
web.xml:
3、Hessian的序列化
Hessian的类可以用于序列化与反序列化,Hessian的序列化是它协议成的基础,通过控制序列化,让应用程序使用Hessian比普通的应用程序的代理接口协议更加有效率。
序列化示例:
反序列化示例:
当序列化的JAVA对象不是JAVA基本类型或者String时,请确认待序列化的类要继承接口java.io.Serializable。
4、Hessian与大二进制数据
当分布式应用需要发布比较大的二进制时,通过使用InputStream而避免分配大字节数组,会更有效率,只有这个方法的final参数可以是InputStream,因为在调用的过程中会读取这些数据,例如,一个文件下载服务使用Hessian会更加有效率。
在下面的示例中,客户端需要使用Hessian协议,因为代理接口会在调用返回之前,会请求缓存整个文件。
文件上传API:
如果结果是InputStream,需要注意的是在finally块中别忘了加了InputStream.close(),因为Hessian只有要读出所有的数据以及数据流关闭之后,才会关闭基于HTTP流。
文件下载API:
JAVA下载代码:
5、Hessian的调试
要调试Hessian需要3.1.3及以后的版本。
启动Hessian的servlet调试需要两步,第一步是将"debug"初使化参数设置到web.xml中,第二步将java.util.logging的为com.caucho.hessian.servlet的级别设置为"fine",在Resin服务中的配置看起来可能会是下面这样:
调试输出示例如下:
6、Hessian流
Hessian 3.1.3介绍了一个流API,应用程序可以使用流来发期周期性数据,例如Comet-style闪存监控应用中定期接受更新。
流示例代码:
流可以与Resin提供的Comet-style servlets一起使用。
7、用于移动电话的Hessian客户端
Hessian可以用于即使是非常小的JAVA设备,以下取自com.caucho.hessian.client的类,可以放到j2me.jar中:
MicroHessianInput
MicroHessianOutput
HessianRemote
HessianServiceException
HessianProtocolException
以下是一个演示了如何使用移动电话作为客户端,比使用代理要复杂一些,因为客户端需要负责建立连接,并且写数据:
Hello, world:
本文出自:冯立彬的博客