Servlet3.0实现文件上传的方法_网络技术_宿州市腾雀网络科技有限公司

Servlet3.0实现文件上传的方法

发布时间 - 2026-01-11 00:23:20 点击率：次

Servlet 实现文件上传

所谓文件上传就是将本地的文件发送到服务器中保存。例如我们向百度网盘中上传本地的资源或者我们将写好的博客上传到服务器等等就是典型的文件上传。

Servlet 3.0

上次完成文件下载功能使用的是 Servlet 2.5，但是想要完成文件上传，那么继续使用 Servlet 2.5 肯定不是一个好的选择，因此我们使用 Servlet 3.0 来完成文件上传。下面我来简单介绍一下 Servlet 3.0 的新特性：

1、新增的注解支持

该版本新增了若干注解，用于简化 Servlet、过滤器（Filter）和监听器（Listener）的声明，这使得 web.xml 部署描述文件从该版本开始不再是必选的了。

2、HttpServletRequest 对文件上传的支持

此前，对于处理上传文件的操作一直是让开发者头疼的问题，因为 Servlet 本身没有对此提供直接的支持，需要使用第三方框架来实现，而且使用起来也不够简单。如今这都成为了历史，Servlet 3.0 已经提供了这个功能，而且使用也非常简单。
Servlet 3.0 的新特性当然肯定不止这些，但是其他的新特性在这里我们暂时还用不到，也就不做过多了解了。

必要条件

想要完成文件上传，肯定不是这么简单，它对浏览器端和服务器端都有许多的要求。

对浏览器的要求：

一个文件的大小一般肯定不止 1 KB，既然这样，那么要上传一个文件肯定不能使用 get 方式了，所以上传文件时必须采用 post 方式。
2.表单中必须有一个文件上传项 <input type="file"> ，而且必须有 name 属性。
必须设置表单的 enctype 属性值为 multipart/form-data。

对服务器的要求：

当然，我们肯定得使用 Servlet 3.0。
Servlet 3.0 中接收普通上传组件（除了文件上传组件）通过 request.getParameter(String)接收，而文件上传组件通过 request.getPart(String)接收。
Servlet 3.0 要求服务器必须是 Tomcat7 及其以上。

准备工作

工欲善其事，必先利其器。

1、首先，打开 Eclipse，新建一个 Dynamic Web Project。

2、键入项目名，选择运行时环境为 Apache Tomcat v7.0，选择 Servlet 版本为 3.0，然后点击 Finished。

3、在项目的 WebContent 目录下，新建一个文件夹 upload，用来存放上传过来的文件。

4、在 WebContent 目录下新建一个 index.jsp。

<%@ page language="java" contentType="text/html; charset=UTF-8"
 pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
 <head>
   <meta charset="UTF-8">
   <title>上传</title>
 </head>

 <body>
   <form action="${pageContext.request.contextPath}/UploadServlet" method="post" enctype="multipart/form-data">
     <label>选择一个文件：</label>
     <input type="file" name="file"><br>
     <input type="submit" value="上传"><br>
   </form>
 </body>
</html>

5、使用 Tomcat 将次项目发布，并在浏览器中预览。

将服务器启动，然后在浏览器中输入：http://localhost:8080/upload。

好吧！样子有点丑，希望不要介意！如果出现以上界面，那么，准备工作就完成了！

完成案例

首先，新建一个 Servlet，在 Servlet 3.0 我们不必再为配置 web.xml 而烦恼了，只要要在 Servlet 的类名上面一行添加一个注解：

@WebServlet("/UploadServlet")

这个注解就相当与 Servlet 2.5 中的：

<servlet>
  <servlet-name>UploadServlet</servlet-name>
  <servlet-class>club.luckylight.upload.UploadServlet</servlet-class>
</servlet>
<servlet-mapping>
  <servlet-name>UploadServlet</servlet-name>
  <url-pattern>/UploadServlet</url-pattern>
</servlet-mapping>

这样比较，使用注解不是简便了很多。

然后，我们还需要添加另一个注解：

@MultipartConfig

该注解主要是为了辅助 Servlet 3.0 中 HttpServletRequest 提供的对上传文件的支持。该注解标注在 Servlet 上面，以表示该 Servlet 希望处理的请求的 MIME类型是 multipart/form-data。

接下来，我们就需要根据上传组件的 name 属性获取它了。这里我们使用 Path request.getPart(String) 方法。

Part part = request.getPart("file");

然后，我们就需要根据 part 获取头信息，然后根据头信息获取文件的路径。

在浏览器抓包，获取头信息为：

据此，我们可以获取文件名或者文件路径。

String header = part.getHeader("content-disposition");
String path = header.substring(header.indexOf("filename=") + 10, header.length() - 1);

由于获取的有可能是文件名，也有可能是文件路径，为此，有必要编写一个工具类，用来获取文件的真实名称。

/**
 * 根据文件的路径获取文件真实名称
 * 
 * @param path
 *      文件的路径
 * @return 文件名称
 */
public static String getRealName(String path) {
  int index = path.lastIndexOf("\\");

  if (index == -1) {
    index = path.lastIndexOf("/");
  }

  return path.substring(index + 1);
}

然后，调用这个方法，获得文件名。

