Package io.protostuff.runtime

Class IncrementalIdStrategy

java.lang.Object

io.protostuff.runtime.IdStrategy

io.protostuff.runtime.NumericIdStrategy

io.protostuff.runtime.IncrementalIdStrategy

public final class IncrementalIdStrategy
extends NumericIdStrategy

The ids are generated (incremental) on the fly and you can optionally register classes by reserving the first x ids via IncrementalIdStrategy.Registry. To minimize overhead, ArrayLists are used for the id mapping rather than ConcurrentHashMap. This optimization has a disadvantage though. Ids will not be unlimited. You'll have to specificy a max id for the 4 types (pojo, enum, collection, map)

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	IncrementalIdStrategy.BaseHS<T>
static class	IncrementalIdStrategy.Factory	To use IncrementalIdStrategy without registering anything, set the system property: "-Dprotostuff.runtime.id_strategy_factory=io.protostuff.runtime.IncrementalIdStrategy$Factory"
(package private) static class	IncrementalIdStrategy.Lazy<T>
(package private) static class	IncrementalIdStrategy.LazyRegister<T>
(package private) static class	IncrementalIdStrategy.Registered<T>
static class	IncrementalIdStrategy.Registry	This Registry is only way to register your pojos/enums/collections/maps/delegates.
(package private) static class	IncrementalIdStrategy.RuntimeCollectionFactory
(package private) static class	IncrementalIdStrategy.RuntimeEnumIO
(package private) static class	IncrementalIdStrategy.RuntimeMapFactory

Nested classes/interfaces inherited from class io.protostuff.runtime.NumericIdStrategy

NumericIdStrategy.RegisteredDelegate<T>

Nested classes/interfaces inherited from class io.protostuff.runtime.IdStrategy

IdStrategy.UnknownTypeException, IdStrategy.Wrapper

Field Summary

Fields

Modifier and Type	Field	Description
(package private) java.util.concurrent.atomic.AtomicInteger	collectionId
(package private) int	collectionIdStart
(package private) java.util.concurrent.ConcurrentHashMap<java.lang.Class<?>,IncrementalIdStrategy.RuntimeCollectionFactory>	collectionMapping
(package private) java.util.ArrayList<IncrementalIdStrategy.RuntimeCollectionFactory>	collections
(package private) java.util.IdentityHashMap<java.lang.Class<?>,NumericIdStrategy.RegisteredDelegate<?>>	delegateMapping
(package private) java.util.ArrayList<NumericIdStrategy.RegisteredDelegate<?>>	delegates
(package private) java.util.concurrent.atomic.AtomicInteger	enumId
(package private) int	enumIdStart
(package private) java.util.concurrent.ConcurrentHashMap<java.lang.Class<?>,IncrementalIdStrategy.RuntimeEnumIO>	enumMapping
(package private) java.util.ArrayList<IncrementalIdStrategy.RuntimeEnumIO>	enums
(package private) java.util.concurrent.atomic.AtomicInteger	mapId
(package private) int	mapIdStart
(package private) java.util.concurrent.ConcurrentHashMap<java.lang.Class<?>,IncrementalIdStrategy.RuntimeMapFactory>	mapMapping
(package private) java.util.ArrayList<IncrementalIdStrategy.RuntimeMapFactory>	maps
(package private) java.util.concurrent.atomic.AtomicInteger	pojoId
(package private) int	pojoIdStart
(package private) java.util.concurrent.ConcurrentHashMap<java.lang.Class<?>,IncrementalIdStrategy.BaseHS<?>>	pojoMapping
(package private) java.util.ArrayList<IncrementalIdStrategy.BaseHS<?>>	pojos

Fields inherited from class io.protostuff.runtime.NumericIdStrategy

