com.caucho.services.message

Interface MessageSender

All Known Implementing Classes:

MessageSenderResource

public interface MessageSender

Service API for a bare-bones message server.

A minimal message server only needs to implement the MessageSender interface. Keeping the server API simple makes it easier for implementations to start up message servers.

The MessageSender service is queue or topic specific. So there's no need for a To header if there's no routing involved. In other words, the service URL generally includes the queue or topic identifier, e.g.

 http://www.caucho.com/hessian/hessian/message?ejbid=topic-a
 

 
More complicated messaging topologies, including configurations
 with routing mesaging servers, will use the headers to define the
 final destination.  The headers have the same functional purpose as
 RFC-822 mail headers.

Method Summary

Modifier and Type	Method and Description
void	send(java.util.HashMap headers, java.lang.Object message) Send a message to the server.

Method Detail

send

void send(java.util.HashMap headers,
          java.lang.Object message)
   throws MessageServiceException

Send a message to the server.

Parameters:

headers - any message headers

message - the message data

Throws:

MessageServiceException - if the message cannot be delivered