oracle.ifs.server

Class MediaBlobHelper

java.lang.Object

oracle.ifs.server.MediaBlobHelper

Direct Known Subclasses:

OracleMediaBlobHelper, PostgresMediaBlobHelper

public abstract class MediaBlobHelper
extends Object

A MediaBlobHelper is an abstract class that represents an interface for Blob operations for an S_MediaBlob instance.

(Unpublished)

Field Summary

Fields

Modifier and Type	Field and Description
protected S_MediaBlob	m_MediaBlob The S_MediaBlob being serviced.
protected S_LibrarySession	m_Session The S_LibrarySession used by the S_MediaBlob being serviced.

Constructor Summary

Constructors

Constructor and Description
MediaBlobHelper(S_MediaBlob mediaBlob) Constructs a MediaBlobHelper instance.

Method Summary

Modifier and Type	Method and Description
protected abstract void	copyContent(S_MediaBfile srcMedia, Long srcCid, Long dstCid, Long partitionValue, AttributeValue[] mediaOptions) Stores a copy of existing content as the content for the specified content id, with a S_MediaBfile being the source.
protected abstract void	copyContent(S_MediaBlob srcMedia, Long srcCid, Long dstCid, Long partitionValue, AttributeValue[] mediaOptions) Stores a copy of existing content as the content for the specified content id, with a S_MediaBlob being the source.
abstract void	createContentIndexProcedure(Connection conn) Recreates the content index procedure, if any, for this MediaBlob instance.
protected abstract void	destroyContent(Long cid, AttributeValue[] mediaOptions) Destroys the content for the specified content ID.
protected abstract InputStream	getContent(Long cid) Gets the content stream for the specified content id.
protected abstract long	getContentSize(Long cid) Gets the size of the content stream for the specified content id.
protected abstract RandomAccessDriver	getRandomAccessDriver(Long cid) Returns a RandomAccessDriver to use to retrieve the indicated content.
S_LibrarySession	getSession() Gets the session context.
protected abstract void	setContent(Long cid, InputStream is, Long partitionValue, AttributeValue[] mediaOptions) Stores content read from the specified InputStream using the specified content id.
protected abstract void	setEmptyContent(Long cid, Long partitionValue, AttributeValue[] mediaOptions) Stores zero-length content for the specified content id.

Methods inherited from class java.lang.Object

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

Field Detail

m_MediaBlob

protected S_MediaBlob m_MediaBlob

The S_MediaBlob being serviced.

m_Session

protected S_LibrarySession m_Session

The S_LibrarySession used by the S_MediaBlob being serviced.

Constructor Detail

MediaBlobHelper

public MediaBlobHelper(S_MediaBlob mediaBlob)
                throws IfsException

Constructs a MediaBlobHelper instance.

Parameters:

mediaBlob - the S_MediaBlob instance being serviced

Throws:

IfsException - if the operation fails

(Published)

Method Detail

getSession

public S_LibrarySession getSession()

Gets the session context.

Returns:

the session context

createContentIndexProcedure

public abstract void createContentIndexProcedure(Connection conn)
                                          throws IfsException

Recreates the content index procedure, if any, for this MediaBlob instance.

Parameters:

conn - the connection

Throws:

IfsException - if the operation fails

(Unpublished)

getContent

protected abstract InputStream getContent(Long cid)
                                   throws IfsException

Gets the content stream for the specified content id.

Parameters:

cid - the content id; required

Returns:

the content stream; non-null

Throws:

IfsException - if the operation fails

(Unpublished)

getContentSize

protected abstract long getContentSize(Long cid)
                                throws IfsException

Gets the size of the content stream for the specified content id.

Parameters:

cid - the content id; required

Returns:

the size, in bytes

Throws:

IfsException - if the operation fails

(Unpublished)

setContent

protected abstract void setContent(Long cid,
                                   InputStream is,
                                   Long partitionValue,
                                   AttributeValue[] mediaOptions)
                            throws IfsException

Stores content read from the specified InputStream using the specified content id.

The implementation of this method is responsible for inserting a row into the content table whose ID column is cid, storing content read from the InputStream, and closing the InputStream.

Parameters:

cid - the content id; required

is - the InputStream from which content is read

partitionValue - the value for the PARTITIONVALUE column in the content table, or null if none

mediaOptions - a set of name/value pairs whose semantics are Media determined, or null for no media options

Throws:

IfsException - if the operation fails

(Unpublished)

setEmptyContent

protected abstract void setEmptyContent(Long cid,
                                        Long partitionValue,
                                        AttributeValue[] mediaOptions)
                                 throws IfsException

Stores zero-length content for the specified content id.

The implementation of this method is responsible for inserting a row into the content table whose ID column is cid.

Althrough a concrete implementation is provided here (by calling setContent and immediately closing the returned OutputStream), subclasses should override this method with a more performant implementation, if possible.

Parameters:

cid - the content id; required

partitionValue - the value for the PARTITIONVALUE column in the content table, or null if none

mediaOptions - a set of name/value pairs whose semantics are Media determined, or null for no media options

Throws:

IfsException - if the operation fails

(Unpublished)

copyContent

protected abstract void copyContent(S_MediaBlob srcMedia,
                                    Long srcCid,
                                    Long dstCid,
                                    Long partitionValue,
                                    AttributeValue[] mediaOptions)
                             throws IfsException

Stores a copy of existing content as the content for the specified content id, with a S_MediaBlob being the source.

The implementation of this method is responsible for inserting a row into the content table whose ID column is dstCid.

Although a concrete implementation is provided here (by copying the InputStream returned by srcMedia.getContent(srcCid) to the OutputStream returned by setContent), subclasses should override this method with a more performant implementation, if possible.

Parameters:

srcMedia - the S_MediaBlob source media; required

srcCid - the source content id; required

dstCid - the destination content id; required

partitionValue - the value for the PARTITIONVALUE column in the content table, or null if none

mediaOptions - a set of name/value pairs whose semantics are Media determined, or null for no media options

Throws:

IfsException - if the operation fails

(Unpublished)

copyContent

protected abstract void copyContent(S_MediaBfile srcMedia,
                                    Long srcCid,
                                    Long dstCid,
                                    Long partitionValue,
                                    AttributeValue[] mediaOptions)
                             throws IfsException

Stores a copy of existing content as the content for the specified content id, with a S_MediaBfile being the source.

The implementation of this method is responsible for inserting a row into the content table whose ID column is dstCid.

Although a concrete implementation is provided here (by copying the InputStream returned by srcMedia.getContent(srcCid) to the OutputStream returned by setContent), subclasses should override this method with a more performant implementation, if possible.

Parameters:

srcMedia - the S_MediaBfile source media; required

srcCid - the source content id; required

dstCid - the destination content id; required

partitionValue - the value for the PARTITIONVALUE column in the content table, or null if none

mediaOptions - a set of name/value pairs whose semantics are Media determined, or null for no media options

Throws:

IfsException - if the operation fails

(Unpublished)

destroyContent

protected abstract void destroyContent(Long cid,
                                       AttributeValue[] mediaOptions)
                                throws IfsException

Destroys the content for the specified content ID.

Parameters:

cid - the content id; required

mediaOptions - a set of name/value pairs whose semantics are Media determined, or null for no media options

Throws:

IfsException - if the operation fails

(Unpublished)

getRandomAccessDriver

protected abstract RandomAccessDriver getRandomAccessDriver(Long cid)
                                                     throws IfsException

Returns a RandomAccessDriver to use to retrieve the indicated content.

Parameters:

cid - the content id; required

Returns:

the RandomAccessDriver

Throws:

IfsException - if the operation fails

(Unpublished)