Package com.esotericsoftware.kryo.util
Class MapReferenceResolver
- java.lang.Object
-
- com.esotericsoftware.kryo.util.MapReferenceResolver
-
- All Implemented Interfaces:
ReferenceResolver
public class MapReferenceResolver extends java.lang.Object implements ReferenceResolver
Uses anIdentityObjectIntMap
to track objects that have already been written. This can handle a graph with any number of objects, but is slightly slower thanListReferenceResolver
for graphs with few objects. Compared toHashMapReferenceResolver
, this may provide better performance since the IdentityObjectIntMap does not normally allocate for get or put.- Author:
- Nathan Sweet
-
-
Field Summary
Fields Modifier and Type Field Description protected Kryo
kryo
protected java.util.ArrayList<java.lang.Object>
readObjects
protected IdentityObjectIntMap<java.lang.Object>
writtenObjects
-
Constructor Summary
Constructors Constructor Description MapReferenceResolver()
Creates a reference resolver with a default maximum capacity of 2048MapReferenceResolver(int maximumCapacity)
Creates a reference resolver with the specified maximum capacity.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description int
addWrittenObject(java.lang.Object object)
Returns a new ID for an object that is being written for the first time.java.lang.Object
getReadObject(java.lang.Class type, int id)
Returns the object for the specified ID.int
getWrittenId(java.lang.Object object)
Returns an ID for the object if it has been written previously, otherwise returns -1.int
nextReadId(java.lang.Class type)
Reserves the ID for the next object that will be read.void
reset()
Called byKryo.reset()
.void
setKryo(Kryo kryo)
Sets the Kryo instance that this ClassResolver will be used for.void
setReadObject(int id, java.lang.Object object)
Sets the ID for an object that has been read.boolean
useReferences(java.lang.Class type)
Returns false for all primitive wrappers and enums.
-
-
-
Field Detail
-
kryo
protected Kryo kryo
-
writtenObjects
protected final IdentityObjectIntMap<java.lang.Object> writtenObjects
-
readObjects
protected final java.util.ArrayList<java.lang.Object> readObjects
-
-
Constructor Detail
-
MapReferenceResolver
public MapReferenceResolver()
Creates a reference resolver with a default maximum capacity of 2048
-
MapReferenceResolver
public MapReferenceResolver(int maximumCapacity)
Creates a reference resolver with the specified maximum capacity. The default value of 2048 is good enough in most cases. If the average object graph is larger than the default, increasing this value can provide better performance.- Parameters:
maximumCapacity
- the capacity to trim written and read objects to whenreset()
is called
-
-
Method Detail
-
setKryo
public void setKryo(Kryo kryo)
Description copied from interface:ReferenceResolver
Sets the Kryo instance that this ClassResolver will be used for. This is called automatically by Kryo.- Specified by:
setKryo
in interfaceReferenceResolver
-
addWrittenObject
public int addWrittenObject(java.lang.Object object)
Description copied from interface:ReferenceResolver
Returns a new ID for an object that is being written for the first time.- Specified by:
addWrittenObject
in interfaceReferenceResolver
- Returns:
- The ID, which is stored more efficiently if it is positive and must not be -1 or -2.
-
getWrittenId
public int getWrittenId(java.lang.Object object)
Description copied from interface:ReferenceResolver
Returns an ID for the object if it has been written previously, otherwise returns -1.- Specified by:
getWrittenId
in interfaceReferenceResolver
-
nextReadId
public int nextReadId(java.lang.Class type)
Description copied from interface:ReferenceResolver
Reserves the ID for the next object that will be read. This is called only the first time an object is encountered.- Specified by:
nextReadId
in interfaceReferenceResolver
- Parameters:
type
- The type of object that will be read.- Returns:
- The ID, which is stored more efficiently if it is positive and must not be -1 or -2.
-
setReadObject
public void setReadObject(int id, java.lang.Object object)
Description copied from interface:ReferenceResolver
Sets the ID for an object that has been read.- Specified by:
setReadObject
in interfaceReferenceResolver
- Parameters:
id
- The ID fromReferenceResolver.nextReadId(Class)
.
-
getReadObject
public java.lang.Object getReadObject(java.lang.Class type, int id)
Description copied from interface:ReferenceResolver
Returns the object for the specified ID. The ID and object are guaranteed to have been previously passed in a call toReferenceResolver.setReadObject(int, Object)
.- Specified by:
getReadObject
in interfaceReferenceResolver
-
reset
public void reset()
Description copied from interface:ReferenceResolver
Called byKryo.reset()
.- Specified by:
reset
in interfaceReferenceResolver
-
useReferences
public boolean useReferences(java.lang.Class type)
Returns false for all primitive wrappers and enums.- Specified by:
useReferences
in interfaceReferenceResolver
- Parameters:
type
- Will never be a primitive type, but may be a primitive type wrapper.
-
-