JavaWeb Servlet实现文件上传与下载功能实例

下面是 "JavaWeb Servlet实现文件上传与下载功能实例" 的完整攻略。

一、准备工作

在开始实现文件上传与下载功能之前，我们需要准备如下环境和工具：

JDK：Java开发环境，最好使用JDK 1.8及以上版本；
Eclipse：Java IDE，也可以使用其他Java IDE，比如IntelliJ IDEA等；
Tomcat：JavaWeb服务器，最好使用Tomcat 8及以上版本；
Maven：Java项目管理工具，用于管理项目依赖；
一个用于上传和下载文件的Web应用程序。

二、实现文件上传功能

1.导入依赖

首先，在pom.xml文件中添加如下依赖：

<dependencies>
  <dependency>
    <groupId>junit</groupId>
    <artifactId>junit</artifactId>
    <version>3.8.1</version>
    <scope>test</scope>
  </dependency>
  <dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>servlet-api</artifactId>
    <version>2.5</version>
    <scope>provided</scope>
  </dependency>
  <dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.3.3</version>
  </dependency>
</dependencies>

这里我们添加了JUnit、Servlet API和commons-fileupload三个依赖。

2.配置Servlet

接下来，我们需要在web.xml文件中配置Servlet，如下所示：

<servlet>
  <servlet-name>UploadServlet</servlet-name>
  <servlet-class>com.examle.UploadServlet</servlet-class>
  <multipart-config>
    <!-- 设置上传文件的最大大小 -->
    <max-file-size>20848820</max-file-size>
    <!-- 设置上传文件的临时存放目录 -->
    <location>/tmp</location>
  </multipart-config>
</servlet>
<servlet-mapping>
  <servlet-name>UploadServlet</servlet-name>
  <url-pattern>/upload</url-pattern>
</servlet-mapping>

这里我们定义了一个Servlet，并设置了上传文件的最大大小和临时存放目录，同时指定了Servlet的访问路径为/upload。

3.实现Servlet

然后，我们需要实现Servlet，如下所示：

public class UploadServlet extends HttpServlet {
  private static final long serialVersionUID = 1L;

  protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // 检查是否为文件上传请求
    if (!ServletFileUpload.isMultipartContent(request)) {
      response.sendError(HttpServletResponse.SC_BAD_REQUEST, "Not a multipart request");
      return;
    }

    // 创建文件上传处理器
    DiskFileItemFactory factory = new DiskFileItemFactory();
    factory.setSizeThreshold(2 * 1024 * 1024); // 设置缓冲区大小（2MB）
    factory.setRepository(new File(System.getProperty("java.io.tmpdir")));

    ServletFileUpload upload = new ServletFileUpload(factory);
    upload.setFileSizeMax(10 * 1024 * 1024); // 限制单个上传文件大小（10MB）
    upload.setSizeMax(20 * 1024 * 1024); // 限制总上传文件大小（20MB）

    // 解析上传请求，并获取文件项列表
    List<FileItem> items = null;
    try {
      items = upload.parseRequest(request);
    } catch (FileUploadException e) {
      response.sendError(HttpServletResponse.SC_INTERNAL_SERVER_ERROR, "File upload failed");
      return;
    }

    // 处理文件项列表
    for (FileItem item : items) {
      // 如果是普通表单字段，则输出字段名和字段值
      if (item.isFormField()) {
        System.out.println(item.getFieldName() + " = " + item.getString());
      }
      // 如果是文件字段，则保存文件到指定路径
      else {
        String fileName = item.getName();
        if (fileName != null && !fileName.isEmpty()) {
          String contentType = item.getContentType();
          long sizeInBytes = item.getSize();
          InputStream inputStream = item.getInputStream();

          // 处理上传文件
          // ...

          inputStream.close();
        }
      }
    }

    // 返回处理结果
    response.getWriter().println("File upload succeeded");
  }
}

