Package one.microstream.persistence.types

Class Persistence

java.lang.Object

one.microstream.persistence.types.Persistence

Direct Known Subclasses:

BinaryPersistence

public class Persistence
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Persistence.IdType

Constructor Summary

Constructors

Constructor	Description
Persistence()

Method Summary

Modifier and Type	Method	Description
static long	classTypeId()
static Object[]	collectEnumConstants(PersistenceTypeHandler<?,?> typeHandler)
static PersistenceTypeIdLookup	createDefaultTypeLookup()
static String	customRootIdentifier()	Deprecated.
static long	defaultBoundConstantId()
static PersistenceFieldEvaluator	defaultFieldEvaluatorCollection()
static PersistenceFieldEvaluator	defaultFieldEvaluatorEnum()
static PersistenceFieldEvaluator	defaultFieldEvaluatorPersistable()
static PersistenceFieldEvaluator	defaultFieldEvaluatorPersister()
static String	defaultFilenameTypeDictionary()
static PersistenceEagerStoringFieldEvaluator	defaultReferenceFieldEagerEvaluator()
static String	defaultRootIdentifier()	Deprecated.
static long	defaultStartConstantId()
static long	defaultStartObjectId()
static long	defaultStartTypeId()
static PersistenceTypeEvaluator	defaultTypeEvaluatorPersistable()
static String	deriveEnumRootIdentifier(PersistenceTypeHandler<?,?> typeHandler)
static String	derivePersistentTypeName(Class<?> type)
static String	derivePersistentTypeName(Class<?> type, String substituteClassIdentifierSeparator)
static String	derivePersistentTypeNameEnum(Class<?> type, String substituteClassIdentifierSeparator)
static String	engineName()
static String	enumRootIdentifierStart()
static Long	getNativeTypeId(Class<?> type)
static boolean	isEnumRootIdentifier(String enumRootIdentifier)
static boolean	isHandleableCollectionField(Class<?> collectionClass, Field field)
static boolean	isHandleableEnumField(Class<?> enumClass, Field field)
static boolean	isNativeType(Class<?> type)
static boolean	isPersistable(Class<?> type)
static boolean	isPersisterField(Field field)
static boolean	isPotentialEnumRootIdentifier(String enumRootIdentifier)
static boolean	isUnpersistable(Class<?> type)
static <C extends BiConsumer<Class<?>,Long>> C	iterateJavaBasicTypes(C iterator)
static void	iterateReferences(PersistenceFunction iterator, Object[] array, int offset, int length)
static void	iterateReferences(PersistenceFunction iterator, XIterable<?> elements)
static void	iterateReferencesIterable(PersistenceFunction iterator, Iterable<?> elements)
static void	iterateReferencesMap(PersistenceFunction iterator, Map<?,?> elements)
static long	notFoundId()
static long	nullId()
static String	objectIdLabel()
static String	objectIdShortLabel()
static Class<?>	objectIdType()	Central architectural information method that always returns long.class.
static Long	parseEnumRootIdentifierTypeId(String enumRootIdentifier)
static XGettingSequence<KeyValue<String,String>>	readRefactoringMappings(File file)	Deprecated.
static XGettingSequence<KeyValue<String,String>>	readRefactoringMappings(Path file)
static PersistenceRefactoringMappingProvider	RefactoringMapping(File refactoringsFile)	Deprecated.
static PersistenceRefactoringMappingProvider	RefactoringMapping(Path refactoringsFile)
static PersistenceRefactoringMappingProvider	RefactoringMapping(XGettingSequence<KeyValue<String,String>> refactoringMappings)
static <R extends PersistenceTypeRegistry> R	registerJavaBasicTypes(R registry)
static <R extends PersistenceObjectRegistry> R	registerJavaConstants(R registry)
static <R extends PersistenceObjectRegistry> R	registerJavaNatives(R registry)
static <T> Class<T>	resolveEnumeratedClassIdentifierSeparatedType(String typeName, String substituteClassIdentifierSeparator)
static <T> Class<T>	resolveType(String typeName)
static <T> Class<T>	resolveType(String typeName, String substituteClassIdentifierSeparator)
static String	rootIdentifier()
static Charset	standardCharset()	Reasons for choosing UTF8 as the standard charset: 1.) It is independent from endianess.
static String	substituteClassIdentifierSeparator()	Persistence-specific separator between a class name and a proper identifier that replaces unreliable class names (like "$1", "$2" etc.) by a reliably identifying substitute name.
static <T> Class<T>	tryResolveType(String typeName)
static <D> PersistenceTypeMismatchValidator<D>	typeMismatchValidatorFailing()
static <D> PersistenceTypeMismatchValidator<D>	typeMismatchValidatorNoOp()
static XGettingEnum<Class<?>>	unpersistableTypes()	Types whose instances cannot be persisted.
static long	validateObjectId(long id)
static long	validateTypeId(long id)

