Java web文件上传下载

2021-09-27 22:33:56

[版权申明：本文系作者原创，转载请注明出处]

文章出处：http://blog.csdn.net/sdksdk0/article/details/52048666

作者：朱培 ID：sdksdk0 邮箱： zhupei@tianfang1314.cn

本文主要从javaweb上传文件到服务器中，并且在服务器端进行数据文件存储，主要分享了文件上传原理、使用第三方开源工具进行上传以及一些文件上传时需要注意的地方，文件的优化处理，还有简易分享了从我们刚才上传进去的文件进行下载。需要掌握基本的开发流程，底层实现原理等。

一、文件上传原理

提供form表单，method必须是post
form表单的enctype必须是multipart/form-data
提供input type=”file”

Enctype属性

告知服务器请求正文的MIME类型。

application/x-www-form-urlencoded(默认):

正文：name=aa&password=123

服务器获取数据:request.getParameter(“name”);

文件上传原理：

解析请求正文的每部分的内容。

基于html form表单上传的数据都是以类似—————————–7da3c8e180752{0x130x10}这样的分割符来标记一块数据的起止。

文件上传的Content-Type为multipart/form-data; boundary=—-WebKitFormBoundaryhQslmBE7nbTLTJzD，而普通的form表单的Content-Type为application/x-www-form-urlencoded。因此，我们可以利用HttpServletRequest的request.getHeaderNames()方法和request.getHeaders(headName)方法得到请求头Headers中的Content-Type数据，然后根据Content-Type数据中是否包含multipart/form-data来区分请求是否为文件上传请求。其中boundary为文件数据的分隔符，用于区分上传多个文件。

二、使用第三方工具实现文件上传

fileupload组件工作流程：

开发步骤

导入commons-fileupload.jar、commons-io.jar包。

1、界面

我们就是需要一个form表单，为其添加enctype属性和post方法：

     <form action="${pageContext.request.contextPath}/servlet/UploadServlet2"  method="post"  enctype="multipart/form-data" >

        姓名: <input  type="text"  name="name" /><br />

        照片: <input  type="file"  name="photo" /><br />

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

    </form>

2、逻辑处理

我们在一个servlet中进行处理：

request.setCharacterEncoding("UTF-8");

        //判断用户的请求内容是不是multipart/form-data

        boolean isMultipart=ServletFileUpload.isMultipartContent(request);

        if(!isMultipart){

            throw new RuntimeException("error!");

        }

//创建DiskFileItemFactory对象

DiskFileItemFactory factory=new DiskFileItemFactory();



        //创建核心解析类ServlertFileUpload

        ServletFileUpload  sfu=new ServletFileUpload(factory);

        //解析请求对象

        List<FileItem> items=new ArrayList<FileItem>(0);

        try {

            items=sfu.parseRequest(request);

        } catch (FileUploadException e) {

            // TODO Auto-generated catch block

            e.printStackTrace();

        }

        for(FileItem item:items){

            if(item.isFormField()){

                processFormField(item);

            }else{

                processUploadField(item);

            }

        }

        response.getWriter().write("sucess!");

接下来就是分为两种情况了，一种是对普通的表单元素进行处理，另一种是对文件类的数据进行处理，对于第一种情况的话就比较简单，我们直接获取名字就可以了，基本上不用过多的处理。

private void processFormField(FileItem item) {

        String fieldName=item.getFieldName();

        String fieldValue=item.getString();

        System.out.println(fieldValue+"="+fieldName);

    }

对于第二种情况，需要我们直接对上传文件进行一系列的处理了，我们首先需要在服务器上找一个存放文件的地方，然后截取上传的文件名、构建输出流、关闭流等操作。

