com.goldencode.p2j.util

Class TransactionImpl

java.lang.Object

com.goldencode.p2j.util.HandleResource

com.goldencode.p2j.util.TransactionImpl

All Implemented Interfaces:

CommonHandle, Deletable, InstantiatingProcedure, Openable, TransactionResource, WrappedResource, Printable

public class TransactionImpl
extends HandleResource
implements TransactionResource, Deletable

Implements the TRANSACTION resources and all associated APIs.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	TransactionImpl.WorkArea Context-local state.

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	defaultCommit The current value of the DEFAULT-COMMIT attribute.
private static CentralLogger	LOG Logger
private boolean	openByTxInitProc Flag indicating the current tx was open by TRANS-INIT-PROCEDURE.
private boolean	pendingCommit Flag turned on when a pending commit is active, via setCommit().
private boolean	pendingRollback Flag turned on when a pending rollback is active, via setRollback().
private handle	txInitProcedure The current value of the TRANS-INIT-PROCEDURE attribute.
private static ContextLocal<TransactionImpl.WorkArea>	work Context local state for the TRANSACTION handle.

Fields inherited from class com.goldencode.p2j.util.HandleResource

instProc, pm

Constructor Summary

Constructors

Modifier	Constructor and Description
private	TransactionImpl() Private c'tor, to allow a singleton instance of this resource, per each context.

Method Summary

Modifier and Type	Method and Description
void	delete() Perform actual delete of an resource.
(package private) static TransactionImpl	get() Get the TRANSACTION resource for this context.
handle	getTxInitProcedure() Get the TRANS-INIT-PROCEDURE attribute.
handle	instantiatingProcedure() Getter for the INSTANTIATING-PROCEDURE attribute.
logical	isDefaultCommit() Check the value of the DEFAULT-COMMIT attribute.
logical	isOpen() Getter of IS-OPEN attribute - it will return the value of the TransactionManager.isTransactionActive() call.
(package private) static boolean	isOpenByTxInitProc() Get the openByTxInitProc flag.
(package private) static boolean	isTxInitProcedure(java.lang.Object referent) Check if the given external program instance is the TRANS-INIT-PROCEDURE attribute.
(package private) static boolean	requestFinished(boolean chained, boolean implicit) Notification that a top-level request has been finished, in the context of a top-level block belonging to the TRANS-INIT-PROCEDURE external program.
logical	setCommit() If we are in a TRANSACTION-MODE AUTOMATIC state and a tx is open, mark a pending commit for the current top-level block.
void	setDefaultCommit(boolean l) Set the value of the DEFAULT-COMMIT attribute.
void	setDefaultCommit(logical l) Set the value of the DEFAULT-COMMIT attribute.
(package private) static void	setOpenByTxInitProc(boolean l) Set the openByTxInitProc flag.
logical	setRollback() If we are in a TRANSACTION-MODE AUTOMATIC state and a tx is open, mark a pending rollback for the current top-level block.
(package private) static void	setTxInitProcedure(java.lang.Object referent) Explicitly assign the TRANS-INIT-PROCEDURE attribute.
boolean	valid() Implementation for the WrappedResource.valid() API.

Methods inherited from class com.goldencode.p2j.util.HandleResource

_instantiatingProcedure, addToPool, doDelete, equals, hashCode, id, id, implicitDeletion, incrementTrigger, invalidAttribute, processResource, readOnlyError, readOnlyError, registerResource, resourceDelete, resourceType, setInstantiatingProcedure, toString, type, unableToAssignUnknown, unknown

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.goldencode.p2j.util.Deletable

allowDelete

Methods inherited from interface com.goldencode.util.Printable

asString, print

Field Detail

LOG

private static final CentralLogger LOG

Logger

work

private static final ContextLocal<TransactionImpl.WorkArea> work

Context local state for the TRANSACTION handle.

txInitProcedure

private handle txInitProcedure

The current value of the TRANS-INIT-PROCEDURE attribute.

defaultCommit

private boolean defaultCommit

The current value of the DEFAULT-COMMIT attribute.

pendingRollback

private boolean pendingRollback

Flag turned on when a pending rollback is active, via setRollback().

pendingCommit

private boolean pendingCommit