CID_BIGDECIMAL, CID_BIGINTEGER, CID_BOOL, CID_BYTE, CID_BYTE_ARRAY, CID_BYTES, CID_CHAR, CID_CLASS, CID_COLLECTION, CID_DATE, CID_DELEGATE, CID_DOUBLE, CID_ENUM, CID_ENUM_MAP, CID_ENUM_SET, CID_FLOAT, CID_INT32, CID_INT64, CID_MAP, CID_OBJECT, CID_POJO, CID_SHORT, CID_STRING

Fields inherited from class io.protostuff.runtime.IdStrategy

ARRAY_BIGDECIMAL_SCHEMA, ARRAY_BIGINTEGER_SCHEMA, ARRAY_BOOL_BOXED_SCHEMA, ARRAY_BOOL_DERIVED_SCHEMA, ARRAY_BOOL_PRIMITIVE_SCHEMA, ARRAY_BYTEARRAY_SCHEMA, ARRAY_BYTESTRING_SCHEMA, ARRAY_CHAR_BOXED_SCHEMA, ARRAY_CHAR_DERIVED_SCHEMA, ARRAY_CHAR_PRIMITIVE_SCHEMA, ARRAY_DATE_SCHEMA, ARRAY_DOUBLE_BOXED_SCHEMA, ARRAY_DOUBLE_DERIVED_SCHEMA, ARRAY_DOUBLE_PRIMITIVE_SCHEMA, ARRAY_ELEMENT_SCHEMA, ARRAY_FLOAT_BOXED_SCHEMA, ARRAY_FLOAT_DERIVED_SCHEMA, ARRAY_FLOAT_PRIMITIVE_SCHEMA, ARRAY_INT32_BOXED_SCHEMA, ARRAY_INT32_DERIVED_SCHEMA, ARRAY_INT32_PRIMITIVE_SCHEMA, ARRAY_INT64_BOXED_SCHEMA, ARRAY_INT64_DERIVED_SCHEMA, ARRAY_INT64_PRIMITIVE_SCHEMA, ARRAY_PIPE_SCHEMA, ARRAY_SCHEMA, ARRAY_SHORT_BOXED_SCHEMA, ARRAY_SHORT_DERIVED_SCHEMA, ARRAY_SHORT_PRIMITIVE_SCHEMA, ARRAY_STRING_SCHEMA, AUTO_LOAD_POLYMORPHIC_CLASSES, CLASS_ELEMENT_SCHEMA, CLASS_PIPE_SCHEMA, CLASS_SCHEMA, COLLECTION_PIPE_SCHEMA, COLLECTION_SCHEMA, COLLECTION_SCHEMA_ON_REPEATED_FIELDS, DEFAULT_FLAGS, DYNAMIC_VALUE_PIPE_SCHEMA, DYNAMIC_VALUE_SCHEMA, ENTRY_PIPE_SCHEMA, ENTRY_SCHEMA, ENUMS_BY_NAME, flags, groupId, MAP_PIPE_SCHEMA, MAP_SCHEMA, MORPH_COLLECTION_INTERFACES, MORPH_MAP_INTERFACES, MORPH_NON_FINAL_POJOS, NUMBER_ELEMENT_SCHEMA, OBJECT_ELEMENT_SCHEMA, OBJECT_PIPE_SCHEMA, OBJECT_SCHEMA, POJO_SCHEMA_ON_COLLECTION_FIELDS, POJO_SCHEMA_ON_MAP_FIELDS, POLYMORPHIC_COLLECTION_PIPE_SCHEMA, POLYMORPHIC_COLLECTION_SCHEMA, POLYMORPHIC_ENUM_ELEMENT_SCHEMA, POLYMORPHIC_MAP_PIPE_SCHEMA, POLYMORPHIC_MAP_SCHEMA, POLYMORPHIC_POJO_ELEMENT_SCHEMA, POLYMORPHIC_THROWABLE_ELEMENT_SCHEMA, PRESERVE_NULL_ELEMENTS, preserveNull, primaryGroup

Constructor Summary

Constructors

