使用JSF和MyFaces实现文件上载(2)

　　文/陶刚编译

    配置JSF和MyFaces扩展

　　目前，JSF规范的主要实现是JSF参考实现（RI），与此同时，Apache提供了另外一个实现，就是MyFaces。当然可能存在其它一些JSF实现，但是JSF RI和MyFaces是其中最流行的两个。很多开发者更喜欢前者，因为Sun把它称为"官方的"实现，但是，MyFaces拥有一些有趣的扩展（例如对上载文件操作的支持）。如果你愿意，可以把MyFaces扩展与Sun的JSF RI一起使用。你只需要把myfaces-extensions.jar文件、JSF RI的JAR文件和commons-fileupload-1.0.jar文件一起放到自己的web应用程序的WEB-INF/lib目录中就可以了。下面是需要的JAR文件：

JSF 1.1 RI jsf-api.jarjsf-impl.jar JSTL 1.1 RI jstl.jarstandard.jar MyFaces扩展 myfaces-extensions.jar Apache Commons（供JSF和MyFaces 扩展使用） commons-collections.jarcommons-digester.jarcommons-beanutils.jarcommons-logging.jarcommons-fileupload-1.0.jar

　　org.apache.myfaces.component.html.util程序包中的MultipartRequestWrapper类充当MyFaces和通用文件上载之间的桥梁。这个类扩展了HttpServletRequestWrapper，重载了getParameterMap()、getParameterNames()、getParameter()和getParameterValues()方法，这样它们才能适应multipart/form-data编码方式。此外，MultipartRequestWrapper提供了两个新的方法，分别是getFileItem()和getFileItems()，它允许你通过org.apache.commons.fileupload.FileItem接口来访问被上载的文件。

　　当MyFaces检测到编码方式的时候，org.apache.myfaces.component.html.util程序包中的ExtensionsFilter就建立MultipartRequestWrapper实例。因此，你不需要关心窗体数据的分解，但是如果你希望改变被上载文件的处理方式，那么了解它是如何实现的就很有用处了。在典型的应用程序中，你必须在自己的web应用程序的web.xml描述信息中配置ExtensionsFilter，这样它才能在JSF的FacesServlet前面截取HTTP请求：

＜?xml version="1.0" encoding="UTF-8"?＞ ＜!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"＞ ＜web-app＞ ＜context-param＞ ＜param-name＞javax.faces.STATE_SAVING_METHOD＜/param-name＞ ＜param-value＞client＜/param-value＞ ＜/context-param＞ ＜servlet＞ ＜servlet-name＞FacesServlet＜/servlet-name＞ ＜servlet-class＞ javax.faces.webapp.FacesServlet ＜/servlet-class＞ ＜load-on-startup＞1＜/load-on-startup＞ ＜/servlet＞ ＜servlet-mapping＞ ＜servlet-name＞FacesServlet＜/servlet-name＞ ＜url-pattern＞/faces/*＜/url-pattern＞ ＜/servlet-mapping＞ ＜servlet-mapping＞ ＜servlet-name＞FacesServlet＜/servlet-name＞ ＜url-pattern＞*.faces＜/url-pattern＞ ＜/servlet-mapping＞ ＜filter＞ ＜filter-name＞ExtensionsFilter＜/filter-name＞ ＜filter-class＞ org.apache.myfaces.component.html.util.ExtensionsFilter ＜/filter-class＞ ＜init-param＞ ＜param-name＞uploadMaxFileSize＜/param-name＞ ＜param-value＞10m＜/param-value＞ ＜/init-param＞ ＜init-param＞ ＜param-name＞uploadThresholdSize＜/param-name＞ ＜param-value＞100k＜/param-value＞ ＜/init-param＞ ＜/filter＞ ＜filter-mapping＞ ＜filter-name＞ExtensionsFilter＜/filter-name＞ ＜servlet-name＞FacesServlet＜/servlet-name＞ ＜/filter-mapping＞ ＜welcome-file-list＞ ＜welcome-file＞index.jsp＜/welcome-file＞ ＜/welcome-file-list＞ ＜/web-app＞

