|
Oracle9i Business Components for Java InterMedia API Reference Oracle9i JDeveloper (9.0.4) B10394-01 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--oracle.ord.im.OrdAudioBase | +--oracle.ord.im.OrdAudio | +--oracle.ord.im.OrdAudioDomain
Represents interMedia ORDSYS.ORDAudio database type as a domain class in the Business Components for Java (BC4J) framework. Most methods in this class are BC4J tier independent. They can work on either the client tier or the middle tier, which allows the application which uses these methods to work in a tier independent fashion. There are some exceptions which are marked as local mode only:
getContent
getBFILE
getComments
setComments
getAllAttributes
getContentInLob
The BC4J tier-independent counterparts of the first three methods are the following:
getContentAsBlobDomain
getBFileDomain
getCommentsAsClobDomain
There are no corresponding BC4J tier-independent methods for setComments
, getAllAttributes
and getContentInLob
.
The term client tier refers to the machine on which the application client is running. Middle tier refers to the server on which the BC4J business components are deployed. The user can use "local mode only" methods when he deploys BC4J and the client application to the same machine. Whereas, the user should use tier independent methods when the application client and BC4J reside on separate machines.
The constructor for this class will create an instance of an OrdAudioDomain
. The user should either manually obtain a valid BLOB locator and a JDBC connection for this instance, or rely on the BC4J framework to obtain a BLOB locator and a JDBC connection for it. See OrdContentSource
for discussion about how to load media content to the database by using the interMedia BC4J domain classes.
OrdAudio
, Serialized FormField Summary |
Fields inherited from class oracle.ord.im.OrdAudioBase |
_SQL_NAME, _SQL_TYPECODE |
Constructor Summary | |
OrdAudioDomain() Constructs a new OrdAudioDomain instance. | |
OrdAudioDomain(byte[] bytes) Constructs a new OrdAudioDomain instance. | |
OrdAudioDomain(OrdHttpUploadFile ohuf) Constructs a new OrdAudioDomain instance. | |
OrdAudioDomain(java.lang.String fileName) Constructs a new OrdAudioDomain instance. |
Method Summary | |
boolean |
checkProperties(byte[][] ctx) Checks if the properties of the audio data are consistent with the attributes of the OrdAudio Java object. |
void |
clearContentSource() Internal: Applications should not use this method. |
void |
clearLocal() Clears the attribute called local to indicate that the content data is stored externally. |
int |
closeSource(byte[][] ctx) Closes a data source. |
oracle.sql.CustomDatum |
create(oracle.sql.Datum d, int sqlType) Internal: Applications should not use this method. |
java.lang.Object |
createDomainFromSerializedXML(org.w3c.dom.Element element) Create a domain instance by reading the xml-data out of the given xml-node. |
void |
deleteContent() Deletes any data stored in the database BLOB specified by the localData attribute. |
void |
domainToBeModified(oracle.jbo.domain.DomainInterface d) Internal: Applications should not use this method. |
void |
doneCommit(oracle.jbo.TransactionStateEvent event) Internal: Applications should not use this method. |
void |
doneRollback(oracle.jbo.TransactionStateEvent event) Internal: Applications should not use this method. |
boolean |
equals(java.lang.Object obj) Compares two OrdAudioDomain objects by their last update time and content length. |
void |
export(byte[][] ctx, java.lang.String sourceType, java.lang.String sourceLocation, java.lang.String sourceName) Exports the data from the BLOB specified by the localData attribute. |
oracle.sql.CLOB |
getAllAttributes(byte[][] ctx) Returns the audio properties in a temporary CLOB in a form defined by the format plug-in. |
java.lang.String |
getAttribute(byte[][] ctx, java.lang.String name) Returns the value of the requested audio property. |
java.lang.Object |
getAttribute(int index) Internal: Applications should not use this method. |
java.lang.Object |
getAttribute(java.lang.String name) Internal: Applications should not use this method. |
int |
getAttributeCount() Internal: Applications should not use this method. |
int |
getAttributeIndexOf(java.lang.String name) Internal: Applications should not use this method. |
java.lang.String[] |
getAttributeNames() |
java.lang.Object[] |
getAttributeValues() |
int |
getAudioDuration() Returns the audioDuration attribute. |
oracle.sql.BFILE |
getBFILE() Returns a BFILE locator from the database when the srcType attribute is "FILE". |
oracle.jbo.domain.BFileDomain |
getBFileDomain() Returns a BFileDomain object which wraps the BFILE locator obtained from the getBFILE method. |
oracle.sql.CLOB |
getComments() Returns the CLOB locator from the comments attribute. |
oracle.jbo.domain.ClobDomain |
getCommentsAsClobDomain() Returns a ClobDomain object which wraps the CLOB locator obtained from the getComments() method. |
java.lang.String |
getCompressionType() Returns the compressionType attribute. |
oracle.sql.BLOB |
getContent() Returns the BLOB locator from the localData attribute. |
oracle.jbo.domain.BlobDomain |
getContentAsBlobDomain() Returns a BlobDomain object which wraps the BLOB locator from the localData attribute. |
oracle.sql.BLOB |
getContentInLob(byte[][] ctx, java.lang.String[] mimetype, java.lang.String[] format) Returns the data from the BLOB specified by the localData attribute in a temporary BLOB in the database. |
int |
getContentLength() Returns the length of the audio data. |
int |
getContentLength(byte[][] ctx) Returns the length of the audio data using source plug-in context information. |
OrdContentSource |
getContentSource() Gets the content source which was previously set by the setContentSource method. |
java.lang.Object |
getCTPassivationHandle() Internal: Applications should not use this method. |
static oracle.sql.CustomDatumFactory |
getCustomDatumFactory() Internal: Applications should not use this method. |
java.lang.Object |
getData() Internal: Applications should not use this method. |
byte[] |
getDataInByteArray() Returns a byte array containing the data from the database BLOB specified by the localData attribute. |
boolean |
getDataInFile(java.lang.String filename) Writes the data from the database BLOB specified by the localData attribute to a local file. |
java.io.InputStream |
getDataInStream() Returns an InputStream from which the data in the database BLOB specified by the localData attribute can be read. |
java.lang.String |
getDescription() Returns the description attribute. |
java.lang.String |
getEncoding() Returns the encoding attribute. |
static oracle.sql.CustomDatumFactory |
getFactory() Returns the OrdAudioDomain CustomDatumFactory for use by the getCustomDatum method. |
java.lang.String |
getFormat() Returns the format attribute. |
java.lang.String |
getMimeType() Returns the mimeType attribute. |
int |
getNumberOfChannels() Returns the numberOfChannels attribute. |
oracle.jbo.domain.DomainOwnerInterface |
getOwner() Internal: Applications should not use this method. |
int |
getOwnerAttributeIndex() Internal: Applications should not use this method. |
java.lang.String |
getRemoteIdString() Internal: Applications should not use this method. |
int |
getSampleSize() Returns the sampleSize attribute. |
int |
getSamplingRate() Returns the samplingRate attribute. |
org.w3c.dom.Node |
getSerializedDomainXML(org.w3c.dom.Document xmlDoc) Creates the XML node in the given XML document for this domain's data. |
long |
getSize() Internal: Applications should not use this method. |
java.lang.String |
getSource() Returns the source information in the form srcType://srcLocation/srcName . |
java.lang.String |
getSourceLocation() Returns the srcLocation attribute. |
java.lang.String |
getSourceName() Returns the srcName attribute. |
java.lang.String |
getSourceType() Returns the srcType attribute. |
int |
getTierInfo() Gets the tier number information that this object lives in. |
java.sql.Timestamp |
getUpdateTime() Returns the updateTime attribute. |
org.w3c.dom.Node |
getXMLContentNode(org.w3c.dom.Document xmlDoc) Internal: Applications should not use this method. |
static oracle.jbo.domain.XMLDomainFactory |
getXMLDomainFactory(java.lang.Class attrClass) Internal: Applications should not use this method. |
int |
hashCode() Returns the hash code as a int |
void |
importData(byte[][] ctx) Imports data from an external source into the database BLOB specified by the localData attribute. |
void |
importFrom(byte[][] ctx, java.lang.String sourceType, java.lang.String sourceLocation, java.lang.String sourceName) Imports data from an external source into the database BLOB specified by the localData attribute. |
boolean |
isConnected() Determines whether the domain object has an internal JDBC connection to the database. |
boolean |
isLocal() Determines whether the content data is stored locally in the database in a BLOB specified by the localData attribute. |
boolean |
loadDataFromByteArray(byte[] byteArr) Loads data from a byte array into the database BLOB specified by the localData attribute. |
boolean |
loadDataFromFile(java.lang.String filename) Loads data from a file into the database BLOB specified by the localData attribute. |
boolean |
loadDataFromInputStream(java.io.InputStream inpStream) Loads data from an InputStream into the database BLOB specified by the localData attribute. |
void |
loadFromDatabase(oracle.jbo.Transaction xAct) Internal: Applications should not use this method. |
oracle.svcmsg.ResponseValues |
marshal() |
int |
openSource(byte[] userarg, byte[][] ctx) Opens a data source. |
void |
prepareCTPassivation() Internal: Applications should not use this method. |
void |
prepareForDML(java.lang.Object context) Internal: Applications should not use this method. |
java.lang.String |
printXMLDefinition(java.util.Hashtable allDefs, java.io.PrintWriter pw, boolean bContainees) Internal: Applications should not use this method. |
byte[] |
processAudioCommand(byte[][] ctx, java.lang.String cmd, java.lang.String args, byte[][] result) Calls the format plug-in in the database to execute a command. |
byte[] |
processSourceCommand(byte[][] ctx, java.lang.String cmd, java.lang.String args, byte[][] result) Calls the source plug-in in the database to execute a command. |
int |
readFromSource(byte[][] ctx, int startpos, int numbytes, byte[][] buffer) Reads data from the data source. |
void |
removeListenerFromTransaction() Internal: Applications should not use this method. |
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 |
setAttribute(int index, java.lang.Object value) Internal: Applications should not use this method. |
void |
setAttribute(java.lang.String name, java.lang.Object value) Internal: Applications should not use this method. |
void |
setAudioDuration(int audioDuration) Sets the audioDuration attribute. |
void |
setComments(oracle.sql.CLOB comments) Sets the comments attribute. |
void |
setCompressionType(java.lang.String compressionType) Sets the compressionType attribute. |
void |
setContentLength(int contentLength) Does nothing for OrdAudioDomain objects. |
void |
setContentSource(OrdContentSource source) Sets the content source for deferred loading. |
void |
setContentSourceOnly(OrdContentSource source) Internal: Applications should not use this method. |
void |
setContext(oracle.jbo.domain.DomainOwnerInterface owner, oracle.jbo.Transaction trans, java.lang.Object ctx) Internal: Applications should not use this method. |
void |
setCTPassivationHandle(java.lang.Object handle) Internal: Applications should not use this method. |
void |
setDescription(java.lang.String description) Sets the description attribute. |
void |
setEncoding(java.lang.String encoding) Sets the encoding attribute. |
void |
setFormat(java.lang.String format) Sets the format attribute. |
void |
setKnownAttributes(java.lang.String knownformat, java.lang.String knownencoding, int knownnumberofchannels, int knownsamplingrate, int knownsamplesize, java.lang.String knowncompressiontype, int knownaudioduration) Sets the known attributes of the OrdAudio Java object. |
void |
setLocal() Sets the attribute called local to indicate that the content data is stored locally in the database in a BLOB > specified by the localData attribute. |
void |
setMimeType(java.lang.String MimeType) Sets the mimeType attribute. |
void |
setNumberOfChannels(int numberOfChannels) Sets the numberOfChannels attribute. |
void |
setProperties() Parses the audio data properties and sets the attributes in the OrdAudioDomain Java object. |
void |
setProperties(byte[][] ctx) Parses the audio data properties and sets the attributes in the OrdAudio Java object. |
void |
setProperties(byte[][] ctx, boolean setComments) Parses the audio data properties, sets the attributes in the OrdAudio Java object, and optionally populates the CLOB specified by the comments attribute. |
void |
setSampleSize(int sampleSize) Sets the sampleSize attribute. |
void |
setSamplingRate(int samplingRate) Sets the samplingRate attribute. |
void |
setSource(java.lang.String sourceType, java.lang.String sourceLocation, java.lang.String sourceName) Sets the srcType, srcLocation, and srcName attributes. |
void |
setUpdateTime(java.sql.Timestamp currentTime) Sets the updateTime attribute. |
void |
syncClientLob(oracle.jbo.domain.LobInterface newArrival) Internal: Applications should not use this method. |
void |
syncServerLob(oracle.jbo.domain.LobInterface oldObj) Internal: Applications should not use this method. |
java.lang.String |
toString() Returns a String object describing this object. |
int |
trimSource(byte[][] ctx, int newLen) Trims the data to the specified length. |
int |
writeToSource(byte[][] ctx, int startpos, int numbytes, byte[] buffer) Writes data to the data source. |
Methods inherited from class oracle.ord.im.OrdAudioBase |
toDatum |
Methods inherited from class java.lang.Object |
getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
public OrdAudioDomain()
OrdAudioDomain
instance. Before it's been inserted into the database table and selected back, this new instance doesn't have a JDBC connection to the database. It also doesn't have a corresponding existing database ORDSYS.ORDAudio object.public OrdAudioDomain(byte[] bytes)
OrdAudioDomain
instance. Before it has been inserted into the database table and selected back; this new instance doesn't have a JDBC connection to the database. It also doesn't have a corresponding existing database ORDSYS.ORDAudio object. Users should use deferred loading to load the audio content into the database.
Calling this constructor has the same effect of calling the following two statements.
OrdAudioDomain audio = new OrdAudioDomain(); audio.setContentSource(new OrdByteArraySource(bytes));
bytes
- the byte array that contains the audio contentOrdContentSource
, OrdByteArraySource
public OrdAudioDomain(java.lang.String fileName)
OrdAudioDomain
instance. Before it has been inserted into the database table and selected back; this new instance doesn't have a JDBC connection to the database. It also doesn't have a corresponding existing database ORDSYS.ORDAudio object. Users should use deferred loading to load the audio content into the database.
Calling this constructor has the same effect of calling the following two statements.
OrdAudioDomain audio = new OrdAudioDomain(); audio.setContentSource(new OrdFileSource(fileName));
fileName
- the audio file nameOrdContentSource
, OrdFileSource
public OrdAudioDomain(OrdHttpUploadFile ohuf)
OrdAudioDomain
instance. Before it has been inserted into the database table and selected back; this new instance doesn't have a JDBC connection to the database. It also doesn't have a corresponding existing database ORDSYS.ORDAudio object. Users should use deferred loading to load the audio content into the database.
Calling this constructor has the same effect of calling the following two statements.
OrdAudioDomain audio = new OrdAudioDomain(); audio.setContentSource(new OrdHttpUploadFileSource(ohuf));
ohuf
- the audio content wrapped as an OrdHttpUploadFile
objectOrdContentSource
, OrdHttpUploadFileSource
Method Detail |
public static oracle.sql.CustomDatumFactory getFactory()
OrdAudioDomain CustomDatumFactory
for use by the getCustomDatum
method. Specify this method as the factory parameter of the getCustomDatum
method when retrieving an OrdAudioDomain
object from an OracleResultSet
or OracleCallableStatement
. For example:
OrdAudioDomain audio = (OrdAudioDomain)rset. getCustomDatum( 1, OrdAudioDomain.getFactory() );
OrdAudioDomain
implementation of the CustomDatumFactory
interfacepublic static oracle.sql.CustomDatumFactory getCustomDatumFactory()
public java.lang.String toString()
String
object describing this object. The format of the description is "OrdAudioDomain: <mimetype>:<length>".toString
in class java.lang.Object
String
object describing this objectpublic int hashCode()
int
hashCode
in class java.lang.Object
public boolean equals(java.lang.Object obj)
OrdAudioDomain
objects by their last update time and content length. For performance reasons, bit by bit comparison of binary content is not done.equals
in class java.lang.Object
obj
- the object to be compared with this objecttrue
if the two OrdAudioDomain
objects have the same last update time and content length; otherwise, returns false
public oracle.sql.BLOB getContent() throws java.sql.SQLException
getContent
in class OrdAudio
oracle.sql.BLOB
java.sql.SQLException
- if an error occurs when accessing the localData attributepublic oracle.sql.BFILE getBFILE() throws java.sql.SQLException
getBFILE
in class OrdAudio
oracle.sql.BFILE
java.sql.SQLException
- if an error occurs while executing the corresponding getBFILE method in the databasepublic boolean isLocal() throws java.sql.SQLException
OrdDomainIOInterface
isLocal
in interface OrdDomainIOInterface
isLocal
in class OrdAudio
true
if the data is stored locally in the database in a BLOB; otherwise, returns false
java.sql.SQLException
- if an error occurs when accessing the attribute called local.public void clearLocal() throws java.sql.SQLException
OrdDomainIOInterface
clearLocal
in interface OrdDomainIOInterface
clearLocal
in class OrdAudio
java.sql.SQLException
- if an error occurs when accessing the attribute called local.public void setLocal() throws java.sql.SQLException
OrdDomainIOInterface
setLocal
in interface OrdDomainIOInterface
setLocal
in class OrdAudio
java.sql.SQLException
- if an error occurs when accessing the attribute called local.public void deleteContent() throws java.sql.SQLException
OrdDomainIOInterface
deleteContent
in interface OrdDomainIOInterface
deleteContent
in class OrdAudio
java.sql.SQLException
- if an error occurs when executing the corresponding deleteContent method in the database.public void importData(byte[][] ctx) throws java.sql.SQLException
OrdAudio
importData
in class OrdAudio
ctx
- the source plug-in context information.java.sql.SQLException
- if an error occurs executing the corresponding import method in the database.public void importFrom(byte[][] ctx, java.lang.String sourceType, java.lang.String sourceLocation, java.lang.String sourceName) throws java.sql.SQLException
OrdAudio
importFrom
in class OrdAudio
ctx
- the source plug-in context information.sourceType
- the source type, for example, "FILE", "HTTP".sourceLocation
- the source location, for example, SOUNDS_DIR, www.xyzcosounds.com/films.sourceName
- the source name, for example, filmtrack1.au.java.sql.SQLException
- if an error occurs executing the corresponding importFrom method in the database.public boolean loadDataFromFile(java.lang.String filename) throws java.sql.SQLException, java.io.IOException
OrdDomainIOInterface
OrdDomainIOInterface.deleteContent()
, to delete any existing data in the BLOB.OrdDomainIOInterface.setLocal()
, to set the local flag.setUpdateTime()
, to set the updateTime attribute to the database server's current SYSDATE time.loadDataFromFile
in interface OrdDomainIOInterface
loadDataFromFile
in class OrdAudio
filename
- name of the file from which to load datatrue
if the data is loaded successfully; otherwise, an exception is raised if an error occurs. This method never returns false
.java.sql.SQLException
- if an error occurs when accessing an object attribute or when executing a method in the database.java.io.IOException
- if an error occurs when reading the data file.public boolean loadDataFromInputStream(java.io.InputStream inpStream) throws java.sql.SQLException, java.io.IOException
OrdDomainIOInterface
InputStream
into the database BLOB specified by the localData attribute. Before loading the data, this method calls the following methods:
OrdDomainIOInterface.deleteContent()
, to delete any existing data in the BLOB.OrdDomainIOInterface.setLocal()
, to set the local flag.setUpdateTime()
, to set the updateTime attribute to the database server's current SYSDATE time.loadDataFromInputStream
in interface OrdDomainIOInterface
loadDataFromInputStream
in class OrdAudio
inpStream
- the InputStream
from which to load datatrue
if the data is loaded successfully; otherwise, an exception is raised if an error occurs. This method never returns false
.java.sql.SQLException
- if an error occurs when accessing an object attribute or when executing a method in the database.java.io.IOException
- if an error occurs when reading the InputStream.public boolean loadDataFromByteArray(byte[] byteArr) throws java.sql.SQLException, java.io.IOException
OrdDomainIOInterface
OrdDomainIOInterface.deleteContent()
, to delete any existing data in the BLOB.OrdDomainIOInterface.setLocal()
, to set the local flag.setUpdateTime()
, to set the updateTime attribute to the database server's current SYSDATE time.loadDataFromByteArray
in interface OrdDomainIOInterface
loadDataFromByteArray
in class OrdAudio
true
if the data is loaded successfully; otherwise, an exception is raised if an error occurs. This method never returns false
.java.io.IOException
- if an error occurs reading the byte array.java.sql.SQLException
- if an error occurs when accessing an object attribute or when executing a method in the database.public int getContentLength() throws java.sql.SQLException
getContentLength
in interface OrdDomainIOInterface
getContentLength
in class OrdAudio
int
java.sql.SQLException
- if an error occurs while executing the corresponding getContentLength method in the databaseOrdImage.getContentLength()
, OrdDoc.getContentLength()
, OrdAudio.getContentLength()
, OrdVideo.getContentLength()
public int getContentLength(byte[][] ctx) throws java.sql.SQLException
getContentLength
in class OrdAudio
ctx
- the source plug-in context informationint
java.sql.SQLException
- if an error occurs while executing the corresponding getContentLength method in the databasepublic void setMimeType(java.lang.String MimeType) throws java.sql.SQLException
OrdDomainIOInterface
setMimeType
in interface OrdDomainIOInterface
setMimeType
in class OrdAudio
java.sql.SQLException
- if an error occurs when accessing the mimeType attribute.public java.lang.String getMimeType() throws java.sql.SQLException
OrdDomainIOInterface
getMimeType
in interface OrdDomainIOInterface
getMimeType
in class OrdAudio
String
.java.sql.SQLException
- if an error occurs when accessing the mimeType attribute.public void setSource(java.lang.String sourceType, java.lang.String sourceLocation, java.lang.String sourceName) throws java.sql.SQLException
OrdDomainIOInterface
setSource
in interface OrdDomainIOInterface
setSource
in class OrdAudio
sourceType
- the source type, for example, "FILE", "HTTP".sourceLocation
- the source location, for example, MEDIA_DIR, www.xyzcoimages.com/public.sourceName
- the source name, for example, media_content.datjava.sql.SQLException
- if an error occurs when accessing the srcType, srcLocation, or srcName attributes.public java.lang.String getSourceType() throws java.sql.SQLException
OrdDomainIOInterface
getSourceType
in interface OrdDomainIOInterface
getSourceType
in class OrdAudio
String
.java.sql.SQLException
- if an error occurs when accessing the srcType attribute.public java.lang.String getSourceLocation() throws java.sql.SQLException
OrdDomainIOInterface
getSourceLocation
in interface OrdDomainIOInterface
getSourceLocation
in class OrdAudio
String
.java.sql.SQLException
- if an error occurs when accessing the srcLocation attribute.public java.lang.String getSourceName() throws java.sql.SQLException
OrdDomainIOInterface
getSourceName
in interface OrdDomainIOInterface
getSourceName
in class OrdAudio
String
.java.sql.SQLException
- if an error occurs when accessing the srcName attribute.public java.lang.String getSource() throws java.sql.SQLException
OrdAudio
srcType://srcLocation/srcName
.getSource
in class OrdAudio
String
.java.sql.SQLException
- if an error occurs executing the correspoding getSource method in the database.public java.lang.String getDescription() throws java.sql.SQLException
OrdAudio
getDescription
in class OrdAudio
String
.java.sql.SQLException
- if an error occurs accessing the description attribute.public void setDescription(java.lang.String description) throws java.sql.SQLException
OrdAudio
setDescription
in class OrdAudio
description
- the new attribute value.java.sql.SQLException
- if an error occurs accessing the description attribute.public oracle.sql.CLOB getComments() throws java.sql.SQLException
getComments
in class OrdAudio
oracle.sql.CLOB
java.sql.SQLException
- if an error occurs when accessing the comments attributepublic void setComments(oracle.sql.CLOB comments) throws java.sql.SQLException
setProperties
method.setComments
in class OrdAudio
comments
- the new attribute valuejava.sql.SQLException
- if an error occurs when accessing the comments attributepublic java.lang.String getEncoding() throws java.sql.SQLException
OrdAudio
getEncoding
in class OrdAudio
String
.java.sql.SQLException
- if an error occurs accessing the encoding attribute.public void setEncoding(java.lang.String encoding) throws java.sql.SQLException
OrdAudio
setProperties
sets this attribute automatically for certain audio formats; use this method only if you are not using setProperties. This method sets the attribute value only; it does not modify the audio data itself.setEncoding
in class OrdAudio
encoding
- the new attribute value.java.sql.SQLException
- if an error occurs accessing the encoding attribute.public int getNumberOfChannels() throws java.sql.SQLException
OrdAudio
getNumberOfChannels
in class OrdAudio
int
.java.sql.SQLException
- if an error occurs accessing the numberOfChannels attribute.public void setNumberOfChannels(int numberOfChannels) throws java.sql.SQLException
OrdAudio
setProperties
sets this attribute automatically for certain audio formats; use this method only if you are not using setProperties. This method sets the attribute value only; it does not modify the audio data itself.setNumberOfChannels
in class OrdAudio
numberOfChannels
- the new attribute value.java.sql.SQLException
- if an error occurs accessing the numberOfChannels attribute.public int getSamplingRate() throws java.sql.SQLException
OrdAudio
getSamplingRate
in class OrdAudio
int
.java.sql.SQLException
- if an error occurs accessing the samplingRate attribute.public void setSamplingRate(int samplingRate) throws java.sql.SQLException
OrdAudio
setProperties
sets this attribute automatically for certain audio formats; use this method only if you are not using setProperties. This method sets the attribute value only; it does not modify the audio data itself.setSamplingRate
in class OrdAudio
samplingRate
- the new attribute value.java.sql.SQLException
- if an error occurs accessing the samplingRate attribute.public int getSampleSize() throws java.sql.SQLException
OrdAudio
getSampleSize
in class OrdAudio
int
.java.sql.SQLException
- if an error occurs accessing the sampleSize attribute.public void setSampleSize(int sampleSize) throws java.sql.SQLException
OrdAudio
setProperties
sets this attribute automatically for certain audio formats; use this method only if you are not using setProperties. This method sets the attribute value only; it does not modify the audio data itself.setSampleSize
in class OrdAudio
sampleSize
- the new attribute value.java.sql.SQLException
- if an error occurs accessing the sampleSize attribute.public java.lang.String getCompressionType() throws java.sql.SQLException
OrdAudio
getCompressionType
in class OrdAudio
int
.java.sql.SQLException
- if an error occurs accessing the compressionType attribute.public void setCompressionType(java.lang.String compressionType) throws java.sql.SQLException
OrdAudio
setProperties
sets this attribute automatically for certain audio formats; use this method only if you are not using setProperties. This method sets the attribute value only; it does not modify the audio data itself.setCompressionType
in class OrdAudio
compressionType
- the new attribute value.java.sql.SQLException
- if an error occurs accessing the compressionType attribute.public int getAudioDuration() throws java.sql.SQLException
OrdAudio
getAudioDuration
in class OrdAudio
int
.java.sql.SQLException
- if an error occurs accessing the audioDuration attribute.public void setAudioDuration(int audioDuration) throws java.sql.SQLException
OrdAudio
setProperties
sets this attribute automatically for certain audio formats; use this method only if you are not using setProperties. This method sets the attribute value only; it does not modify the audio data itself.setAudioDuration
in class OrdAudio
audioDuration
- the new attribute value.java.sql.SQLException
- if an error occurs accessing the audioDuration attribute.public java.lang.String getFormat() throws java.sql.SQLException
OrdAudio
getFormat
in class OrdAudio
String
.java.sql.SQLException
- if an error occurs accessing the format attribute.public void setFormat(java.lang.String format) throws java.sql.SQLException
OrdAudio
setProperties
method for more information on how to initialize the format attribute before calling the setProperties method, and for information on how the setProperties method in the default, Oracle-supplied plug-in, sets the format attribute. Note that calling the setFormat method sets the attribute value only; it does not modify the audio data itself.setFormat
in class OrdAudio
format
- the new attribute value.java.sql.SQLException
- if an error occurs accessing the format attribute.public boolean checkProperties(byte[][] ctx) throws java.sql.SQLException
OrdAudio
checkProperties
in class OrdAudio
ctx
- the format plug-in context information.true
if the properties of the audio data are consistent with the attributes of the OrdAudio Java object; false
otherwise.java.sql.SQLException
- if an error occurs executing the corresponding checkProperties method in the database.public void setProperties() throws java.sql.SQLException
OrdAudioDomain
Java object. This method sets the format, mimeType, encoding, numberOfChannels, samplingRate, sampleSize, compressionType, and audioDuration attributes. An attribute is set to null if the corresponding property cannot be extracted for a specific audio format. This method throws a SQLException
if the audio format is not recognized.
setProperties(byte[][])
or setProperties(byte[][], boolean)
instead of this method. Otherwise, this method may fail.setProperties
in interface OrdDomainIOInterface
java.sql.SQLException
- if an error occurs while executing the corresponding setProperties method in the databaseOrdImageDomain.setProperties()
, setProperties()
, OrdVideoDomain.setProperties()
, OrdDocDomain.setProperties()
public void setProperties(byte[][] ctx) throws java.sql.SQLException
OrdAudio
setProperties
in class OrdAudio
ctx
- the format plug-in context information.java.sql.SQLException
- if an error occurs executing the corresponding setProperties method in the database.public void setProperties(byte[][] ctx, boolean setComments) throws java.sql.SQLException
OrdAudio
setComments
is true, this method also populates the CLOB specified by the comments attribute with all extracted properties in XML form. If setComments
is false, the comments attribute is not modified. This method throws a SQLException if the audio format is not recognized.
setProperties
in class OrdAudio
ctx
- the format plug-in context information.setComments
- a boolean
that specifies whether or not to populate the CLOB specified by the comments attribute.java.sql.SQLException
- if an error occurs executing the corresponding setProperties method in the database.public void setContentLength(int contentLength) throws java.sql.SQLException
OrdAudioDomain
objects. This method exists only for the OrdDomainIOInterface
.setContentLength
in interface OrdDomainIOInterface
java.sql.SQLException
- if an error occurs when accessing the contentLength attribute.OrdImage.setContentLength(int)
, OrdDoc.setContentLength(int)
public int trimSource(byte[][] ctx, int newLen) throws java.sql.SQLException
OrdAudio
Not all source plug-ins support trim operations. For example, applications can trim the data stored in a BLOB specified by the localData attribute; however, the "FILE" and "HTTP" source types do not support writable data sources and so do not support this method. Furthermore, those source plug-ins that do support write access may not support the trim operation.
Not all source plug-ins require that the data source be opened before it can be modified. However, if you call the openSource
method before calling trimSource, your application should work with any current or future source plug-ins.
trimSource
in class OrdAudio
ctx
- the source plug-in context information.int
, where 0 indicates success and a non-0 value indicates a failure code specific to the source plug-in.java.sql.SQLException
- if an error occurs executing the corresponding trimSource method in the database.public int openSource(byte[] userarg, byte[][] ctx) throws java.sql.SQLException
This method throws Exception
instead of SQLException
in Oracle 817 version OrdAudioDomain
class.
openSource
in class OrdAudio
userarg
- additional source plug-in information that may be required by user-defined source plug-ins.ctx
- the source plug-in context information.int
, where 0 indicates success and a non-0 value indicates a failure code specific to the source plug-in.java.sql.SQLException
- if an error occurs executing the corresponding openSource method in the database.public int closeSource(byte[][] ctx) throws java.sql.SQLException
OrdAudio
closeSource
in class OrdAudio
ctx
- the source plug-in context information.int
, where 0 indicates success and a non-0 value indicates a failure code specific to the source plug-in.java.sql.SQLException
- if an error occurs executing the corresponding closeSource method in the database.public byte[] processSourceCommand(byte[][] ctx, java.lang.String cmd, java.lang.String args, byte[][] result) throws java.sql.SQLException
OrdAudio
processSourceCommand
in class OrdAudio
ctx
- the source plug-in context information.cmd
- the command to be executed by the source plug-in.args
- the command arguments.result
- a byte[][]
array of the form [1][n
] into which the result of the command execution is written.java.sql.SQLException
- if an error occurs executing the corresponding processSourceCommand method in the database.public byte[] processAudioCommand(byte[][] ctx, java.lang.String cmd, java.lang.String args, byte[][] result) throws java.sql.SQLException
OrdAudio
processAudioCommand
in class OrdAudio
ctx
- the format plug-in context information.cmd
- the command to be executed by the format plug-in.args
- the command arguments.result
- a byte[][]
array of the form [1][n
] into which the result of the command execution is written.java.sql.SQLException
- if an error occurs executing the corresponding processAudioCommand method in the database.public void setUpdateTime(java.sql.Timestamp currentTime) throws java.sql.SQLException
OrdDomainIOInterface
setUpdateTime
in interface OrdDomainIOInterface
setUpdateTime
in class OrdAudio
currentTime
- the update time in a java.sql.Timestamp
, or null
to set the update time to the database server's current SYSDATE time.java.sql.SQLException
- if an error occurs when executing the corresponding setUpdateTime method in the database.public java.sql.Timestamp getUpdateTime() throws java.sql.SQLException
OrdDomainIOInterface
getUpdateTime
in interface OrdDomainIOInterface
getUpdateTime
in class OrdAudio
java.sql.Timestamp
.java.sql.SQLException
- if an error occurs when accessing the updateTime attribute.public java.lang.String getAttribute(byte[][] ctx, java.lang.String name) throws java.sql.SQLException
OrdAudio
getAttribute
in class OrdAudio
ctx
- the format plug-in context information.name
- the property or attribute name.String
.java.sql.SQLException
- if an error occurs executing the corresponding getAttribute method in the database.public oracle.sql.CLOB getAllAttributes(byte[][] ctx) throws java.sql.SQLException
attributeName=attributeValue
, where the list contains the following attributes: format, mimeType, encoding, numberOfChannels, samplingRate, sampleSize, compressionType, and audioDuration. For user-defined formats, the information is presented in a form defined by the format plug-in.
getAllAttributes
in class OrdAudio
ctx
- the format plug-in context informationoracle.sql.CLOB
java.sql.SQLException
- if an error occurs while executing the corresponding getAllAttributes method in the databasepublic oracle.sql.BLOB getContentInLob(byte[][] ctx, java.lang.String[] mimetype, java.lang.String[] format) throws java.sql.SQLException
getContentInLob
in class OrdAudio
ctx
- the format plug-in context informationmimetype
- a String[]
array, 1 element in length, into which the mimeType attribute is written as element 0format
- a String[]
array, 1 element in length, into which the format attribute is written as element 0oracle.sql.BLOB
java.sql.SQLException
- if an error occurs while creating the temporary BLOB or while executing the corresponding getContentInLob method in the databasepublic void setKnownAttributes(java.lang.String knownformat, java.lang.String knownencoding, int knownnumberofchannels, int knownsamplingrate, int knownsamplesize, java.lang.String knowncompressiontype, int knownaudioduration) throws java.sql.SQLException
OrdAudio
setProperties
sets the following attributes automatically for certain audio formats: format, encoding, numberOfChannels, samplingRate, sampleSize, compressionType, and audioDuration; use this method only if you are not using setProperties. This method sets the specified attribute values only; it does not modify the audio data itself.setKnownAttributes
in class OrdAudio
knownformat
- the new attribute value as a String
.knownencoding
- the new attribute value as a String
.knownnumberofchannels
- the new attribute value as an int
.knownsamplingrate
- the new attribute value as an int
.knownsamplesize
- the new attribute value as an int
.knowncompressiontype
- the new attribute value as a String
.knownaudioduration
- the new attribute value as an int
.java.sql.SQLException
- if an error occurs executing the corresponding setKnownAttributes method in the database.public int readFromSource(byte[][] ctx, int startpos, int numbytes, byte[][] buffer) throws java.sql.SQLException
OrdAudio
Not all source plug-ins require that the data source be opened before it can be read. However, if you call the openSource
method before calling readFromSource, your application should work with any current or future source plug-ins.
readFromSource
in class OrdAudio
ctx
- the source plug-in context information.startpos
- the start position in the data source.numbytes
- the number of bytes to read from the data source.buffer
- a byte[][]
array of the form [1][n
], where n
>= numbytes
int
.java.sql.SQLException
- if an error occurs executing the corresponding readFromSource method in the database.public int writeToSource(byte[][] ctx, int startpos, int numbytes, byte[] buffer) throws java.sql.SQLException
OrdAudio
Not all source plug-ins support write operations. For example, applications can write to a BLOB specified by the localData attribute; however, the "FILE" and "HTTP" source types do not support writable data sources and so do not support this method. Furthermore, those source plug-ins that do support write access may support only sequential write access and may not support write access to arbitrary starting positions within the data source.
Not all source plug-ins require that the data source be opened before it can be written. However, if you call the openSource
method before calling writeToSource, your application should work with any current or future source plug-ins.
writeToSource
in class OrdAudio
ctx
- the source plug-in context information.startpos
- the start position in the data source.numbytes
- the number of bytes to write to the data source.buffer
- a byte[]
array containing the data to be written.int
.java.sql.SQLException
- if an error occurs executing the corresponding writeToSource method in the database.public void export(byte[][] ctx, java.lang.String sourceType, java.lang.String sourceLocation, java.lang.String sourceName) throws java.sql.SQLException
OrdAudio
Not all source plug-ins support the export method. For example, the "FILE" source type is the only Oracle-supplied source type that supports the export method. In addition, this method is supported only by Oracle database server release 8.1.7 or later.
The remainder of this description illustrates the use of the export method and the Oracle-supplied "FILE" source plug-in. User-written plug-ins will have different behaviors.
The export method implemented by the Oracle-supplied "FILE" source plug-in copies the audio data from the BLOB specified by the localData attribute, but does not modify the audio data stored in the database BLOB in any way.
After exporting the audio data, all the audio property attributes remain unchanged, however, the srcType, srcLocation, and srcName attributes are updated with values of the srcType, srcLocation, and srcName parameters passed to the export method. After calling the export method, if you no longer intend to manage the audio data within the database, call the OrdAudio.clearLocal()
method to indicate the audio data is stored outside the database and call the OrdAudio.deleteContent()
method to delete the audio data stored in the database BLOB.
The export method in the database writes only to a database directory object that the user has privilege to access. That is, you can access a directory that you have created using the SQL CREATE DIRECTORY statement, or one to which you have been granted READ access. To execute the CREATE DIRECTORY statement, you must have the CREATE ANY DIRECTORY privilege. In addition, you must use the DBMS_JAVA.GRANT_PERMISSION method to specify which files can be written.
For example, the following SQL*Plus command grants the user, MEDIAUSER
, the permission to write to the file named filmtrack1.au
.
CALL DBMS_JAVA.GRANT_PERMISSION( 'MEDIAUSER', 'java.io.FilePermission', '/audio/movies/filmtrack1.au', 'write');
The previous example illustrates how to authorize access to write to a single file. In addition, there are various wildcard path specifications that authorize write access to multiple directories and file names. For example, a path specification that ends in "/*"
(where "/"
is the operating-system dependent file separator character) indicates all the files contained in the specified directory. A path specification that ends with "/-"
indicates all files contained in the specified directory and all its subdirectories. A pathname consisting of the special token "<<ALL FILES>>"
authorizes access to any file.
See the security and performance section in Oracle Java Developer's Guide and the java.io.FilePermission class in the Java API for more information.
export
in class OrdAudio
ctx
- the source plug-in context information.sourceType
- the source type, for example, "FILE".sourceLocation
- the source location, for example, SOUNDS_DIR.sourceName
- the source name, for example, filmtrack1.au.java.sql.SQLException
- if an error occurs executing the corresponding export method in the database.public boolean getDataInFile(java.lang.String filename) throws java.sql.SQLException, java.io.IOException
OrdDomainIOInterface
getDataInFile
in interface OrdDomainIOInterface
getDataInFile
in class OrdAudio
filename
- name of the file to which the data is to be written.true
if the data is written to the file successfully; otherwise, an exception is raised if an error occurs. This method never returns false
.java.io.IOException
- if an error occurs when reading the data from the BLOB or when writing the data to the output file.java.sql.SQLException
- if an error occurs when accessing an object attribute.public java.io.InputStream getDataInStream() throws java.sql.SQLException
OrdDomainIOInterface
getDataInStream
in interface OrdDomainIOInterface
getDataInStream
in class OrdAudio
InputStream
from which the data can be read.java.sql.SQLException
- if an error occurs when accessing an object attribute.public byte[] getDataInByteArray() throws java.sql.SQLException, java.io.IOException, java.lang.OutOfMemoryError
OrdDomainIOInterface
getDataInByteArray
in interface OrdDomainIOInterface
getDataInByteArray
in class OrdAudio
byte[]
array containing the data.java.lang.OutOfMemoryError
- if sufficient memory cannot be allocated to hold the data.java.sql.SQLException
- if an error occurs when accessing an object attribute.java.io.IOException
- if an error occurs when reading the data from the BLOB.public oracle.jbo.domain.BlobDomain getContentAsBlobDomain() throws java.sql.SQLException
OrdDomainIOInterface
BlobDomain
object which wraps the BLOB locator from the localData attribute.getContentAsBlobDomain
in interface OrdDomainIOInterface
BlobDomain
objectjava.sql.SQLException
- if an error occurs in calling getContent
method.OrdImage.getContent()
, OrdAudio.getContent()
, OrdVideo.getContent()
, OrdDoc.getContent()
public oracle.jbo.domain.BFileDomain getBFileDomain() throws java.sql.SQLException
OrdDomainIOInterface
BFileDomain
object which wraps the BFILE locator obtained from the getBFILE
method.getBFileDomain
in interface OrdDomainIOInterface
BFileDomain
objectjava.sql.SQLException
- if an error occurs in calling getBFILE
method.OrdImage.getBFILE()
, OrdAudio.getBFILE()
, OrdVideo.getBFILE()
, OrdDoc.getBFILE()
public oracle.jbo.domain.ClobDomain getCommentsAsClobDomain() throws java.sql.SQLException
ClobDomain
object which wraps the CLOB locator obtained from the getComments()
method.ClobDomain
objectjava.sql.SQLException
- if an error occurs while calling the getComments
methodpublic void setContentSource(OrdContentSource source)
OrdDomainIOInterface
OrdHttpUploadFile
object. The loading of content from the client into the database doesn't happen inside this method. It's deferred to the next postChanges
method call.
If the source parameter is null
, this method just resets the previously set content source.
In 3Tier environment, this method registers the domain object in the client post listener list so the content won't be replicated from CT to MT. The content will be streamed to the database directly after the postChanges
.
setContentSource
in interface OrdDomainIOInterface
source
- the content source for the deferred loadingOrdContentSource
public OrdContentSource getContentSource()
OrdDomainIOInterface
setContentSource
method.getContentSource
in interface OrdDomainIOInterface
public oracle.sql.CustomDatum create(oracle.sql.Datum d, int sqlType) throws java.sql.SQLException
create
in interface oracle.sql.CustomDatumFactory
create
in class OrdAudio
java.sql.SQLException
public static oracle.jbo.domain.XMLDomainFactory getXMLDomainFactory(java.lang.Class attrClass)
public org.w3c.dom.Node getXMLContentNode(org.w3c.dom.Document xmlDoc)
getXMLContentNode
in interface oracle.jbo.domain.XMLDomainInterface
public java.lang.Object createDomainFromSerializedXML(org.w3c.dom.Element element)
createDomainFromSerializedXML
in interface oracle.jbo.domain.XMLDomainReaderFactory
public org.w3c.dom.Node getSerializedDomainXML(org.w3c.dom.Document xmlDoc)
getSerializedDomainXML
in interface oracle.jbo.domain.XMLDomainWriter
xmlDoc
- name of the XML document in which the node should be created.public java.lang.String printXMLDefinition(java.util.Hashtable allDefs, java.io.PrintWriter pw, boolean bContainees)
printXMLDefinition
in interface oracle.jbo.domain.XMLDomainInterface
public void domainToBeModified(oracle.jbo.domain.DomainInterface d)
domainToBeModified
in interface oracle.jbo.domain.DomainOwnerInterface
public java.lang.Object getAttribute(int index)
getAttribute
in interface oracle.jbo.AttributeList
public java.lang.Object getAttribute(java.lang.String name)
getAttribute
in interface oracle.jbo.AttributeList
public void setAttribute(int index, java.lang.Object value)
setAttribute
in interface oracle.jbo.AttributeList
public void setAttribute(java.lang.String name, java.lang.Object value)
setAttribute
in interface oracle.jbo.AttributeList
public int getAttributeCount()
getAttributeCount
in interface oracle.jbo.AttributeList
public int getAttributeIndexOf(java.lang.String name)
getAttributeIndexOf
in interface oracle.jbo.AttributeList
public java.lang.String[] getAttributeNames()
getAttributeNames
in interface oracle.jbo.AttributeList
public java.lang.Object[] getAttributeValues()
getAttributeValues
in interface oracle.jbo.AttributeList
public void syncServerLob(oracle.jbo.domain.LobInterface oldObj)
syncServerLob
in interface oracle.jbo.domain.LobInterface
public void syncClientLob(oracle.jbo.domain.LobInterface newArrival)
syncClientLob
in interface oracle.jbo.domain.LobInterface
public long getSize()
getSize
in interface oracle.jbo.domain.LobInterface
public java.lang.String getRemoteIdString()
getRemoteIdString
in interface oracle.jbo.domain.LobInterface
public void saveToDatabase(oracle.jbo.Transaction xAct) throws java.sql.SQLException
saveToDatabase
in interface oracle.jbo.domain.BlobDomainInterface
java.sql.SQLException
public void saveToDatabase(oracle.jbo.Transaction xAct, java.lang.Object emptySQLObject) throws java.sql.SQLException, java.io.IOException
saveToDatabase
in interface oracle.jbo.domain.BlobDomainInterface
java.sql.SQLException
java.io.IOException
public void prepareForDML(java.lang.Object context)
prepareForDML
in interface oracle.jbo.domain.BlobDomainInterface
public void loadFromDatabase(oracle.jbo.Transaction xAct) throws java.lang.Exception
loadFromDatabase
in interface oracle.jbo.domain.BlobDomainInterface
java.lang.Exception
public oracle.jbo.domain.DomainOwnerInterface getOwner()
getOwner
in interface oracle.jbo.domain.LobInterface
public int getOwnerAttributeIndex()
getOwnerAttributeIndex
in interface oracle.jbo.domain.LobInterface
public java.lang.Object getData()
getData
in interface oracle.jbo.domain.DomainInterface
public void setContext(oracle.jbo.domain.DomainOwnerInterface owner, oracle.jbo.Transaction trans, java.lang.Object ctx)
setContext
in interface oracle.jbo.domain.DomainInterface
public oracle.svcmsg.ResponseValues marshal()
marshal
in interface oracle.jbo.domain.MarshalledDomain
public boolean isConnected()
OrdDomainState
isConnected
in interface OrdDomainState
true
if the there exists an internal JDBC connection; otherwise, returns false
public int getTierInfo()
OrdDomainState
The returned value indicates the tier information.
getTierInfo
in interface OrdDomainState
public void removeListenerFromTransaction()
OrdDomainState
removeListenerFromTransaction
in interface OrdDomainState
public void doneCommit(oracle.jbo.TransactionStateEvent event)
doneCommit
in interface oracle.jbo.TransactionStateListener
public void doneRollback(oracle.jbo.TransactionStateEvent event)
doneRollback
in interface oracle.jbo.TransactionStateListener
public void setContentSourceOnly(OrdContentSource source)
OrdDomainIOInterface
setContentSourceOnly
in interface OrdDomainIOInterface
public void setCTPassivationHandle(java.lang.Object handle)
setCTPassivationHandle
in interface OrdDomainSupportInterface
public java.lang.Object getCTPassivationHandle()
getCTPassivationHandle
in interface OrdDomainSupportInterface
public void prepareCTPassivation()
prepareCTPassivation
in interface OrdDomainSupportInterface
public void clearContentSource()
OrdDomainIOInterface
clearContentSource
in interface OrdDomainIOInterface
|
Oracle9i Business Components for Java InterMedia API Reference Oracle9i JDeveloper (9.0.4) B10394-01 | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |