com.sleepycat.persist.impl

Class ObjectArrayFormat

java.lang.Object

com.sleepycat.persist.impl.Format

com.sleepycat.persist.impl.ObjectArrayFormat

All Implemented Interfaces:

RawType, Serializable

public class ObjectArrayFormat
extends Format

An array of objects having a specified number of dimensions. All multidimensional arrays are handled by this class, since even a primitive array of more than one dimension is an array of objects, where the component objects may be primitive arrays. The PrimitiveArrayFormat class handles primitive arrays of one dimension only. In this class, and PrimitiveArrayFormat, we resort to using reflection to allocate multidimensional arrays. If there is a need for it, reflection could be avoided in the future by generating code as new array formats are encountered.

Author:

Mark Hayes

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
Format	getComponentType() Returns the array component type, or null if this is not an array type.
int	getDimensions() Returns the number of array dimensions, or zero if this is not an array type.
boolean	isArray() Returns whether this is an array type.
Object	newInstance(EntityInput input, boolean rawAccess) Creates a new instance of the target class using its default constructor.
Object	readObject(Object o, EntityInput input, boolean rawAccess) Called after newInstance() to read the rest of the data bytes and fill in the object contents.

Methods inherited from class com.sleepycat.persist.impl.Format

allowEvolveFromProxy, getAccessor, getClassMetadata, getClassName, getEntityMetadata, getEnumConstants, getFields, getId, getOldKeyName, getPreviousVersion, getSuperType, getVersion, initializeReader, isDeleted, isEnum, isPrimitive, isSimple, readPriKey, toString

Methods inherited from class java.lang.Object

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

Method Detail

isArray

public boolean isArray()

Description copied from interface: RawType

Returns whether this is an array type. Raw value arrays are represented as RawObject instances.

If true is returned, the array component type is returned by RawType.getComponentType() and the number of array dimensions is returned by RawType.getDimensions().

If false is returned, then this is a complex type, an enum type (see RawType.isEnum()), or a simple type (see RawType.isSimple()).

Specified by:

isArray in interface RawType

Overrides:

isArray in class Format

Returns:

whether this is an array type.

getDimensions

public int getDimensions()

Description copied from interface: RawType

Returns the number of array dimensions, or zero if this is not an array type.

Specified by:

getDimensions in interface RawType

Overrides:

getDimensions in class Format

Returns:

the number of array dimensions, or zero if this is not an array type.

getComponentType

public Format getComponentType()

Description copied from interface: RawType

Returns the array component type, or null if this is not an array type.

Specified by:

getComponentType in interface RawType

Overrides:

getComponentType in class Format

Returns:

the array component type, or null if this is not an array type.

newInstance

public Object newInstance(EntityInput input,
                          boolean rawAccess)

Description copied from class: Format

Creates a new instance of the target class using its default constructor. Normally this creates an empty object, and readObject() is called next to fill in the contents. This is done in two steps to allow the instance to be registered by EntityInput before reading the contents. This allows the fields in an object or a nested object to refer to the parent object in a graph. Alternatively, this method may read all or the first portion of the data, rather than that being done by readObject(). This is required for simple types and enums, where the object cannot be created without reading the data. In these cases, there is no possibility that the parent object will be referenced by the child object in the graph. It should not be done in other cases, or the graph references may not be maintained faithfully. Is public only in order to implement the Reader interface. Note that this method should only be called directly in raw conversion mode or during conversion of an old format. Normally it should be called via the getReader method and the Reader interface.

Specified by:

newInstance in class Format

readObject

public Object readObject(Object o,
                         EntityInput input,
                         boolean rawAccess)
                  throws RefreshException

Description copied from class: Format

Called after newInstance() to read the rest of the data bytes and fill in the object contents. If the object was read completely by newInstance(), this method does nothing. Is public only in order to implement the Reader interface. Note that this method should only be called directly in raw conversion mode or during conversion of an old format. Normally it should be called via the getReader method and the Reader interface.

Specified by:

readObject in class Format

Throws:

RefreshException