您的位置：首页 > 编程语言 > Java开发

Struts2文件的上传、下载之二

2014-09-21 16:14 183 查看



在开发基于Web的应用的时候，经常会碰到需要实现文件上传、下载的功能，比如编辑某个商品，需要给它上传一个图片等等。

不使用Struts2的话，可以有很多种方式来实现文件上传，比如使用Apache的Common-FileUpload等。但是这些传统的方式，实现起来非常麻烦，需要写很多代码来进行控制。

现在使用Struts2来实现文件上传的功能，会更加简单和方便，事实上，Struts2的文件上传功能，默认就是基于Common-FileUpload来实现的，只不过比直接使用Common-FileUpload来得更简单。


1.2使用Struts2实现文件上传

1：fileUpload拦截器

使用Struts2来实现文件上传，需要使用Struts2预定义的fileUpload拦截器。简要的看看在struts-default.xml中的配置，示例如下：

java代码：

查看复制到剪贴板打印

<package name="struts-default" abstract="true">

…

<interceptors>

…

<interceptor name="fileUpload"

ss="org.apache.struts2.interceptor.FileUploadInterceptor"/>

…

<interceptor-stack name="defaultStack">

…

<interceptor-ref name="fileUpload"/>

…

</interceptor-stack>

</interceptors>

<default-interceptor-ref name="defaultStack"/>

</package>

上面列出了struts-default.xml中跟fileUpload拦截器有关的部分。首先，Struts2有一个预定义拦截器叫fileUpload；然后，defaultStack拦截器栈引用了fileUpload拦截器；最后，struts-default包又将defaultStack拦截器声明为自己的默认拦截器引用。

因此，如果我们的包继承了struts-default包，而我们的Action类又没有声明自己的拦截器引用的话，使用的就是defaultStack拦截器栈，从而引用了fileUpload拦截器。

2：实现上传页面

如果一个表单中，包含了文件上传的表单域，则一定要把整个表单enctype属性设置为multipart/form-data。形如：

java代码：

查看复制到剪贴板打印

<%@ page language="java" contentType="text/html; charset=gb2312"

pageEncoding="gb2312"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"

"http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=gb2312">

<title>Insert title here</title>

</head>

<body>

<form action="/helloworld/uploadAction.action" method="post"

enctype=&
20000
quot;multipart/form-data">

文件名称：<input type="text" name="fileName"><br>

文件：<input type="file" name="myFile"><br>

<input type="submit" value="提交">

</form>

</body>

</html>

在这个文件里，指定了<form>元素的enctype属性为multipart/form-data，还用了一个type为file的输入域，它会在页面上生成一个文件选择框。整个页面运行如下：



图13.1 文件上传页面

在这个页面上文件域里面，在输入框后面多了一个“浏览”按钮，点击这个浏览按钮，就会弹出文件选择框。

3：实现文件上传Action

这个Action和其他的Action没有太多特殊之处，使用一个String属性fileName来准备接收前一个页面的fileName文本框的值，然后使用一个File属性myFile来准备接收前一个页面的myFile文件框传过来的文件的值。

在execute方法中，我们可以随意存储上传的文件，本例只是把它放到了e盘的temp目录下，并以传入的fileName作为保存的文件名。

示例代码如下：

java代码：

查看复制到剪贴板打印

public class UploadAction extends ActionSupport{

private String fileName;

private File myFile;

public String getFileName() {

return fileName;

}

public void setFileName(String fileName) {

this.fileName = fileName;

}

public File getMyFile() {

return myFile;

}

public void setMyFile(File myFile) {

this.myFile = myFile;

}

public String execute()throws Exception{

//先把上传过来的文件存放到e盘temp目录下，以传入的fileName为名字

OutputStream output = null;

InputStream input = null;

try{

output = new FileOutputStream("e:/temp/"+fileName);

//建立一个1k大小的缓冲区

byte[] bs = new byte[1024];

//将上传过来的文件输出到output中

input = new FileInputStream(myFile);

int length = 0;

//length=input.read(bs)这句话中，length=-1代表了读到文件结尾

while ((length=input.read(bs))>0){

output.write(bs, 0, length);

}

}finally{

input.close();

output.close();

}

return SUCCESS;

}

}

