java 获取文件上传流

原创

mob64ca12d2317d 2024-08-13 11:42:16 ©著作权

©著作权归作者所有：来自51CTO博客作者mob64ca12d2317d的原创作品，请联系作者获取转载授权，否则将追究法律责任

Java 获取文件上传流的基本方法

在现代Web应用程序中，文件上传是一项常见的需求。Java作为一种广泛使用的编程语言，提供了多种方法来处理文件上传。本文将介绍如何使用Java获取文件上传的流，以及相关的示例代码。

文件上传原理

在HTTP协议中，文件上传通常通过POST请求实现。客户端将文件与其他数据一起发送到服务器。服务器端接收到请求后，可以通过获取输入流来处理上传的文件。特别是在Java Web应用中，常用的Servlet和Spring框架提供了便捷的API来实现这一功能。

使用Servlet获取上传流

首先，我们来看一个简单的使用Servlet获取文件上传流的示例。为了上传文件，我们常用Apache Commons FileUpload库。首先确保在项目中引入该库。

Maven依赖

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

Servlet代码示例

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;

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 java.io.File;
import java.io.IOException;
import java.util.List;

@WebServlet("/upload")
@MultipartConfig
public class UploadServlet extends HttpServlet {
    protected void doPost(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        if (ServletFileUpload.isMultipartContent(request)) {
            DiskFileItemFactory factory = new DiskFileItemFactory();
            ServletFileUpload upload = new ServletFileUpload(factory);

            try {
                List<FileItem> items = upload.parseRequest(request);
                for (FileItem item : items) {
                    if (!item.isFormField()) {
                        // 上传文件的路径
                        String filePath = "C:/uploads/" + item.getName();
                        File uploadedFile = new File(filePath);
                        item.write(uploadedFile);
                    }
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    }
}

在以上代码中，我们首先检查请求是否为多部分内容。如果是，我们创建一个ServletFileUpload对象，并解析请求。接着，对于每一个文件项，我们获取其内容并将其写入指定路径中。

在Spring中获取文件上传流

如果你使用Spring框架，可以使用@RequestParam注解轻松获取上传文件。

Spring Controller 示例

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.IOException;

@RestController
public class FileUploadController {
    @PostMapping("/upload")
    public String handleFileUpload(@RequestParam("file") MultipartFile file) {
        try {
            String filePath = "C:/uploads/" + file.getOriginalFilename();
            file.transferTo(new File(filePath));
            return "File uploaded successfully: " + filePath;
        } catch (IOException e) {
            e.printStackTrace();
            return "File upload failed";
        }
    }
}

在这个示例中，我们使用@RequestParam注解来获取上传的文件，并使用transferTo方法将文件保存到指定路径。

旅程图

接下来，我们使用mermaid语法创建旅行图，以便更好地理解文件上传的过程。

journey
    title 文件上传过程
    section 客户端
      选择文件: 5: 客户端
      点击上传: 5: 客户端
    section 网络
      发送POST请求: 5: 网络
    section 服务器
      验证请求: 5: 服务器
      处理文件上传: 5: 服务器
      文件存储: 5: 服务器