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

最新推荐文章于 2024-01-31 11:06:43 发布

夜空中苦逼的程序员

最新推荐文章于 2024-01-31 11:06:43 发布

阅读量1w

点赞数 6

分类专栏：【Servlet】文章标签： attach servlet

本文链接：https://blog.csdn.net/chenghui0317/article/details/9502143

版权

【Servlet】专栏收录该内容

1 篇文章 0 订阅

订阅专栏

原创作品，允许转载，转载时请务必以超链接形式标明文章原始出处、作者信息和本人声明。否则将追究法律责任。
作者：永恒の_☆ 地址： http://blog.csdn.net/chenghui0317/article/details/9502143

一、简单介绍

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

二、准备条件

common-io.jar ，下载地址：http://commons.apache.org/io/download_io.cgi

common-upload.jar ，下载地址：http://jakarta.apache.org/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" "http://www.w3.org/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 org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.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标签输入的值也属于FileInput
            List<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标签的name
                    String value = fileItem.getString();    //input表单的value
                    if("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");

就好了。

正确显示效果如下：

另外，将上传的附件是使用org.apache.commons.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标签输入的值也属于FileInput
			List<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标签的name
					String value = fileItem.getString();    //input表单的value
					if("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("."));
					//org.apache.commons.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" "http://www.w3.org/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标签输入的值也属于FileInput
			List<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标签的name
					String value = fileItem.getString();    //input表单的value
					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("."));
					//org.apache.commons.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() 输出发现页面依旧没有换行，只不过源代码换行了，具体如下：

可见out.println()输出的换行一直控制页面文件的换行，真正的换行还需要使用<br/>标签，在servlet中加上<br/>之后，效果如下：

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

五、实现下载功能

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

如果我们把附件放在当前项目下，可以直接通过超链接进行下载，但是假如附件放在我们上面例子的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 就好了。

2、采用输入流读取附件，然后输出流写入即可完成下载功能

具体代码如下：

	/**
	 * @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的Header
				response.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，原先取参数都是

String value = fileItem.getString();    //input表单的value

需要传递encoding ，让FileItem知道你想得到什么格式的value，代码如下：

String value = fileItem.getString("UTF-8");    //input表单的value

再重新部署一下，具体效果如下：

2、String类型的变量索引越界

String 类型的变量索引越界了，具体如下：

java.lang.StringIndexOutOfBoundsException: String index out of range: -1

仔细排查发现如果上传的附件框如果不选择图片，那么Servlet还是会去按照常规获取附件写入磁盘，所以这里

String filePath = UPLOAD_PATH + showFileName + fileName.substring(fileName.lastIndexOf("."));

在它上面过滤掉就好了，具体如下：

   if(fileName.length()==0){
   	continue;
   }

夜空中苦逼的程序员

关注

6
点赞
踩
13

收藏

觉得还不错? 一键收藏
5
评论
Servlet 实现上传附件（支持多附件）

使用 Servlet上传附件原理上还是蛮简单的，首先获取上传的附件对象，然后做一些简单处理后写入到指定路径的磁盘中。准备条件： common-io.jar ，下载地址：http://commons.apache.org/io/download_io.cgi common-upload.jar ，下载地址：http://jakarta.apache.org/comm
复制链接

扫一扫