Constructor	Description
IncrementalIdStrategy(int collectionIdMax, int collectionIdStart, int mapIdMax, int mapIdStart, int enumIdMax, int enumIdStart, int pojoIdMax, int pojoIdStart)
IncrementalIdStrategy(int flags, IdStrategy primaryGroup, int groupId, int collectionIdMax, int collectionIdStart, int mapIdMax, int mapIdStart, int enumIdMax, int enumIdStart, int pojoIdMax, int pojoIdStart)

Method Summary

Modifier and Type	Method	Description
protected java.lang.Class<?>	collectionClass(int id)
protected java.lang.Class<?>	delegateClass(int id)
protected java.lang.Class<?>	enumClass(int id)
private <T> IncrementalIdStrategy.BaseHS<T>	getBaseHS(java.lang.Class<T> typeClass, boolean create)
protected CollectionSchema.MessageFactory	getCollectionFactory(java.lang.Class<?> clazz)	Returns the CollectionSchema.MessageFactory.
<T> Delegate<T>	getDelegate(java.lang.Class<? super T> typeClass)	Returns the delegate.
<T> HasDelegate<T>	getDelegateWrapper(java.lang.Class<? super T> typeClass)	Returns the delegate.
protected int	getEnumId(java.lang.Class<?> clazz)
protected EnumIO<? extends java.lang.Enum<?>>	getEnumIO(java.lang.Class<?> enumClass)	Returns the EnumIO.
protected int	getId(java.lang.Class<?> clazz)
protected MapSchema.MessageFactory	getMapFactory(java.lang.Class<?> clazz)	Returns the MapSchema.MessageFactory.
protected NumericIdStrategy.RegisteredDelegate<?>	getRegisteredDelegate(java.lang.Class<?> clazz)
private IncrementalIdStrategy.RuntimeCollectionFactory	getRuntimeCollectionFactory(java.lang.Class<?> clazz)
private IncrementalIdStrategy.RuntimeEnumIO	getRuntimeEnumIO(java.lang.Class<?> enumClass)
private IncrementalIdStrategy.RuntimeMapFactory	getRuntimeMapFactory(java.lang.Class<?> clazz)
<T> HasSchema<T>	getSchemaWrapper(java.lang.Class<T> typeClass, boolean create)	Returns the schema wrapper.
boolean	isDelegateRegistered(java.lang.Class<?> typeClass)	Returns true if there is a Delegate explicitly registered for the typeClass.
boolean	isRegistered(java.lang.Class<?> typeClass)	Returns true if the typeClass is explicitly registered.
protected java.lang.Class<?>	mapClass(int id)
protected java.lang.Class<?>	pojoClass(int id)
protected CollectionSchema.MessageFactory	resolveCollectionFrom(Input input)
protected <T> HasDelegate<T>	resolveDelegateFrom(Input input)
protected EnumIO<?>	resolveEnumFrom(Input input)
protected MapSchema.MessageFactory	resolveMapFrom(Input input)
protected <T> HasSchema<T>	resolvePojoFrom(Input input, int fieldNumber)
protected void	transferCollectionId(Input input, Output output, int fieldNumber)
protected <T> HasDelegate<T>	transferDelegateId(Input input, Output output, int fieldNumber)
protected void	transferEnumId(Input input, Output output, int fieldNumber)
protected void	transferMapId(Input input, Output output, int fieldNumber)
protected <T> HasSchema<T>	transferPojoId(Input input, Output output, int fieldNumber)
protected <T> HasDelegate<T>	tryWriteDelegateIdTo(Output output, int fieldNumber, java.lang.Class<T> clazz)	If this method returns null, the clazz was not registered as a delegate.
protected <T> HasSchema<T>	tryWritePojoIdTo(Output output, int fieldNumber, java.lang.Class<T> clazz, boolean registered)
protected void	writeCollectionIdTo(Output output, int fieldNumber, java.lang.Class<?> clazz)
protected void	writeEnumIdTo(Output output, int fieldNumber, java.lang.Class<?> clazz)
protected void	writeMapIdTo(Output output, int fieldNumber, java.lang.Class<?> clazz)
protected <T> Schema<T>	writeMessageIdTo(Output output, int fieldNumber, Message<T> message)
protected <T> HasSchema<T>	writePojoIdTo(Output output, int fieldNumber, java.lang.Class<T> clazz)

