oracle.ord.html
Class OrdPlayMedia

oracle.ord.html.OrdPlayMedia

public class OrdPlayMedia

Interprets the URLs constructed by OrdURLBuilder, retrieves multimedia content from the database, and sends the data to the browser.

OrdPlayMedia only supports JSP applications. Internally, it uses oracle.ord.im.OrdHttpJspResponseHandler to deliver binary multimedia content to the browser. There are some important notes on using JSP to deliver binary data in OrdHttpJspResponseHandler.

A JSP page named ordPlayMedia.jsp is the front end of this class. When the JSP application intends to use OrdPlayMedia to retrieve multimedia content and deliver it to the browser, ordPlayMedia.jsp should be included into the user's JSP application. After delivering the content, the resources will be released. The default release mode is Reserved. Users can set the release mode by invoking setReleaseMode() method on OrdPlayMedia object. A sample usage is provided below:

 <jsp:useBean id="playMedia" class="oracle.ord.html.OrdPlayMedia" scope="request">
   <jsp:setProperty name="playMedia" property="*" />
   <%
     playMedia.initialize(pageContext);
     playMedia.setReleaseMode("Stateless");
     playMedia.renderContent();
     if(true) return;
   %>
 </jsp:useBean>

 

The ordPlayMedia.jsp file can be extracted from the webapp.zip file located in the JDeveloper /redist/ folder.

Since:

JDev3.2

See Also:

OrdURLBuilder, OrdHttpJspResponseHandler

Constructor Summary

OrdPlayMedia()
Constructs an OrdPlayMedia instance.

Method Summary

Type	Method
void	ordRender() Deprecated. As of JDeveloper5.0, replaced by renderContent()
void	renderContent() Retrieves the multimedia content from the database using the appropriate interMedia domain object and then sends it to the browser window.
void	setAppModID(java.lang.String appModId) Sets the Business Components for Java application module id.
void	setContentCol(java.lang.String attrName) Sets the attribute name for the interMedia column.
void	setReleaseMode(java.lang.String releaseMode) Sets the release mode of application module.
void	setRowKey(java.lang.String rowKey) Sets the String representation of the row that contains the multimedia content.
void	setRowSetName(java.lang.String rowSetName) Sets the rowset name.

Constructor Detail

OrdPlayMedia

public OrdPlayMedia()

Constructs an OrdPlayMedia instance.

Method Detail

setContentCol

public void setContentCol(java.lang.String attrName)

Sets the attribute name for the interMedia column.

Parameters:

attrName - the attribute name for the interMedia column

setRowSetName

public void setRowSetName(java.lang.String rowSetName)

Sets the rowset name.

Parameters:

rowSetName - the rowset name

setAppModID

public void setAppModID(java.lang.String appModId)

Sets the Business Components for Java application module id.

Parameters:

appModId - the application module id

setRowKey

public void setRowKey(java.lang.String rowKey)

Sets the String representation of the row that contains the multimedia content. The RowKey object may include a primary key when one exists, but it also includes information from the view object to uniquely identify the row.

Parameters:

rowKey - the String object that uniquely identifies a row

See Also:

oracle.jbo.Key#toStringFormat

setReleaseMode

public void setReleaseMode(java.lang.String releaseMode)

Sets the release mode of application module. If user does not call this method, the default release mode is Stateful.

Parameters:

releaseMode - the release mode of application module, including Stateful, Stateless and Reserved.

ordRender

public void ordRender()
               throws java.lang.Exception

Deprecated. As of JDeveloper5.0, replaced by renderContent()

Retrieves the multimedia content from the database using the appropriate interMedia domain object and then sends it to the browser window.

renderContent

public void renderContent()
                   throws java.lang.Exception

Retrieves the multimedia content from the database using the appropriate interMedia domain object and then sends it to the browser window.