com.soa.messenger

Interface Messenger

public interface Messenger

Executes message exchanges with web services. The web service to communicate with is dictated by the information in the exchange. A Messenger is obtained from a MessengerService. The following shows how a messenger is obtained and then used to execute an in-out message exchange with a web service.

Method Summary

Modifier and Type	Method and Description
void	send(Exchange exchange) Sends the given exchange.
void	send(Exchange exchange, boolean audit) Sends the given exchange.

Method Detail

send

void send(Exchange exchange)
   throws GException

Sends the given exchange. If the exchanges is in-only no output message will be returned upon completion. If the exchange is in-out an output message will be returned. The exchange must be filled out properly with all addressing information in order to deliver it. The required information is a service, interface, and operation name.

Parameters:

exchange - Addressed Exchange

Throws:

GException - Thrown if unable to deliver the exchange, possibly due to not properly addressing the exchange or the target not being registered with the MessengerService.

send

void send(Exchange exchange,
          boolean audit)
   throws GException

Sends the given exchange. If the exchanges is in-only no output message will be returned upon completion. If the exchange is in-out an output message will be returned. The exchange must be filled out properly with all addressing information in order to deliver it. The required information is a service, interface, and operation name. The exchange can be audited if the audit flag is set to true and the call is made within the context of an exchange already being audited.

Parameters:

exchange - Addressed Exchange

audit - If true and if being called within the context of an exchange already being audited then the input and output messages will also be audited. If false no auditing will occur.

Throws:

GException - Thrown if unable to deliver the exchange, possibly due to not properly addressing the exchange or the target not being registered with the MessengerService.