public abstract class AbstractMessageEndpointFactory
extends java.lang.Object
javax.resource.spi.endpoint.MessageEndpointFactory
interface,
providing transaction management capabilities as well as ClassLoader
exposure for endpoint invocations.setTransactionManager(java.lang.Object)
Modifier and Type | Class and Description |
---|---|
protected class |
AbstractMessageEndpointFactory.AbstractMessageEndpoint
Inner class for actual endpoint implementations, based on template
method to allow for any kind of concrete endpoint implementation.
|
private class |
AbstractMessageEndpointFactory.TransactionDelegate
Private inner class that performs the actual transaction handling,
including enlistment of the endpoint's XAResource.
|
Modifier and Type | Field and Description |
---|---|
protected Log |
logger
Logger available to subclasses
|
private TransactionFactory |
transactionFactory |
private java.lang.String |
transactionName |
private int |
transactionTimeout |
Constructor and Description |
---|
AbstractMessageEndpointFactory() |
Modifier and Type | Method and Description |
---|---|
MessageEndpoint |
createEndpoint(javax.transaction.xa.XAResource xaResource)
The standard JCA 1.5 version of
createEndpoint . |
MessageEndpoint |
createEndpoint(javax.transaction.xa.XAResource xaResource,
long timeout)
The alternative JCA 1.6 version of
createEndpoint . |
protected abstract AbstractMessageEndpointFactory.AbstractMessageEndpoint |
createEndpointInternal()
Create the actual endpoint instance, as a subclass of the
AbstractMessageEndpointFactory.AbstractMessageEndpoint inner class of this factory. |
boolean |
isDeliveryTransacted(java.lang.reflect.Method method)
This implementation returns
true if a transaction manager
has been specified; false otherwise. |
void |
setTransactionFactory(TransactionFactory transactionFactory)
Set the Spring TransactionFactory to use for wrapping endpoint
invocations, enlisting the endpoint resource in each such transaction.
|
void |
setTransactionManager(java.lang.Object transactionManager)
Set the the XA transaction manager to use for wrapping endpoint
invocations, enlisting the endpoint resource in each such transaction.
|
void |
setTransactionName(java.lang.String transactionName)
Specify the name of the transaction, if any.
|
void |
setTransactionTimeout(int transactionTimeout)
Specify the transaction timeout, if any.
|
protected final Log logger
private TransactionFactory transactionFactory
private java.lang.String transactionName
private int transactionTimeout
public void setTransactionManager(java.lang.Object transactionManager)
The passed-in object may be a transaction manager which implements
Spring's TransactionFactory
interface, or a plain javax.transaction.TransactionManager
.
If no transaction manager is specified, the endpoint invocation will simply not be wrapped in an XA transaction. Check out your resource provider's ActivationSpec documentation for local transaction options of your particular provider.
public void setTransactionFactory(TransactionFactory transactionFactory)
Alternatively, specify an appropriate transaction manager through
the "transactionManager"
property.
If no transaction factory is specified, the endpoint invocation will simply not be wrapped in an XA transaction. Check out your resource provider's ActivationSpec documentation for local transaction options of your particular provider.
public void setTransactionName(java.lang.String transactionName)
Default is none. A specified name will be passed on to the transaction manager, allowing to identify the transaction in a transaction monitor.
public void setTransactionTimeout(int transactionTimeout)
Default is -1: rely on the transaction manager's default timeout. Specify a concrete timeout to restrict the maximum duration of each endpoint invocation.
public boolean isDeliveryTransacted(java.lang.reflect.Method method) throws java.lang.NoSuchMethodException
true
if a transaction manager
has been specified; false
otherwise.java.lang.NoSuchMethodException
setTransactionManager(java.lang.Object)
,
setTransactionFactory(org.springframework.transaction.jta.TransactionFactory)
public MessageEndpoint createEndpoint(javax.transaction.xa.XAResource xaResource) throws UnavailableException
createEndpoint
.
This implementation delegates to createEndpointInternal()
,
initializing the endpoint's XAResource before the endpoint gets invoked.
UnavailableException
public MessageEndpoint createEndpoint(javax.transaction.xa.XAResource xaResource, long timeout) throws UnavailableException
createEndpoint
.
This implementation delegates to createEndpointInternal()
,
ignoring the specified timeout. It is only here for JCA 1.6 compliance.
UnavailableException
protected abstract AbstractMessageEndpointFactory.AbstractMessageEndpoint createEndpointInternal() throws UnavailableException
AbstractMessageEndpointFactory.AbstractMessageEndpoint
inner class of this factory.null
)UnavailableException
- if no endpoint is available at present