Methods inherited from class io.protostuff.runtime.NumericIdStrategy

grow, newList, resolveArrayComponentTypeFrom, resolveClassFrom, transferArrayId, transferClassId, writeArrayIdTo, writeClassIdTo

Methods inherited from class io.protostuff.runtime.IdStrategy

createMessageInstance, newSchema

Methods inherited from class java.lang.Object

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

Field Detail

collectionMapping

final java.util.concurrent.ConcurrentHashMap<java.lang.Class<?>,IncrementalIdStrategy.RuntimeCollectionFactory> collectionMapping

collections

final java.util.ArrayList<IncrementalIdStrategy.RuntimeCollectionFactory> collections

mapMapping

final java.util.concurrent.ConcurrentHashMap<java.lang.Class<?>,IncrementalIdStrategy.RuntimeMapFactory> mapMapping

maps

final java.util.ArrayList<IncrementalIdStrategy.RuntimeMapFactory> maps

enumMapping

final java.util.concurrent.ConcurrentHashMap<java.lang.Class<?>,IncrementalIdStrategy.RuntimeEnumIO> enumMapping

enums

final java.util.ArrayList<IncrementalIdStrategy.RuntimeEnumIO> enums

pojoMapping

final java.util.concurrent.ConcurrentHashMap<java.lang.Class<?>,IncrementalIdStrategy.BaseHS<?>> pojoMapping

pojos

final java.util.ArrayList<IncrementalIdStrategy.BaseHS<?>> pojos

delegateMapping

final java.util.IdentityHashMap<java.lang.Class<?>,NumericIdStrategy.RegisteredDelegate<?>> delegateMapping

delegates

final java.util.ArrayList<NumericIdStrategy.RegisteredDelegate<?>> delegates

pojoId

final java.util.concurrent.atomic.AtomicInteger pojoId

enumId

final java.util.concurrent.atomic.AtomicInteger enumId

collectionId

final java.util.concurrent.atomic.AtomicInteger collectionId

mapId

final java.util.concurrent.atomic.AtomicInteger mapId

pojoIdStart

final int pojoIdStart

enumIdStart

final int enumIdStart

collectionIdStart

final int collectionIdStart

mapIdStart

final int mapIdStart

Constructor Detail

IncrementalIdStrategy

public IncrementalIdStrategy(int collectionIdMax,
                             int collectionIdStart,
                             int mapIdMax,
                             int mapIdStart,
                             int enumIdMax,
                             int enumIdStart,
                             int pojoIdMax,
                             int pojoIdStart)

IncrementalIdStrategy

public IncrementalIdStrategy(int flags,
                             IdStrategy primaryGroup,
                             int groupId,
                             int collectionIdMax,
                             int collectionIdStart,
                             int mapIdMax,
                             int mapIdStart,
                             int enumIdMax,
                             int enumIdStart,
                             int pojoIdMax,
                             int pojoIdStart)

Method Detail

isRegistered

public boolean isRegistered(java.lang.Class<?> typeClass)

Description copied from class: IdStrategy

Returns true if the typeClass is explicitly registered.

Specified by:

isRegistered in class IdStrategy

getBaseHS

private <T> IncrementalIdStrategy.BaseHS<T> getBaseHS(java.lang.Class<T> typeClass,
                                                      boolean create)

getSchemaWrapper

public <T> HasSchema<T> getSchemaWrapper(java.lang.Class<T> typeClass,
                                         boolean create)

Description copied from class: IdStrategy