Methods inherited from class java.lang.Object

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

Constructor Detail

Persistence

public Persistence()

Method Detail

engineName

public static String engineName()

objectIdLabel

public static final String objectIdLabel()

objectIdShortLabel

public static final String objectIdShortLabel()

objectIdType

public static final Class<?> objectIdType()

Central architectural information method that always returns long.class.

Returns:

long.class

nullId

public static final long nullId()

notFoundId

public static final long notFoundId()

createDefaultTypeLookup

public static final PersistenceTypeIdLookup createDefaultTypeLookup()

defaultStartTypeId

public static final long defaultStartTypeId()

defaultStartConstantId

public static final long defaultStartConstantId()

defaultStartObjectId

public static final long defaultStartObjectId()

defaultBoundConstantId

public static final long defaultBoundConstantId()

classTypeId

public static final long classTypeId()

isNativeType

public static final boolean isNativeType(Class<?> type)

getNativeTypeId

public static final Long getNativeTypeId(Class<?> type)

registerJavaNatives

public static final <R extends PersistenceObjectRegistry> R registerJavaNatives(R registry)

registerJavaBasicTypes

public static final <R extends PersistenceTypeRegistry> R registerJavaBasicTypes(R registry)

iterateJavaBasicTypes

public static final <C extends BiConsumer<Class<?>,Long>> C iterateJavaBasicTypes(C iterator)

registerJavaConstants

public static final <R extends PersistenceObjectRegistry> R registerJavaConstants(R registry)

validateObjectId

public static long validateObjectId(long id)
                             throws PersistenceExceptionConsistencyInvalidObjectId

Throws:

PersistenceExceptionConsistencyInvalidObjectId

validateTypeId

public static long validateTypeId(long id)
                           throws PersistenceExceptionConsistencyInvalidTypeId

Throws:

PersistenceExceptionConsistencyInvalidTypeId

iterateReferences

public static final void iterateReferences(PersistenceFunction iterator,
                                           Object[] array,
                                           int offset,
                                           int length)

iterateReferences

public static final void iterateReferences(PersistenceFunction iterator,
                                           XIterable<?> elements)

iterateReferencesIterable

public static final void iterateReferencesIterable(PersistenceFunction iterator,
                                                   Iterable<?> elements)

iterateReferencesMap

public static final void iterateReferencesMap(PersistenceFunction iterator,
                                              Map<?,?> elements)

standardCharset

public static final Charset standardCharset()

Reasons for choosing UTF8 as the standard charset: 1.) It is independent from endianess. 2.) It is massively smaller due to most content containing almost only single-byte ASCII characters 3.) It is overall more commonly and widespread used and compatible than any specific format.

defaultFilenameTypeDictionary

public static String defaultFilenameTypeDictionary()

unpersistableTypes

public static XGettingEnum<Class<?>> unpersistableTypes()

Types whose instances cannot be persisted. E.g. Unpersistable, Thread, ClassLoader, etc. Note that the Class instances representing these types are very well persistable and will get empty type descriptions to assign type ids to them. Only their instances cannot be persisted.

isPersistable

public static boolean isPersistable(Class<?> type)

isUnpersistable

public static boolean isUnpersistable(Class<?> type)

