wt.dataops.archive
Class ArchiveIdentity

java.lang.Object
  wt.fc.IdentificationObject
      wt.dataops.archive.ArchiveIdentity

All Implemented Interfaces:

Externalizable, IdentificationObjectNamespace, NetFactor, Serializable, WTContainerNamespace

public class ArchiveIdentity

extends IdentificationObject

implements WTContainerNamespace, Externalizable

Use the newArchiveIdentity static factory method(s), not the ArchiveIdentity constructor, to construct instances of this class. Instances must be constructed using the static factory(s), in order to ensure proper initialization of the instance.

Supported API: false

Extendable: false

See Also:

Serialized Form

Field Summary

private static String	CLASSNAME
private WTContainedIdentified	containedIdentified
private WTContainerRef	containerReference
static long	EXTERNALIZATION_VERSION_UID
private String	name
private WTContainerRef	namespaceReference
protected static long	OLD_FORMAT_VERSION_UID
private static String	RESOURCE
(package private) static long	serialVersionUID

Fields inherited from class wt.fc.IdentificationObject

Fields inherited from interface wt.inf.container.WTContainerNamespace

CONTAINED_IDENTIFIED, CONTAINER_REFERENCE, NAMESPACE_ID, NAMESPACE_REFERENCE

Constructor Summary

ArchiveIdentity()

Method Summary

private void	containerReferenceValidate(WTContainerRef a_ContainerReference)
String	getConceptualClassname() Deprecated.
WTContainedIdentified	getContainedIdentified() Gets the value of the attribute: containedIdentified; A callback to the WTContainedIdentified object that this is a namespace for.
WTContainerRef	getContainerReference() Gets the value of the attribute: containerReference; The container that the WTContainedIdentified object is contained by.
String	getIdentity() Constructs and returns a string representing the object's identity.
String	getName() Gets the value of the attribute: name.
WTContainerRef	getNamespaceReference() Gets the value of the attribute: namespaceReference; This property is used internally by the container service's identity processing.
protected void	initialize(Archive archive) Supports initialization, following construction of an instance.
private void	namespaceReferenceValidate(WTContainerRef a_NamespaceReference)
private void	nameValidate(String a_Name)
static ArchiveIdentity	newArchiveIdentity(Archive archive) Supported API: false
void	readExternal(ObjectInput input) Reads the non-transient fields of this class from an external source.
private boolean	readOldVersion(ObjectInput input, long readSerialVersionUID, boolean passThrough, boolean superDone) Reads the non-transient fields of this class from an external source, which is not the current version.
protected boolean	readVersion(ArchiveIdentity thisObject, ObjectInput input, long readSerialVersionUID, boolean passThrough, boolean superDone) Reads the non-transient fields of this class from an external source.
void	setContainedIdentified(WTContainedIdentified a_ContainedIdentified) Sets the value of the attribute: containedIdentified; A callback to the WTContainedIdentified object that this is a namespace for.
void	setContainerReference(WTContainerRef a_ContainerReference) Sets the value of the attribute: containerReference; The container that the WTContainedIdentified object is contained by.
void	setName(String a_Name) Sets the value of the attribute: name.
void	setNamespaceReference(WTContainerRef a_NamespaceReference) Sets the value of the attribute: namespaceReference; This property is used internally by the container service's identity processing.
protected void	setToObject(Identified obj) Updates the identity of the object passed as argument with the identity held in the object.
void	writeExternal(ObjectOutput output) Writes the non-transient fields of this class to an external source.

Methods inherited from class wt.fc.IdentificationObject

changeIdentity, checkIdentity, createKey, getClassInfo, getKeyClassName, getSemanticKey, initialize, readVersion, setAdditionalKeyAttributes, toString

Methods inherited from class java.lang.Object

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

Field Detail

RESOURCE

private static final String RESOURCE

See Also:

Constant Field Values

CLASSNAME

private static final String CLASSNAME

name

private String name

containedIdentified

private WTContainedIdentified containedIdentified

containerReference

private WTContainerRef containerReference

namespaceReference

private WTContainerRef namespaceReference

serialVersionUID

static final long serialVersionUID

See Also:

Constant Field Values

EXTERNALIZATION_VERSION_UID

public static final long EXTERNALIZATION_VERSION_UID

See Also:

Constant Field Values

OLD_FORMAT_VERSION_UID

protected static final long OLD_FORMAT_VERSION_UID

See Also:

Constant Field Values

Constructor Detail

ArchiveIdentity

public ArchiveIdentity()

Method Detail

writeExternal

public void writeExternal(ObjectOutput output)
                   throws IOException

Writes the non-transient fields of this class to an external source.

Supported API: false

Specified by:

writeExternal in interface Externalizable

Overrides:

writeExternal in class IdentificationObject

Parameters:

output -

Throws:

IOException

readExternal

public void readExternal(ObjectInput input)
                  throws IOException,
                         ClassNotFoundException

Reads the non-transient fields of this class from an external source.

Supported API: false

Specified by:

readExternal in interface Externalizable

Overrides:

readExternal in class IdentificationObject

Parameters:

input -

Throws:

IOException

ClassNotFoundException

readVersion

protected boolean readVersion(ArchiveIdentity thisObject,
                              ObjectInput input,
                              long readSerialVersionUID,
                              boolean passThrough,
                              boolean superDone)
                       throws IOException,
                              ClassNotFoundException

Reads the non-transient fields of this class from an external source.

Supported API: false