注意：如何操作上传的文件，完全是I/O的知识，为了保持实例的简单，只是采用了最简单的方式，把内容存放在一个绝对路径表示的文件里面，当然还可以将上传的文件存储在web服务器上，甚至数据库中。

4：映射这个Action

在struts.xml中对这个Action进行配置，可以看到没有任何特异之处，只是指出了Action名称和对应的实现类，以及上传之后要跳转到的页面。

java代码：

查看复制到剪贴板打印

<package name="helloworld" extends="struts-default">

<action name="uploadAction" class="cn.javass.fileupload.UploadAction">

<result>/fileupload/success.jsp</result>

</action>

</package>

5：上传之后的页面

由于上传的文件在Action中已经被正确处理了，所以这个上传之后的页面没有任何特殊的作用，只是显示一下，表示上传成功了，示例代码如下：

java代码：

查看复制到剪贴板打印

<%@ page language="java" contentType="text/html; charset=gb2312"

pageEncoding="gb2312"%>

<%@taglib prefix="s" uri="/struts-tags" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"

"http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=gb2312">

<title>Insert title here</title>

</head>

<body>

成功上传文件<s:property value="fileName"/>

</body>

</html>

运行测试一下，在文件上传页面选择要上传的文件，然后点击提交按钮，会发现文件会上传，并以我们指定的文件名称保存到我们指定的文件夹下去了。


13.1.3获取文件的更多信息

Struts2支持用更多的属性来获取有关上传文件的真实文件名和文件类型。

比如：表单中包含了一个叫xyz的文件域，也就是类似于<input type=”file” name=”xyz”，那么可以用三个属性来获取上传文件的信息：

File类型的属性xyz用来获取文件内容。
String类型的属性xyzFileName用来获取文件的真实文件名。
String类型的属性xyzContentType属性用来获取文件的类型。

将处理上传文件的Action类修改一下，添加两个属性：myFileFileName和myFileContentType，以及他们对应的getter/setter方法，来尝试获得文件的真实文件名和文件类型。

另外，保存文件的时候，也使用文件的真实名称，示例代码如下：

java代码：

查看复制到剪贴板打印

public class UploadAction extends ActionSupport{

private String fileName;

private File myFile;

private String myFileFileName;

private String myFileContentType;

public String getMyFileFileName() {

return myFileFileName;

}

public void setMyFileFileName(String myFileFileName) {

this.myFileFileName = myFileFileName;

}

public String getMyFileContentType() {

return myFileContentType;

}

public void setMyFileContentType(String myFileContentType) {

this.myFileContentType = myFileContentType;

}

public String getFileName() {

return fileName;

}

public void setFileName(String fileName) {

this.fileName = fileName;

}

public File getMyFile() {

return myFile;

}

public void setMyFile(File myFile) {

this.myFile = myFile;

}

public String execute()throws Exception{

System.out.println("用户传入的文件名："+fileName);

System.out.println("上传文件的真实文件名："+myFileFileName);

System.out.println("上传文件的类型："+myFileContentType);

System.out.println("这个文件的文件名是什么?"+myFile.getName());

//把上传过来的文件存放到e盘temp目录下，以真实的文件名作为名字

OutputStream output = null;

InputStream input = null;

try{

output = new FileOutputStream("e:/temp/"+myFileFileName);

//建立一个1k大小的缓冲区

byte[] bs = new byte[1024];

//将上传过来的文件输出到output中

input = new FileInputStream(myFile);

int length = 0;

//length=input.read(bs)这句话中，length=-1代表了读到文件结尾

while ((length=input.read(bs))>0){

output.write(bs, 0, length);

}

}finally{

input.close();

output.close();

}

return SUCCESS;

}

}

运行测试一下，后台输出为：

