FileDocCategorySizeDatePackage
ExecutionContext.javaAPI DocGlassfish v2 API5221Fri May 04 22:35:38 BST 2007javax.resource.spi.work

ExecutionContext

public class ExecutionContext extends Object
This class models an execution context (transaction, security, etc) with which the Work instance must be executed. This class is provided as a convenience for easily creating ExecutionContext instances by extending this class and overriding only those methods of interest.

Some reasons why it is better for ExecutionContext to be a class rather than an interface:

  • There is no need for a resource adapter to implement this class. It only needs to implement the context information like transaction, etc.
  • The resource adapter code does not have to change when the ExecutionContext class evolves. For example, more context types could be added to the ExecutionContext class (in the future) without forcing resource adapter implementations to change.
version
1.0
author
Ram Jeyaraman

Fields Summary
private Xid
xid
transaction context.
private long
transactionTimeout
transaction timeout value.
Constructors Summary
Methods Summary
public longgetTransactionTimeout()
Get the transaction timeout value for a imported transaction.

return
the specified transaction timeout value in seconds. When no timeout value or an illegal timeout value had been specified, a value of -1 (WorkManager.UNKNOWN) is returned; such a transaction is excluded from regular timeout processing.

	return this.transactionTimeout;
public javax.transaction.xa.XidgetXid()

 return this.xid;
public voidsetTransactionTimeout(long timeout)
Set the transaction timeout value for a imported transaction.

param
timeout transaction timeout value in seconds. Only positive non-zero values are accepted. Other values are illegal and are rejected with a NotSupportedException.
throws
NotSupportedException thrown to indicate an illegal timeout value.

	if (timeout > 0) {
	    this.transactionTimeout = timeout;
	} else {
	    throw new NotSupportedException("Illegal timeout value");
	}
public voidsetXid(javax.transaction.xa.Xid xid)
set a transaction context.

param
xid transaction context.


           
    //private SecurityContext securityCtx;

                 
         this.xid = xid;