Parameters:

thisObject -

input -

readSerialVersionUID -

passThrough -

superDone -

Returns:

boolean

Throws:

IOException

ClassNotFoundException

readOldVersion

private boolean readOldVersion(ObjectInput input,
                               long readSerialVersionUID,
                               boolean passThrough,
                               boolean superDone)
                        throws IOException,
                               ClassNotFoundException

Reads the non-transient fields of this class from an external source, which is not the current version.

Parameters:

input -

readSerialVersionUID -

passThrough -

superDone -

Returns:

boolean

Throws:

IOException

ClassNotFoundException

getConceptualClassname

public String getConceptualClassname()

Deprecated.

Returns the conceptual (modeled) name for the class.

Supported API: false

Specified by:

getConceptualClassname in interface NetFactor

Returns:

String

getName

public String getName()

Gets the value of the attribute: name.

Supported API: false

Returns:

String

setName

public void setName(String a_Name)
             throws WTPropertyVetoException

Sets the value of the attribute: name.

Supported API: false

Parameters:

a_Name -

Throws:

WTPropertyVetoException

nameValidate

private void nameValidate(String a_Name)
                   throws WTPropertyVetoException

Parameters:

a_Name -

Throws:

WTPropertyVetoException

newArchiveIdentity

public static ArchiveIdentity newArchiveIdentity(Archive archive)
                                          throws WTException

Supported API: false

Parameters:

archive -

Returns:

ArchiveIdentity

Throws:

WTException

initialize

protected void initialize(Archive archive)
                   throws WTException

Supports initialization, following construction of an instance. Invoked by "new" factory having the same signature.

Supported API: false

Parameters:

archive -

Throws:

WTException

getIdentity

public String getIdentity()

Constructs and returns a string representing the object's identity. This is an abstract method that must be implemented by classes extending the IdentifiactionObject class. A straightforward way of build a string representation of the identity is to concatenate the attributes that constitute the identity, using an appropriate separator.

Supported API: false

Specified by:

getIdentity in class IdentificationObject

Returns:

String

setToObject

protected void setToObject(Identified obj)
                    throws WTException

Updates the identity of the object passed as argument with the identity held in the object.

Supported API: false

Specified by:

setToObject in class IdentificationObject

Parameters:

obj -

Throws:

WTException

getContainedIdentified

public WTContainedIdentified getContainedIdentified()

Gets the value of the attribute: containedIdentified; A callback to the WTContainedIdentified object that this is a namespace for. This property is used internally and never needs to be set by callers.

Supported API: false

Specified by:

getContainedIdentified in interface WTContainerNamespace

Returns:

WTContainedIdentified

setContainedIdentified

public void setContainedIdentified(WTContainedIdentified a_ContainedIdentified)
                            throws WTPropertyVetoException

Sets the value of the attribute: containedIdentified; A callback to the WTContainedIdentified object that this is a namespace for. This property is used internally and never needs to be set by callers.

Supported API: false

Specified by:

setContainedIdentified in interface WTContainerNamespace

Parameters:

a_ContainedIdentified -

Throws:

WTPropertyVetoException

getContainerReference

public WTContainerRef getContainerReference()

Gets the value of the attribute: containerReference; The container that the WTContainedIdentified object is contained by. Setting this property and then calling IdentityService.changeIdentity will update the object's container reference.

Supported API: false

Specified by:

getContainerReference in interface WTContainerNamespace

Returns:

WTContainerRef

setContainerReference

public void setContainerReference(WTContainerRef a_ContainerReference)
                           throws WTPropertyVetoException

Sets the value of the attribute: containerReference; The container that the WTContainedIdentified object is contained by. Setting this property and then calling IdentityService.changeIdentity will update the object's container reference.

Supported API: false

Specified by:

setContainerReference in interface WTContainerNamespace

Parameters:

a_ContainerReference -

Throws:

WTPropertyVetoException

containerReferenceValidate

private void containerReferenceValidate(WTContainerRef a_ContainerReference)
                                 throws WTPropertyVetoException

Parameters:

a_ContainerReference -

Throws:

WTPropertyVetoException

getNamespaceReference

public WTContainerRef getNamespaceReference()

Gets the value of the attribute: namespaceReference; This property is used internally by the container service's identity processing. Callers should never need to set it.

A reference to the WTContainer that serves as a namespace for the WTContainedIdentified object. This value is typically derivable from WTContainerHelper.service.getNamespace, except for situations where a container and its children are being re-namespaced as part of a single transaction.

Supported API: false

Specified by:

getNamespaceReference in interface WTContainerNamespace

Returns:

WTContainerRef

setNamespaceReference

public void setNamespaceReference(WTContainerRef a_NamespaceReference)
                           throws WTPropertyVetoException

Sets the value of the attribute: namespaceReference; This property is used internally by the container service's identity processing. Callers should never need to set it.

A reference to the WTContainer that serves as a namespace for the WTContainedIdentified object. This value is typically derivable from WTContainerHelper.service.getNamespace, except for situations where a container and its children are being re-namespaced as part of a single transaction.

Supported API: false

Specified by:

setNamespaceReference in interface WTContainerNamespace

Parameters:

a_NamespaceReference -

Throws:

WTPropertyVetoException

namespaceReferenceValidate

private void namespaceReferenceValidate(WTContainerRef a_NamespaceReference)
                                 throws WTPropertyVetoException

Parameters:

a_NamespaceReference -

Throws:

WTPropertyVetoException