wt.epm.occurrence
Class EPMOccurrenceTable

java.lang.Object
  extended bywt.epm.occurrence.EPMOccurrenceTable
All Implemented Interfaces:
Externalizable, NetFactor, ObjectMappable, Persistable, Serializable

public class EPMOccurrenceTable
extends Object
implements Persistable, Externalizable

Creates and maintains a list of occurrence identifiers. Will likely map an occurrence identifier to a unique path through the assembly structure.

Use the newEPMOccurrenceTable static factory method(s), not the EPMOccurrenceTable 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 static SequencePool epmOccIDPool
           
static String EPMOCCURRENCE_IDENTIFIER
          Label for the attribute.
static long EXTERNALIZATION_VERSION_UID
           
protected static long OLD_FORMAT_VERSION_UID
           
private static String RESOURCE
           
(package private) static long serialVersionUID
           
private  Vector theEPMOccurrenceIdentifier
           
private  PersistInfo thePersistInfo
           
 
Fields inherited from interface wt.fc.Persistable
IDENTITY, PERSIST_INFO, TYPE
 
Constructor Summary
EPMOccurrenceTable()
           
 
Method Summary
 void checkAttributes()
          Validate the values of this Persistable object's attributes.
 boolean compareArraysForEquality(long[] a, long[] b)
           
private  long createOccurrence(long[] path)
          Create a new occurrence identifier for the given path of placed member link identifiers.
 boolean equals(Object obj)
          Indicates whether the given object is equal to this object from a persistence perspective, by comparing the two objects ObjectIdentifiers.
 long findOccurrence(long[] path)
          Given a path of placed member link identifiers, search the table for the occurrence identifier.
 ClassInfo getClassInfo()
          Returns the ClassInfo object for this class.
 String getConceptualClassname()
          Deprecated.  
 Vector getEPMOccurrenceIdentifier()
          Gets the object for the association that plays role: EPMOCCURRENCE_IDENTIFIER.
 String getIdentity()
          Deprecated. Replaced by IdentityFactory.getDispayIdentifier(object) to return a localizable equivalent of getIdentity(). To return a localizable value which includes the object type, use IdentityFactory.getDisplayIdentity(object). Other alternatives are ((WTObject)obj).getDisplayIdentifier() and ((WTObject)obj).getDisplayIdentity().
 long getOccurrence(long[] path)
          Given the path of placed member link identifiers, return the occurrence identifier.
 PersistInfo getPersistInfo()
          Gets the object for the association that plays role: PERSIST_INFO.
 String getType()
          Deprecated. Replaced by IdentityFactory.getDispayType(object) to return a localizable equivalent of getType(). Another alternative is ((WTObject)obj).getDisplayType().
 int hashCode()
          Returns a hash code for this object based upon its ObjectIdentifier.
protected  void initialize()
          Supports initialization, following construction of an instance.
static EPMOccurrenceTable newEPMOccurrenceTable()
          Default factory for the class.
 void readExternal(ObjectInput input)
          Reads the non-transient fields of this class from an external source.
 void readExternal(PersistentRetrieveIfc input)
          Used by Persistent Data Service to populate the persistent attributes of this class from a persistent store.
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(EPMOccurrenceTable thisObject, ObjectInput input, long readSerialVersionUID, boolean passThrough, boolean superDone)
          Reads the non-transient fields of this class from an external source.
 long search_path(long[] path)
           
 void setEPMOccurrenceIdentifier(Vector a_EPMOccurrenceIdentifier)
          Sets the object for the association that plays role: EPMOCCURRENCE_IDENTIFIER.
 void setPersistInfo(PersistInfo a_PersistInfo)
          Sets the object for the association that plays role: PERSIST_INFO.
 String toString()
          Returns the conceptual (modeled) name for the class.
 void writeExternal(ObjectOutput output)
          Writes the non-transient fields of this class to an external source.
 void writeExternal(PersistentStoreIfc output)
          Used by Persistent Data Service to obtain the values of the persistent attributes of this class, so they can be written to a persistent store.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Field Detail

RESOURCE

private static final String RESOURCE
See Also:
Constant Field Values

CLASSNAME

private static final String CLASSNAME

EPMOCCURRENCE_IDENTIFIER

public static final String EPMOCCURRENCE_IDENTIFIER
Label for the attribute.

Supported API: false

See Also:
Constant Field Values

theEPMOccurrenceIdentifier

private Vector theEPMOccurrenceIdentifier

thePersistInfo

private PersistInfo thePersistInfo

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

epmOccIDPool

private static SequencePool epmOccIDPool
Constructor Detail

EPMOccurrenceTable

public EPMOccurrenceTable()
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
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
Parameters:
input -
Throws:
IOException
ClassNotFoundException

readVersion