Returns the schema wrapper. The caller is responsible that the typeClass is a pojo (e.g not an enum/array/etc).

Specified by:

getSchemaWrapper in class IdStrategy

getRuntimeEnumIO

private IncrementalIdStrategy.RuntimeEnumIO getRuntimeEnumIO(java.lang.Class<?> enumClass)

getEnumIO

protected EnumIO<? extends java.lang.Enum<?>> getEnumIO(java.lang.Class<?> enumClass)

Description copied from class: IdStrategy

Returns the EnumIO. The callers (internal field factories) are responsible that the class provided is an enum class.

Specified by:

getEnumIO in class IdStrategy

getRuntimeCollectionFactory

private IncrementalIdStrategy.RuntimeCollectionFactory getRuntimeCollectionFactory(java.lang.Class<?> clazz)

getCollectionFactory

protected CollectionSchema.MessageFactory getCollectionFactory(java.lang.Class<?> clazz)

Description copied from class: IdStrategy

Returns the CollectionSchema.MessageFactory. The callers (internal field factories) are responsible that the class provided implements Collection.

Specified by:

getCollectionFactory in class IdStrategy

getRuntimeMapFactory

private IncrementalIdStrategy.RuntimeMapFactory getRuntimeMapFactory(java.lang.Class<?> clazz)

getMapFactory

protected MapSchema.MessageFactory getMapFactory(java.lang.Class<?> clazz)

Description copied from class: IdStrategy

Returns the MapSchema.MessageFactory. The callers (internal field factories}) are responsible that the class provided implements Map.

Specified by:

getMapFactory in class IdStrategy

writeCollectionIdTo

protected void writeCollectionIdTo(Output output,
                                   int fieldNumber,
                                   java.lang.Class<?> clazz)
                            throws java.io.IOException

Specified by:

writeCollectionIdTo in class IdStrategy

Throws:

java.io.IOException

transferCollectionId

protected void transferCollectionId(Input input,
                                    Output output,
                                    int fieldNumber)
                             throws java.io.IOException

Specified by:

transferCollectionId in class IdStrategy

Throws:

java.io.IOException

resolveCollectionFrom

protected CollectionSchema.MessageFactory resolveCollectionFrom(Input input)
                                                         throws java.io.IOException

Specified by:

resolveCollectionFrom in class IdStrategy

Throws:

java.io.IOException

writeMapIdTo

protected void writeMapIdTo(Output output,
                            int fieldNumber,
                            java.lang.Class<?> clazz)
                     throws java.io.IOException

Specified by:

writeMapIdTo in class IdStrategy

Throws:

java.io.IOException

transferMapId

protected void transferMapId(Input input,
                             Output output,
                             int fieldNumber)
                      throws java.io.IOException

Specified by:

transferMapId in class IdStrategy

Throws:

java.io.IOException

resolveMapFrom

protected MapSchema.MessageFactory resolveMapFrom(Input input)
                                           throws java.io.IOException

Specified by:

resolveMapFrom in class IdStrategy

Throws:

java.io.IOException

writeEnumIdTo

protected void writeEnumIdTo(Output output,
                             int fieldNumber,
                             java.lang.Class<?> clazz)
                      throws java.io.IOException

Specified by:

writeEnumIdTo in class IdStrategy

Throws:

java.io.IOException

transferEnumId

protected void transferEnumId(Input input,
                              Output output,
                              int fieldNumber)
                       throws java.io.IOException

Specified by:

transferEnumId in class IdStrategy

Throws:

java.io.IOException

resolveEnumFrom

protected EnumIO<?> resolveEnumFrom(Input input)
                             throws java.io.IOException

Specified by:

resolveEnumFrom in class IdStrategy

Throws:

java.io.IOException

isDelegateRegistered

public boolean isDelegateRegistered(java.lang.Class<?> typeClass)

Description copied from class: IdStrategy

Returns true if there is a Delegate explicitly registered for the typeClass.

Specified by:

