li.strolch.persistence.api

Class AbstractTransaction

java.lang.Object

li.strolch.persistence.api.AbstractTransaction

All Implemented Interfaces:

AutoCloseable, StrolchTransaction

Direct Known Subclasses:

InMemoryTransaction

public abstract class AbstractTransaction
extends Object
implements StrolchTransaction

Author:

Robert von Burg

Field Summary

Fields

Modifier and Type	Field and Description
protected static org.slf4j.Logger	logger

Constructor Summary

Constructors

Constructor and Description
AbstractTransaction(PrivilegeHandler privilegeHandler, StrolchRealm realm, Certificate certificate, String action)

Method Summary

Modifier and Type	Method and Description
void	addCommand(Command command) Adds the given Command to the transaction.
Audit	auditFrom(AccessType accessType, String elementType, String elementSubType, String id) Helper method to create an Audit with the given arguments.
Audit	auditFrom(AccessType accessType, StrolchRootElement element) Helper method to create an Audit with the given arguments.
void	autoCloseableCommit() DO NOT CALL THIS METHOD.
void	autoCloseableDoNothing() DO NOT CALL THIS METHOD.
void	autoCloseableRollback() DO NOT CALL THIS METHOD.
void	close() DO NOT CALL THIS METHOD.
protected abstract void	commit()
void	commitOnClose() Sets the TransactionCloseStrategy to TransactionCloseStrategy.COMMIT
void	doNothingOnClose() Sets the TransactionCloseStrategy to TransactionCloseStrategy.DO_NOTHING
<U> List<U>	doQuery(ActivityQuery<U> query) Performs the given ActivityQuery and each returned Activity is passed through the ActivityVisitor attached to the ActivityQuery and the return value of the visitor is added to the return list
<U> List<U>	doQuery(AuditQuery<U> query) Performs the given AuditQuery and each returned Audit is passed through the AuditVisitor attached to the AuditQuery and the return value of the visitor is added to the return list
<U> List<U>	doQuery(OrderQuery<U> query) Performs the given OrderQuery and each returned Order is passed through the OrderVisitor attached to the OrderQuery and the return value of the visitor is added to the return list
<U> List<U>	doQuery(ResourceQuery<U> query) Performs the given ResourceQuery and each returned Resource is passed through the ResourceVisitor attached to the ResourceQuery and the return value of the visitor is added to the return list
StrolchTransactionException	fail(String string) Sets the TransactionCloseStrategy to TransactionCloseStrategy.ROLLBACK and returns a StrolchTransactionException which can be thrown by the caller to stop the exception
<T extends StrolchElement> T	findElement(Locator locator) Used to find a StrolchElement by a Locator.
void	flush() Performs all registered commands
List<Activity>	getActivitiesBy(StringListParameter refP) Returns all Activities which are referenced by the given StringListParameter.
List<Activity>	getActivitiesBy(StringListParameter refP, boolean assertExists) Returns all Activities which are referenced by the given StringListParameter.
Activity	getActivityBy(StringParameter refP) Returns the Activity which is referenced by the given StringParameter.
Activity	getActivityBy(StringParameter refP, boolean assertExists) Returns the Activity which is referenced by the given StringParameter.
Activity	getActivityBy(String type, String id) Returns the Activity with the given type and id, or null if it does not exist
Activity	getActivityBy(String type, String id, boolean assertExists) Returns the Activity with the given type and id, or null if it does not exist
ActivityMap	getActivityMap() Returns a reference to the ActivityMap for the StrolchRealm for which this transaction was opened
Activity	getActivityTemplate(String type) Returns a copy of the Activity of Type StrolchConstants.TEMPLATE with the given type as id, or null if it does not exist
Activity	getActivityTemplate(String type, boolean assertExists) Returns a copy of the Activity of Type StrolchConstants.TEMPLATE with the given type as id.
AuditTrail	getAuditTrail() Returns a reference to the AuditTrail for the StrolchRealm for which this transaction was opened
Certificate	getCertificate() Returns the Certificate which allowed this TX to be opened
TransactionCloseStrategy	getCloseStrategy() Returns the currently set TransactionCloseStrategy
Order	getOrderBy(StringParameter refP) Returns the Order which is referenced by the given StringParameter.
Order	getOrderBy(StringParameter refP, boolean assertExists) Returns the Order which is referenced by the given StringParameter.
Order	getOrderBy(String type, String id) Returns the Order with the given type and id, or null if it does not exist
Order	getOrderBy(String type, String id, boolean assertExists) Returns the Order with the given type and id, or null if it does not exist
OrderMap	getOrderMap() Returns a reference to the OrderMap for the StrolchRealm for which this transaction was opened
List<Order>	getOrdersBy(StringListParameter refP) Returns all Orders which are referenced by the given StringListParameter.
List<Order>	getOrdersBy(StringListParameter refP, boolean assertExists) Returns all Orders which are referenced by the given StringListParameter.
Order	getOrderTemplate(String type) Returns a copy of the Order of Type StrolchConstants.TEMPLATE with the given type as id, or null if it does not exist
Order	getOrderTemplate(String type, boolean assertExists) Returns a copy of the Order of Type StrolchConstants.TEMPLATE with the given type as id.
StrolchRealm	getRealm()
String	getRealmName() Returns the name of the StrolchRealm for which this transaction was opened
Resource	getResourceBy(StringParameter refP) Returns the Resource which is referenced by the given StringParameter.
Resource	getResourceBy(StringParameter refP, boolean assertExists) Returns the Resource which is referenced by the given StringParameter.
Resource	getResourceBy(String type, String id) Returns the Resource with the given type and id, or null if it does not exist
Resource	getResourceBy(String type, String id, boolean assertExists) Returns the Resource with the given type and id, or null if it does not exist
ResourceMap	getResourceMap() Returns a reference to the ResourceMap for the StrolchRealm for which this transaction was opened
List<Resource>	getResourcesBy(StringListParameter refP) Returns all Resources which are referenced by the given StringListParameter.
List<Resource>	getResourcesBy(StringListParameter refP, boolean assertExists) Returns all Resources which are referenced by the given StringListParameter.
Resource	getResourceTemplate(String type) Returns a copy of the Resource of Type StrolchConstants.TEMPLATE with the given type as id, or null if it does not exist
Resource	getResourceTemplate(String type, boolean assertExists) Returns a copy of the Resource of Type StrolchConstants.TEMPLATE with the given type as id.
TransactionState	getState()
TransactionResult	getTxResult()
protected void	handleFailure(long closeStartNanos, Exception e)
boolean	isClosing()
boolean	isCommitting()
boolean	isRollingBack()
boolean	isSuppressAudits() Returns true if writing Audits is currently suppressed
boolean	isSuppressDoNothingLogging() Returns true if logging of a TransactionCloseStrategy.DO_NOTHING should be suppressed
boolean	isSuppressUpdates() Returns true if the observer updates are currently suppressed
boolean	isVersioningEnabled() Returns true if versioning is enabled on the StrolchRealm for which this transaction has been opened
<T extends StrolchRootElement> void	lock(T element) Locks the given element and registers it on the transaction so the lock is released when the transaction is closed
<T extends StrolchRootElement> void	releaseLock(T element) Releases the lock of the given element so that even though the transaction is still open, another thread/transaction can lock the element
protected abstract void	rollback()
void	rollbackOnClose() Sets the TransactionCloseStrategy to TransactionCloseStrategy.ROLLBACK
void	setSuppressAudits(boolean suppressAudits) If the given argument is true, then no Audits are written
void	setSuppressDoNothingLogging(boolean quietDoNothing) If the given argument is true, then logging of a TransactionCloseStrategy.DO_NOTHING will be suppressed
void	setSuppressUpdates(boolean suppressUpdates) If the given argument is true, then no observer updates are performed
protected abstract void	writeChanges()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface li.strolch.persistence.api.StrolchTransaction

