FileDocCategorySizeDatePackage
MessageEndpointFactory.javaAPI DocGlassfish v2 API3923Fri May 04 22:35:38 BST 2007javax.resource.spi.endpoint

MessageEndpointFactory

public interface MessageEndpointFactory
This serves as a factory for creating message endpoints.
version
1.0
author
Ram Jeyaraman

Fields Summary
Constructors Summary
Methods Summary
public MessageEndpointcreateEndpoint(javax.transaction.xa.XAResource xaResource)
This is used to create a message endpoint. The message endpoint is expected to implement the correct message listener type.

param
xaResource an optional XAResource instance used to get transaction notifications when the message delivery is transacted.
return
a message endpoint instance.
throws
UnavailableException indicates a transient failure in creating a message endpoint. Subsequent attempts to create a message endpoint might succeed.

public booleanisDeliveryTransacted(java.lang.reflect.Method method)
This is used to find out whether message deliveries to a target method on a message listener interface that is implemented by a message endpoint will be transacted or not. The message endpoint may indicate its transacted delivery preferences (at a per method level) through its deployment descriptor. The message delivery preferences must not change during the lifetime of a message endpoint.

param
method description of a target method. This information about the intended target method allows an application server to find out whether the target method call will be transacted or not.
throws
NoSuchMethodException indicates that the specified method does not exist on the target endpoint.
return
true, if message endpoint requires transacted message delivery.