日期:2014-05-16 浏览次数:20367 次
作者:Andrei Cioroianu
翻译:RR00
?
版权声明:可以任意转载,转载时请务必以超链接形式标明文章原始出处和作者信息及本声明
英文原文地址:
http://www.onjava.com/pub/a/onjava/2005/07/13/jsfupload.html
中文地址:
http://www.matrix.org.cn/resource/article/43/43703_JSF_MyFaces_Upload.html
用户可以很方便使用浏览器上传文件,但是当前的Java Web标准(如servlets, JSP, and JSF)并没有提供任何上传的功能。幸好第三方框架,比如 Apache Commons File Upload, Apache MyFaces, and Oracle ADF Faces,提供了简单的API和客户标签,实现了这个功能。文章的前半部分将介绍上传组件是如何工作的,你将看到MyFaces and Commons File Upload 的部分源码(实际上,前者采用的是后者的代码)。了解这些源码的内在机制将使我们更有效的使用这些框架,并且可以根据需要修改他们!在文章的后半部分,介绍了一个让用户通过浏览器上传文件的例子。
?
基于WEB的文件上传
“上传”这个词的使用比较广泛。一个web管理员在他的主页发布了一个文件,他可以说他上传了一个文件;当一个网络工程师创建了一个HTML form和一些脚本使普通用户可以通过浏览器上传文件,他说他实现了上传的功能。
这两种方式之中有些共同的地方,因为一个web管理员可以通过一个基于web的接口来发布文件(页面,图像,脚本等等)。那些免费提供个人主页的公司,比如yahoo,实现了基于web的文件上传功能,因为客户需要上传页面。这样任何人只要接入网络,就可以通过浏览器发布他的个人站点。但是,还有许多更好的方式让你发布你的网页内容,比如FTP或secure FTP。在这种情况下,你就需要一个对应的应用程序,比如FTP客户端,而不是浏览器来发布你的网站。
这篇文章将从网络开发者的角度来讨论文件上传。一个基于web的mail应用程序,比如yahoo mail,实现了上传功能,这样用户才能发送信息和附件。另一个好的例子是一个job网站必须让你能够发送简历给招聘人员。在你的应用程序中,你可以对上传的文件作任何你想做的事情,比如把这些文件的内容储存到数据库中或者把他们当作附件发送出去。这篇文章的例子计算了上传文件的hash值。现在,让我们看看如何在一个web应用程序中实现上传功能。
一个html表单包含一个或多个 元素,这个元素将在页面上生成文件输入框,用户可以在这里填写文件路径。用户点击输入字段后面的浏览(browse)按钮后,会弹出一个对话框让用户选择路径:
?
当用户点击表单的Sumbit按钮,浏览器对表单数据进行编码,其中包括文件的内容,名字,路径以及其他的表单参数。然后,浏览器把编码过的数据传递给web服务器,服务器再把这些数据传递给相应的页面,比如<form>标签里的action属性值。如果是java网络应用程序,action属性值可能是个servlet或者是个jsp页面。
因为默认的表单编码和get方法不适合上传文件,所以一个包含文件输入框的表单必须定义编码为multipart/form-data ,并且在<form>标签里使用POST方法:
?
?
?但是,事情并不象看起来那么简单,实现了servlet and JSP 标准的应用服务器并没有被要求处理 multipart/form-data编码。所以你需要一个解析器来处理请求的输入流,比如Apache Commons File Upload组件,它是个java包,能从已编码的数据中读取出上传文件的内容。这个包的API很灵活,允许你把小文件存在内存里而大文件储存在磁盘上一个临时文件夹里。你不但可以定义大文件和小文件的界限,还可以定义上传文件所占空间的最大值。
org.apache.commons.fileupload里有个DiskFileUpload类,它的parseRequest()函数获得一个HttpServletRequest,返回一个List,其中包含了org.apache.commons.fileupload.FileItem的实例。servlet请求的getInputStream()函数返回一个数据流,已编译的表单数据就是从这里读取出来的。FileItem很容易让人误解,因为这个接口的实例不仅包括上传文件,还有其他的请求参数。
Commons File Upload 包提供的API可以解析数据,但是servlet请求的getParameter()函数和getParameterValues()函数却不能工作。因为这两个函数被运行在常用的输入框, 复选框, 单选按钮, 和下拉列表后面的标准JSF组件调用,所以这个问题需要解决。Servlets API提供的两个功能(filters和request wrappers) 可以解决这个问题。下面的章节描述了在没有破坏原有JSF结构的情况下,Apache MyFaces 如何实现了一个filter功能,从而添加了更多需要的支持。另外,MyFaces提供的API可以创建javaBean,和生成<input type="file">元素的JSF组件相对应。
配置 JSF 和MyFaces Extensions
目前最主要的实现JSF规范的框架有JSF Reference Implementation (RI)以及Apache提供的MyFaces。虽然还有别的,但这两个是最流行的。很多开发者更倾向于JSF RI,因为这是来自于sun的官方产品。但MyFaces有一些有趣的扩展的功能,比如上传文件。如果你喜欢,你可以同时使用MyFaces的扩展功能和JSF RI。你只需要把myfaces-extensions.jar和JSF RI的jar文件以及 commons-fileupload-1.0.jar 放在web应用程序的WEB-INF/lib 目录下即可。下面是你需要的jar文件:
?
?
JSF 1.1 RI | jsf-api.jar jsf-impl.jar |
JSTL 1.1 RI | jstl.jar standard.jar |
M
免责声明: 本文仅代表作者个人观点,与爱易网无关。其原创性以及文中陈述文字和内容未经本站证实,对本文以及其中全部或者部分内容、文字的真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
|