11. Servlet 文件上传

本文介绍如何使用Servlet结合commons-fileupload和commons-io库实现文件上传功能。通过示例代码详细展示了HTML表单创建、Servlet配置及文件处理流程。
Servlet 文件上传

Servlet 可以通过 HTML 的 <form> 和 2个第3方库  commons-fileupload、commons-io 来完成,在程序运行时确保这2个依赖库引入到 WEB-INF/lib 中;
以下是这两个库的下载地址:
upload.html
 
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Upload File</title>
</head>
<body>
<form method="POST" action="uploadFile" enctype="multipart/form-data">
    <label>Choose File: </label><input type="file" name="file" /><br/>
    <input type="submit" name="submit" value="upload">
</form>
</body>
</html>

UploadFileServlet.java
 
public class UploadFileServlet extends HttpServlet {
    private static final String UPLOAD_DIR = "upload"; //上传保存目录
    private static final int MEMORY_HRESHOLD = 1024 * 1024 * 3 ; //传输内存使用上限 ,超过后将临时文件储存在临时目录中3MB
    private static final int MAX_FILE_SIZE = 1024 * 1024 * 40 ;  //文件大小上限 40MB
    private static final int MAX_REQUEST_SIZE = 1024 * 1024 * 50 ; //请求大小上限 50MB
    /*上传数据,保存文件*/
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException,IOException{
        //检测文件是否为多媒体上传,如果不是则停止
        if(!ServletFileUpload.isMultipartContent(request)){
            PrintWriter out = response.getWriter();
            out.println("Error: form must include enctype=multipart/form-data");
            out.flush();
            return ;
        }
        //设置上传参数
        DiskFileItemFactory factory = new DiskFileItemFactory();
        factory.setSizeThreshold(MEMORY_HRESHOLD);    //设置内存临界值
        factory.setRepository(new File(System.getProperty("java.io.tmpdir")));  //设置临时储存目录
        ServletFileUpload upload = new ServletFileUpload(factory);
        upload.setFileSizeMax(MAX_FILE_SIZE);   //设置文件大小上限
        upload.setSizeMax(MAX_REQUEST_SIZE);   //设置请求大小上限
        upload.setHeaderEncoding("UTF-8");
        //文件上传过程
        String uploadPath = request.getServletContext().getRealPath("./") + File.separator + UPLOAD_DIR;  //构造临时路径来储存上传文件
        File uploadDir = new File(uploadPath);
        if(!uploadDir.exists())
            uploadDir.mkdir();
        try{
            @SuppressWarnings("unchecked")
            //解析请求的内容,提取文件数据
            List<FileItem> formItems = upload.parseRequest(request);
            if(formItems != null && formItems.size() > 0){
                for(FileItem item : formItems){   //迭代表单数据
                    if(!item.isFormField()){     //不在表单中的字段,即为上传文件数据所在的FileItem
                        String fileName = new File(item.getName()).getName();
                        String filePath = uploadPath + File.separator + fileName;
                        File storeFile = new File(filePath);
                        item.write(storeFile);        //保存文件到硬盘
                        request.setAttribute("message","Upload file successfully");
                    }
                }
            }
        }catch(Exception ex){
           request.setAttribute("message","Error: " + ex.getMessage());
        }
        //跳转到 massage.jsp
        request.getServletContext().getRequestDispatcher("/message.jsp").forward(request,response);
    }
}

message.jsp
 
<%@ page contentType="text/html;charset=UTF-8" language="java" pageEncoding="UTF-8" %>
<html>
<head>
    <title>Upload file message</title>
</head>
<body>
<h1>${message}</h1>
</body>
</html>

web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
    <servlet>
        <servlet-name>uploadFile</servlet-name>
        <servlet-class>control2.UploadFileServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>uploadFile</servlet-name>
        <url-pattern>/uploadFile</url-pattern>
    </servlet-mapping>
</web-app>


### javax.servlet 简介与常见问题 `javax.servlet` 是 Java EE 平台中用于开发 Web 应用程序的核心 API,它定义了 Servlet 的行为和生命周期。Servlet 是运行在服务器端的小型 Java 程序,用于处理 HTTP 请求并生成动态内容[^1]。 #### 1. Servlet API 文档 Servlet API 文档提供了关于 `javax.servlet` 包及其子包的详细信息。开发者可以通过以下方式获取官方文档: - 访问 Oracle 官方网站上的 Java EE 文档页面。 - 下载包含 Servlet 规范的最新版本 Javadoc 文件。 以下是 `javax.servlet` 包中一些常用的类和接口: - **Servlet**:定义了所有 Servlet 必须实现的方法,如 `init()`、`service()` 和 `destroy()`[^2]。 - **GenericServlet**:提供了一个通用的实现,简化了 Servlet 的开发。 - **HttpServlet**:扩展了 `GenericServlet`,专门为处理 HTTP 请求而设计。 - **ServletRequest** 和 **ServletResponse**:分别表示客户端请求和服务器响应的对象。 - **Filter**:用于拦截和修改请求或响应。 #### 2. 常见问题及解决方案 ##### (1) 如何处理 GET 和 POST 请求? `HttpServlet` 提供了专门的方法来处理不同类型的 HTTP 请求。例如,`doGet()` 方法用于处理 GET 请求,而 `doPost()` 方法用于处理 POST 请求[^3]。 ```java protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 处理 GET 请求 } protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 处理 POST 请求 } ``` ##### (2) 如何读取表单数据? 通过 `HttpServletRequest` 对象可以读取表单提交的数据。对于简单的键值对,可以使用 `getParameter()` 方法;对于文件上传等复杂场景,则需要借助第三方库(如 Apache Commons FileUpload)[^4]。 ```java String username = request.getParameter("username"); String password = request.getParameter("password"); ``` ##### (3) 如何设置响应内容类型? 使用 `HttpServletResponse` 的 `setContentType()` 方法可以指定返回给客户端的内容类型。 ```java response.setContentType("text/html;charset=UTF-8"); ``` ##### (4) 如何重定向到另一个 URL? 通过调用 `HttpServletResponse` 的 `sendRedirect()` 方法可以实现页面重定向。 ```java response.sendRedirect("https://example.com"); ``` ##### (5) 如何共享会话数据? 利用 `HttpSession` 对象可以在多个请求之间共享数据。会话通常由 Servlet 容器自动创建,也可以通过 `request.getSession()` 方法显式获取。 ```java HttpSession session = request.getSession(); session.setAttribute("user", user); ``` ### 注意事项 - 确保正确配置 `web.xml` 或使用注解(如 `@WebServlet`)来注册 Servlet。 - 在生产环境中,考虑安全性问题,例如防止 XSS 和 CSRF 攻击[^5]。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值