org.fcrepo.kernel

Class Transaction

java.lang.Object

org.fcrepo.kernel.Transaction

public class Transaction
extends Object

A Fedora Transaction wraps a JCR session with some expiration logic. Whenever the transaction's session is requested, the expiration is extended

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Transaction.State Information about the state of the transaction

Field Summary

Fields

Modifier and Type	Field and Description
static long	DEFAULT_TIMEOUT
static String	TIMEOUT_SYSTEM_PROPERTY

Constructor Summary

Constructors

Constructor and Description
Transaction(javax.jcr.Session session) Create a transaction for the given Session

Method Summary

Methods

Modifier and Type	Method and Description
void	addPathToVersion(String absPath) Adds a path at which a new version should be made upon successful completion of this transaction.
void	commit(VersionService vService) "Commit" the transaction by saving the backing-session
void	expire() End the session, and mark for reaping
Date	getCreated() Get the date this transaction was created
Date	getExpires() Get the Date when this transaction is expired and can be garbage-collected
String	getId() Get the transaction identifier
javax.jcr.Session	getSession() Get the transaction-aware session
Transaction.State	getState() Get the state of this transaction
void	rollback() Discard all unpersisted changes and expire
void	updateExpiryDate() Roll forward the expiration date for recent activity

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_TIMEOUT

public static final long DEFAULT_TIMEOUT

See Also:

Constant Field Values

TIMEOUT_SYSTEM_PROPERTY

public static final String TIMEOUT_SYSTEM_PROPERTY

See Also:

Constant Field Values

Constructor Detail

Transaction

public Transaction(javax.jcr.Session session)

Create a transaction for the given Session

Parameters:

session -

Method Detail

getSession

public javax.jcr.Session getSession()

Get the transaction-aware session

Returns:

getCreated

public Date getCreated()

Get the date this transaction was created

Returns:

getId

public String getId()

Get the transaction identifier

Returns:

getState

public Transaction.State getState()
                           throws javax.jcr.RepositoryException

Get the state of this transaction

Returns:

Throws:

javax.jcr.RepositoryException

getExpires

public Date getExpires()

Get the Date when this transaction is expired and can be garbage-collected

Returns:

addPathToVersion

public void addPathToVersion(String absPath)

Adds a path at which a new version should be made upon successful completion of this transaction. Subsequent calls with the same path have no effect, as the entire transaction is meant to be atomic and only one new version can result from it.

Parameters:

absPath - the object path to the resource to have a version checkpoint made

commit

public void commit(VersionService vService)
            throws javax.jcr.RepositoryException

"Commit" the transaction by saving the backing-session

Parameters:

vService - a versionService

Throws:

javax.jcr.RepositoryException

expire

public void expire()
            throws javax.jcr.RepositoryException

End the session, and mark for reaping

Throws:

javax.jcr.RepositoryException

rollback

public void rollback()
              throws javax.jcr.RepositoryException

Discard all unpersisted changes and expire

Throws:

javax.jcr.RepositoryException

updateExpiryDate

public void updateExpiryDate()

Roll forward the expiration date for recent activity