isDelegateRegistered in class IdStrategy

getDelegate

public <T> Delegate<T> getDelegate(java.lang.Class<? super T> typeClass)

Description copied from class: IdStrategy

Returns the delegate.

Specified by:

getDelegate in class IdStrategy

getDelegateWrapper

public <T> HasDelegate<T> getDelegateWrapper(java.lang.Class<? super T> typeClass)

Description copied from class: IdStrategy

Returns the delegate.

Specified by:

getDelegateWrapper in class IdStrategy

tryWriteDelegateIdTo

protected <T> HasDelegate<T> tryWriteDelegateIdTo(Output output,
                                                  int fieldNumber,
                                                  java.lang.Class<T> clazz)
                                           throws java.io.IOException

Description copied from class: IdStrategy

If this method returns null, the clazz was not registered as a delegate.

Specified by:

tryWriteDelegateIdTo in class IdStrategy

Throws:

java.io.IOException

transferDelegateId

protected <T> HasDelegate<T> transferDelegateId(Input input,
                                                Output output,
                                                int fieldNumber)
                                         throws java.io.IOException

Specified by:

transferDelegateId in class IdStrategy

Throws:

java.io.IOException

resolveDelegateFrom

protected <T> HasDelegate<T> resolveDelegateFrom(Input input)
                                          throws java.io.IOException

Specified by:

resolveDelegateFrom in class IdStrategy

Throws:

java.io.IOException

tryWritePojoIdTo

protected <T> HasSchema<T> tryWritePojoIdTo(Output output,
                                            int fieldNumber,
                                            java.lang.Class<T> clazz,
                                            boolean registered)
                                     throws java.io.IOException

Specified by:

tryWritePojoIdTo in class IdStrategy

Throws:

java.io.IOException

writePojoIdTo

protected <T> HasSchema<T> writePojoIdTo(Output output,
                                         int fieldNumber,
                                         java.lang.Class<T> clazz)
                                  throws java.io.IOException

Specified by:

writePojoIdTo in class IdStrategy

Throws:

java.io.IOException

transferPojoId

protected <T> HasSchema<T> transferPojoId(Input input,
                                          Output output,
                                          int fieldNumber)
                                   throws java.io.IOException

Specified by:

transferPojoId in class IdStrategy

Throws:

java.io.IOException

resolvePojoFrom

protected <T> HasSchema<T> resolvePojoFrom(Input input,
                                           int fieldNumber)
                                    throws java.io.IOException

Specified by:

resolvePojoFrom in class IdStrategy

Throws:

java.io.IOException

writeMessageIdTo

protected <T> Schema<T> writeMessageIdTo(Output output,
                                         int fieldNumber,
                                         Message<T> message)
                                  throws java.io.IOException

Specified by:

writeMessageIdTo in class IdStrategy

Throws:

java.io.IOException

collectionClass

protected java.lang.Class<?> collectionClass(int id)

Specified by:

collectionClass in class NumericIdStrategy

mapClass

protected java.lang.Class<?> mapClass(int id)

Specified by:

mapClass in class NumericIdStrategy

enumClass

protected java.lang.Class<?> enumClass(int id)

Specified by:

enumClass in class NumericIdStrategy

delegateClass

protected java.lang.Class<?> delegateClass(int id)

Specified by:

delegateClass in class NumericIdStrategy

pojoClass

protected java.lang.Class<?> pojoClass(int id)

Specified by:

pojoClass in class NumericIdStrategy

getRegisteredDelegate

protected NumericIdStrategy.RegisteredDelegate<?> getRegisteredDelegate(java.lang.Class<?> clazz)

Specified by:

getRegisteredDelegate in class NumericIdStrategy

getEnumId

protected int getEnumId(java.lang.Class<?> clazz)

Specified by:

getEnumId in class NumericIdStrategy

getId

protected int getId(java.lang.Class<?> clazz)

Specified by:

getId in class NumericIdStrategy