oracle.jbo.domain
Class BaseLobDomain

oracle.jbo.domain.BaseLobDomain

All Implemented Interfaces:

java.io.Serializable

public abstract class BaseLobDomain

implements java.io.Serializable

This class provides a lightweight wrapper for oracle.sql.BLOB, the Java representation of the BLOB database type. This wrapper allows an instance of the oracle.sql.BLOB to be used as a domain object.

Since:

JDeveloper 3.0

See Also:

Serialized Form

Method Summary

Type	Method
void	closeOutputStream()
boolean	equals(java.lang.Object obj) Tests for equality between this and obj.
java.lang.Object	getData() Internal: Applications should not use this method.
java.io.InputStream	getInputStream()
static java.lang.reflect.Method	getInvokeDomainMethod()
java.io.OutputStream	getOutputStream()
oracle.jbo.domain.DomainOwnerInterface	getOwner()
int	getOwnerAttributeIndex()
protected oracle.jbo.domain.DomainOwnerInterface	getOwnerRow()
protected int	getRemoteBufferSize()
java.lang.String	getRemoteIdString()
protected long	getRemoteLength()
long	getSize()
byte[]	getStorageByteArray()
boolean	isCacheDataModified()
void	loadFromDatabase(oracle.jbo.Transaction xAct) Internal: Applications should not use this method.
protected void	resetCachedData()
void	saveToDatabase(oracle.jbo.Transaction xAct) Internal: Applications should not use this method.
void	saveToDatabase(oracle.jbo.Transaction xAct, java.lang.Object emptySQLObject) Internal: Applications should not use this method.
void	setBytes(byte[] blobData) Sets the blob data for this object.
void	setContext(oracle.jbo.domain.DomainOwnerInterface owner, oracle.jbo.Transaction trans, java.lang.Object ctx) Internal: Applications should not use this method.
void	syncClientLob(oracle.jbo.domain.LobInterface oldObj)
void	syncServerLob(oracle.jbo.domain.LobInterface oldObj)
byte[]	toByteArray() Converts this BLOB contents into a byte array.
Datum	toDatum(OracleConnection c)
java.lang.String	toString() For testing purposes only: converts this BlobDomain object to a string.

Method Detail

toDatum

public Datum toDatum(OracleConnection c)
              throws java.sql.SQLException

setBytes

public void setBytes(byte[] blobData)

Sets the blob data for this object. On the client side, if there's a context available with this object, the bytes are streamed to the middle-tier object right-away. However if there's no context object, it's assumed that there will be a setAttribute call invoked on a containing row with this object as argument to stream the bytes via piggy-back.

Parameters:

blobData - data to fill the Blob.

loadFromDatabase

public void loadFromDatabase(oracle.jbo.Transaction xAct)
                      throws java.lang.Exception

Internal: Applications should not use this method.

Uses the given transaction context to load data from the database.

Parameters:

xAct - name of the transaction context.

setContext

public void setContext(oracle.jbo.domain.DomainOwnerInterface owner,
                       oracle.jbo.Transaction trans,
                       java.lang.Object ctx)

Internal: Applications should not use this method.

Sets the transaction context for this Blob.

getRemoteBufferSize

protected int getRemoteBufferSize()

getRemoteLength

protected long getRemoteLength()

getData

public java.lang.Object getData()

Internal: Applications should not use this method.

saveToDatabase

public void saveToDatabase(oracle.jbo.Transaction xAct)
                    throws java.sql.SQLException

Internal: Applications should not use this method.

Uses the given transaction context to store data back into the database using the blob-locator which should be set before this method is invoked.

Parameters:

xAct - name of the transaction context.

saveToDatabase

public void saveToDatabase(oracle.jbo.Transaction xAct,
                           java.lang.Object emptySQLObject)
                    throws java.sql.SQLException

Internal: Applications should not use this method.

Uses the given transaction context to store data back into the database using the blob-locator which should be set before this method is invoked.

toString

public java.lang.String toString()

For testing purposes only: converts this BlobDomain object to a string.

Returns:

this BlobDomain as a string.

isCacheDataModified

public boolean isCacheDataModified()

getStorageByteArray

public byte[] getStorageByteArray()

toByteArray

public byte[] toByteArray()

Converts this BLOB contents into a byte array.

Returns:

a byte array containing the contents of the BLOB.

equals

public boolean equals(java.lang.Object obj)

Tests for equality between this and obj. Converts all the data into a String and compares the two strings. This is a default implementation of equals which could be overridden to perform more scalable application-specific comparisons.

Parameters:

obj - the data item to compare against.

getOutputStream

public java.io.OutputStream getOutputStream()

getRemoteIdString

public java.lang.String getRemoteIdString()

getOwner

public oracle.jbo.domain.DomainOwnerInterface getOwner()

getOwnerAttributeIndex

public int getOwnerAttributeIndex()

getOwnerRow

protected oracle.jbo.domain.DomainOwnerInterface getOwnerRow()

getInputStream

public java.io.InputStream getInputStream()

resetCachedData

protected void resetCachedData()

syncClientLob

public void syncClientLob(oracle.jbo.domain.LobInterface oldObj)

syncServerLob

public void syncServerLob(oracle.jbo.domain.LobInterface oldObj)

getSize

public long getSize()

getInvokeDomainMethod

public static java.lang.reflect.Method getInvokeDomainMethod()

closeOutputStream

public void closeOutputStream()