com.sleepycat.persist.impl

Class ProxiedFormat

java.lang.Object

com.sleepycat.persist.impl.Format

com.sleepycat.persist.impl.ProxiedFormat

All Implemented Interfaces:

Reader, RawType, java.io.Serializable

public class ProxiedFormat
extends Format

Format for types proxied by a PersistentProxy.

Author:

Mark Hayes

See Also:

Serialized Form

Field Summary

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

ID_BIGDEC, ID_BIGINT, ID_BOOL, ID_BOOL_W, ID_BYTE, ID_BYTE_W, ID_CHAR, ID_CHAR_W, ID_DATE, ID_DOUBLE, ID_DOUBLE_W, ID_FLOAT, ID_FLOAT_W, ID_INT, ID_INT_W, ID_LONG, ID_LONG_W, ID_NULL, ID_NUMBER, ID_OBJECT, ID_PREDEFINED, ID_SHORT, ID_SHORT_W, ID_SIMPLE_MAX, ID_SIMPLE_MIN, ID_STRING

Constructor Summary

Constructors

Constructor and Description
ProxiedFormat(Catalog catalog, java.lang.Class proxiedType, java.lang.String proxyClassName)

Method Summary

Methods

Modifier and Type	Method and Description
(package private) boolean	areNestedRefsProhibited() In the future if we implement container proxies, which support nested references to the container, then we will return false if this is a container proxy.
(package private) void	collectRelatedFormats(Catalog catalog, java.util.Map<java.lang.String,Format> newFormats) Calls catalog.createFormat for formats that this format depends on, or that should also be persistent.
(package private) java.lang.Object	convertRawObject(Catalog catalog, boolean rawAccess, RawObject rawObject, IdentityHashMap converted) Converts a RawObject to a current class object and adds the converted pair to the converted map.
(package private) void	copySecMultiKey(RecordInput input, Format keyFormat, java.util.Set results) Called after skipToSecKey() to copy the data bytes of an array or collection (XXX_TO_MANY) key field.
(package private) boolean	evolve(Format newFormatParam, Evolver evolver) Called for an existing format that may not equal the current format for the same class.
(package private) void	initialize(Catalog catalog, EntityModel model, int initVersion) Initializes an uninitialized format, initializing its related formats (superclass formats and array component formats) first.
(package private) java.lang.Object	newArray(int len) Creates an array of the format's class of the given length, as if Array.newInstance(getType(), len) were called.
java.lang.Object	newInstance(EntityInput input, boolean rawAccess) Creates a new instance of the target class using its default constructor.
java.lang.Object	readObject(java.lang.Object o, EntityInput input, boolean rawAccess) Called after newInstance() to read the rest of the data bytes and fill in the object contents.
(package private) void	skipContents(RecordInput input) Skips over the object's contents, as if readObject() were called, but without returning an object.
(package private) void	writeObject(java.lang.Object o, EntityOutput output, boolean rawAccess) Writes a given instance of the target class to the output data bytes.

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

allowEvolveFromProxy, copySecKey, evolveMetadata, getAccessor, getCatalog, getClassMetadata, getClassName, getComponentType, getDimensions, getEntityFormat, getEntityMetadata, getEnumConstants, getEvolveNeeded, getExistingType, getFields, getId, getLatestVersion, getNewStringFormat, getOldKeyName, getPreviousVersion, getProxiedFormat, getReader, getSequenceKeyFormat, getSuperFormat, getSuperType, getType, getVersion, getWrapperFormat, initCatalog, initializeIfNeeded, initializeReader, isArray, isAssignableTo, isCurrentVersion, isDeleted, isEntity, isEnum, isInitialized, isModelClass, isNew, isPredefined, isPriKeyNullOrZero, isPrimitive, isSameClass, isSimple, migrateFromBeta, nullifySecKey, readPriKey, setDeleted, setEvolveNeeded, setId, setLatestVersion, setProxiedFormat, setReader, setSuperFormat, setUnused, skipToSecKey, toString, writePriKey

Methods inherited from class java.lang.Object

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

Constructor Detail

ProxiedFormat

ProxiedFormat(Catalog catalog,
             java.lang.Class proxiedType,
             java.lang.String proxyClassName)

Method Detail

areNestedRefsProhibited

boolean areNestedRefsProhibited()

In the future if we implement container proxies, which support nested references to the container, then we will return false if this is a container proxy. [#15815]

Overrides:

areNestedRefsProhibited in class Format

collectRelatedFormats

void collectRelatedFormats(Catalog catalog,
                         java.util.Map<java.lang.String,Format> newFormats)

Description copied from class: Format

Calls catalog.createFormat for formats that this format depends on, or that should also be persistent.

Specified by:

collectRelatedFormats in class Format

initialize

void initialize(Catalog catalog,
              EntityModel model,
              int initVersion)

Description copied from class: Format

Initializes an uninitialized format, initializing its related formats (superclass formats and array component formats) first.

Specified by:

initialize in class Format

newArray

java.lang.Object newArray(int len)

Description copied from class: Format

Creates an array of the format's class of the given length, as if Array.newInstance(getType(), len) were called. Formats implement this method for specific classes, or call the accessor, to avoid the reflection overhead of Array.newInstance.

Specified by:

newArray in class Format

newInstance

public java.lang.Object newInstance(EntityInput input,
                           boolean rawAccess)
                             throws RefreshException

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 interface Reader

Specified by:

newInstance in class Format

Throws:

RefreshException

readObject

public java.lang.Object readObject(java.lang.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 interface Reader

Specified by:

readObject in class Format

Throws:

RefreshException

writeObject

void writeObject(java.lang.Object o,
               EntityOutput output,
               boolean rawAccess)
           throws RefreshException

Description copied from class: Format

Writes a given instance of the target class to the output data bytes. This is the complement of the newInstance()/readObject() pair.

Specified by:

writeObject in class Format

Throws:

RefreshException

convertRawObject

java.lang.Object convertRawObject(Catalog catalog,
                                boolean rawAccess,
                                RawObject rawObject,
                                IdentityHashMap converted)
                            throws RefreshException

Description copied from class: Format

Converts a RawObject to a current class object and adds the converted pair to the converted map.

Overrides:

convertRawObject in class Format

Throws:

RefreshException

skipContents

void skipContents(RecordInput input)
            throws RefreshException

Description copied from class: Format

Skips over the object's contents, as if readObject() were called, but without returning an object. Used for extracting secondary key bytes without having to instantiate the object. For reference types, the format ID is read just before calling this method, so this method is responsible for skipping everything following the format ID.

Specified by:

skipContents in class Format

Throws:

RefreshException

copySecMultiKey

void copySecMultiKey(RecordInput input,
                   Format keyFormat,
                   java.util.Set results)
               throws RefreshException

Description copied from class: Format

Called after skipToSecKey() to copy the data bytes of an array or collection (XXX_TO_MANY) key field.

Overrides:

copySecMultiKey in class Format

Throws:

RefreshException

evolve

boolean evolve(Format newFormatParam,
             Evolver evolver)

Description copied from class: Format

Called for an existing format that may not equal the current format for the same class.

If this method returns true, then it must have determined one of two things: - that the old and new formats are equal, and it must have called Evolver.useOldFormat; or - that the old format can be evolved to the new format, and it must have called Evolver.useEvolvedFormat.

If this method returns false, then it must have determined that the old format could not be evolved to the new format, and it must have called Evolver.addInvalidMutation, addMissingMutation or addEvolveError.

Specified by:

evolve in class Format