Flag turned on when a pending commit is active, via setCommit().

openByTxInitProc

private boolean openByTxInitProc

Flag indicating the current tx was open by TRANS-INIT-PROCEDURE.

Constructor Detail

TransactionImpl

private TransactionImpl()

Private c'tor, to allow a singleton instance of this resource, per each context.

Method Detail

get

static TransactionImpl get()

Get the TRANSACTION resource for this context.

Returns:

See above.

valid

public boolean valid()

Implementation for the WrappedResource.valid() API.

Specified by:

valid in interface WrappedResource

Returns:

Always true.

delete

public void delete()

Description copied from class: HandleResource

Perform actual delete of an resource. At the time of this call, it is assumed the resource is valid for deletion (the handle and the resource are both valid).

The method first calls HandleResource.resourceDelete(), if the method returns false, the deletion is aborted.

Specified by:

delete in interface Deletable

Overrides:

delete in class HandleResource

instantiatingProcedure

public handle instantiatingProcedure()

Getter for the INSTANTIATING-PROCEDURE attribute.

Specified by:

instantiatingProcedure in interface InstantiatingProcedure

Overrides:

instantiatingProcedure in class HandleResource

Returns:

Always an unknown handle.

isOpen

public logical isOpen()

Getter of IS-OPEN attribute - it will return the value of the TransactionManager.isTransactionActive() call.

Specified by:

isOpen in interface Openable

Returns:

See above.

isDefaultCommit

public logical isDefaultCommit()

Check the value of the DEFAULT-COMMIT attribute.

Specified by:

isDefaultCommit in interface TransactionResource

Returns:

The value of the DEFAULT-COMMIT attribute.

setDefaultCommit

public void setDefaultCommit(logical l)

Set the value of the DEFAULT-COMMIT attribute.

Specified by:

setDefaultCommit in interface TransactionResource

Parameters:

l - The value of the DEFAULT-COMMIT attribute.

setDefaultCommit

public void setDefaultCommit(boolean l)

Set the value of the DEFAULT-COMMIT attribute.

Specified by:

setDefaultCommit in interface TransactionResource

Parameters:

l - The value of the DEFAULT-COMMIT attribute.

getTxInitProcedure

public handle getTxInitProcedure()

Get the TRANS-INIT-PROCEDURE attribute.

Specified by:

getTxInitProcedure in interface TransactionResource

Returns:

See above.

setCommit

public logical setCommit()

If we are in a TRANSACTION-MODE AUTOMATIC state and a tx is open, mark a pending commit for the current top-level block.

Specified by:

setCommit in interface TransactionResource

Returns:

true if the pending commit was set or a tx is not open.

setRollback

public logical setRollback()

If we are in a TRANSACTION-MODE AUTOMATIC state and a tx is open, mark a pending rollback for the current top-level block.

Specified by:

setRollback in interface TransactionResource

Returns:

true if the pending rollback was set or a tx is not open.

setTxInitProcedure

static void setTxInitProcedure(java.lang.Object referent)

Explicitly assign the TRANS-INIT-PROCEDURE attribute.

Parameters:

referent - The new procedure having a TRANSACTION-MODE AUTOMATIC statement, or null to clear this attribute and the pending flags.

isTxInitProcedure

static boolean isTxInitProcedure(java.lang.Object referent)

Check if the given external program instance is the TRANS-INIT-PROCEDURE attribute.

Parameters:

referent - The external program instance to check.

Returns:

true if the refernet is the same as the txInitProcedure.

isOpenByTxInitProc

static boolean isOpenByTxInitProc()

Get the openByTxInitProc flag.

Returns:

The state of the openByTxInitProc.

setOpenByTxInitProc

static void setOpenByTxInitProc(boolean l)

Set the openByTxInitProc flag.

Parameters:

l - The new state of the openByTxInitProc.

requestFinished

static boolean requestFinished(boolean chained,
                               boolean implicit)

Notification that a top-level request has been finished, in the context of a top-level block belonging to the TRANS-INIT-PROCEDURE external program.

Parameters:

chained - Flag indicating a new tx will be opened.

implicit - Flag indicating if this call is for the implicit end of a request, not the delete of the tx procedure.

Returns:

true if there is either a pending commit or rollback.