wt.content
Class StreamData

java.lang.Object
  extended bywt.fc.WTObject
      extended bywt.content.StreamData
All Implemented Interfaces:
DisplayIdentification, Externalizable, NetFactor, ObjectMappable, Persistable, Revaultable, Serializable, Streamed, UniquelyIdentifiedContent

public class StreamData
extends WTObject
implements Streamed, Externalizable

This is where the class where the bulk data is actually stored. It is referenced as an ObjectReference from the ApplicationData class.

Use the newStreamData static factory method(s), not the StreamData 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:
ApplicationData, Serialized Form

Field Summary
private static String CLASSNAME
           
private static boolean DEBUG
           
static long EXTERNALIZATION_VERSION_UID
           
private  long fileSize
           
static String LOB_LOC
          Label for the attribute; This is the actual pointer to the stream.
private  LobLocator lobLoc
           
protected static long OLD_FORMAT_VERSION_UID
           
private static String RESOURCE
           
private  long revaultSessionId
           
(package private) static long serialVersionUID
           
private  long streamId
           
 
Fields inherited from class wt.fc.WTObject
CREATE_TIMESTAMP, MODIFY_TIMESTAMP
 
Fields inherited from interface wt.content.Streamed
FILE_SIZE
 
Fields inherited from interface wt.fc.Persistable
IDENTITY, PERSIST_INFO, TYPE
 
Fields inherited from interface wt.fv.Revaultable
INITIAL_VALUE, REVAULT_SESSION_ID
 
Fields inherited from interface wt.fv.UniquelyIdentifiedContent
STREAM_ID
 
Fields inherited from interface wt.identity.DisplayIdentification
DISPLAY_IDENTIFIER, DISPLAY_IDENTITY, DISPLAY_TYPE
 
Constructor Summary
StreamData()
           
 
Method Summary
 boolean equals(Object obj)
          Indicates whether the given object is equal to this object from a persistence perspective, by comparing the two objects ObjectIdentifiers.
 String getConceptualClassname()
          Deprecated.  
 long getFileSize()
          Gets the value of the attribute: FILE_SIZE.
 LobLocator getLobLoc()
          Gets the value of the attribute: LOB_LOC.
 long getRevaultSessionId()
          Gets the value of the attribute: REVAULT_SESSION_ID.
 long getStreamId()
          Gets the value of the attribute: STREAM_ID.
 int hashCode()
          Returns a hash code for this object based upon its ObjectIdentifier.
static StreamData newStreamData()
          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(StreamData thisObject, ObjectInput input, long readSerialVersionUID, boolean passThrough, boolean superDone)
          Reads the non-transient fields of this class from an external source.
 void removeStream()
          

Supported API: false
 InputStream retrieveStream()
          

Supported API: false
 void setFileSize(long a_FileSize)
          Sets the value of the attribute: FILE_SIZE.
 void setLobLoc(LobLocator a_LobLoc)
          Sets the value of the attribute: LOB_LOC.
 void setRevaultSessionId(long a_RevaultSessionId)
          Sets the value of the attribute: REVAULT_SESSION_ID.
 void setStreamId(long a_StreamId)
          Sets the value of the attribute: STREAM_ID.
 Streamed storeStream(ContentHolder holder, ApplicationData appData, InputStream is)
          

Supported API: false
 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 wt.fc.WTObject
checkAttributes, duplicate, finalize, getClassInfo, getCreateTimestamp, getDisplayIdentifier, getDisplayIdentity, getDisplayType, getIdentity, getModifyTimestamp, getPersistInfo, getType, initialize, readVersion, setPersistInfo, toString
 
Methods inherited from class java.lang.Object
clone, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface wt.fc.Persistable
checkAttributes, getIdentity, getPersistInfo, getType, setPersistInfo
 
Methods inherited from interface wt.fc.NetFactor
getClassInfo
 

Field Detail

RESOURCE

private static final String RESOURCE
See Also:
Constant Field Values

CLASSNAME

private static final String CLASSNAME

LOB_LOC

public static final String LOB_LOC
Label for the attribute; This is the actual pointer to the stream. Do not try to access this from the client side. Download of streams must occur through the http gateway

Supported API: false

See Also:
Constant Field Values

lobLoc

private LobLocator lobLoc

fileSize

private long fileSize

revaultSessionId

private long revaultSessionId

streamId

private long streamId

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

DEBUG

private static final boolean DEBUG
See Also:
Constant Field Values
Constructor Detail

StreamData

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

readVersion

protected boolean readVersion(StreamData 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
Overrides:
writeExternal in class WTObject
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
Overrides:
readExternal in class WTObject
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

getLobLoc

public LobLocator getLobLoc()
Gets the value of the attribute: LOB_LOC. This is the actual pointer to the stream. Do not try to access this from the client side. Download of streams must occur through the http gateway

Supported API: false

Returns:
LobLocator

setLobLoc

public void setLobLoc(LobLocator a_LobLoc)
               throws WTPropertyVetoException
Sets the value of the attribute: LOB_LOC. This is the actual pointer to the stream. Do not try to access this from the client side. Download of streams must occur through the http gateway

Supported API: false

Parameters:
a_LobLoc -
Throws:
WTPropertyVetoException

newStreamData

public static StreamData newStreamData()
                                throws WTException
Default factory for the class.

Supported API: false

Returns:
StreamData
Throws:
WTException

getFileSize

public long getFileSize()
Gets the value of the attribute: FILE_SIZE.

Supported API: false

Specified by:
getFileSize in interface Streamed
Returns:
long

setFileSize

public void setFileSize(long a_FileSize)
Sets the value of the attribute: FILE_SIZE.

Supported API: false

Specified by:
setFileSize in interface Streamed
Parameters:
a_FileSize -

storeStream

public Streamed storeStream(ContentHolder holder,
                            ApplicationData appData,
                            InputStream is)
                     throws WTException


Supported API: false

Specified by:
storeStream in interface Streamed
Parameters:
holder -
appData -
is -
Returns:
Streamed
Throws:
WTException

retrieveStream

public InputStream retrieveStream()
                           throws WTException


Supported API: false

Specified by:
retrieveStream in interface Streamed
Returns:
InputStream
Throws:
WTException

removeStream

public void removeStream()
                  throws WTException


Supported API: false

Specified by:
removeStream in interface Streamed
Throws:
WTException

getRevaultSessionId

public long getRevaultSessionId()
Gets the value of the attribute: REVAULT_SESSION_ID.

Supported API: false

Specified by:
getRevaultSessionId in interface Revaultable
Returns:
long

setRevaultSessionId

public void setRevaultSessionId(long a_RevaultSessionId)
Sets the value of the attribute: REVAULT_SESSION_ID.

Supported API: false

Specified by:
setRevaultSessionId in interface Revaultable
Parameters:
a_RevaultSessionId -

getStreamId

public long getStreamId()
Gets the value of the attribute: STREAM_ID.

Supported API: false

Specified by:
getStreamId in interface UniquelyIdentifiedContent
Returns:
long

setStreamId

public void setStreamId(long a_StreamId)
Sets the value of the attribute: STREAM_ID.

Supported API: false

Specified by:
setStreamId in interface UniquelyIdentifiedContent
Parameters:
a_StreamId -

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

Overrides:
equals in class WTObject
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

Overrides:
hashCode in class WTObject
Returns:
int