OrdHttpResponseHandler (Oracle Multimedia Servlets and JSP Java API Reference)

The OrdHttpResponseHandler class facilitates the retrieval of media data from Oracle Database, and its delivery to a browser or other HTTP client from a Java servlet.

An Oracle Multimedia Java object, such as an OrdImage object, is not dependent on the JDBC statement or result set from which it was obtained. However, an Oracle Multimedia Java object is dependent on the JDBC connection it is using and on which the SQL statement was executed, or from which the result set was obtained. Therefore, having obtained an Oracle Multimedia Java object from the database, an application must not release the JDBC connection before delivering the media data to the browser.

This class contains the following field: public static final int DEFAULT_BUFFER_SIZE.

The OrdHttpResponseHandler class uses a default buffer size of 32768 to retrieve LOB data from the database and deliver it to the client. You can override this value with the setBufferSize method.

The following example shows how to use the OrdHttpResponseHandler class to retrieve an image from a database and deliver it to a browser:

If you wish to retrieve from an OrdDoc object a text-based document with a character set (charset) other than ISO-8859-1 (also called Latin-1), and deliver that document to a browser, your application must specify the charset name in the HTTP Content-Type header.

If the charset specification is included in the MIME type attribute in the OrdDoc object, then your application needs to call only the sendDoc method to retrieve the document and deliver it to the browser. For example, an HTML page that is written in Japanese might be stored in the OrdDoc object with a MIME type of text/html; charset=Shift_JIS. In this case, calling sendDoc method will send the appropriate Content-Type header, allowing the browser to display the page correctly.

However, if the MIME type in the OrdDoc object does not include the charset specification, then you must call one of the sendResponse methods and specify the MIME type explicitly. For example, if the MIME type of an HTML page written in Japanese is stored in the OrdDoc object as text/html, and the charset name is specified in a separate column, then the application must append the charset specification to the MIME type before calling a sendResponse method. For example:

  OraclePreparedStatement stmt =
      (OraclePreparedStatement)conn.prepareStatement(
          "select doc, charset from documents where id = ?" );
  stmt.setString( 1, request.getParameter("id") );
  OracleResultSet rset = (OracleResultSet)stmt.executeQuery();
  if ( rset.next() )
  {
      OrdDoc doc = (OrdDoc)rset.getORAData( 1, OrdDoc.getORADataFactory() );
      String charset = rset.getString( 2 );
      String mimeType = doc.getMimeType() + "; charset=" + charset;
      OrdHttpResponseHandler handler =
                      new OrdHttpResponseHandler( request, response );
      handler.sendResponse( mimeType, doc.getContentLength(),
                            doc.getContent(), doc.getUpdateTime() );
  }
  else
  {
      response.setStatus( response.SC_NOT_FOUND );
  }
  rset.close();
  stmt.close();

In order to run Oracle Multimedia methods for servlets and JSP, you will need to import classes from the oracle.ord.im package into your Java file.

Method Summary
`void`	`sendAudio(oracle.ord.im.OrdAudio media)` Retrieves an audio clip from an OrdAudio object and delivers it to the browser.
`void`	`sendDoc(oracle.ord.im.OrdDoc media)` Retrieves media data from an OrdDoc object and delivers it to the browser.
`void`	`sendImage(oracle.ord.im.OrdImage media)` Retrieves an image from an OrdImage object and delivers it to the browser.
`void`	`sendResponse()` Retrieves a media object from one of the Oracle Multimedia objects (OrdImage, OrdAudio, OrdVideo, or OrdDoc) and delivers it to the browser.
`void`	`sendResponse(java.lang.String contentType, int length, oracle.sql.BFILE bfile, java.sql.Timestamp lastModified)` Builds the HTTP response header, then retrieves the contents of the BFILE from the database and delivers it to the browser.
`void`	`sendResponse(java.lang.String contentType, int length, oracle.sql.BLOB blob, java.sql.Timestamp lastModified)` Builds the HTTP response header, then retrieves the contents of the BLOB from the database and delivers it to the browser.
`void`	`sendResponse(java.lang.String contentType, int length, java.io.InputStream in, java.sql.Timestamp lastModified)` Builds the HTTP response header, then retrieves the contents of the InputStream object and delivers it to the browser.
`void`	`sendResponseBody(int length, oracle.sql.BFILE bfile)` Retrieves the content of a BFILE from the database and delivers it as the response body to the browser.
`void`	`sendResponseBody(int length, oracle.sql.BLOB blob)` Retrieves the content of a BLOB from the database and delivers it as the response body to the browser.
`void`	`sendResponseBody(int length, java.io.InputStream in)` Retrieves the content of the InputStream object and delivers it as the response body to the browser.
`void`	`sendVideo(oracle.ord.im.OrdVideo media)` Retrieves a video clip from an OrdVideo object and delivers it to the browser.
`void`	`setBufferSize(int bufferSize)` Sets the buffer size for LOB read and HTTP response write operations.
`void`	`setEncodeHtml(boolean doEncode)` Enables the encoding of special characters (! " % & ' ( ) ; < >) from the response output stream with HTML numeric code.
`void`	`setHeader(java.lang.String name, int value)` Sets the HTTP response header with the integer (int) value.
`void`	`setHeader(java.lang.String name, long date)` Sets the HTTP response header with the date value.
`void`	`setHeader(java.lang.String name, java.lang.String value)` Sets the HTTP response header with the String value.
`void`	`setMedia(oracle.ord.im.OrdAudio media)` Sets the OrdAudio object as the media object to be delivered.
`void`	`setMedia(oracle.ord.im.OrdDoc media)` Sets the OrdDoc object as the media object to be delivered.
`void`	`setMedia(oracle.ord.im.OrdImage media)` Sets the OrdImage object as the media object to be delivered.
`void`	`setMedia(oracle.ord.im.OrdVideo media)` Sets the OrdVideo object as the media object to be delivered.
`void`	`setServletRequest(javax.servlet.http.HttpServletRequest request)` Specifies the HttpServletRequest object for this response handler.
`void`	`setServletResponse(javax.servlet.http.HttpServletResponse response)` Specifies the HttpServletResponse object for this response handler.

Constructor Summary
`OrdHttpResponseHandler()` Creates an OrdHttpResponseHandler object to handle the response to a media retrieval request.
`OrdHttpResponseHandler(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)` Creates an OrdHttpResponseHandler object to handle the response to a media retrieval request and specifies the HttpServletRequest and HttpServletResponse objects for the response handler.

oracle.ord.im Class OrdHttpResponseHandler

DEFAULT_BUFFER_SIZE

OrdHttpResponseHandler

OrdHttpResponseHandler

setServletRequest

setServletResponse

sendImage

sendAudio

sendVideo

sendDoc

sendResponse

sendResponse

sendResponse

sendResponseBody

sendResponseBody

sendResponseBody

setBufferSize

setMedia

setMedia

setMedia

setMedia

setHeader

setHeader

setHeader

sendResponse

setEncodeHtml

oracle.ord.im
Class OrdHttpResponseHandler