Revision as of 19:53, 18 June 2006

The Hessian binary web service protocol makes web services usable without requiring a large framework, and without learning yet another alphabet soup of protocols. Because it is a binary protocol, it is well-suited to sending binary data without any need to extend the protocol with attachments.

Hessian Downloads

See http://www.caucho.com/hessian for the current downloadable Java versions.

The Hessian name

Hessian was named after Hessian cloth, which is the British term for Burlap, and the binary Hessian protocol derives from Caucho's XML Burlap protocol.

The name burlap was originally chosen since burlap is a practical, simple, and useful, but extremely ordinary material, reflecting the design goals for the two protocols. Other RPC and web service protocols may strive for excitement and world domination; Hessian just gets things done.

Hessian Java API Overview

Main article: Hessian Java API Overview

Sample Java Client

   String url = "http://www.caucho.com/hessian/test/basic";

   HessianProxyFactory factory = new HessianProxyFactory();
   Basic basic = (Basic) factory.create(Basic.class, url);

   System.out.println("hello(): " + basic.hello());

Specifications

Hessian 1.0.1 spec

Hessian 1.0 Grammar - quick, terse summary of the protocol

Hessian 2.0 Grammar - draft proposal for Hessian 2.0

Language Implementations

.NET C#

Microsoft .NET compatible version of HessianC# is available under the LGPL by Dimitri Minich, Vitaliy Byelyenkiy and Andre Voltmann

See http://www.hessiancsharp.org/

Objective-C

Main article: Hessian: Objective-C

Byron Wright has released of Hessian for Objective-C at http://www.bluebearstudio.com/hessianobjc/

PHP

A PHP implementation of Hessian is available under the GPL at http://hessianphp.sourceforge.net by Manolo Gómez.

Also see http://www.hessianphp.org/wiki/index.php

Ruby

Christer Sandberg has implemented a Ruby Hessian client at http://rubyforge.org/projects/hessian:

"I just wanted to inform you all that I have made another Ruby Hessian client. It has support for chunks for both strings, xml and binary data and it provides proper encoding and decoding for UTF-8."

Pankaj Mishra has implemented a Ruby Hessian client at http://sourceforge.net/projects/hessianruby under the LGPL.

Links

Dinamica

Technical article about integrating Hessian with our open source J2EE framework "Dinamica"

dinamica-hessian.pdf

The article explains how to return disconnected recordsets (a Dinamica feature) using a Hessian service. In the example, a customer record, all its orders and the detail records for every order are returned using a single recordset and a very simple hessian service.

Former MTS/COM+/VB6 programmers will recognize this technique.

Spring Framework

The Spring Framework includes support for Hessian. The org.springframework.remoting.caucho JavaDoc provides an overview.

RIFE

RIFE aims to offer a viable solution for rapid web application development in Java without being troubled by the complex implications of J2EE. RIFE offers an alternative approach to web application development and design. It builds upon the Java platform, but offers all required tools and APIs to implement and perform all common website related tasks in a fast, intuitive and consistent manner.

RIFE has a page describing its [http://rifers.org/wiki/display/RIFE/Support+for+Hessian+web+services support for Hessian web services].