![]() | ![]() | ![]() | ||||||||
![]() | ||||||||||
documentation examples changes overview quick start installation command-line configuration admin amber clustering caching database deployment ejb 3.0 embedding filters hessian hmtp ioc jsp logging messaging performance quercus/php remoting scheduled tasks security server push servlets third-party troubleshooting virtual hosting watchdog webapp xml and xslt hessian hessian 1.0 spec hessian 2.0 draft spec java binding burlap burlap 1.0 spec burlap design notes hessian messaging | hessian messaging
The Hessian binary web service protocol can provide a messaging service layered on top of its RPC call. The messaging service itself is based on the standard Hessian RPC call, so Hessian itself has no need to become more complicated. Each hop the message takes uses a simple We'll just be discussing the hop protocol, i.e. the SMTP replacement. Any definition of the end-to-end headers and routing would be built on top of the basic Hessian messaging. This discussion shows that Hessian's RPC mechanism is sufficient for handling messaging, without introducing any extra complications to the Hessian protocol itself. By choosing a layered protocol model, each protocol layer can be simple independent of the others. The message service sends a message from the client to the server. When you strip away all other complications, that's all messaging does. The message service method is simple. It consists of a single
method API package com.caucho.services.message; public interface MessageSender { public void send(java.util.HashMap headers, Object message) throws MessageServiceException; } The simplest messaging service receives text message to a URL. With that messaging service, only the message object is used and the headers are ignored. Many applications only need the most basic messaging protocol. Until the application needs messages to be forwarded and to have many middle servers, the simple use case is sufficient. The message service URL is the message destination. This example might use . Since this sample service ignores the headers, there's no forwarding of the message.Hessian call to send Hello, world message c x01 x00 -- hessian call m x00 x04 send -- the send method N -- null headers S x00 x0c Hello, world -- string message z -- end of request The Hessian packet does not need to contain the URL, since that's specified in the containing enveloper. For example, when using Hessian with HTTP, the HTTP request will specify the URL of the Hessian service. Sending a message from a Java clientAn application can use any Java client which can send Hessian to the message service. The standard HessianProxyFactory could be used. Calling the messaging service from Java uses HessianProxyFactory to create a client proxy. Once the client is available, the application can just start sending messages. Calling from Java String url = "http://foo.com/hessian/message/test-bean"; HessianProxyFactory factory = new HessianProxyFactory(); MessageSender sender; sender = (MessageSender) factory.create(MessageSender.class, url); sender.send(null, "Hello"); Calling from a Python clientSince Hessian is language-independent, any scripting languages with a Hessian implementation can send to a messaging service. For example, the Python Hessian library allows Python to send a message to a Hessian message service. Calling from Python import hessianlib; proxy = Hessian("http://foo.com/hessian/message/test-bean") proxy.send(None, "hello") Implementing the Service as an EJB Message BeanResin-Enterprise uses the Hessian MessageSender as a JMS (Java Message Service) protocol. So applications can use EJB MessageBeans to implement a message service. MessageBean implementation package test.hello; import javax.ejb.*; import javax.jms.*; public class MyMessageBean implements MessageDrivenBean, MessageListener { public void setMessageDrivenContext(MessageDrivenContext cxt) { } public void ejbCreate() { } public void onMessage(Message msg) { try { TextMessage textMessage = (TextMessage) msg; String text = textMessage.getText(); System.out.println("MESSAGE: " + text); } catch (JMSException e) { } } public void ejbRemove() { } } The EJB deployment descriptor and the EJB server configuration are implemented in the usual way. In this case, the bean name would be .web.xml entries to configure the EJB server <-- configure the EJB server --> <resource-ref> <res-ref-name>java:comp/env/cmp</res-ref-name> <class-name>com.caucho.ejb.EJBService</class-name> </resource-ref> <-- configure the Hessian protocol --> <servlet-mapping> <url-pattern>/hessian/*</url-pattern> <servlet-name>com.caucho.ejb.hessian.HessianServlet</servlet-name> </servlet-mappin> Routing parameters are contained in the headers map. For example, Java's messaging service (JMS) defines a number of routing headers. These headers could be used for more sophisticated mail routing than point to point. Defining the routing headers is beyond the aim of this page. The important point to note is that the routing protocol is built on top of the Hessian messaging service which is built on Hessian. Hessian itself does not need to be complicated with the routing headers. In some sense, this protocol is too simple. That's the point. By designing the messaging protocol as a layered system, each layer can be simple. So a simple messaging service will be easy, and complicated messaging routing services are still possible.
|