private void processUploadField(FileItem item) {

        try {

            InputStream in=item.getInputStream();

            String filename=item.getName();

            //在服务器上找一个存放文件的地方

            String storeDirectoryRealPath=getServletContext().getRealPath("/WEB-INF/files");

            File storeDirectory=new File(storeDirectoryRealPath);

            if(!storeDirectory.exists()){

                storeDirectory.mkdirs();

            }

            //截取上传的文件名

            //filename=filename.substring(filename.lastIndexOf(File.separator)+1);

            if(filename!=null){

                filename=FilenameUtils.getName(filename);

            }

            String guidFilename=GUIDUtil.generateGUID()+"_"+filename;

            //按日期来区分存储目录

        //  String childDirectory=makeChileDirectory(storeDirectory);

            String childDirectory=makeChildDirectory(storeDirectory,guidFilename);

            //构建输出流

            OutputStream  out=new FileOutputStream(new File(storeDirectory,childDirectory+File.separator+guidFilename));

            int len = -1;

            byte buf[] = new byte[1024];

            while((len=in.read(buf))!=-1){

                out.write(buf, 0, len);

            }

            in.close();

            out.close();

        } catch (IOException e) {

            e.printStackTrace();

        }

    }

三、文件上传优化处理

1、把保存的文件放在用户无法直接访问到的地方：例如放在：在WEB-INF/files目录中。

   String storeDirectoryRealPath=getServletContext().getRealPath("/WEB-INF/files");

2、让文件名唯一。

    String guidFilename=GUIDUtil.generateGUID()+"_"+filename;

            //构建输出流

            OutputStream  out=new FileOutputStream(new File(storeDirectory,guidFilename));

3、避免同一个文件夹中的文件过多。

3.1按照日期进行存储。

    String childDirectory=makeChileDirectory(storeDirectory);

    private String makeChileDirectory(File storeDirectory) {

        Date now=new Date();

        DateFormat df=new SimpleDateFormat("yyyy-MM-dd");

        String sdate=df.format(now);

        File f=new File(storeDirectory,sdate);

        if(!f.exists()){

            f.mkdirs();

        }

        return sdate;

    }

3.2用文件名的hashCode计算需要进行存储的目录，二级目录。

    private String makeChildDirectory(File storeDirectory, String guidFilename) {

        int hashCode = guidFilename.hashCode();

        int dir1 = hashCode&0xf;//  0~15

        int dir2 = (hashCode&0xf0)>>4;//0~15

        String s = dir1+File.separator+dir2;

        File f = new File(storeDirectory,s);

        if(!f.exists()){

            f.mkdirs();

        }

        return s;

    }

4、限制文件的大小。web方式不适合上传大的文件。

4.1单个文件大小：

ServletFileUpload  sfu=new ServletFileUpload(factory);

        sfu.setFileSizeMax(4*1024*1024);//限制不超过4M

4.2总文件大小：多文件上传

    ServletFileUpload  sfu=new ServletFileUpload(factory);

    sfu.setSizeMax(8*1024*1024);//总文件大小

5、限制文件的上传类型。

5.1通过文件扩展名来进行限制。

  String extensionName=FilenameUtils.getExtension(filename);

5.2通过文件MIME类型来限制。



    String mimeType=item.getContentType();

6、空文件上传解决方案。

判断文件名是否为空，当文件名为空时return。

7、临时文件

DiskFileItemFactory的作用是产生FileItem对象。其内部有一个缓存，默认大写拾10kb，如果上传文件超过10kb，则用磁盘作为缓存。存放缓存的目录默认是系统的临时目录。

DiskFileItemFactory factory=new DiskFileItemFactory();

        //更改临时文件的存放目录

        factory.setRepository(new File("D:/"));

如果是自己用IO流实现的文件上传，则需要在流关闭后，清理临时文件。

    FileItem.delete();

可以使用FileItem.write(File f)实现文件上传的保存。

8、中文编码

    request.setCharacterEncoding("UTF-8");

    //该编码要和jsp页面保持一致

    String fieldValue=item.getString("UTF-8");

9、动态js控制上传框

   <form action="${pageContext.request.contextPath}/servlet/UploadServlet3" method="post" enctype="multipart/form-data">

        name:<input type="text" name="name"/><br/>

        <div id="d1">

            <div>

            photo:<input type="file" name="photo"/><input type="button" value="继续上传" onclick="addFile()"/>

            </div>

        </div>

        <input type="submit" value="上传"/>

    </form>

    <script type="text/javascript">

        function addFile(){

            var d1 = document.getElementById("d1");

            var oldInnerHtml = d1.innerHTML;

            d1.innerHTML=oldInnerHtml+"<div>photo:<input type='file' name='photo'/><input type='button' value='删除' onclick='deleteOne(this)'/></div>";

        }

        function deleteOne(delBtn){

            delBtn.parentNode.parentNode.removeChild(delBtn.parentNode);

        }

    </script>

