oracle.jbo.domain
Class BFileDomain

java.lang.Object
  |
  +--oracle.jbo.domain.BFileDomain

All Implemented Interfaces:

java.io.Serializable

public class BFileDomain

extends java.lang.Object

implements java.io.Serializable

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

Since:

JDeveloper 3.0

See Also:

Serialized Form

Constructor Summary

BFileDomain()
Constructor for this class.

BFileDomain(BFILE bFile)
Constructor for this class, given a BFILE object.

BFileDomain(BFILE bFile, byte[] bFileData)
Deprecated. since 9.0.4 BFile domains cannot be updated.

Method Summary

void	closeFile()
void	closeOutputStream()
boolean	equals(java.lang.Object obj) Converts all the data into a String and compares the two strings.
java.io.Reader	getCharacterStream()
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()
DomainOwnerInterface	getOwner()
int	getOwnerAttributeIndex()
protected DomainOwnerInterface	getOwnerRow()
java.lang.String	getRemoteIdString()
long	getSize()
void	loadFromDatabase(Transaction xAct) Internal: Applications should not use this method.
void	openFile()
void	prepareForDML(java.lang.Object context) Internal: Applications should not use this method.
void	saveToDatabase(Transaction xAct) Internal: Applications should not use this method.
void	saveToDatabase(Transaction xAct, java.lang.Object emptySQLObject) Internal: Applications should not use this method.
void	setBytes(byte[] bFileData) Deprecated. since 9.0.4 BFile domains cannot be updated.
void	setContext(DomainOwnerInterface owner, Transaction trans, java.lang.Object ctx) Internal: Applications should not use this method.
void	shareBFILE(BFileDomain newBFile) Internal: Applications should not use this method.
void	syncClientLob(LobInterface oldObject)
void	syncServerLob(LobInterface oldObj)
byte[]	toByteArray() Returns the contents of this BFILE as a byte array.
java.lang.String	toString() For testing purposes only: returns the contents fo the BFILE as a string.
void	useBFILE(BFILE newBlob) Internal: Applications should not use this method.

Methods inherited from class java.lang.Object

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

Constructor Detail

BFileDomain

public BFileDomain()

Constructor for this class.

BFileDomain

public BFileDomain(BFILE bFile)

Constructor for this class, given a BFILE object. This is for use by JDBC.

Parameters:

bFile - name of a BFILE object.

BFileDomain

public BFileDomain(BFILE bFile,
                   byte[] bFileData)

Deprecated. since 9.0.4 BFile domains cannot be updated.

Internal: Applications should not use this constructor.

Creates an instance of this class with data as described in bFileData and using the transaction context from bFile to use the file-locator in the database.

Parameters:

bFileData - the data for the BFILE.

Method Detail

shareBFILE

public void shareBFILE(BFileDomain newBFile)

Internal: Applications should not use this method.

If this object does not have a transaction context, shares the transaction and BFILE locator from newBfile.

useBFILE

public void useBFILE(BFILE newBlob)

Internal: Applications should not use this method.

If this object does not have a transaction context, shares the transaction and BFILE locator from newBfile.

setBytes

public void setBytes(byte[] bFileData)
              throws DomainValidationException

Deprecated. since 9.0.4 BFile domains cannot be updated.

Internal: Applications should not use this method. Sets the file data for this object.

Parameters:

bFileData - the data used to fill the BFILE.

Throws:

oracle.jbo.domain.DomainValidationException - if domain creation fails.

DomainValidationException

loadFromDatabase

public void loadFromDatabase(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 - the name of the transaction to use.

java.lang.Exception

setContext

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

Internal: Applications should not use this method.

Sets the transaction context for this BFILE.

getData

public java.lang.Object getData()

Internal: Applications should not use this method.

Returns a BFILE that contains data for this object.

saveToDatabase

public void saveToDatabase(Transaction xAct)
                    throws java.lang.Exception

Internal: Applications should not use this method.

NOT IMPLEMENTED FOR 3.0 Uses the given transaction context to store data back into the database using the BFILE locator which should be set before this method is invoked.

Parameters:

xAct - the name of the transaction.

java.lang.Exception

saveToDatabase

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

Internal: Applications should not use this method.

NOT IMPLEMENTED FOR 3.0 Uses the given transaction context to store data back into the database using the BFILE locator which should be set before this method is invoked.

java.sql.SQLException

prepareForDML

public void prepareForDML(java.lang.Object context)

Internal: Applications should not use this method.

toString

public java.lang.String toString()

For testing purposes only: returns the contents fo the BFILE as a string.

Overrides:

toString in class java.lang.Object

toByteArray

public byte[] toByteArray()

Returns the contents of this BFILE as a byte array.

Returns:

the contents of the BFILE as a byte array.

equals

public boolean equals(java.lang.Object 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 comparision.

Overrides:

equals in class java.lang.Object

Parameters:

obj - the object to compare to this BfileDomain.

getOutputStream

public java.io.OutputStream getOutputStream()

closeOutputStream

public void closeOutputStream()

getInputStream

public java.io.InputStream getInputStream()

getOwnerRow

protected DomainOwnerInterface getOwnerRow()

getRemoteIdString

public java.lang.String getRemoteIdString()

syncServerLob

public void syncServerLob(LobInterface oldObj)

syncClientLob

public void syncClientLob(LobInterface oldObject)

getOwner

public DomainOwnerInterface getOwner()

getSize

public long getSize()

getOwnerAttributeIndex

public int getOwnerAttributeIndex()

openFile

public void openFile()

closeFile

public void closeFile()

getInvokeDomainMethod

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

getCharacterStream

public java.io.Reader getCharacterStream()