one.microstream.persistence.types

Interface PersistenceManager<D>

All Superinterfaces:

ByteOrderTargeting<PersistenceManager<D>>, one.microstream.util.Cloneable<PersistenceObjectManager<D>>, one.microstream.reference.ObjectSwizzling, PersistenceObjectIdHolder, PersistenceObjectIdLookup, PersistenceObjectLookup, PersistenceObjectManager<D>, PersistenceRetrieving, PersistenceSourceSupplier<D>, PersistenceStoring, PersistenceSwizzlingLookup, Persister

All Known Implementing Classes:

PersistenceManager.Default

public interface PersistenceManager<D>
extends PersistenceObjectManager<D>, PersistenceRetrieving, Persister, PersistenceSourceSupplier<D>, ByteOrderTargeting<PersistenceManager<D>>

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	PersistenceManager.Default<D>

Nested classes/interfaces inherited from interface one.microstream.persistence.types.ByteOrderTargeting

ByteOrderTargeting.Mutable<T extends ByteOrderTargeting.Mutable<?>>

Method Summary

Modifier and Type	Method and Description
void	close() Closes all ties to outside resources, if applicable.
PersistenceStorer	createEagerStorer() Creates a new Storer instance with eager storing behavior.
PersistenceStorer	createLazyStorer() Creates a new Storer instance with lazy storing behavior.
PersistenceLoader	createLoader()
PersistenceRegisterer	createRegisterer()
PersistenceStorer	createStorer() Creates a new Storer instance with default storing behavior.
PersistenceStorer	createStorer(PersistenceStorer.Creator<D> storerCreator)
long	currentObjectId()
static <D> PersistenceManager<D>	New(PersistenceObjectRegistry objectRegistering, PersistenceObjectManager<D> objectManager, PersistenceTypeHandlerManager<D> typeHandlerManager, PersistenceContextDispatcher<D> contextDispatcher, PersistenceStorer.Creator<D> storerCreator, PersistenceLoader.Creator<D> loaderCreator, PersistenceRegisterer.Creator registererCreator, Persister persister, PersistenceTarget<D> target, PersistenceSource<D> source, one.microstream.util.BufferSizeProviderIncremental bufferSizeProvider, ByteOrder targetByteOrder)
PersistenceObjectRegistry	objectRegistry()
PersistenceSource<D>	source()
PersistenceTarget<D>	target()
PersistenceTypeDictionary	typeDictionary()
PersistenceManager<D>	updateCurrentObjectId(long currentObjectId)
default void	updateMetadata(PersistenceTypeDictionary typeDictionary)
void	updateMetadata(PersistenceTypeDictionary typeDictionary, long highestTypeId, long highestObjectId)

Methods inherited from interface one.microstream.persistence.types.PersistenceObjectManager

Clone, consolidate, ensureObjectId, ensureObjectId, ensureObjectIdGuaranteedRegister, mergeEntries, New, registerLocalRegistry

Methods inherited from interface one.microstream.persistence.types.PersistenceObjectIdLookup

lookupObjectId

Methods inherited from interface one.microstream.persistence.types.PersistenceObjectLookup

lookupObject

Methods inherited from interface one.microstream.persistence.types.PersistenceRetrieving

collect, get, getObject

Methods inherited from interface one.microstream.persistence.types.Persister

getObject, store, storeAll, storeAll

Methods inherited from interface one.microstream.persistence.types.PersistenceSourceSupplier

getObject

Methods inherited from interface one.microstream.persistence.types.ByteOrderTargeting

getTargetByteOrder, isByteOrderMismatch, isByteOrderMismatch

Method Detail

createLazyStorer

PersistenceStorer createLazyStorer()

Description copied from interface: Persister

Creates a new Storer instance with lazy storing behavior. This means an entity instance encountered while traversing the entity graph is only stored if it is not yet known to the persistence context, i.e. does not have an objectId associated with it in the persistence context's PersistenceObjectRegistry.

Specified by:

createLazyStorer in interface Persister

Returns:

the newly created Storer instance.

createStorer

PersistenceStorer createStorer()

Description copied from interface: Persister

Creates a new Storer instance with default storing behavior. The default is lazy storing. See Persister.createLazyStorer().

Specified by:

createStorer in interface Persister

Returns:

the newly created Storer instance.

createEagerStorer

PersistenceStorer createEagerStorer()

Description copied from interface: Persister

Creates a new Storer instance with eager storing behavior. This means an entity instance encountered while traversing the entity graph is always stored, regardless of if it is already known to the persistence context or not, i.e. does have an objectId associated with it in the persistence context's PersistenceObjectRegistry.

Note: Eager storing is a dangerous behavior since - depending on the entity graph's referential layout - it can cause the whole entity graph present in the heap to be stored. Therefore, it is stronly advised to instead use lazy storing logic (see Persister.createLazyStorer()) or some other kind of limiting storing logic.

Specified by:

createEagerStorer in interface Persister

Returns:

the newly created Storer instance.

createStorer

PersistenceStorer createStorer(PersistenceStorer.Creator<D> storerCreator)

createLoader

PersistenceLoader createLoader()

createRegisterer

PersistenceRegisterer createRegisterer()

updateMetadata

void updateMetadata(PersistenceTypeDictionary typeDictionary,
                    long highestTypeId,
                    long highestObjectId)

updateMetadata

default void updateMetadata(PersistenceTypeDictionary typeDictionary)

objectRegistry

PersistenceObjectRegistry objectRegistry()

typeDictionary

PersistenceTypeDictionary typeDictionary()

currentObjectId

long currentObjectId()

Specified by:

currentObjectId in interface PersistenceObjectIdHolder

Specified by:

currentObjectId in interface PersistenceObjectManager<D>

updateCurrentObjectId

PersistenceManager<D> updateCurrentObjectId(long currentObjectId)

Specified by:

updateCurrentObjectId in interface PersistenceObjectIdHolder

Specified by:

updateCurrentObjectId in interface PersistenceObjectManager<D>

source

PersistenceSource<D> source()

Specified by:

source in interface PersistenceSourceSupplier<D>

target

PersistenceTarget<D> target()

close

void close()

Closes all ties to outside resources, if applicable. Typ

New

static <D> PersistenceManager<D> New(PersistenceObjectRegistry objectRegistering,
                                     PersistenceObjectManager<D> objectManager,
                                     PersistenceTypeHandlerManager<D> typeHandlerManager,
                                     PersistenceContextDispatcher<D> contextDispatcher,
                                     PersistenceStorer.Creator<D> storerCreator,
                                     PersistenceLoader.Creator<D> loaderCreator,
                                     PersistenceRegisterer.Creator registererCreator,
                                     Persister persister,
                                     PersistenceTarget<D> target,
                                     PersistenceSource<D> source,
                                     one.microstream.util.BufferSizeProviderIncremental bufferSizeProvider,
                                     ByteOrder targetByteOrder)