Package com.sun.enterprise.transaction.config

Interface TransactionService

All Superinterfaces:

ConfigBeanProxy, ConfigExtension, Container, PropertyBag

public interface TransactionService
extends ConfigBeanProxy, PropertyBag, ConfigExtension, Container

Configuration for Transaction Manager

Nested Class Summary

Nested classes/interfaces inherited from interface org.jvnet.hk2.config.ConfigBeanProxy

ConfigBeanProxy.Duck

Nested classes/interfaces inherited from interface org.jvnet.hk2.config.types.PropertyBag

PropertyBag.Duck

Method Summary

Modifier and Type	Method	Description
String	getAutomaticRecovery()	Gets the value of the automaticRecovery property.
String	getHeuristicDecision()	Gets the value of the heuristicDecision property.
String	getKeypointInterval()	Gets the value of the keypointInterval property.
List<Property>	getProperty()	Properties.
String	getRetryTimeoutInSeconds()	Gets the value of the retryTimeoutInSeconds property.
String	getTimeoutInSeconds()	Gets the value of the timeoutInSeconds property.
String	getTxLogDir()	Gets the value of the txLogDir property.
void	setAutomaticRecovery(String value)	Sets the value of the automaticRecovery property.
void	setHeuristicDecision(String value)	Sets the value of the heuristicDecision property.
void	setKeypointInterval(String value)	Sets the value of the keypointInterval property.
void	setRetryTimeoutInSeconds(String value)	Sets the value of the retryTimeoutInSeconds property.
void	setTimeoutInSeconds(String value)	Sets the value of the timeoutInSeconds property.
void	setTxLogDir(String value)	Sets the value of the txLogDir property.

Methods inherited from interface org.jvnet.hk2.config.ConfigBeanProxy

createChild, deepCopy, getParent, getParent

Methods inherited from interface org.jvnet.hk2.config.types.PropertyBag

addProperty, getProperty, getPropertyValue, getPropertyValue, lookupProperty, removeProperty, removeProperty

Method Detail

getAutomaticRecovery

String getAutomaticRecovery()

Gets the value of the automaticRecovery property. If true, server instance attempts recovery at restart

Returns:

possible object is String

setAutomaticRecovery

void setAutomaticRecovery(String value)
                   throws PropertyVetoException

Sets the value of the automaticRecovery property.

Parameters:

value - allowed object is String

Throws:

PropertyVetoException

getTimeoutInSeconds

String getTimeoutInSeconds()

Gets the value of the timeoutInSeconds property. amount of time the transaction manager waits for response from a datasource participating in transaction. A value of 0 implies infinite timeout

Returns:

possible object is String

setTimeoutInSeconds

void setTimeoutInSeconds(String value)
                  throws PropertyVetoException

Sets the value of the timeoutInSeconds property.

Parameters:

value - allowed object is String

Throws:

PropertyVetoException

getTxLogDir

String getTxLogDir()

Gets the value of the txLogDir property. Transaction service creates a sub directory 'tx' under tx-log-dir to store the transaction logs. The default value of the tx-log-dir is $INSTANCE-ROOT/logs. If this attribute is not explicitly specified in the element, 'tx' sub directory will be created under the path specified in log-root attribute of element.

Returns:

possible object is String

setTxLogDir

void setTxLogDir(String value)
          throws PropertyVetoException

Sets the value of the txLogDir property.

Parameters:

value - allowed object is String

Throws:

PropertyVetoException

getHeuristicDecision

String getHeuristicDecision()

Gets the value of the heuristicDecision property. During recovery, if outcome of a transaction cannot be determined from the logs, then this property is used to fix the outcome

Returns:

possible object is String

setHeuristicDecision

void setHeuristicDecision(String value)
                   throws PropertyVetoException

Sets the value of the heuristicDecision property.

Parameters:

value - allowed object is String

Throws:

PropertyVetoException

getRetryTimeoutInSeconds

String getRetryTimeoutInSeconds()

Gets the value of the retryTimeoutInSeconds property. Used to determine the retry time in the following scenarios. 1 Time to wait at the transaction recovery time, when resources are unreachable. 2 If there are any transient exceptions in the second phase of the two PC protocol. A negative value indicates infinite retry. '0' indicates no retry. A positive value indicates the number of seconds for which retry will be attempted. Default is 10 minutes which may be appropriate for a database being restarted

Returns:

possible object is String

setRetryTimeoutInSeconds

void setRetryTimeoutInSeconds(String value)
                       throws PropertyVetoException

Sets the value of the retryTimeoutInSeconds property.

Parameters:

value - allowed object is String

Throws:

PropertyVetoException

getKeypointInterval

String getKeypointInterval()

Gets the value of the keypointInterval property. property used to specify the number of transactions between keypoint operations on the log. A Keypoint operations could reduce the size of the transaction log files. A larger value for this property (for example, 1000) will result in larger transaction log files, between log compactions, but less keypoint operations, and potentially better performance. A smaller value (e.g. 20) results in smaller log files but slightly reduced performance due to the greater frequency of keypoint operations.

Returns:

possible object is String

setKeypointInterval

void setKeypointInterval(String value)
                  throws PropertyVetoException

Sets the value of the keypointInterval property.

Parameters:

value - allowed object is String

Throws:

PropertyVetoException

getProperty

@PropertyDesc(name="oracle-xa-recovery-workaround",defaultValue="true",dataType=java.lang.Boolean.class,description="If true, the Oracle XA Resource workaround is used in transaction recovery") @PropertyDesc(name="disable-distributed-transaction-logging",defaultValue="false",dataType=java.lang.Boolean.class,description="If true, disables transaction logging, which might improve performance. If the automatic-recovery attribute is set to true , this property is ignored") @PropertyDesc(name="xaresource-txn-timeout",defaultValue="120",dataType=PositiveInteger.class,description=" Changes the XAResource timeout. In some cases, the XAResource default timeout can cause transactions to be aborted, so it is desirable to change it") @PropertyDesc(name="pending-txn-cleanup-interval",defaultValue="60",dataType=PositiveInteger.class,description="Interval in seconds at which an asynchronous thread checks for pending transactions and completes them") @PropertyDesc(name="use-last-agent-optimization",defaultValue="true",dataType=java.lang.Boolean.class,description="Enables last agent optimization, which improves the throughput of transactions. If one non-XA resource is used with XA resources in the same transaction, the non XA resource is the last agent") @PropertyDesc(name="wait-time-before-recovery-insec",defaultValue="60",dataType=PositiveInteger.class,description="Wait time in seconds after which an instance starts the recovery for a dead instance") @PropertyDesc(name="db-logging-resource",description="db-logging-resource NDI name of the JDBC resource for the database to which transactions are logged")
List<Property> getProperty()

Properties.

Specified by:

getProperty in interface PropertyBag

Returns:

the property list