四、文件的下载

首先我们来看一下页面的处理：

新建一个list.jsp文件:

  全部资源如下:<br />

   <c:forEach items="${map}" var="me">

        <c:url value="/servlet/DownLoadServlet" var="url">

            <c:param name="filename" value="${me.key}"></c:param>

        </c:url>

        ${me.value}&nbsp;&nbsp;<a href="${url}">下载</a><br/>

    </c:forEach>

要记得引入jstl的核心包。

<%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>

接下做界面显示的servlet。

我们之前上传的文件是用GUID做过相应处理的，是一个拼接好的文件名，用来防止文件同名的情况发生，这里用户浏览到的文件当然要和上传的时候的文件名相同，所以这里我们要进行截取，把GUID拼接的前缀去掉，以“_”分开。一个是在服务器中防同名的文件名以及显示出来的截取后的文件名。这里以前面说过的，防同名文件方法2：用文件名的hashCode计算需要进行存储的目录，二级目录。这里也就需要使用hashCode找到做过文件的路径。

public void doGet(HttpServletRequest request, HttpServletResponse response)

            throws ServletException, IOException {

        //key:GUID文件名  value：old文件名

        Map<String, String> map = new HashMap<String, String>();

        //获取/WEB-INF/files的真实路径

        String rootDirectoryRealPath = getServletContext().getRealPath("/WEB-INF/files");

        //递归遍历找出所有的文件

        System.out.println(rootDirectoryRealPath);

        File rootDirectory = new File(rootDirectoryRealPath);

        treeWalk(rootDirectory,map);

        //存到请求范围中，转发给jsp显示

        request.setAttribute("map", map);

        request.getRequestDispatcher("/list.jsp").forward(request, response);

    }

    //递归遍历找出所有的文件,把文件名高出来

    public void treeWalk(File file, Map<String, String> map) {

        if(file.isFile()){

            String guidFileName = file.getName();

            String oldFileName = guidFileName.substring(guidFileName.indexOf("_")+1);

            map.put(guidFileName, oldFileName);

        }else{

            //目录

            File[] childFiles = file.listFiles();

            for(File f:childFiles){

                treeWalk(f, map);

            }

        }

    }

接下来就是下载的处理了。

public void doGet(HttpServletRequest request, HttpServletResponse response)

            throws ServletException, IOException {

        String guidFilename = request.getParameter("filename");//get方式提交的

        guidFilename = new String(guidFilename.getBytes("ISO-8859-1"),"UTF-8");

        //计算存放路径

        File storeDirectory = new File(getServletContext().getRealPath("/WEB-INF/files"));

        String childDirectory = makeChildDirecotry(storeDirectory, guidFilename);//  13/1

        //构建输入流

        InputStream in = new FileInputStream(new File(storeDirectory,childDirectory+File.separator+guidFilename));

        //用响应对象的输出流输出：下载的方式

        String oldFileName = guidFilename.substring(guidFilename.indexOf("_")+1);

        response.setHeader("Content-Disposition", "attachment;filename="+URLEncoder.encode(oldFileName,"UTF-8"));//不适用火狐

        response.setContentType("application/octet-stream");

        OutputStream out = response.getOutputStream();

        int len = -1;

        byte buf[] = new byte[1024];

        while((len=in.read(buf))!=-1){

            out.write(buf, 0, len);

        }

        in.close();

    }

    private String makeChildDirecotry(File storeDirectory, String guidFilename) {

        int hashCode = guidFilename.hashCode();

        int dir1 = hashCode&0xf;

        int dir2 = (hashCode&0xf0)>>4;

        String s = dir1+File.separator+dir2;

        File f = new File(storeDirectory,s);

        if(!f.exists()){

            f.mkdirs();

        }

        return s;

    }

通过这个网址进行访问

http://localhost:8080/UploadDemo/servlet/ShowAllFilesServlet

源码下载：https://github.com/sdksdk0/UploadDemo

码农公寓