org.objectweb.petals.tools.rmi.server.remote.interfaces
Interface RemoteMessageExchangeFactory

All Superinterfaces:

java.rmi.Remote

All Known Implementing Classes:

RemoteMessageExchangeFactoryImpl

public interface RemoteMessageExchangeFactory
extends java.rmi.Remote

the rmi interface of MessageExchangeFactory.

Author:

nsalatge

Method Summary

javax.jbi.messaging.MessageExchange	createExchange(javax.xml.namespace.QName serviceName, javax.xml.namespace.QName operationName) TODO createExchange find an endpoint for the service at the ME creation Creates a new MessageExchange instance used to initiate a service invocation.
javax.jbi.messaging.MessageExchange	createExchange(java.net.URI pattern) Creates a new MessageExchange instance used to initiate a service invocation.
javax.jbi.messaging.InOnly	createInOnlyExchange() Convenience method that creates an In-Only message exchange.
javax.jbi.messaging.InOptionalOut	createInOptionalOutExchange() Convenience method that creates an In-Optional-Out message exchange.
javax.jbi.messaging.InOut	createInOutExchange() Convenience method that creates an In Out message exchange.
javax.jbi.messaging.RobustInOnly	createRobustInOnlyExchange() Convenience method that creates a Robust-In-Only message exchange.

Method Detail

createExchange

javax.jbi.messaging.MessageExchange createExchange(javax.xml.namespace.QName serviceName,
                                                   javax.xml.namespace.QName operationName)
                                                   throws javax.jbi.messaging.MessagingException,
                                                          java.rmi.RemoteException

TODO createExchange find an endpoint for the service at the ME creation Creates a new MessageExchange instance used to initiate a service invocation.

JBI defines a set of four basic message exchange types, corresponding to the predefined in-* WSDL 2.0 Message Exchange Patterns. Message exchanges of any type are created using the DeliveryChannel.

Parameters:

serviceName - the name of the service to be invoked; must be non-null

operationName - the name of the operation to be invoked; must be non-null and non-empty

Returns:

new message exchange, initialized for invoking the given service and operation; must be non-null

Throws:

javax.jbi.messaging.MessagingException - if the given service or operation are not registered with the NMR.

java.rmi.RemoteException - impossible to realize a remote access

javax.jbi.messaging.MessagingException - if the factory was created for a particular interface, and the given serviceName does not implement that interface.

createExchange

javax.jbi.messaging.MessageExchange createExchange(java.net.URI pattern)
                                                   throws javax.jbi.messaging.MessagingException,
                                                          java.rmi.RemoteException

Creates a new MessageExchange instance used to initiate a service invocation. JBI defines a set of four fundamental message exchange types which are created using binding and engine delivery channels. This base met0hod is provided for extensibility, to satisfy the need for vendor-specific message exchange patterns. The registration and administration of these patterns is not addressed by JBI.

Parameters:

pattern - message exchange pattern; must be non-null and non-empty

Returns:

new message exchange; must be non-null

Throws:

java.rmi.RemoteException - impossible to realize a remote access

javax.jbi.messaging.MessagingException - specified pattern is not registered to a message exchange type

createInOnlyExchange

javax.jbi.messaging.InOnly createInOnlyExchange()
                                                throws javax.jbi.messaging.MessagingException,
                                                       java.rmi.RemoteException

Convenience method that creates an In-Only message exchange.

Returns:

new InOnly message exchange; must be non-null

Throws:

java.rmi.RemoteException - impossible to realize a remote access

javax.jbi.messaging.MessagingException - failed to create exchange

createInOptionalOutExchange

javax.jbi.messaging.InOptionalOut createInOptionalOutExchange()
                                                              throws javax.jbi.messaging.MessagingException,
                                                                     java.rmi.RemoteException

Convenience method that creates an In-Optional-Out message exchange.

Returns:

new InOptionalOut message exchange; must be non-null

Throws:

java.rmi.RemoteException - impossible to realize a remote access

javax.jbi.messaging.MessagingException - failed to create exchange

createInOutExchange

javax.jbi.messaging.InOut createInOutExchange()
                                              throws javax.jbi.messaging.MessagingException,
                                                     java.rmi.RemoteException

Convenience method that creates an In Out message exchange.

Returns:

new InOut message exchange; must be non-null

Throws:

java.rmi.RemoteException - impossible to realize a remote access

javax.jbi.messaging.MessagingException - failed to create exchange

createRobustInOnlyExchange

javax.jbi.messaging.RobustInOnly createRobustInOnlyExchange()
                                                            throws javax.jbi.messaging.MessagingException,
                                                                   java.rmi.RemoteException

Convenience method that creates a Robust-In-Only message exchange.

Returns:

new RobustInOnly message exchange; must be non-null

Throws:

java.rmi.RemoteException - impossible to realize a remote access

javax.jbi.messaging.MessagingException - failed to create exchange