protected boolean readVersion(EPMOccurrenceTable 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

writeExternal

public void writeExternal(PersistentStoreIfc output)
                   throws SQLException,
                          DatastoreException
Used by Persistent Data Service to obtain the values of the persistent attributes of this class, so they can be written to a persistent store.

(Not intended for general use.)

Supported API: false

Specified by:
writeExternal in interface ObjectMappable
Parameters:
output -
Throws:
SQLException
DatastoreException

readExternal

public void readExternal(PersistentRetrieveIfc input)
                  throws SQLException,
                         DatastoreException
Used by Persistent Data Service to populate the persistent attributes of this class from a persistent store.

(Not intended for general use.)

Supported API: false

Specified by:
readExternal in interface ObjectMappable
Parameters:
input -
Throws:
SQLException
DatastoreException

getConceptualClassname

public String getConceptualClassname()
Deprecated.  

Returns the conceptual (modeled) name for the class.

Supported API: false

Specified by:
getConceptualClassname in interface NetFactor
Returns:
String

toString

public String toString()
Returns the conceptual (modeled) name for the class.

Supported API: false

Returns:
String

getClassInfo

public ClassInfo getClassInfo()
                       throws WTIntrospectionException
Returns the ClassInfo object for this class.

Supported API: false

Specified by:
getClassInfo in interface NetFactor
Returns:
ClassInfo
Throws:
WTIntrospectionException

getEPMOccurrenceIdentifier

public Vector getEPMOccurrenceIdentifier()
Gets the object for the association that plays role: EPMOCCURRENCE_IDENTIFIER.

Supported API: false

Returns:
Vector

setEPMOccurrenceIdentifier

public void setEPMOccurrenceIdentifier(Vector a_EPMOccurrenceIdentifier)
                                throws WTPropertyVetoException
Sets the object for the association that plays role: EPMOCCURRENCE_IDENTIFIER.

Supported API: false

Parameters:
a_EPMOccurrenceIdentifier -
Throws:
WTPropertyVetoException

getOccurrence

public long getOccurrence(long[] path)
                   throws WTException
Given the path of placed member link identifiers, return the occurrence identifier. If one does not exist for this path then create a new one.

Supported API: false

Parameters:
path -
Returns:
long
Throws:
WTException

findOccurrence

public long findOccurrence(long[] path)
                    throws WTException
Given a path of placed member link identifiers, search the table for the occurrence identifier.

Supported API: false

Parameters:
path -
Returns:
long
Throws:
WTException

createOccurrence

private long createOccurrence(long[] path)
                       throws WTException
Create a new occurrence identifier for the given path of placed member link identifiers.

Parameters:
path -
Returns:
long
Throws:
WTException

newEPMOccurrenceTable

public static EPMOccurrenceTable newEPMOccurrenceTable()
                                                throws WTException
Default factory for the class.

Supported API: false

Returns:
EPMOccurrenceTable
Throws:
WTException

initialize

protected void initialize()
                   throws WTException
Supports initialization, following construction of an instance. Invoked by "new" factory having the same signature.

Supported API: false

Throws:
WTException

getIdentity

public String getIdentity()
Deprecated. Replaced by IdentityFactory.getDispayIdentifier(object) to return a localizable equivalent of getIdentity(). To return a localizable value which includes the object type, use IdentityFactory.getDisplayIdentity(object). Other alternatives are ((WTObject)obj).getDisplayIdentifier() and ((WTObject)obj).getDisplayIdentity().

Gets the value of the attribute: IDENTITY. Supplies the identity of the object for business purposes. The identity is composed of name, number or possibly other attributes. The identity does not include the type of the object.

Supported API: false

Specified by:
getIdentity in interface Persistable
Returns:
String

getType

public String getType()
Deprecated. Replaced by IdentityFactory.getDispayType(object) to return a localizable equivalent of getType(). Another alternative is ((WTObject)obj).getDisplayType().

Gets the value of the attribute: TYPE. Identifies the type of the object for business purposes. This is typically the class name of the object but may be derived from some other attribute of the object.

Supported API: false

Specified by:
getType in interface Persistable
Returns:
String

checkAttributes

public void checkAttributes()
                     throws InvalidAttributeException
Validate the values of this Persistable object's attributes.

Supported API: false

Specified by:
checkAttributes in interface Persistable
Throws:
InvalidAttributeException

getPersistInfo

public PersistInfo getPersistInfo()
Gets the object for the association that plays role: PERSIST_INFO.

Supported API: false

Specified by:
getPersistInfo in interface Persistable
Returns:
PersistInfo

setPersistInfo

public void setPersistInfo(PersistInfo a_PersistInfo)
Sets the object for the association that plays role: PERSIST_INFO.

Supported API: false

Specified by:
setPersistInfo in interface Persistable
Parameters:
a_PersistInfo -

equals

public boolean equals(Object obj)
Indicates whether the given object is equal to this object from a persistence perspective, by comparing the two objects ObjectIdentifiers. Changed or stale copies are still considered equal by this method. Delegates to PersistenceHelper.equals(Persistable,Object).

Warning: Certain core Windchill operations may depend upon equals being ObjectIdentifier-based. Changes to the default implementation should be done with care, if at all.

Supported API: false

Parameters:
obj -
Returns:
boolean

hashCode

public int hashCode()
Returns a hash code for this object based upon its ObjectIdentifier. Delegates to PersistenceHelper.hashCode(Persistable).

Warning: Certain core Windchill operations may depend upon hashCode being ObjectIdentifier-based. Changes to the default implementation should be done with care, if at all.

Supported API: false

Returns:
int

search_path

public long search_path(long[] path)

compareArraysForEquality

public boolean compareArraysForEquality(long[] a,
                                        long[] b)