文件上传与下载
Posted shi_zi_183
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了文件上传与下载相关的知识，希望对你有一定的参考价值。
文件上传与下载
如何实现文件上传
在Web应用中，由于大多数文件的上传都是通过表单的形式提交给服务器的，因此，要想在程序中实现文件上传的功能，首先要创建一个用于提交上传文件的表单页面。需要注意的是，为了使Servlet程序可以获取到上传文件的数据，需要将表单页面的method属性设置为post方式，enctype属性设置为multipart/form-data类型，添加文件的input标签类型设置为file类型。
当浏览器通过表单提交上传文件时，由于文件数据都附带在HTTP请求消息体中，并且采用MIME类型进行描述，因此，浏览器发送给服务器的HTTP消息比较特殊
请求正文分为多个部分，解析这部分内容比较麻烦。为此，Apache组织提供了一个开源组件Commons-FileUpload，该组件可以方便地将multipart/form-data类型请求中地各种表单域解析处理，并实现一个或多个文件地上传，同时也可以限制上传文件地大小等内容，并且性能优异，使用极其简单。需要注意地是，在使用FileUpload组件时，需要导入commons-fileupload和commons-io两个包。
Fileltem接口
Fileltem接口用于封装单个表单字段元素地数据，一个表单字段元素对应一个FileItem对象，FileItem地实现类简称为FileItem类，FileItem类实现了Serializable接口，因此支持序列化操作。在FileItem类中定义了许多获取表单字段元素地方法。
1、boolean isFormField()方法
方法用于判断FileItem类对象封装地数据是一个普通文本表单字段，还是一个文件表单字段，如果是普通表单字段则返回true，否则返回false。
2、String getName()方法
方法用于获得文件上传字段中地文件名。如果FileItem类对象对应地是普通表单字段，方法将返回null，否则，只有浏览器将文件的字段信息传递给服务器，getName()方法就会返回一个字符串类型的结果，如"C:\\Sunset.jpg"
需要注意的是，通过不同浏览器上传的文件，获取到的完整路径和名称都是不一样的。例如，用户使用ie浏览器上传文件，获取到的就是完整路径，如果使用其他浏览器获取到的仅仅是文件名，没有路径。
3、String getFieldName()方法
方法用于获得表单字段元素描述头的name属性。
4、void write(File file)方法
方法用于将FileItem对象中保存的主体内容保存到某个指定的文件中。如果FileItem对象中的主题内容是保存在某个临时文件中，那么该方法顺利完成后，临时文件有可能会被清除。另外，该方法也可将普通表单字段内容写入到一个文件中，但它主要用于将上传的文件内容保存到本地系统中。
5、String getString()方法
方法用于将FileItem对象中保存的数据流内容以一个字符串返回，它有两个重载的定义形式
1）public getString()
2）public getString(java.lang.String encoding)
前者使用默认的字符集编码将主体内容转换成字符串，后者使用参数指定的字符集编码将主体内容转换成字符串。
6、String getContextType()方法
方法用于获得上传文件的类型，即表单字段元素描述头属性"Content-Type"的值，如"image/jpeg"。如果FileItem类对象对应的普通表单字段，该方法将返回null
7、boolean isInMemory()方法
方法用来判断FileItem对象封装的数据内容是存储在内存中，还是存储在临时文件中，如果存储在内存中则返回true，否则返回false。
8、void delete()方法
方法用于清空FileItem类对象中存放的主体内容，如果主体内容被保存在临时文件中，delete()方法将清除该临时文件。需要注意的是，尽管FileItem对象被垃圾收集器收集时会自动清除临时文件，但应该及时调用delete()方法来清除临时文件，避免系统出现故障而导致临时文件被永久保存到磁盘中。
9、InputStream getInputStream()方法
方法以流的形式返回上传文件的数据内容。
10、long getSize()方法
方法返回该上传文件的大小（字节）
DiskFileItemFactory类
DiskFileItemFactory类用于将请求消息实体中的每个文件封装成单独的FileItem对象。如果上传的文件比较小，将直接保存在内存中，如果文件比较大，则会以临时文件的形式，保存在磁盘的临时文件夹中，默认情况下，临界值为10240即10kb
| 构造方法 | 功能描述 |
|---|---|
| DiskFileItemFactory() | 采用默认临界值和系统临时文件夹构造文件项工厂对象 |
| DiskFileItemFactory(int sizeThreshold,File repositury) | 采用参数指定临界值和系统临时文件夹构造文件项工厂对象。 |
常用方法
1、FileItem createItem(String fildName,String contentType,boolean isFormField,String fileName)方法
该方法用于将请求实体创建成FileItem类型的实例对象，该方法时FileUpload组件在解析请求时内部自动调用，无需管理。
2、setSizeThreshold(int sizeThreshold)和getSizeThreshold()方法
setSizeThreshold(int sizeThreshold)用于设置以临时文件保存在磁盘的临界值，getSizeThreshold()用于获取临界值。
3、setRepository(File repository)和getRepository()方法
如果上传文件的大小大于setSizeThreshold()方法设置的临界值，这时，可以采用setRepository()方法，将上传的文件以临时文件的形式保存在指定的目录下。在默认情况下，采用的是系统默认的临时文件路径，可以通过以下方式获得
System.getProperty("java.io.tmpdir")
getRepository()用于获取临时文件
ServletFileUpload类
ServletFileUpload类是Apache组件处理文件上传的核心高级类，通过使用parseRequest(HttpServletRequest)方法可以将html中每个表单提交的数据封装成一个FileItem对象，然后以List列表的形式返回。
构造方法
| 方法声明 | 功能描述 |
|---|---|
| ServletFileUpload() | 构造一个未初始化的ServletFileUpload实例对象 |
| ServletFileUpload(FileItemFactory fileItemFactory) | 根据参数指定的FileItemFactory 对象创建一个ServletFileUpload对象。 |
常用方法
1、setSizeMax(long sizeMax)和getSizeMax()方法
setSizeMax()方法继承自FileUploadBase类，用于设置请求消息实体内容（即所有上传数据）的最大尺寸限制，以防止客户端恶意上传超大文件来浪费服务器端的存储空间。其中sizeMax以字节为单位。
2、setFileSizeMax(long sizeMax)和getFileSizeMax()方法
setFileSizeMax()方法继承自FileUploadBase类，用于设置单个上传文件的最大尺寸限制，以防止客户端恶意上传超大文件来浪费服务器的存储空间。getFileSizeMax()方法用于获取单个上传文件所允许的最大值。
3、parseRequest(javax.servlet.http.HttpServletRequest req)方法
parseRequest()方法是ServletFileUpload类的重要方法，它是对HTTP请求消息体内容进行解析的入口。它解析出FORM表单的每个字段的数据，并将他们分别包装成独立的FileItem对象，然后将这些FileItem对象加入进一个List类型的集合对象中返回。
4、getItemIterator(HttpServletRequest request)
getItemIterator()方法和parseRequest()方法基本相同。但是getItemIterator()方法返回的是一个迭代器，该迭代器中保存的不是FileItem对象，而是FileItemStream对象，如果希望进一步提供性能，可以采用该方法，直接获得每个文件项的数据传输流，做底层处理，如果性能不是问题，希望代码简单，则采用parseRequest()方法。
5、isMultipartContent(HttpServletRequest req)
isMultipartContent()方法用于判断请求消息中的内容是否是multipart/form-data类型，如果是，则返回true，否则返回false。该方法是一个静态方法。
6、getFileItemFactory()和setFileItemFactory(FileItemFactory factory)
这两个方法继承自FileUpload类，分别用于读取和设置fileItemFactory属性。
7、setHeaderEncoding(String encoding)方法和getHeaderEncoding()方法
这两个方法继承自FileUploadBase类，用于设置和读取字符编码。如果没有使用setHeaderEncoding()设置字符编码，则getHeaderEncoding()方法返回null，上传组件会采用HttpServletRequest设置的字符编码。但是，如果HttpServletRequest的字符集编码也为null，这时，上传组件将采用系统默认的字符编码。
获取系统默认字符编码的方式
System.getProperty("file.encoding")
案例_文件上传
1）创建upload包
2）导入Apache组件的jar包，commons-fileupload和commons-io。
3）form.html
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>Insert title here</title>
</head>
<body>
<form action="UploadServlet" method="post" enctype="multipart/form-data">
<table width="600px">
<tr>
<td>上传者</td>
<td><input type="text" name="name"/></td>
</tr>
<tr>
<td>上传文件</td>
<td><input type="file" name="myfile"/></td>
</tr>
<tr>
<td colspan="2">
<input type="submit" value="上传"/>
</td>
</tr>
</table>
</form>
</body>
</html>
4）编写UploadServlet类
package upload;
import java.io.*;
import java.util.*;
import javax.servlet.*;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.commons.fileupload.*;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
@WebServlet("/UploadServlet")
public class UploadServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType("text/html;charset=utf-8");
try{
DiskFileItemFactory factory=new DiskFileItemFactory();
File f=new File("D:\\\\Target");
if(!f.exists()){
f.mkdirs();
}
factory.setRepository(f);
ServletFileUpload fileupload=new ServletFileUpload(factory);
fileupload.setHeaderEncoding("gbk");
List<FileItem>fileitems=fileupload.parseRequest(request);
PrintWriter writer=response.getWriter();
for(FileItem fileitem:fileitems){
if(fileitem.isFormField()){
String name=fileitem.getFieldName();
String value=fileitem.getString("gbk");
writer.print("上传者:"+value+"<br>");
}else{
String filename=fileitem.getName();
writer.print("文件来源:"+filename+"<br>");
filename=filename.substring(filename.lastIndexOf("\\\\")+1);
writer.print("成功上传的文件:"+filename+"<br>");
filename=UUID.randomUUID().toString()+"_"+filename;
String webPath="/upload/";
String filepath=getServletContext().getRealPath(webPath+filename);
File file=new File(filepath);
file.getParentFile().mkdirs();
file.createNewFile();
InputStream in=fileitem.getInputStream();
OutputStream out=new FileOutputStream(file);
byte[]buffer=new byte[1024];
int len;
while((len=in.read(buffer))>0)
out.write(buffer,0,len);
in.close();
out.close();
fileitem.delete();
}
}
}catch(Exception e){
throw new RuntimeException(e);
}
}
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// TODO Auto-generated method stub
doGet(request, response);
}
}
文件下载
文件下载原理
实现文件下载功能比较简单，通常情况下，不使用第三方组件实现，而是直接使用Servlet类和输入/输出流实现即可。
可以，与访问服务器文件不同的是，要实现文件的下载，不仅需要指定文件的路径，还需要在HTTP中设置两个相应消息头
//设定接收程序处理数据的方式
Content-Disposition:attachment;filename=
//设定实体内容的MIME类型
Content-Type:application/x-msdownload
浏览器通常会直接处理响应的实体内容。这时需要在HTTP响应消息中设置两个响应消息头字段，指定接收程序处理数据内容的方式为下载方式，当单击“下载”超链接时，系统将请求提交到对应的Servlet。在该Servlet中，首先获取下载文件的地址，并根据该地址创建文件字节输入流，再通过该流读取下载文件内容，最后将读取的内容通过输出流写到目标文件中。
1）download.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!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=UTF-8">
<title>Insert title here</title>
</head>
<body>
<a href="DownloadServlet">
文件下载
</a>
</body>
</html>
2）DownloadServlet.java
package upload;
import java.io.*;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("/DownloadServlet")
public class DownloadServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType("text/html;charset=utf-8");
response.addHeader("Content-Disposition", "attachment;filename=1.png");
response.addHeader("Content-Type", "application/x-msdownload");
//FileInputStream in=new FileInputStream(new File("D:\\\\无标题.png"));
InputStream in=getServletContext().getResourceAsStream("/download/无标题.png");
OutputStream out=response.getOutputStream();
byte[] buffer=new byte[1024];
int len;
while((len=in.read(buffer))!=-1){
out.write(buffer, 0, len);
}
in.close();
out.close();
}
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// TODO Auto-generated method stub
doGet(request, response);
}
}
需要注意的是，在tomcat下的webapps文件夹下的对应的web应用目录会被tomcat清理垃圾，在web应用目录重新部署时，tomcat会将非自带目录删除（非META-INF和WEB-INF目录），所以如果将下载文件放入web应用目录下重新部署tomcat会将文件夹删除，所以这里需要先重新部署使代码生效，再将文件放入目录。
或者将文件放在web应用外，通过文件输入流读取。
将文件名修改为中文
package upload;
import java.io.*;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("/DownloadServlet")
public class DownloadServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType("text/html;charset=utf-8");
String path="D:\\\\无标题.png";
File file=new File(path);
FileInputStream in=new FileInputStream(file);
//InputStream in=getServletContext().getResourceAsStream("/download/无标题.png");
OutputStream out=response.getOutputStream();
response.addHeader("Content-Disposition", "attachment;filename="+file.getName());
response.addHeader("Content-Type", "application/x-msdownload");
byte[] buffer=new byte[1024];
int len;
while((len=in.read(buffer))!=-1){
out.write(buffer, 0, len);
}
in.close();
out.close();
}
protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// TODO Auto-generated method stub
doGet(request, response);
}
}
中文没有显示的原因是，文件名是在HTTP协议中头字段content-disposition声明的，所以之前处理消息体乱码的setContentType()方法是无法解决的，为了解决问题我们需要将字符串以指定的编码形式输出，通常这种编码方式称为URL编码。这样HTTP才能传输中文（因为中文通过编码变成了通用字符）。
同样GET方式发送中文也需要通过这种方式进行编码，解码。
package upload;
import java.io.*;
import java.net.URLEncoder;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("/DownloadServlet")
public class DownloadServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
response.setContentType("text/html;charset=utf-8");
String path="D:\\\\无标题.png";
File file=new File以上是关于文件上传与下载的主要内容，如果未能解决你的问题，请参考以下文章