getPersistenceHandler

Field Detail

logger

protected static final org.slf4j.Logger logger

Constructor Detail

AbstractTransaction

public AbstractTransaction(PrivilegeHandler privilegeHandler,
                           StrolchRealm realm,
                           Certificate certificate,
                           String action)

Method Detail

getTxResult

public TransactionResult getTxResult()

getState

public TransactionState getState()

Specified by:

getState in interface StrolchTransaction

Returns:

the current state of the transaction

See Also:

TransactionState

isRollingBack

public boolean isRollingBack()

Specified by:

isRollingBack in interface StrolchTransaction

Returns:

if the current state of the StrolchTransaction is TransactionState.ROLLING_BACK

isCommitting

public boolean isCommitting()

Specified by:

isCommitting in interface StrolchTransaction

Returns:

if the current state of the StrolchTransaction is TransactionState.COMMITTING

isClosing

public boolean isClosing()

Specified by:

isClosing in interface StrolchTransaction

Returns:

if the current state of the StrolchTransaction is TransactionState.CLOSING

getRealmName

public String getRealmName()

Description copied from interface: StrolchTransaction

Returns the name of the StrolchRealm for which this transaction was opened

Specified by:

getRealmName in interface StrolchTransaction

Returns:

the name of the StrolchRealm for which this transaction was opened

