JSF 1.2 文件上载组件

另请参见

文件上载组件 “文件上载”组件图标 提供了输入字段和浏览按钮,该按钮可以在本地系统上打开文件选择器对话框,用户可以在其中选择文件或在输入字段中键入文件名。提交页面后,文件内容的副本将被发送到 Web 应用程序。此组件可用于收集文本文件、图像文件和其他数据。已上载文件的内容是与该文件的一些相关信息存储在一起的,这些相关信息包括文件名、大小和 MIME 类型(如纯文本或 jpeg 图像)。

此组件类似于 HTML <input type="file"> 元素。

文件上载组件使用过滤器,该过滤器是在 Web 应用程序部署描述符中配置的 com.sun.webui.jsf.util.UploadFilter 对象。UploadFilter 使用 Apache Commons fileupload 包。在以下两种情况下,您可能需要更改这些设置:

上载文件的内容及其相关信息存储在 com.sun.webui.jsf.model.UploadedFile 的实例中。通过使用该对象,可以获取作为 String 的文件内容,或者将内容写入硬盘,还可以获取文件名和文件大小等属性。为了节省内存,内容和文件数据仅在上载文件的 HTTP 请求过程中可用。要访问上载文件的内容,请将 uploadedFile 属性绑定到类型为 com.sun.webui.jsf.model.UploadedFile 的 Bean 属性。请使用 setter 或 action 方法来处理文件。

UploadedFile 接口具有多种方法,用于获取文件的名称和大小、确定文件的 MIME 类型(如 text/plainimage/jpeg)、按字节或按 String 获取文件的内容以及将内容写入硬盘。或者,如果您已设置此文件上载组件的 preservePath 属性,则可以通过调用 UploadedFile Bean 属性的 getClientFilePath() 方法从该属性获取保存的路径。要了解更多信息,请在 Java 编辑器中右键单击声明语句中的 UploadedFile,然后从弹出式菜单中选择“显示 Javadoc”。

另请参见
文件上载属性窗口
绑定组件属性
使用组件
组件任务:快速参考
关于 Visual Web 组件面板

法律声明