java代码：

查看复制到剪贴板打印

用户传入的文件名：aaa

上传文件的真实文件名：filelist.xml

上传文件的类型：text/xml

这个文件的文件名是什么?upload__5ab75acc_12c5f17ac7a__8000_00000001.tmp

注意其中“这个文件的文件名是什么?”，代码写的是输出myFile这个File对象的名字，由于myFile对象封装了上传文件的内容，因而某些朋友就认为这个文件就是我们上传的文件，从而认为它的getName方法就是返回的上传的这个文件的名字。

这是错误的，这个myFile文件是Struts2在上传过程中生成的临时文件，它的内容与上传文件相同，但是名字并不相同，它的名字是由Struts2临时生成的，形如“upload__5ab75acc_12c5f17ac7a__8000_00000001.tmp”这样的。


13.1.4限制文件的大小及类型

在文件上传的时候，有可能需要对文件的大小和类型做出限制。Struts2支持直接在fileUpload拦截器上设置参数来进行限制。

在引用fileUpload拦截器的时候，可以指定三个参数(指定<param>子元素)：

allowedTypes：指定允许上传的文件的类型，如果存在多种类型，以逗号隔开。注意：这里添的不是文件的扩展名，而是对应的ContentType，如果不知道某种文件的ContentType可以先上传一下试试，在后台输出ContentType来。
maximumSize：指定允许上传的文件的最大字节数。
allowedExtensions：指定允许上传的文件的扩展名。

如果上传的文件不满足以上的参数指定的条件，则会跳转到一个叫input的<result>上，一般input都会指回到提交之前的页面，也就是文件上传页面。

参数非常简单，但是配置比较怪异，fileUpload拦截器虽然在defaultStack拦截器栈上已经引用了，但是还可以在defaultStack拦截器栈之前再引用一次，然后在这次引用上指定参数，示例代码如下：

java代码：

查看复制到剪贴板打印

<package name="helloworld" extends="struts-default">

<action name="uploadAction" class="cn.javass.fileupload.UploadAction">

<interceptor-ref name="fileUpload">

<param name="allowedTypes">text/plain</param>

<param name="maximumSize">1000</param>

</interceptor-ref>

<interceptor-ref name="defaultStack"/>

<result name="input">/fileupload/fileupload.jsp</result>

<result>/fileupload/success.jsp</result>

</action>

</package>

观察以上的<action>元素，要额外注意两点：

这个Action应该先引用fileUpload拦截器，然后引用defaultStack拦截器栈。
这个Action中还要有一个叫input的<result>，以备上传不成功时，Struts2跳转到提交前的页面。

还要稍微修改一下login.jsp，来显示不满足限制条件时的错误信息。只需要在合适的地方加上<s:fielderror/>来显示错误信息即可。形如：

java代码：

查看复制到剪贴板打印

<%@ page language="java" contentType="text/html; charset=gb2312"

pageEncoding="gb2312"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"

"http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=gb2312">

<title>Insert title here</title>

</head>

<body>

<%@taglib prefix="s" uri="/struts-tags" %>

<s:fielderror/>

<form action="/helloworld/uploadAction.action" method="post"

enctype="multipart/form-data">

文件名称：<input type="text" name="fileName"><br>

文件：<input type="file" name="myFile"><br>

<input type="submit" value="提交">

</form>

</body>

</html>

运行修改之后的文件上传功能，如果上传非txt文件，运行结果如下：



图13.2 fileUpload拦截器限制文件上传类型

如果上传大于1000字节的txt文件，运行结果如下：



图13.3 fileUpload拦截器限制文件上传大小


13.1.5上传超大的文件

Struts2在实现文件上传的时候，还有一个小问题，那就是默认上传文件的大小是不能超过2097152字节的。这个配置在struts2-core-2.1.8.1.jar文件里面，“\org\apache\struts2”文件夹
18ab3
下的default.properties文件里面，配置如下：

java代码：

查看复制到剪贴板打印