getRealm

public StrolchRealm getRealm()

getCertificate

public Certificate getCertificate()

Description copied from interface: StrolchTransaction

Returns the Certificate which allowed this TX to be opened

Specified by:

getCertificate in interface StrolchTransaction

Returns:

the Certificate which allowed this TX to be opened

getCloseStrategy

public TransactionCloseStrategy getCloseStrategy()

Description copied from interface: StrolchTransaction

Returns the currently set TransactionCloseStrategy

Specified by:

getCloseStrategy in interface StrolchTransaction

Returns:

the currently set TransactionCloseStrategy

close

public void close()
           throws StrolchTransactionException

Description copied from interface: StrolchTransaction

DO NOT CALL THIS METHOD. This interface implements AutoCloseable and transactions are expected to be used in a auto closing try block:

StrolchAgent strolchAgent = getStrolchAgent(); StrolchRealm realm = strolchAgent.getContainer().getRealm("defaultRealm"); try(StrolchTransaction tx = realm.openTx(certificate, getClass())){ // do work tx.commitOnClose(); } After the block is closed, the transaction is automatically closed and all allocated resources are released

Specified by:

close in interface AutoCloseable

Specified by:

close in interface StrolchTransaction

Throws:

StrolchTransactionException

doNothingOnClose

public void doNothingOnClose()

Description copied from interface: StrolchTransaction

Sets the TransactionCloseStrategy to TransactionCloseStrategy.DO_NOTHING

Specified by:

doNothingOnClose in interface StrolchTransaction

commitOnClose

public void commitOnClose()

Description copied from interface: StrolchTransaction

Sets the TransactionCloseStrategy to TransactionCloseStrategy.COMMIT

Specified by:

commitOnClose in interface StrolchTransaction

rollbackOnClose

public void rollbackOnClose()

Description copied from interface: StrolchTransaction

Sets the TransactionCloseStrategy to TransactionCloseStrategy.ROLLBACK

Specified by:

rollbackOnClose in interface StrolchTransaction

fail

public StrolchTransactionException fail(String string)

Description copied from interface: StrolchTransaction

Sets the TransactionCloseStrategy to TransactionCloseStrategy.ROLLBACK and returns a StrolchTransactionException which can be thrown by the caller to stop the exception

Specified by:

fail in interface StrolchTransaction

Returns:

a StrolchTransactionException to be thrown by the caller

setSuppressUpdates

public void setSuppressUpdates(boolean suppressUpdates)

Description copied from interface: StrolchTransaction

If the given argument is true, then no observer updates are performed

Specified by:

setSuppressUpdates in interface StrolchTransaction

Parameters:

suppressUpdates - true to suppress the updates, false to enable them

isSuppressUpdates

public boolean isSuppressUpdates()

Description copied from interface: StrolchTransaction

Returns true if the observer updates are currently suppressed

Specified by:

isSuppressUpdates in interface StrolchTransaction

Returns:

true if the observer updates are currently suppressed

setSuppressAudits

public void setSuppressAudits(boolean suppressAudits)

Description copied from interface: StrolchTransaction

If the given argument is true, then no Audits are written

Specified by:

setSuppressAudits in interface StrolchTransaction

Parameters:

suppressAudits - true to suppress writing Audits, false to enable them

isSuppressAudits

public boolean isSuppressAudits()

Description copied from interface: StrolchTransaction

Returns true if writing Audits is currently suppressed

Specified by:

isSuppressAudits in interface StrolchTransaction

Returns:

true if writing Audits is currently suppressed

isSuppressDoNothingLogging

public boolean isSuppressDoNothingLogging()

Description copied from interface: StrolchTransaction

Returns true if logging of a TransactionCloseStrategy.DO_NOTHING should be suppressed

Specified by:

isSuppressDoNothingLogging in interface StrolchTransaction

Returns:

true if logging of a TransactionCloseStrategy.DO_NOTHING should be suppressed

setSuppressDoNothingLogging

public void setSuppressDoNothingLogging(boolean quietDoNothing)

Description copied from interface: StrolchTransaction

If the given argument is true, then logging of a TransactionCloseStrategy.DO_NOTHING will be suppressed

Specified by:

setSuppressDoNothingLogging in interface StrolchTransaction

isVersioningEnabled

public boolean isVersioningEnabled()

Description copied from interface: StrolchTransaction

Returns true if versioning is enabled on the StrolchRealm for which this transaction has been opened

Specified by:

isVersioningEnabled in interface StrolchTransaction

Returns:

true if versioning is enabled

lock

public <T extends StrolchRootElement> void lock(T element)
                                         throws StrolchLockException

Description copied from interface: StrolchTransaction

Locks the given element and registers it on the transaction so the lock is released when the transaction is closed

Specified by:

lock in interface StrolchTransaction

Parameters:

element - the element to lock

Throws:

StrolchLockException

releaseLock

public <T extends StrolchRootElement> void releaseLock(T element)
                                                throws StrolchLockException

Description copied from interface: StrolchTransaction

Releases the lock of the given element so that even though the transaction is still open, another thread/transaction can lock the element

Specified by:

releaseLock in interface StrolchTransaction

Parameters:

element - the element for which the lock is to be released

Throws:

StrolchLockException

addCommand

public void addCommand(Command command)

Description copied from interface: StrolchTransaction

Adds the given Command to the transaction. Using this method guarantees that a Command is executed properly:

• Command.validate()
• Command.doCommand()

and if an exception occurs:

• Command.undo()

Specified by:

addCommand in interface StrolchTransaction

getResourceMap

public ResourceMap getResourceMap()

Description copied from interface: StrolchTransaction

Returns a reference to the ResourceMap for the StrolchRealm for which this transaction was opened

Specified by:

getResourceMap in interface StrolchTransaction

Returns:

the ResourceMap

getOrderMap

public OrderMap getOrderMap()

Description copied from interface: StrolchTransaction

Returns a reference to the OrderMap for the StrolchRealm for which this transaction was opened

Specified by:

getOrderMap in interface StrolchTransaction

Returns:

the OrderMap

getActivityMap

public ActivityMap getActivityMap()

Description copied from interface: StrolchTransaction

Returns a reference to the ActivityMap for the StrolchRealm for which this transaction was opened

Specified by:

getActivityMap in interface StrolchTransaction

Returns:

the ActivityMap

getAuditTrail

public AuditTrail getAuditTrail()

Description copied from interface: StrolchTransaction

Returns a reference to the AuditTrail for the StrolchRealm for which this transaction was opened

Specified by:

getAuditTrail in interface StrolchTransaction

Returns:

the AuditTrail

doQuery

public <U> List<U> doQuery(OrderQuery<U> query)

Description copied from interface: StrolchTransaction

Performs the given OrderQuery and each returned Order is passed through the OrderVisitor attached to the OrderQuery and the return value of the visitor is added to the return list

Specified by:

doQuery in interface StrolchTransaction

Parameters:

query - the query to perform

Returns:

the result list of elements as returned by the OrderVisitor, never null

doQuery

public <U> List<U> doQuery(ResourceQuery<U> query)

Description copied from interface: StrolchTransaction

Performs the given ResourceQuery and each returned Resource is passed through the ResourceVisitor attached to the ResourceQuery and the return value of the visitor is added to the return list

Specified by:

doQuery in interface StrolchTransaction

Parameters:

query - the query to perform

Returns:

the result list of elements as returned by the ResourceVisitor, never null

doQuery

public <U> List<U> doQuery(ActivityQuery<U> query)

Description copied from interface: StrolchTransaction

Performs the given ActivityQuery and each returned Activity is passed through the ActivityVisitor attached to the ActivityQuery and the return value of the visitor is added to the return list

Specified by:

doQuery in interface StrolchTransaction

Parameters:

query - the query to perform

Returns:

the result list of elements as returned by the ActivityVisitor, never null

doQuery

public <U> List<U> doQuery(AuditQuery<U> query)

Description copied from interface: StrolchTransaction

Performs the given AuditQuery and each returned Audit is passed through the AuditVisitor attached to the AuditQuery and the return value of the visitor is added to the return list

Specified by:

doQuery in interface StrolchTransaction

Parameters:

query - the query to perform

Returns:

the result list of elements as returned by the AuditVisitor, never null

findElement

public <T extends StrolchElement> T findElement(Locator locator)

Description copied from interface: StrolchTransaction

Used to find a StrolchElement by a Locator.

A Locator has the form <ObjectClassType>/<Type>/<Id> - this is the least amount of path elements to find an object. Thus to query a Resource of type "MyType" and the id "@1" use the following path: Resourcee/MyType/@1

This method can also be used to find a deeper element, e.g. a specific Parameter on an ParameterBag on an Order. This would be done as follows: Order/MyType/@1/myParam

Specified by:

findElement in interface StrolchTransaction

Parameters:

locator - the locator defining the path to the element which is to be found

Returns:

the element described by the locator. If Locator references an element which does not exist, i.e. an inexistant Resource or an inexistand Parameter on a Resource, then a StrolchException is thrown

getResourceTemplate

public Resource getResourceTemplate(String type)

Description copied from interface: StrolchTransaction

Returns a copy of the Resource of Type StrolchConstants.TEMPLATE with the given type as id, or null if it does not exist

Templates are StrolchRootElements which have the type StrolchConstants.TEMPLATE and their id is the type of element for which it is a template. For instance when creating a Resource of type Person then having a template with the id Person helps creating new Person resources; get the resource and then create a clone: Resource.getClone()

Specified by:

getResourceTemplate in interface StrolchTransaction

Parameters:

type - the id of the Resource template

Returns:

the copy of the Resource template with the given id, or null if it does not exist

getResourceTemplate

public Resource getResourceTemplate(String type,
                                    boolean assertExists)
                             throws StrolchException

Description copied from interface: StrolchTransaction

Returns a copy of the Resource of Type StrolchConstants.TEMPLATE with the given type as id. If assertExists is true, then an exception is thrown if the template does not exist does not exist

Templates are StrolchRootElements which have the type StrolchConstants.TEMPLATE and their id is the type of element for which it is a template. For instance when creating a Resource of type Person then having a template with the id Person helps creating new Person resources; get the resource and then create a clone: Resource.getClone()

Specified by:

getResourceTemplate in interface StrolchTransaction

Parameters:

type - the id of the Resource template

Returns:

the copy of the Resource template with the given id, or if assertExists is true, then an exception is thrown if the resource does not exist

Throws:

StrolchException

getOrderTemplate

public Order getOrderTemplate(String type)

Description copied from interface: StrolchTransaction

Returns a copy of the Order of Type StrolchConstants.TEMPLATE with the given type as id, or null if it does not exist

Templates are StrolchRootElements which have the type StrolchConstants.TEMPLATE and their id is the type of element for which it is a template. For instance when creating an Order of type PurchaseOrder then having a template with the id PurchaseOrder helps creating new PurchaseOrder orders; get the order and then create a clone: Order.getClone()

Specified by:

getOrderTemplate in interface StrolchTransaction

Parameters:

type - the id of the Order template

Returns:

the copy of the Order template with the given id, or null if it does not exist

getOrderTemplate

public Order getOrderTemplate(String type,
                              boolean assertExists)
                       throws StrolchException

Description copied from interface: StrolchTransaction

Returns a copy of the Order of Type StrolchConstants.TEMPLATE with the given type as id. If assertExists is true, then an exception is thrown if the template does not exist does not exist

Templates are StrolchRootElements which have the type StrolchConstants.TEMPLATE and their id is the type of element for which it is a template. For instance when creating an Order of type PurchaseOrder then having a template with the id PurchaseOrder helps creating new PurchaseOrder orders; get the order and then create a clone: Order.getClone()

Specified by:

getOrderTemplate in interface StrolchTransaction

Parameters:

type - the id of the Order template

Returns:

the copy of the Order template with the given id, or if assertExists is true, then an exception is thrown if the order does not exist

Throws:

StrolchException

getActivityTemplate

public Activity getActivityTemplate(String type)

Description copied from interface: StrolchTransaction

Returns a copy of the Activity of Type StrolchConstants.TEMPLATE with the given type as id, or null if it does not exist

Templates are StrolchRootElements which have the type StrolchConstants.TEMPLATE and their id is the type of element for which it is a template. For instance when creating a Activity of type ToStock then having a template with the id ToStock helps creating new ToStock activities; get the activity and then create a clone: Activity.getClone()

Specified by:

getActivityTemplate in interface StrolchTransaction

Parameters:

type - the id of the Activity template

Returns:

the copy of the Activity template with the given id, or null if it does not exist

getActivityTemplate

public Activity getActivityTemplate(String type,
                                    boolean assertExists)
                             throws StrolchException

Description copied from interface: StrolchTransaction

Returns a copy of the Activity of Type StrolchConstants.TEMPLATE with the given type as id. If assertExists is true, then an exception is thrown if the template does not exist does not exist

Templates are StrolchRootElements which have the type StrolchConstants.TEMPLATE and their id is the type of element for which it is a template. For instance when creating a Activity of type ToStock then having a template with the id ToStock helps creating new ToStock activities; get the activity and then create a clone: Activity.getClone()

Specified by:

getActivityTemplate in interface StrolchTransaction

Parameters:

type - the id of the Activity template

Returns:

the copy of the Activity template with the given id, or if assertExists is true, then an exception is thrown if the activity does not exist

Throws:

StrolchException

getOrderBy

public Order getOrderBy(String type,
                        String id)

Description copied from interface: StrolchTransaction

Returns the Order with the given type and id, or null if it does not exist

Specified by:

getOrderBy in interface StrolchTransaction

Parameters:

type - the type of the Order

id - the id of the Order

Returns:

the Order with the given type and id, or null if it does not exist

getOrderBy

public Order getOrderBy(String type,
                        String id,
                        boolean assertExists)
                 throws StrolchException

Description copied from interface: StrolchTransaction

Returns the Order with the given type and id, or null if it does not exist

Specified by:

getOrderBy in interface StrolchTransaction

Parameters:

type - the type of the Order

id - the id of the Order

assertExists - if true, and order does not exist, then a StrolchException is thrown

Returns:

the Order with the given type and id, or null if it does not exist

Throws:

StrolchException - if the order does not exist, and assertExists is true

getOrderBy

public Order getOrderBy(StringParameter refP)
                 throws StrolchException

Description copied from interface: StrolchTransaction

Returns the Order which is referenced by the given StringParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_ORDER_REF and the UOM must be set to the order's type and the value is the id of the order

Specified by:

getOrderBy in interface StrolchTransaction

Parameters:

refP - the StringParameter which references an Order

Returns:

the order referenced by the parameter, or null if it does not exist

Throws:

StrolchException - if the StringParameter is not a properly configured as a reference parameter

getOrderBy

public Order getOrderBy(StringParameter refP,
                        boolean assertExists)
                 throws StrolchException

Description copied from interface: StrolchTransaction

Returns the Order which is referenced by the given StringParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_ORDER_REF and the UOM must be set to the order's type and the value is the id of the order

Specified by:

getOrderBy in interface StrolchTransaction

Parameters:

refP - the StringParameter which references an Order

assertExists - if true, and order does not exist, then a StrolchException is thrown

Returns:

the order referenced by the parameter, or null if it does not exist

Throws:

StrolchException - if the StringParameter is not a properly configured as a reference parameter, or if the order does not exist, and assertExists is true

getOrdersBy

public List<Order> getOrdersBy(StringListParameter refP)
                        throws StrolchException

Description copied from interface: StrolchTransaction

Returns all Orders which are referenced by the given StringListParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_ORDER_REF and the UOM must be set to the order's type and the value is the id of the order

Specified by:

getOrdersBy in interface StrolchTransaction

Parameters:

refP - the StringListParameter which references a list of Orders

Returns:

the orders referenced by the parameter, or the empty list if they do not exist. Note: Any missing orders are not returned!

Throws:

StrolchException - if the StringListParameter is not a properly configured as a reference parameter

getOrdersBy

public List<Order> getOrdersBy(StringListParameter refP,
                               boolean assertExists)
                        throws StrolchException

Description copied from interface: StrolchTransaction

Returns all Orders which are referenced by the given StringListParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_ORDER_REF and the UOM must be set to the order's type and the value is the id of the order

Specified by:

getOrdersBy in interface StrolchTransaction

Parameters:

refP - the StringListParameter which references a list of Orders

assertExists - if true, and order does not exist, then a StrolchException is thrown

Returns:

the orders referenced by the parameter, or the empty list if they do not exist. Note: Any missing orders are not returned unless assertExists is true

Throws:

StrolchException - if the StringListParameter is not a properly configured as a reference parameter

getResourceBy

public Resource getResourceBy(String type,
                              String id)

Description copied from interface: StrolchTransaction

Returns the Resource with the given type and id, or null if it does not exist

Specified by:

getResourceBy in interface StrolchTransaction

Parameters:

type - the type of the Resource

id - the id of the Resource

Returns:

the Resource with the given type and id, or null if it does not exist

getResourceBy

public Resource getResourceBy(String type,
                              String id,
                              boolean assertExists)
                       throws StrolchException

Description copied from interface: StrolchTransaction

Returns the Resource with the given type and id, or null if it does not exist

Specified by:

getResourceBy in interface StrolchTransaction

Parameters:

type - the type of the Resource

id - the id of the Resource

assertExists - if true, and resource does not exist, then a StrolchException is thrown

Returns:

the Resource with the given type and id, or null if it does not exist

Throws:

StrolchException - if the resource does not exist, and assertExists is true

getResourceBy

public Resource getResourceBy(StringParameter refP)
                       throws StrolchException

Description copied from interface: StrolchTransaction

Returns the Resource which is referenced by the given StringParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_RESOURCE_REF and the UOM must be set to the resource's type and the value is the id of the resource

Specified by:

getResourceBy in interface StrolchTransaction

Parameters:

refP - the StringParameter which references a Resource

Returns:

the resource referenced by the parameter, or null if it does not exist

Throws:

StrolchException - if the StringParameter is not a properly configured as a reference parameter

getResourceBy

public Resource getResourceBy(StringParameter refP,
                              boolean assertExists)
                       throws StrolchException

Description copied from interface: StrolchTransaction

Returns the Resource which is referenced by the given StringParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_RESOURCE_REF and the UOM must be set to the resource's type and the value is the id of the resource

Specified by:

getResourceBy in interface StrolchTransaction

Parameters:

refP - the StringParameter which references a Resource

assertExists - if true, and resource does not exist, then a StrolchException is thrown

Returns:

the resource referenced by the parameter, or null if it does not exist

Throws:

StrolchException - if the StringParameter is not a properly configured as a reference parameter, or if the resource does not exist, and assertExists is true

getResourcesBy

public List<Resource> getResourcesBy(StringListParameter refP)
                              throws StrolchException

Description copied from interface: StrolchTransaction

Returns all Resources which are referenced by the given StringListParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_RESOURCE_REF and the UOM must be set to the resource's type and the value is the id of the resource

Specified by:

getResourcesBy in interface StrolchTransaction

Parameters:

refP - the StringListParameter which references a list of Resources

Returns:

the resources referenced by the parameter, or the empty list if they do not exist. Note: Any missing resources are not returned!

Throws:

StrolchException - if the StringListParameter is not a properly configured as a reference parameter

getResourcesBy

public List<Resource> getResourcesBy(StringListParameter refP,
                                     boolean assertExists)
                              throws StrolchException

Description copied from interface: StrolchTransaction

Returns all Resources which are referenced by the given StringListParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_RESOURCE_REF and the UOM must be set to the resource's type and the value is the id of the resource

Specified by:

getResourcesBy in interface StrolchTransaction

Parameters:

refP - the StringListParameter which references a list of Resources

assertExists - if true, and resource does not exist, then a StrolchException is thrown

Returns:

the resources referenced by the parameter, or the empty list if they do not exist. Note: Any missing resources are not returned unless assertExists is true

Throws:

StrolchException - if the StringListParameter is not a properly configured as a reference parameter

getActivityBy

public Activity getActivityBy(String type,
                              String id)

Description copied from interface: StrolchTransaction

Returns the Activity with the given type and id, or null if it does not exist

Specified by:

getActivityBy in interface StrolchTransaction

Parameters:

type - the type of the Activity

id - the id of the Activity

Returns:

the Activity with the given type and id, or null if it does not exist

getActivityBy

public Activity getActivityBy(String type,
                              String id,
                              boolean assertExists)
                       throws StrolchException

Description copied from interface: StrolchTransaction

Returns the Activity with the given type and id, or null if it does not exist

Specified by:

getActivityBy in interface StrolchTransaction

Parameters:

type - the type of the Activity

id - the id of the Activity

assertExists - if true, and activity does not exist, then a StrolchException is thrown

Returns:

the Activity with the given type and id, or null if it does not exist

Throws:

StrolchException - if the activity does not exist, and assertExists is true

getActivityBy

public Activity getActivityBy(StringParameter refP)
                       throws StrolchException

Description copied from interface: StrolchTransaction

Returns the Activity which is referenced by the given StringParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_ACTIVITY_REF and the UOM must be set to the activity's type and the value is the id of the activity

Specified by:

getActivityBy in interface StrolchTransaction

Parameters:

refP - the StringParameter which references an Activity

Returns:

the activity referenced by the parameter, or null if it does not exist

Throws:

StrolchException - if the StringParameter is not a properly configured as a reference parameter

getActivityBy

public Activity getActivityBy(StringParameter refP,
                              boolean assertExists)
                       throws StrolchException

Description copied from interface: StrolchTransaction

Returns the Activity which is referenced by the given StringParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_ACTIVITY_REF and the UOM must be set to the activity's type and the value is the id of the activity

Specified by:

getActivityBy in interface StrolchTransaction

Parameters:

refP - the StringParameter which references an Activity

assertExists - if true, and activity does not exist, then a StrolchException is thrown

Returns:

the activity referenced by the parameter, or null if it does not exist

Throws:

StrolchException - if the StringParameter is not a properly configured as a reference parameter, or if the activity does not exist, and assertExists is true

getActivitiesBy

public List<Activity> getActivitiesBy(StringListParameter refP)
                               throws StrolchException

Description copied from interface: StrolchTransaction

Returns all Activities which are referenced by the given StringListParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_ACTIVITY_REF and the UOM must be set to the activity's type and the value is the id of the activity

Specified by:

getActivitiesBy in interface StrolchTransaction

Parameters:

refP - the StringListParameter which references a list of Activities

Returns:

the activities referenced by the parameter, or the empty list if they do not exist. Note: Any missing activities are not returned!

Throws:

StrolchException - if the StringListParameter is not a properly configured as a reference parameter

getActivitiesBy

public List<Activity> getActivitiesBy(StringListParameter refP,
                                      boolean assertExists)
                               throws StrolchException

Description copied from interface: StrolchTransaction

Returns all Activities which are referenced by the given StringListParameter. A reference Parameter must have its interpretation set to StrolchConstants.INTERPRETATION_ACTIVITY_REF and the UOM must be set to the activity's type and the value is the id of the activity

Specified by:

getActivitiesBy in interface StrolchTransaction

Parameters:

refP - the StringListParameter which references a list of Activities

assertExists - if true, and activity does not exist, then a StrolchException is thrown

Returns:

the activities referenced by the parameter, or the empty list if they do not exist. Note: Any missing activities are not returned unless assertExists is true

Throws:

StrolchException - if the StringListParameter is not a properly configured as a reference parameter

flush

public void flush()

Description copied from interface: StrolchTransaction

Performs all registered commands

This method does not release any locks, nor does it notify any observers

Specified by:

flush in interface StrolchTransaction

autoCloseableCommit

public void autoCloseableCommit()

Description copied from interface: StrolchTransaction

DO NOT CALL THIS METHOD. If the currently set close strategy is TransactionCloseStrategy.COMMIT, then when the transaction is closed, this method is called and all registered Command are performed, locks on objects are released and any other resources are released

Specified by:

autoCloseableCommit in interface StrolchTransaction

autoCloseableRollback

public void autoCloseableRollback()

Description copied from interface: StrolchTransaction

DO NOT CALL THIS METHOD. If the currently set close strategy is TransactionCloseStrategy.ROLLBACK, then when the transaction is closed, no further actions are performed and any Command which were performed have their Command.undo() method called and any DB connections are also rolled back

Specified by:

autoCloseableRollback in interface StrolchTransaction

autoCloseableDoNothing

public void autoCloseableDoNothing()
                            throws StrolchTransactionException

Description copied from interface: StrolchTransaction

DO NOT CALL THIS METHOD. If the currently set close strategy is TransactionCloseStrategy.DO_NOTHING, then when the transaction is closed, this method is called no changes to the model is performed but locks on objects are released and any other resources are released

Specified by:

autoCloseableDoNothing in interface StrolchTransaction

Throws:

StrolchTransactionException

writeChanges

protected abstract void writeChanges()
                              throws Exception

Throws:

Exception

rollback

protected abstract void rollback()
                          throws Exception

Throws:

Exception

commit

protected abstract void commit()
                        throws Exception

Throws:

Exception

handleFailure

protected void handleFailure(long closeStartNanos,
                             Exception e)

auditFrom

public Audit auditFrom(AccessType accessType,
                       StrolchRootElement element)

Description copied from interface: StrolchTransaction

Helper method to create an Audit with the given arguments. The audit can then be saved by calling AuditTrail.add(StrolchTransaction, Audit)

Specified by:

auditFrom in interface StrolchTransaction

Parameters:

accessType - the type of access

element - the element from which to to create the audit

Returns:

the new audit

auditFrom

public Audit auditFrom(AccessType accessType,
                       String elementType,
                       String elementSubType,
                       String id)

Description copied from interface: StrolchTransaction

Helper method to create an Audit with the given arguments. The audit can then be saved by calling AuditTrail.add(StrolchTransaction, Audit)

Specified by:

auditFrom in interface StrolchTransaction

Parameters:

accessType - the type of access

elementType - the element type, i.e. Tags.RESOURCE, Tags.ORDER

id - the id of the element audited

Returns:

the new audit