cz.cvut.kbss.jopa.sessions

Interface CloneBuilder

public interface CloneBuilder

Objects of this interface are responsible for building clones for UnitOfWork transactions.

Method Summary

Modifier and Type	Method and Description
Object	buildClone(Object original, Descriptor descriptor) Builds clone of the given object.
Object	buildClone(Object cloneOwner, Field clonedField, Object original, Descriptor descriptor) Builds clone of the given object.
void	mergeChanges(ObjectChangeSet changeSet) Merges the changes on clone into the original object.
void	removeVisited(Object instance, Descriptor descriptor) Removes the specified instance from the clone builder's visited entities cache.
void	reset() Resets the clone builder.

Method Detail

buildClone

Object buildClone(Object original,
                  Descriptor descriptor)

Builds clone of the given object.

Parameters:

original - Object

descriptor - Entity descriptor

Returns:

Object The clone

Throws:

NullPointerException - If original or repository is null

buildClone

Object buildClone(Object cloneOwner,
                  Field clonedField,
                  Object original,
                  Descriptor descriptor)

Builds clone of the given object.

This method differs from buildClone(Object, cz.cvut.kbss.jopa.model.descriptors.Descriptor) in that it accepts another argument which represents the owner of the built clone. This is useful in situations when we are cloning attributes directly, e. g. when lazily loading a field value.

Parameters:

cloneOwner - The owner of the created clone

clonedField - The field whose value is being cloned

original - The original to clone

descriptor - Entity descriptor

Returns:

The clone

Throws:

NullPointerException - If cloneOwner, original or contextUri is null

reset

void reset()

Resets the clone builder.

Especially resets the visited objects cache to make sure all the clones are built from scratch and are not affected by the previously built ones.

removeVisited

void removeVisited(Object instance,
                   Descriptor descriptor)

Removes the specified instance from the clone builder's visited entities cache.

Parameters:

instance - The instance to remove (original object).

descriptor - Instance descriptor

mergeChanges

void mergeChanges(ObjectChangeSet changeSet)

Merges the changes on clone into the original object.

Parameters:

changeSet - Contains changes to merge