这里我们定义了一个UploadServlet类，并在doPost()方法中实现了文件上传功能。具体来说，我们首先通过ServletFileUpload.isMultipartContent()方法检查请求是否为文件上传请求，如果不是，则返回错误响应。然后，我们创建了一个DiskFileItemFactory对象，并设置了缓冲区大小和临时存放目录。接着，我们创建了一个ServletFileUpload对象，并设置了上传文件大小限制以及总上传文件大小限制。然后，我们解析上传请求，并通过FileItem对象的isFormField()方法判断字段是普通表单字段还是文件字段。如果是普通表单字段，则输出字段名和字段值。如果是文件字段，则获取文件名、文件类型、文件大小以及文件内容，并将文件内容保存到指定路径。最后，我们返回处理结果。

4.实现页面

最后，我们需要实现一个HTML页面，通过该页面来上传文件，如下所示：

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8" />
  <title>File Upload</title>
</head>
<body>
  <form method="POST" action="/upload" enctype="multipart/form-data">
    <input type="file" name="file" /><br>
    <input type="submit" value="Upload" />
  </form>
</body>
</html>

这里我们定义了一个HTML表单，通过该表单可以选择文件并提交到/upload路径。

三、实现文件下载功能

1.实现Servlet

首先，我们需要实现一个Servlet来提供文件下载功能，如下所示：

public class DownloadServlet extends HttpServlet {
  private static final long serialVersionUID = 1L;

  protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
    // 获取请求参数中的文件名
    String fileName = request.getParameter("fileName");
    if (fileName == null || fileName.isEmpty()) {
      response.sendError(HttpServletResponse.SC_BAD_REQUEST, "Missing file name");
      return;
    }

    // 获取文件的MIME类型并设置响应头
    String mimeType = getServletContext().getMimeType(fileName);
    if (mimeType == null) {
      mimeType = "application/octet-stream";
    }
    response.setContentType(mimeType);
    response.setHeader("Content-Disposition", String.format("attachment; filename=\"%s\"", fileName));

    // 获取文件内容并输出
    InputStream inputStream = null;
    OutputStream outputStream = null;
    try {
      inputStream = new FileInputStream(new File("/path/to/file/" + fileName));
      outputStream = response.getOutputStream();
      byte[] buffer = new byte[1024];
      int bytesRead = -1;
      while ((bytesRead = inputStream.read(buffer)) != -1) {
        outputStream.write(buffer, 0, bytesRead);
      }
    } catch (FileNotFoundException e) {
      response.sendError(HttpServletResponse.SC_NOT_FOUND, "File not found");
      return;
    } finally {
      if (inputStream != null) {
        inputStream.close();
      }
      if (outputStream != null) {
        outputStream.close();
      }
    }
  }
}

这里我们定义了一个DownloadServlet类，并在doGet()方法中实现了文件下载功能。具体来说，我们首先从请求参数中获取需要下载的文件名，如果文件名为空，则返回错误响应。然后，我们获取文件的MIME类型和大小，并设置响应头。接着，我们获取文件内容并将其输出到响应流中。最后，我们关闭输入输出流。

2.实现页面

然后，我们需要实现一个页面来提供文件下载链接，如下所示：

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8" />
  <title>File Download</title>
</head>
<body>
  <ul>
    <li><a href="/download?fileName=file1.txt">file1.txt</a></li>
    <li><a href="/download?fileName=file2.zip">file2.zip</a></li>
    <li><a href="/download?fileName=file3.pdf">file3.pdf</a></li>
  </ul>
</body>
</html>

这里我们定义了一个HTML列表，通过该列表可以下载文件。具体来说，我们定义了三个文件下载链接，分别下载file1.txt、file2.zip和file3.pdf三个文件。

四、结束语

至此，我们已经完成了 "JavaWeb Servlet实现文件上传与下载功能实例" 的完整攻略。通过本文，你可以掌握如何使用commons-fileupload和Servlet API来实现文件上传和下载功能。当然，这只是一个基本的示例，请根据实际需求进行修改和拓展。

本站文章如无特殊说明，均为本站原创，如若转载，请注明出处：JavaWeb Servlet实现文件上传与下载功能实例 - Python技术站