Package cz.cvut.kbss.jopa.sessions

Class CloningReadOnlyUnitOfWork

java.lang.Object

cz.cvut.kbss.jopa.sessions.AbstractSession

cz.cvut.kbss.jopa.sessions.AbstractUnitOfWork

cz.cvut.kbss.jopa.sessions.CloningReadOnlyUnitOfWork

All Implemented Interfaces:

ConfigurationHolder, MetamodelProvider, UnitOfWork, Wrapper

public class CloningReadOnlyUnitOfWork
extends AbstractUnitOfWork

Read-only UoW which clones all entities before returning them to the application.

Cloning entities allows using second-level cache which brings better performance than ReadOnlyUnitOfWork which does not clone entities but also skips second-level cache (unless entity is already there in which case it behaves exactly like this class).

Field Summary

Fields inherited from class cz.cvut.kbss.jopa.sessions.AbstractUnitOfWork

LOG

Fields inherited from class cz.cvut.kbss.jopa.sessions.AbstractSession

configuration

Method Summary

Modifier and Type	Method	Description
void	attributeChanged(Object entity, FieldSpecification<?,?> fieldSpec)	Method is not supported.
void	attributeChanged(Object entity, Field f)	Method is not supported.
void	commit()	ReadOnlyUnitOfWork commits nothing.
void	commitToStorage()
Object	createIndirectCollection(Object collection, Object owner, Field field)	Creates an indirect collection that wraps the specified collection instance and propagates changes to this persistence context.
protected void	evictAfterMerge(EntityType<?> et, URI identifier, Descriptor descriptor)	Method not supported.
protected <T> T	getInstanceForMerge(URI identifier, EntityType<T> et, Descriptor descriptor)	Method not supported.
boolean	hasChanges()
boolean	isFlushingChanges()	Returns true if this Unit of Work is currently flushing changes to the repository.
boolean	isReadOnly()
protected void	markCloneForDeletion(Object entity, Object identifier)	Method is not supported.
<T> T	mergeDetached(T entity, Descriptor descriptor)	Method not supported.
<T> T	mergeDetachedInternal(T entity, Descriptor descriptor)	Method not supported.
protected ObjectChangeSet	processInferredValueChanges(ObjectChangeSet changeSet)	Method is not supported.
<T> void	refreshObject(T object)	Method not supported.
void	registerNewObject(Object entity, Descriptor descriptor)	Method is not supported.
void	registerOriginalForNewClone(Object clone, Object original)	Method is not supported.
void	removeObject(Object object)	Method is not supported.
void	removeObjectFromCache(Object toRemove, URI context)	Method not supported.
void	restoreRemovedObject(Object entity)	Method is not supported.
void	writeUncommittedChanges()	Method is not supported.

Methods inherited from class cz.cvut.kbss.jopa.sessions.AbstractUnitOfWork

acquireConnection, begin, clear, contains, copyChangeSet, entityType, getCloneForOriginal, getContexts, getCriteriaBuilder, getFieldDescriptor, getLiveObjectCache, getLoadStateRegistry, getManagedOriginal, getMetamodel, getOriginal, getReference, getState, getState, isActive, isConsistent, isEntityType, isInferred, isInRepository, isInTransaction, isLoaded, isLoaded, isObjectManaged, loadEntityField, putObjectIntoCache, readObject, readObjectFromAxioms, readObjectInternal, readObjectWithoutRegistration, registerExistingObject, registerExistingObject, release, removeIndirectWrappersAndProxies, rollback, sparqlQueryFactory, stringify, unregisterEntityFromOntologyContext, unregisterObject, unwrap

Methods inherited from class cz.cvut.kbss.jopa.sessions.AbstractSession

getConfiguration

Methods inherited from class java.lang.Object

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

Methods inherited from interface cz.cvut.kbss.jopa.sessions.ConfigurationHolder

getConfiguration

Methods inherited from interface cz.cvut.kbss.jopa.sessions.MetamodelProvider

getNamedQueryManager, getResultSetMappingManager

Method Details

commit

public void commit()

ReadOnlyUnitOfWork commits nothing. The persistence context is cleared.

Specified by:

commit in interface UnitOfWork

Overrides:

commit in class AbstractUnitOfWork

commitToStorage

public void commitToStorage()

createIndirectCollection

public Object createIndirectCollection(Object collection,
 Object owner,
 Field field)

Description copied from interface: UnitOfWork

Creates an indirect collection that wraps the specified collection instance and propagates changes to this persistence context.

Parameters:

collection - Collection to be proxied

owner - Collection owner instance

field - Field filled with the collection

Returns:

Indirect collection

isReadOnly

public boolean isReadOnly()

Overrides:

isReadOnly in class AbstractUnitOfWork

hasChanges

public boolean hasChanges()
                   throws UnsupportedOperationException

Overrides:

hasChanges in class AbstractUnitOfWork

Throws:

UnsupportedOperationException

isFlushingChanges

public boolean isFlushingChanges()

Description copied from interface: UnitOfWork

Returns true if this Unit of Work is currently flushing changes to the repository.

Specified by:

isFlushingChanges in interface UnitOfWork

Overrides:

isFlushingChanges in class AbstractUnitOfWork

Returns:

true if the UoW is flushing changes, false otherwise

removeObjectFromCache

public void removeObjectFromCache(Object toRemove,
 URI context)
                           throws UnsupportedOperationException

Method not supported.

Specified by:

removeObjectFromCache in interface UnitOfWork

Overrides:

removeObjectFromCache in class AbstractUnitOfWork

Parameters:

toRemove - Object to remove from cache

context - Entity context URI

Throws:

UnsupportedOperationException - Method not supported.

mergeDetached

public <T> T mergeDetached(T entity,
 Descriptor descriptor)
                    throws UnsupportedOperationException

Method not supported.

Specified by:

mergeDetached in interface UnitOfWork

Overrides:

mergeDetached in class AbstractUnitOfWork

Parameters:

entity - entity instance

descriptor - Entity descriptor, specifies repository context

Returns:

the managed instance that the state was merged to

Throws:

UnsupportedOperationException - Method not supported.

mergeDetachedInternal

public <T> T mergeDetachedInternal(T entity,
 Descriptor descriptor)
                            throws UnsupportedOperationException

Method not supported.

Throws:

UnsupportedOperationException - Method not supported.

getInstanceForMerge

protected <T> T getInstanceForMerge(URI identifier,
 EntityType<T> et,
 Descriptor descriptor)
                             throws UnsupportedOperationException

Method not supported.

Overrides:

getInstanceForMerge in class AbstractUnitOfWork

Throws:

UnsupportedOperationException - Method not supported.

evictAfterMerge

protected void evictAfterMerge(EntityType<?> et,
 URI identifier,
 Descriptor descriptor)
                        throws UnsupportedOperationException

Method not supported.

Overrides:

evictAfterMerge in class AbstractUnitOfWork

Throws:

UnsupportedOperationException - Method not supported.

refreshObject

public <T> void refreshObject(T object)
                       throws UnsupportedOperationException

Method not supported.

Specified by:

refreshObject in interface UnitOfWork

Overrides:

refreshObject in class AbstractUnitOfWork

Type Parameters:

T - Object type

Parameters:

object - The object to revert

Throws:

UnsupportedOperationException - Method not supported.

processInferredValueChanges

protected ObjectChangeSet processInferredValueChanges(ObjectChangeSet changeSet)
                                               throws UnsupportedOperationException

Method is not supported.

Overrides:

processInferredValueChanges in class AbstractUnitOfWork

Throws:

UnsupportedOperationException - Always thrown

registerOriginalForNewClone

public void registerOriginalForNewClone(Object clone,
 Object original)
                                 throws UnsupportedOperationException

Method is not supported.

Overrides:

registerOriginalForNewClone in class AbstractUnitOfWork

Parameters:

clone - Already registered clone

original - Original to register

Throws:

UnsupportedOperationException - Always thrown

writeUncommittedChanges

public void writeUncommittedChanges()
                             throws UnsupportedOperationException

Method is not supported.

Specified by:

writeUncommittedChanges in interface UnitOfWork

Overrides:

writeUncommittedChanges in class AbstractUnitOfWork

Throws:

UnsupportedOperationException - Always thrown

restoreRemovedObject

public void restoreRemovedObject(Object entity)
                          throws UnsupportedOperationException

Method is not supported.

Specified by:

restoreRemovedObject in interface UnitOfWork

Overrides:

restoreRemovedObject in class AbstractUnitOfWork

Parameters:

entity - The object to restore

Throws:

UnsupportedOperationException - Always thrown

attributeChanged

public void attributeChanged(Object entity,
 Field f)
                      throws UnsupportedOperationException

Method is not supported.

Parameters:

entity - Entity with changes (the clone)

f - The field whose value has changed

Throws:

UnsupportedOperationException - Always thrown

See Also:

• UnitOfWork.attributeChanged(Object, FieldSpecification)

attributeChanged

public void attributeChanged(Object entity,
 FieldSpecification<?,?> fieldSpec)
                      throws UnsupportedOperationException

Method is not supported.

Parameters:

entity - Entity with changes (the clone)

fieldSpec - Metamodel element representing the attribute that changed

Throws:

UnsupportedOperationException - Always thrown

markCloneForDeletion

protected void markCloneForDeletion(Object entity,
 Object identifier)
                             throws UnsupportedOperationException

Method is not supported.

Overrides:

markCloneForDeletion in class AbstractUnitOfWork

Throws:

UnsupportedOperationException - Always thrown

registerNewObject

public void registerNewObject(Object entity,
 Descriptor descriptor)
                       throws UnsupportedOperationException

Method is not supported.

Specified by:

registerNewObject in interface UnitOfWork

Overrides:

registerNewObject in class AbstractUnitOfWork

Parameters:

entity - The object to register

descriptor - Entity descriptor

Throws:

UnsupportedOperationException - Always thrown

removeObject

public void removeObject(Object object)
                  throws UnsupportedOperationException

Method is not supported.

Parameters:

object - Object to remove

Throws:

UnsupportedOperationException - Always thrown