Hessian Web Service Protocol – Hello World Example

Introduction

Yesterday I took a quit look to the binary communication protocol: Hessian.

With Hessian your admins will not have any troubles with port-activation for your (‘desktop’) application, if they have to access remote services (DB etc.).

The Java implemenation from Caucho is released under the Apache License 2.0. Hessian is well integrated into Spring and seems to perform well for version 3.2 (one year old!). An ORM tool which supports Hessian out of the box is Cayenne.

Example

Now to our hello world example. It is a maven project and you can get it from here (public domain of course …).

If you don’t want to use maven you should get the following jars:

But maybe you have the same problems with downloading a none-corrupted hessian.jar from Caucho (Why that?) – then you will be forced to install maven or NetBeans.

The usage is simple: In NetBeans you can directly open maven projects with the maven plugin. Then start the jetty-server: go into the MyServlet class and press SHIFT+F6. You should see in the output window:
… INFO:  Logging to STDERR via org.mortbay.log.StdErrLog
… INFO:  jetty-6.1.16
… INFO:  Started SocketConnector@0.0.0.0:8080

Then go to the Client class and press SHIFT+F6. You should see a new window coming up:

Change the text and press ENTER will push the text to the server and get the response text at the bottom of the window updated:

Now let us understand what is necessary:

1. An interface which has to be available on the server and on the client side:

   public interface CommunicationService {
       String communicate(String str);
   }

2. An implementation of this interface on the server side:

   public class MyServlet extends HessianServlet implements CommunicationService {
       public String communicate(String str) {
           return "Hello World! " + str;
       }
       ...
   }

   (Here only the ‘implements CommunicationService’ is important)

3. Now the server code:

   public static void main(String[] args) throws Exception {
           Server server = new Server(8080);
           Context context = new Context(server, "/", Context.SESSIONS);
           context.addServlet(MyServlet.class, "/communication-service");
           server.start();
   }

4. And the client code:

   String url = "http://localhost:8080/communication-service";
   HessianProxyFactory factory = new HessianProxyFactory();
   final CommunicationService basic = (CommunicationService) factory.create(CommunicationService.class, url);
   ...
   resultLabel.setText("Server said : " + basic.communicate(field.getText()));

5. Thats it!

Looks really like RPC of Java but it is language independent – there are implementations for ruby, phyton … and it seems to be more performant than language independent solutions like XML-RPC. Are there other advantages or disadvantages?