String name = UploadUtils.getRealName(path);

接下来，我们有必要，给每个文件分配一个存放目录，因此我又编写了一个方法，用来生成一个目录。

/**
 * 根据文件名返回一个目录
 * 
 * @param name
 *      文件名称
 * @return 目录
 */
public static String getDir(String name) {
  int i = name.hashCode();
  String hex = Integer.toHexString(i);
  int j = hex.length();

  for (int k = 0; k < 8 - j; k++) {
    hex = "0" + hex;
  }

  return "/" + hex.charAt(0) + "/" + hex.charAt(1);
}

到此，万事俱备，只欠东风。我们只需要将文件拷贝到服务器。

// 获取文件的真实路径
String realPath = this.getServletContext().getRealPath("/upload" + dir);
File file = new File(realPath);

if (!file.exists()) {
  file.mkdirs();
}

// 获取输入流
InputStream inputStream = part.getInputStream();
// 定义输出流
FileOutputStream outputStream = new FileOutputStream(new File(file, name));

// 从输入流中读入数据并写到输出字节流中
int len = -1;
byte[] bytes = new byte[1024];
while ((len = inputStream.read(bytes)) != -1) {
  outputStream.write(bytes, 0, len);
}

// 关闭资源
outputStream.close();
inputStream.close();

// 删除临时文件
part.delete();

下面来测试一下：

然后，在 Tomcat 的 webapps -> 项目名 -> upload 中就可以找到上传成功的文件了！

最后，我们打开音乐来试验下是否真的上传成功了？

嗯！薛之谦低沉的声音从耳机中传来，看来确实是上传成功了！

完整代码

UploadServlet.java

package club.luckylight.upload;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;

import javax.servlet.ServletException;
import javax.servlet.annotation.MultipartConfig;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import javax.servlet.http.Part;

import club.luckylight.util.UploadUtils;

@WebServlet("/UploadServlet")
@MultipartConfig
public class UploadServlet extends HttpServlet {

  private static final long serialVersionUID = 5661013723204858883L;

  protected void doGet(HttpServletRequest request, HttpServletResponse response)
      throws ServletException, IOException {
    // 获取文件上传组件
    Part part = request.getPart("file");

    // 获取文件的路径
    String header = part.getHeader("content-disposition");
    String path = header.substring(header.indexOf("filename=") + 10, header.length() - 1);

    // 获取文件名
    String name = UploadUtils.getRealName(path);

    // 获取文件的存放目录
    String dir = UploadUtils.getDir(name);

    String realPath = this.getServletContext().getRealPath("/upload" + dir);
    File file = new File(realPath);
    if (!file.exists()) {
      file.mkdirs();
    }

    // 对拷流
    InputStream inputStream = part.getInputStream();
    FileOutputStream outputStream = new FileOutputStream(new File(file, name));
    int len = -1;
    byte[] bytes = new byte[1024];
    while ((len = inputStream.read(bytes)) != -1) {
      outputStream.write(bytes, 0, len);
    }

    // 关闭资源
    outputStream.close();
    inputStream.close();

    // 删除临时文件
    part.delete();

    response.setContentType("text/html;charset=utf-8");
    response.getWriter().print("文件" + name + "上传成功！");
  }

  protected void doPost(HttpServletRequest request, HttpServletResponse response)
      throws ServletException, IOException {
    doGet(request, response);
  }

}

UploadUtils.java

package club.luckylight.util;

public class UploadUtils {

  /**
   * 根据文件的路径获取文件真实名称
   * 
   * @param path
   *      文件的路径
   * @return 文件名称
   */
  public static String getRealName(String path) {
    int index = path.lastIndexOf("\\");

    if (index == -1) {
      index = path.lastIndexOf("/");
    }

    return path.substring(index + 1);
  }

  /**
   * 根据文件名返回一个目录
   * 
   * @param name
   *      文件名称
   * @return 目录
   */
  public static String getDir(String name) {
    int i = name.hashCode();
    String hex = Integer.toHexString(i);
    int j = hex.length();

    for (int k = 0; k < 8 - j; k++) {
      hex = "0" + hex;
    }

    return "/" + hex.charAt(0) + "/" + hex.charAt(1);
  }
}

总结

这样，文件上传案例就完成了，希望对大家的学习有所帮助，也希望大家多多支持。

# servlet3.0文件上传 # servlet实现上传 # servlet文件上传下载 # Servlet3.0学习总结之基于Servlet3.0的文件上传实例 # 详解Servlet3.0新特性（从注解配置到websocket编程） # SpringMVC + servlet3.0 文件上传的配置和实现代码 # Java Servlet3.0异步处理问题 # 文件上传 # 上传 # 新建一个 # 上传文件 # 新特性 # 器中 # 有必要 # 准备工作 # 表单 # 的是 # 临时文件 # 完成了 # 也不 # 都有 # 在这里 # 也有 # 工欲善其事 # 必先利其器 # 只欠东风 # 目录下

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：如何在使用 readlines() 读取文件行后避免自动换行

下一篇：如何在北京创建一个中英文网站：初学者指南

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：如何在使用 readlines() 读取文件行后避免自动换行

下一篇：如何在北京创建一个中英文网站：初学者指南