1000字范文 > Servlet 实现上传附件（支持多附件）

Servlet 实现上传附件（支持多附件）

时间：2018-07-15 08:13:21

一、简单介绍

使用 Servlet上传附件原理上还是蛮简单的，首先获取上传的附件对象，然后做一些简单处理后写入到指定路径的磁盘中。

二、准备条件

common-io.jar，下载地址：/io/download_io.cgi

common-upload.jar ，下载地址：/commons/fileupload/

三、实现流程

首先在新建好的项目中加入上述的两个必须jar包，然后根据需求创建好upload.jsp页面选择附件，代码如下：

<%@page import="java.io.File"%><%@ page language="java" contentType="text/html; charset=UTF-8"pageEncoding="UTF-8"%><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "/TR/html4/loose.dtd"><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Use servlet upload file</title></head><body><form name="uploadForm" method="post" action="servlet/uploadFileServlet" enctype="multipart/form-data">附件名称：<input type="text" name="uploadName" value=""/><br/>选择附件：<input type="file" name="uploadFile"/><br/><input type="submit" value="上传"/></form></body></html>

其中，enctype="multipart/form-data" 是必须加入的，因为原先没有加入的普通表单是以字符提交到后台的，但是加了之后所有参数全部会以二进制流格式传入后台，所以后台处理代码 request.getParameter("paramName") 将返回空字符串。

基本显示如下图：

页面定义好了，接下来创建上面提交的servlet ，代码如下：

package com.chenghui.servlet;import java.io.File;import java.io.IOException;import java.io.PrintWriter;import java.util.Iterator;import java.util.List;import javax.servlet.ServletConfig;import javax.servlet.ServletException;import javax.servlet.http.HttpServlet;import javax.servlet.http.HttpServletRequest;import javax.servlet.http.HttpServletResponse;import mons.fileupload.FileItem;import mons.fileupload.FileUploadException;import mons.fileupload.disk.DiskFileItemFactory;import mons.fileupload.servlet.ServletFileUpload;/*** Servlet implementation class UploadFileServlet*/public class UploadFileServlet extends HttpServlet {private static final long serialVersionUID = 1L;private static final String UPLOAD_PATH = "d:\\attach\\";/*** @see HttpServlet#HttpServlet()*/public UploadFileServlet() {super();// TODO Auto-generated constructor stub}/*** @see Servlet#init(ServletConfig)*/public void init(ServletConfig config) throws ServletException {// TODO Auto-generated method stub}/*** @see Servlet#destroy()*/public void destroy() {// TODO Auto-generated method stub}/**** 偶然发现一个现象，当我定义的servlet 中重写了 service方法，那么每次调用的是service方法，除非注释掉该方法才会根据请求挑战到对象的doPost/doGet中* @see HttpServlet#service(HttpServletRequest request, HttpServletResponse response)*//*protected void service(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {System.out.println("service");}*//*** @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)*/protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {//创建一个磁盘文件的工厂，然后将它传递到servletFileUplaod的实例中DiskFileItemFactory diskFileItemFactory = new DiskFileItemFactory();ServletFileUpload servletFileUpload = new ServletFileUpload(diskFileItemFactory);try {//根据request对象获取所有的文件集合，这里包括input标签输入的值也属于FileInputList<FileItem> fileItemList = servletFileUpload.parseRequest(request);Iterator iterator = fileItemList.iterator();String showFileName = "";while(iterator.hasNext()){FileItem fileItem = (FileItem)iterator.next();if(fileItem.isFormField()){ //是否是表单提交域，可以分区是否上传的附件String name = fileItem.getFieldName();//input标签的nameString value = fileItem.getString();//input表单的valueif("uploadName".equals(name)){showFileName = value;}}else{String fieldName = fileItem.getFieldName();//表单提交过来的file input标签中name的属性值String fileName = fileItem.getName();//file input上传的文件名String contentType = fileItem.getContentType();//获得上传文件的类型long size = fileItem.getSize();//上传文件的大小String filePath = UPLOAD_PATH + showFileName + fileName.substring(fileName.lastIndexOf("."));File saveFile = new File(filePath);fileItem.write(saveFile); //将文件写入磁盘中//成功之后简单输出一下PrintWriter out = response.getWriter();out.print("上传成功！上传文件为:"+fileName+"<br/>保存的地址为"+filePath+ "！！");out.close();}}} catch (FileUploadException e) {e.printStackTrace();} catch (Exception e) {e.printStackTrace();}}/*** @see HttpServlet#doPost(HttpServletRequest request, HttpServletResponse response)*/protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {doGet(request, response);}}在web.xml中对应的配置：

<servlet><servlet-name>uploadFileServlet</servlet-name><servlet-class>com.chenghui.servlet.UploadFileServlet</servlet-class></servlet><servlet-mapping><servlet-name>uploadFileServlet</servlet-name><url-pattern>/servlet/uploadFileServlet</url-pattern></servlet-mapping>

好了基本上可以走一下流程了，在upload.jsp页面选择附件后点击“上传”按钮，效果显示如下

然后去d:attach 目录下找上传的附件，找到了，ok上传成功！但是显示的文字有乱码，这是因为response对象在输出的时候没有指定具体的编码，所以按照默认的iso-8859-1输出就乱码了。

解决方案：在 PrintWriter out = response.getWriter(); 的上面加上

response.setContentType("text/html;charset=UTF-8");

就好了。

另外，将上传的附件是使用mons.fileupload.FileItem 提供write方法写入磁盘中的，这也可以用字节流完成该操作。

/*** @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)*/protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { //创建一个磁盘文件的工厂，然后将它传递到servletFileUplaod的实例中DiskFileItemFactory diskFileItemFactory = new DiskFileItemFactory();ServletFileUpload servletFileUpload = new ServletFileUpload(diskFileItemFactory);try {//根据request对象获取所有的文件集合，这里包括input标签输入的值也属于FileInputList<FileItem> fileItemList = servletFileUpload.parseRequest(request);Iterator iterator = fileItemList.iterator();String showFileName = "";//如果附件地址不存在就创建一下File uploadPath = new File(UPLOAD_PATH);if(!uploadPath.exists()){uploadPath.mkdir();}while(iterator.hasNext()){FileItem fileItem = (FileItem)iterator.next();if(fileItem.isFormField()){ //是否是表单提交域，可以分区是否上传的附件String name = fileItem.getFieldName(); //input标签的nameString value = fileItem.getString(); //input表单的valueif("uploadName".equals(name)){showFileName = value;}}else{String fieldName = fileItem.getFieldName(); //表单提交过来的file input标签中name的属性值String fileName = fileItem.getName(); //file input上传的文件名String contentType = fileItem.getContentType(); //获得上传文件的类型long size = fileItem.getSize(); //上传文件的笑答String filePath = UPLOAD_PATH + showFileName + fileName.substring(fileName.lastIndexOf("."));//mons.fileupload.FileItem 提供write方法写入磁盘中//fileItem.write(new File(filePath));//使用字节流读取二进制格式的附件传给文件流然后写入磁盘OutputStream outputStream = new FileOutputStream(new File(UPLOAD_PATH,showFileName + fileName.substring(fileName.lastIndexOf("."))));//这里传递父亲的文件夹路径和当前文件的名称InputStream inputStream = fileItem.getInputStream();int length = 0;byte[] buf = new byte[1024];while((length = inputStream.read(buf)) != -1){ //首先根据传递的字节数组将读取的字节的数量返回，在判断是否读取的空System.out.println(buf);outputStream.write(buf, 0, length);}inputStream.close();outputStream.close();//成功之后简单输出一下response.setContentType("text/html;charset=UTF-8");PrintWriter out = response.getWriter();out.print("上传成功！上传文件为:"+fileName+"<br/>保存的地址为"+filePath+ "！！");out.close();}}} catch (FileUploadException e) {e.printStackTrace();} catch (Exception e) {e.printStackTrace();}}

上传的效果是一样的。输出每次读取的byte数组，效果如下：

基本上，使用servlet 上传附件的功能就已经完成了。

四、多附件上传

如果有需求需要上传多个附件，那么现在这个demo同样有效果，只需要稍作修改就好了。

upload.jsp需要增加一个选择附件的控件，代码如下：

<%@page import="java.io.File"%><%@ page language="java" contentType="text/html; charset=UTF-8"pageEncoding="UTF-8"%><!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "/TR/html4/loose.dtd"><html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>Use servlet upload file</title></head><body><form name="uploadForm" method="post" action="servlet/uploadFileServlet" enctype="multipart/form-data">附件名称：<input type="text" name="uploadName" value=""/><br/>选择附件：<input type="file" name="uploadFile"/><br/>附件名称：<input type="text" name="uploadName1" value=""/><br/>选择附件：<input type="file" name="uploadFile2"/><br/><input type="submit" value="上传"/></form></body></html>

servlet.java 逻辑其实不用改，因为我们是迭代所有FileItem对象的集合，所以所有的附件和附件信息全都保存在这个集合中，简单提炼了下代码，具体如下：

/*** @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)*/protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.setContentType("text/html;charset=UTF-8");PrintWriter out = response.getWriter();//创建一个磁盘文件的工厂，然后将它传递到servletFileUplaod的实例中DiskFileItemFactory diskFileItemFactory = new DiskFileItemFactory();ServletFileUpload servletFileUpload = new ServletFileUpload(diskFileItemFactory);try {//根据request对象获取所有的文件集合，这里包括input标签输入的值也属于FileInputList<FileItem> fileItemList = servletFileUpload.parseRequest(request);Iterator iterator = fileItemList.iterator();String showFileName = "";String showFileName1 = "";//如果附件地址不存在就创建一下File uploadPath = new File(UPLOAD_PATH);if(!uploadPath.exists()){uploadPath.mkdir();}while(iterator.hasNext()){FileItem fileItem = (FileItem)iterator.next();if(fileItem.isFormField()){ //是否是表单提交域，可以分区是否上传的附件String name = fileItem.getFieldName(); //input标签的nameString value = fileItem.getString(); //input表单的valueshowFileName = value; //这里注意好出场顺序，不然就乱套了}else{String fieldName = fileItem.getFieldName(); //表单提交过来的file input标签中name的属性值String fileName = fileItem.getName(); //file input上传的文件名String contentType = fileItem.getContentType(); //获得上传文件的类型long size = fileItem.getSize(); //上传文件的笑答String filePath = UPLOAD_PATH + showFileName + fileName.substring(fileName.lastIndexOf("."));//mons.fileupload.FileItem 提供write方法写入磁盘中//fileItem.write(new File(filePath));//使用字节流读取二进制格式的附件传给文件流然后写入磁盘OutputStream outputStream = new FileOutputStream(new File(UPLOAD_PATH,showFileName + fileName.substring(fileName.lastIndexOf("."))));//这里传递父亲的文件夹路径和当前文件的名称InputStream inputStream = fileItem.getInputStream();int length = 0;byte[] buf = new byte[1024];while((length = inputStream.read(buf)) != -1){ //首先根据传递的字节数组将读取的字节的数量返回，在判断是否读取的空System.out.println(buf);outputStream.write(buf, 0, length);}inputStream.close();outputStream.close();//成功之后简单输出一下out.print("上传成功！上传文件为:"+fileName+"<br/>保存的地址为"+filePath+ "！！");}}} catch (FileUploadException e) {e.printStackTrace();} catch (Exception e) {e.printStackTrace();}finally{out.close();}}

重新部署项目后运行，选择好附件，然后提交后查看源代码如下：

这里发现没有换行，所以我在servlet 中使用out.println() 输出发现页面依旧没有换行，只不过源代码换行了，具体如下：

这样源代码换行了，页面显示也换行了。

五、实现下载功能

上传功能实现完了之后再来说说下载功能的具体实现。

如果我们把附件放在当前项目下，可以直接通过超链接进行下载，但是假如附件放在我们上面例子的d:\attach 下那怎么办，tomcat 是不可能访问项目以外的资源的。

所以接下来有两种解决方案：

1、创建一个虚拟目录

我们发布项目的时候，也是通过在server.xml配置<Context> 实现将一个虚拟目录发布到tomcat服务器上，不一定这个虚拟目录上非得有什么WEB-INF，web.ml 等等之类的文件，这个目录专门存放一些附件之类的同样可以访问。

那么同理在server.xml 中加上如下例子：

<Context docBase="D:\attach" path="/img" reloabable="true" />访问的话可以使用 localhost:8080/img/imgName 就好了。/*** @see HttpServlet#doGet(HttpServletRequest request, HttpServletResponse response)*/protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {//获取需要下载的附件的地址，然后采用输入流InputStream读取附件信息String filePath = request.getParameter("filePath");if(filePath!=null){try{File file = new File(filePath);//创建输入流InputStream inputStream = new BufferedInputStream(new FileInputStream(file));byte[] buffer = new byte[inputStream.available()];//传递available() 有效的字节数，可以一次性读取完毕inputStream.read(buffer);inputStream.close();//清空response，设置response的Headerresponse.reset();response.addHeader("Content-Disposition", "attachment;filename=" + new String(file.getName().getBytes("utf-8"),"ISO-8859-1"));response.addHeader("Content-Length", "" + file.length());OutputStream outputStream = new BufferedOutputStream(response.getOutputStream());response.setContentType("application/octet-stream");outputStream.write(buffer);outputStream.flush();outputStream.close();} catch (IOException ex) {ex.printStackTrace();}}}

然后把上传的输出字符串改一下，加一个超链接，代码如下：

//成功之后简单输出一下

out.println("上传成功！上传文件为:"+fileName+"<br/>保存的地址为"+filePath+ "！！<a href='downloadFileServlet?filePath="+filePath+"'>下载</a><br/>");

接下来重新部署下项目，看看结果。效果如下图所示：

ok，下载附件功能也完成了！

六、上传附件中遇到问题的解决方案

1、中文乱码

在上面的例子中附件显示名称和附件的名称都是使用的英文名称，如果改为中文呢？所以果断尝试了一下，结果都乱码了，当时第一时间想到的是使用request.setCharacterEncoding("UTF-8"); 但是没有效果呀，这种设置字符编码方式只适合普通表单的post请求。

后来发现可以这样，在创建ServletFileUpload对象之后设置一下头部编码，代码如下：

ServletFileUpload servletFileUpload = new ServletFileUpload(diskFileItemFactory);

servletFileUpload.setHeaderEncoding("UTF-8");

再试一下，发现附件的实际名称没变乱码，但是附件的显示名称还是乱码，这需要单独设置encoding，原先取参数都是