　　前面示例中的两个过滤器（filter）参数告诉MyFaces把小于100K的文件放入内存中，并且忽略（即不处理）占用10MB以上磁盘空间的文件。大小介于uploadThresholdSize和uploadMaxFileSize之间的文件将作为临时文件存储在磁盘上。如果你试图载入一个太大的文件，MyFaces当前版本将忽略所有的窗体数据，就像用户提交了一个空表单一样。如果你希望给上载文件失败的用户一些提示信息，就需要更改MyFaces的MultipartRequestWrapper类，找到捕捉SizeLimitExceededException异常的位置，并使用FacesContext.getCurrentInstance().addMessage()来警告用户。

　　前面提到，MyFaces扩展包含了文件上载组件，我们可以在JSF页面中使用它。下一部分将介绍如何实现这样的操作。 使用MyFaces的文件上载组件。

　　为了在web页面中使用JSF和MyFaces，你必须在＜%@taglib%＞指令中声明它们的标记库：

＜%@ taglib uri="http://java.sun.com/jsf/core" prefix="f"%＞ ＜%@ taglib uri="http://java.sun.com/jsf/html" prefix="h"%＞ ＜%@ taglib uri="http://myfaces.apache.org/extensions" prefix="x"%＞

　　JSF的＜h:form＞标记没有method属性，这是因为它只支持POST方法，但它拥有enctype属性，如果你希望上载文件，就必须使用该属性，把窗体数据设置为多部分（multipart）编码类型：

＜f:view＞ ＜h:form id="MyForm" enctype="multipart/form-data" ＞ ... ＜x:inputFileUpload id="myFileId" value="#{myBean.myFile}" storage="file" required="true"/＞ ... ＜/h:form＞ ＜/f:view＞

　　MyFaces的＜x:inputFileUpload＞标记使你能够定义UI组件的属性，它的呈现部件（renderer）生成＜input type="file"＞元素。org.apache.myfaces.custom.fileupload程序包包含了UI组件类（HtmlInputFileUpload）、呈现部件（HtmlFileUploadRenderer）、定制的标记处理程序（HtmlInputFileUploadTag）、UploadedFile接口和其它一些辅助类。HtmlInputFileUpload类扩展了JSF标准的HtmlInputText组件，重载了它的一些方法。HtmlFileUploadRenderer负责生成HTML标记，从MultipartRequestWrapper中获取FileItem。

　　MyFaces并没有让你直接访问通用文件上载所建立的FileItem实例，它提供了自己的UploadedFile接口来获取被上载的文件的内容、内容类型、文件名和文件大小。JSF窗体的后台bean必须拥有一个UploadedFile类型的属性。前面的例子用JSF表达式（#{myBean.myFile}）把UI组件的值绑定到了这样一个bean上。JSF框架组件将获取HtmlInputFileUpload组件的值，它是一个UploadedFile实例，并且会设置后台bean的myFile属性：

import org.apache.myfaces.custom.fileupload.UploadedFile; ... public class MyBean { private UploadedFile myFile; public UploadedFile getMyFile() { return myFile; } public void setMyFile(UploadedFile myFile) { this.myFile = myFile; } ... }

　　MyFaces拥有UploadedFile接口的两种实现方式：UploadedFileDefaultMemoryImpl和UploadedFileDefaultFileImpl。当＜x:inputFileUpload＞标记没有带storage属性，或者这个属性的值是memory的时候，就使用前者。当storage属性的值是file的时候使用后者。

　　UploadedFileDefaultMemoryImpl类从FileItem实例中获取被上载文件的内容、文件名、文件大小和内容类型，并把所有这些信息存储在私有字段中。因此，即使通用文件上载把这个文件保存在磁盘上，UploadedFile的这种实现也会把被上载文件的内容保存在内存中，浪费了资源。

　　UploadedFileDefaultFileImpl类使用一个过渡字段来保存FileItem实例的指针，仅仅在调用getInputStream()方法的时候，才使用它来获取被上载文件的内容。这种实现

[上一页]　[1]　[2]　[3]　[下一页]