typeMismatchValidatorFailing

public static final <D> PersistenceTypeMismatchValidator<D> typeMismatchValidatorFailing()

typeMismatchValidatorNoOp

public static final <D> PersistenceTypeMismatchValidator<D> typeMismatchValidatorNoOp()

defaultTypeEvaluatorPersistable

public static final PersistenceTypeEvaluator defaultTypeEvaluatorPersistable()

defaultFieldEvaluatorPersistable

public static final PersistenceFieldEvaluator defaultFieldEvaluatorPersistable()

defaultFieldEvaluatorPersister

public static final PersistenceFieldEvaluator defaultFieldEvaluatorPersister()

isPersisterField

public static final boolean isPersisterField(Field field)

isHandleableEnumField

public static boolean isHandleableEnumField(Class<?> enumClass,
                                            Field field)

defaultFieldEvaluatorEnum

public static final PersistenceFieldEvaluator defaultFieldEvaluatorEnum()

isHandleableCollectionField

public static boolean isHandleableCollectionField(Class<?> collectionClass,
                                                  Field field)

defaultFieldEvaluatorCollection

public static final PersistenceFieldEvaluator defaultFieldEvaluatorCollection()

defaultReferenceFieldEagerEvaluator

public static final PersistenceEagerStoringFieldEvaluator defaultReferenceFieldEagerEvaluator()

resolveEnumeratedClassIdentifierSeparatedType

public static <T> Class<T> resolveEnumeratedClassIdentifierSeparatedType(String typeName,
                                                                         String substituteClassIdentifierSeparator)

resolveType

public static <T> Class<T> resolveType(String typeName)

resolveType

public static <T> Class<T> resolveType(String typeName,
                                       String substituteClassIdentifierSeparator)

tryResolveType

public static <T> Class<T> tryResolveType(String typeName)

deriveEnumRootIdentifier

public static String deriveEnumRootIdentifier(PersistenceTypeHandler<?,?> typeHandler)

collectEnumConstants

public static Object[] collectEnumConstants(PersistenceTypeHandler<?,?> typeHandler)

enumRootIdentifierStart

public static String enumRootIdentifierStart()

parseEnumRootIdentifierTypeId

public static Long parseEnumRootIdentifierTypeId(String enumRootIdentifier)

isEnumRootIdentifier

public static boolean isEnumRootIdentifier(String enumRootIdentifier)

isPotentialEnumRootIdentifier

public static boolean isPotentialEnumRootIdentifier(String enumRootIdentifier)

defaultRootIdentifier

@Deprecated
public static final String defaultRootIdentifier()

Deprecated.

customRootIdentifier

@Deprecated
public static final String customRootIdentifier()

Deprecated.

rootIdentifier

public static final String rootIdentifier()

RefactoringMapping

@Deprecated
public static final PersistenceRefactoringMappingProvider RefactoringMapping(File refactoringsFile)

Deprecated.

RefactoringMapping

public static final PersistenceRefactoringMappingProvider RefactoringMapping(Path refactoringsFile)

RefactoringMapping

public static final PersistenceRefactoringMappingProvider RefactoringMapping(XGettingSequence<KeyValue<String,String>> refactoringMappings)

readRefactoringMappings

@Deprecated
public static XGettingSequence<KeyValue<String,String>> readRefactoringMappings(File file)

Deprecated.

readRefactoringMappings

public static XGettingSequence<KeyValue<String,String>> readRefactoringMappings(Path file)

substituteClassIdentifierSeparator

public static final String substituteClassIdentifierSeparator()

Persistence-specific separator between a class name and a proper identifier that replaces unreliable class names (like "$1", "$2" etc.) by a reliably identifying substitute name.

derivePersistentTypeName

public static final String derivePersistentTypeName(Class<?> type)

derivePersistentTypeName

public static final String derivePersistentTypeName(Class<?> type,
                                                    String substituteClassIdentifierSeparator)

derivePersistentTypeNameEnum

public static final String derivePersistentTypeNameEnum(Class<?> type,
                                                        String substituteClassIdentifierSeparator)