struts.multipart.maxSize=2097152

先来测试一下，看看是不是有这个问题。到文件上传页面，选择一个超过上述字节数的文件来上传看看，点击提交按钮，后台输出错误，示例如下：

java代码：

查看复制到剪贴板打印

org.apache.commons.fileupload.FileUploadBase$SizeLimitExceededException: the request was rejected because its size (3402567) exceeds the configured maximum (2097152)

at org.apache.commons.fileupload.FileUploadBase$FileItemIteratorImpl.<init>(FileUploadBase.java:914)

......

注意上面加粗的那句话，明确告诉我们，上传的文件大小为3402567，大于配置的最大值2097152字节。

那么该怎么办呢？

方法很简单，只要覆盖这个默认设置就可以了，有两种方式，一种是在Struts.properties里面配置，另外一种就是在struts.xml里面配置。这里就以在struts.xml来配置为例，只要在struts.xml中加入如下的常量定义，示例代码如下：

java代码：

查看复制到剪贴板打印

<constant name="struts.multipart.maxSize" value="10000000" />

设置上传文件的最大值为大约10M。再次测试运行看看，应该就可以正常上传了。


13.1.6在一个表单中上传多个文件

在实际开发中，经常会碰到需要在一个表单中上传多个文件的情况，比如为某文档添加附件，就可能要求在一个表单上添加多个附件。

对于在一个表单中上传多个文件的功能，使用Struts2也能轻松实现。只需要在提交页面上添加同名的多个文件输入域，然后在Action中对应使用File类型的数组去接收这些参数即可。

比如上面的示例，可以把上传文件页面改为：

java代码：

查看复制到剪贴板打印

<%@ page language="java" contentType="text/html; charset=gb2312"

pageEncoding="gb2312"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"

"http://www.w3.org/TR/html4/loose.dtd">

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=gb2312">

<title>Insert title here</title>

</head>

<body>

<%@taglib prefix="s" uri="/struts-tags" %>

<s:fielderror/>

<form action="/helloworld/uploadAction.action" method="post"

enctype="multipart/form-data">

文件：<input type="file" name="myFile"><br>

文件：<input type="file" name="myFile"><br>

文件：<input type="file" name="myFile"><br>

文件：<input type="file" name="myFile"><br>

<input type="submit" value="提交">

</form>

</body>

</html>

上例中，<form>表单中有多个同名的file输入域myFile。

在Action中，只要使用数组或List来操作就可以了，这里以数组为例来修改Action，示例代码如下：

java代码：

查看复制到剪贴板打印

public class UploadAction extends ActionSupport{

private File[] myFile;

private String[] myFileFileName;

public File[] getMyFile() {

return myFile;

}

public void setMyFile(File[] myFile) {

this.myFile = myFile;

}

public String[] getMyFileFileName() {

return myFileFileName;

}

public void setMyFileFileName(String[] myFileFileName) {

this.myFileFileName = myFileFileName;

}

public String execute()throws Exception{

//把上传过来的文件存放到e盘temp目录下，以真实的文件名作为名字

OutputStream output = null;

InputStream input = null;

try{

for(int i=0;i<myFileFileName.length;i++){

output = new FileOutputStream("e:/temp/"+myFileFileName[i]);

//建立一个1k大小的缓冲区

byte[] bs = new byte[1024];

//将上传过来的文件输出到output中

input = new FileInputStream(myFile[i]);

int length = 0;

//length=input.read(bs)这句话中，length=-1代表了读到文件结尾

while ((length=input.read(bs))>0){

output.write(bs, 0, length);

}

}

}finally{

input.close();

output.close();

}

return SUCCESS;

}

}

然后就可以去运行测试了，看看上面的实现是不是真的能同时上传多个文件。但是要提醒一点，如果想要上传不同类型的文件，记得把前面示例的时候，在struts.xml中所作的限制设定去掉。
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 点击这里给我发消息
标签：  upload struts2 上传 下载
相关文章推荐
新的分享
章节导航