Servlet 文件上传-优快云博客

本文链接：https://blog.youkuaiyun.com/csbysj2020/article/details/143728424

Servlet 文件上传

在Java Web开发中，文件上传是一个常见的需求。Servlet作为一种服务器端的技术，可以轻松实现文件上传功能。本文将详细介绍如何在Servlet中处理文件上传，包括环境配置、代码实现以及常见问题的解决方案。

环境配置

1. 添加依赖

在项目的pom.xml文件中，添加Apache Commons FileUpload库的依赖。这个库提供了易于使用的API来处理文件上传。

<dependency>
    <groupId>commons-fileupload</groupId>
    <artifactId>commons-fileupload</artifactId>
    <version>1.4</version>
</dependency>

2. 配置web.xml

在web.xml文件中，配置Servlet用于处理文件上传的URL映射。

<servlet>
    <servlet-name>FileUploadServlet</servlet-name>
    <servlet-class>com.example.FileUploadServlet</servlet-class>
</servlet>
<servlet-mapping>
    <servlet-name>FileUploadServlet</servlet-name>
    <url-pattern>/upload</url-pattern>
</servlet-mapping>

代码实现

1. 创建HTML表单

创建一个HTML表单，允许用户选择要上传的文件。

<form action="upload" method="post" enctype="multipart/form-data">
    选择文件：<input type="file" name="file" />
    <input type="submit" value="上传" />
</form>

注意：表单的enctype属性必须设置为multipart/form-data，这样才能正确地发送文件数据。

2. 编写Servlet

在Servlet中，使用Apache Commons FileUpload库来处理上传的文件。

@WebServlet("/upload")
@MultipartConfig
public class FileUploadServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        // 检查是否是multipart内容类型
        if (!ServletFileUpload.isMultipartContent(request)) {
            throw new IllegalArgumentException("表单必须包含enctype=multipart/form-data");
        }

        // 创建一个ServletFileUpload实例
        ServletFileUpload upload = new ServletFileUpload(new DiskFileItemFactory());

        try {
            // 解析请求，获取文件项
            List<FileItem> items = upload.parseRequest(request);
            for (FileItem item : items) {
                if (!item.isFormField()) {
                    // 处理上传的文件
                    String fileName = item.getName();
                    InputStream inputStream = item.getInputStream();
                    // 这里可以编写代码将文件保存到服务器
                }
            }
        } catch (FileUploadException e) {
            e.printStackTrace();
        }
    }
}

3. 保存文件

在处理文件项时，可以将文件保存到服务器的指定目录。

String uploadPath = "/path/to/upload/directory";
File uploadDir = new File(uploadPath);
if (!uploadDir.exists()) {
    uploadDir.mkdir();
}

String fileName = item.getName();
File file = new File(uploadDir, fileName);
item.write(file);

常见问题

1. 文件大小限制

默认情况下，Servlet容器和Apache Commons FileUpload库都对上传的文件大小有限制。可以在web.xml中配置Servlet的maxFileSize和maxRequestSize属性来调整这些限制。

<servlet>
    <servlet-name>FileUploadServlet</servlet-name>
    <servlet-class>com.example.FileUploadServlet</servlet-class>
    <multipart-config>
        <max-file-size>1000000</max-file-size>
        <max-request-size>1000000</max-request-size>
    </multipart-config>
</servlet>

2. 文件类型限制

可以在Servlet中添加逻辑来检查上传文件的类型，以防止上传不安全的文件。

String fileName = item.getName();
String contentType = item.getContentType();
if (!contentType.equalsIgnoreCase("image/jpeg") && !contentType.equalsIgnoreCase("image/png")) {
    throw new IllegalArgumentException("不支持的文件类型");
}

3. 文件重名问题

为了避免上传的文件覆盖服务器上的现有文件，可以在保存文件之前为文件名添加一个唯一的后缀。

String fileName = item.getName();
String uniqueFileName = UUID.randomUUID().toString() + "_" + fileName;
File file = new File(uploadDir, uniqueFileName);
item.write(file);