oracle.ord.html
Class OrdUploadFileRenderer

java.lang.Object
  |
  +--oracle.jdeveloper.html.HTMLFieldRendererImpl
        |
        +--oracle.ord.html.OrdUploadFileRenderer

All Implemented Interfaces:

oracle.jdeveloper.html.HTMLFieldRenderer, oracle.jdeveloper.html.HTMLRenderingContext

public class OrdUploadFileRenderer

extends oracle.jdeveloper.html.HTMLFieldRendererImpl

Generates an HTML tag string that allows users to upload files from the browser to an interMedia domain object. The tag string also allows users to delete existing content in the domain object.

OrdUploadFileRenderer serves as the default input HTML renderer for all interMedia domain classes:

• OrdImageDomain
• OrdAudioDomain
• OrdVideoDomain
• OrdDocDomain

The HTML tag string generated by this class is a FORM FILE INPUT element for an interMedia domain object. The FILE INPUT element allows users to load a multimedia file from the browser file system to the interMedia domain object on the web server.

The FILE INPUT element should be used inside an HTML FORM tag with the attributes METHOD="post" and ENCTYPE="multipart/form-data" specified. A typical file upload HTML FORM looks like the following:

   <FORM ACTION="[URL]" METHOD="POST" ENCTYPE="multipart/form-data">
       <INPUT TYPE="FILE" NAME="[AttributeName]">
       <BR>
       <INPUT TYPE="SUBMIT" TEXT="submit">
   </FORM>
 

Since:

JDev3.2

Constructor Summary

OrdUploadFileRenderer()
Constructs an OrdUploadFileRenderer instance.

OrdUploadFileRenderer(oracle.jbo.AttributeDef aDef)

Method Summary

Type	Method
java.lang.String	renderToString(oracle.jbo.Row row) Returns HTML FORM elements that allow users to update a specific interMedia domain object with the contents of a file they select.

Methods inherited from class oracle.jdeveloper.html.HTMLFieldRendererImpl

getAttributeDef, getCSSClassName, getDatasource, getDisplayHeight, getDisplayWidth, getFieldName, getFormName, getMaxDataLength, getPageContext, getPromptText, getValue, setAttributeDef, setCSSClassName, setDatasource, setDisplayHeight, setDisplayWidth, setFieldName, setFormName, setHtmlAttributes, setMaxDataLength, setPageContext, setPromptText, setValue

Methods inherited from class java.lang.Object

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

Constructor Detail

OrdUploadFileRenderer

public OrdUploadFileRenderer()

Constructs an OrdUploadFileRenderer instance.

OrdUploadFileRenderer

public OrdUploadFileRenderer(oracle.jbo.AttributeDef aDef)

Method Detail

renderToString

public java.lang.String renderToString(oracle.jbo.Row row)

Returns HTML FORM elements that allow users to update a specific interMedia domain object with the contents of a file they select. The generated tag string consists of a FILE INPUT element and, in certain cases, a CHECKBOX INPUT element.

The HTML tag string generated by this method depends on whether or not the domain object has existing multimedia content:

• If the domain object contains no media content or content length is 0:

   <INPUT TYPE="file" NAME=[AttributeName] ID="LOADFILE" SIZE=40>
   <LABEL FOR="LOADFILE">Upload file</LABEL>
   

• If the domain object contains media content and content length is larger than 0:

   <INPUT TYPE="file" NAME=[AttributeName] ID="LOADFILE" SIZE=40>
   <LABEL FOR="LOADFILE">Upload file</LABEL><BR>
   <INPUT TYPE="checkbox" NAME="[AttributeName]_DELETE" ID="DELETECONTENT">
   <LABEL FOR="DELETECONTENT">Check to remove existing object</LABEL>
   

Certain Business Components for Java data tags and data web beans call this method when they use the HTML input renderer to upload a file to the domain object.

Overrides:

renderToString in class oracle.jdeveloper.html.HTMLFieldRendererImpl

Parameters:

dataSource - the object that contains data binding information used by the HTML renderer to access the domain object

row - the row which contains the domain object

Returns:

the HTML tag string to update the domain object