gd
Tag inputFile


Upload a file from the client to the server. Note: this element must be enclosed within a form whose enctype is set to multipart/form-data in order for it to work properly. Also, be aware that using a target type other than stream or reader on large files can be severely detrimental to performance.


Tag Information
Tag ClassNone
TagExtraInfo ClassNone
Body ContentJSP
Display NameNone

Attributes
NameRequiredRequest-timeTypeDescription
acceptfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
This attribute specifies a comma-separated list of content types that a server processing this form will handle correctly. User agents may use this information to filter out non-conforming files when prompting a user to select files to be sent to the server.
accesskeyfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
This attribute assigns an access key to an element. An access key is a single character from the document character set. Note: Authors should consider the input method of the expected reader when specifying an accesskey.
altfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Alternate text to display for user agents that cannot render this type of form field.
bindingfalsefalsejavax.el.ValueExpression
(must evaluate to javax.faces.component.UIComponent)
A writable ValueExpression to store this component instance into on request.
dirfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
The value of the HTML dir attribute for this component.
disabledfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
A flag that indicates whether this field is disabled.
fileNamefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
A file name to prepopulate this form field with.
idfalsefalsejava.lang.StringThe ID of this component.
langfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
The value of the HTML lang attribute for this component.
maxMemorySizefalsefalsejavax.el.ValueExpression
(must evaluate to long)
The maximum number of bytes of RAM that may be consumed by this value. For target types that do not support spooling to disk, the size of the request parameter value will not be allowed to exceed this value. If not specified, the default value given in the context initialization parameter code>gravel.FileInput.MAX_MEMORY_SIZE. If that value is not given, the default is 512 bytes.
maxSizefalsefalsejavax.el.ValueExpression
(must evaluate to long)
The maximum number of bytes allowed for upload. If not specified, the default value given in the context initialization parameter gravel.FileInput.MAX_SIZE. If that value is not given, the default is 256KiB.
onblurfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onblur attribute. The onfocus event occurs when an element loses focus either by the pointing device or by tabbing navigation.
onchangefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onchange attribute. The onchange event occurs when a control loses the input focus and its value has been modified since gaining focus.
onclickfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onclick attribute. The onclick event occurs when the pointing device button is clicked over an element. This attribute may be used with most elements.
ondblclickfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML ondblclick attribute. The ondblclick event occurs when the pointing device button is double clicked over an element. This attribute may be used with most elements.
onfocusfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onfocus attribute. The onfocus event occurs when an element receives focus either by the pointing device or by tabbing navigation.
onkeydownfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onkeydown attribute. The onkeydown event occurs when a key is pressed down over an element. This attribute may be used with most elements.
onkeypressfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onkeypress attribute. The onkeypress event occurs when a key is pressed and released over an element. This attribute may be used with most elements.
onkeyupfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onkeyup attribute. The onkeyup event occurs when a key is released over an element. This attribute may be used with most elements.
onloadfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onload attribute. The onload event occurs when the user agent finishes loading a window or all frames within a FRAMESET. This attribute may be used with BODY and FRAMESET elements. Though nonstandard, this attribute is widely supported on other attributes as well.
onmousedownfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onmousedown attribute. The onmousedown event occurs when the pointing device button is pressed over an element. This attribute may be used with most elements.
onmousemovefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onmousemove attribute. The onmousemove event occurs when the pointing device is moved while it is over an element. This attribute may be used with most elements.
onmouseoutfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onmouseout attribute. The onmouseout event occurs when the pointing device is moved away from an element. This attribute may be used with most elements.
onmouseoverfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onmouseover attribute. The onmouseover event occurs when the pointing device is moved onto an element. This attribute may be used with most elements.
onmouseupfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onmouseup attribute. The onmouseup event occurs when the pointing device button is released over an element. This attribute may be used with most elements.
onselectfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onselect attribute. The onselect event occurs when a user selects some text in a text field.
onunloadfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
Render the HTML onunload attribute. The onunload event occurs when the user agent removes a document from a window or frame. This attribute may be used with BODY and FRAMESET elements.
readonlyfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
A flag that indicates whether this field may be changed.
renderedfalsefalsejavax.el.ValueExpression
(must evaluate to boolean)
A flag indicating whether this component should be rendered.
sizefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
This attribute tells the user agent the initial width of the control, in pixels.
stylefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
The value of the HTML style attribute for this component.
styleClassfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
The value of the HTML class attribute for this component.
tabindexfalsefalsejavax.el.ValueExpression
(must evaluate to int)
This attribute specifies the position of the current element in the tabbing order for the current document. This value must be a number between 0 and 32767.
targettruefalsejavax.el.ValueExpression
(must evaluate to java.lang.Object)
An EL expression into which the file data will be stored for processing by actions. By default this will be an InputStream, but can be changed by providing the targetType attribute.
targetCharsetfalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
The charset to use when converting bytes into characters. This attribute is only relevant for target types that require characters, specifically string, chars, and reader.
targetTypefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
The type of the target attribute. Possible values are:
  • stream - the target value will be an InputStream instance, and any temporary backing file created will be automatically cleaned up after the request is complete.
  • reader - the target value will be a Reader instance, and any temporary backing file created will be automatically cleaned up after the request is complete. You should also specify the targetCharset attribute when using this target type. If no charset is specified, then the platform's default charset is used.
  • string - the target value will be converted to a String instance. No backing file will be created; the full contents of the file will be stored in memory. You shouldalso specify the targetCharset attribute when using this target type. If no charset is specified, then the platform's default charset is used.
  • bytes - the target value will be a byte array. No backing file will be created; the full contents of the file will be stored in memory.
  • chars - the target value will be a char array. No backing file will be created; the full contents of the file will be stored in memory.
titlefalsefalsejavax.el.ValueExpression
(must evaluate to java.lang.String)
The value of the HTML title attribute for this component.

Variables
No Variables Defined.


Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.