java将文件上传到服务器，Java实现文件上传到服务器的详细教程及源码解析

本教程详细解析了Java如何将文件上传至服务器，包括文件上传的准备工作、关键代码实现、异常处理等，并提供源码示例，助您轻松掌握文件上传技术。

随着互联网的快速发展,文件上传和下载已经成为我们日常生活中不可或缺的一部分，在Java开发中，文件上传到服务器是一个常见的需求，本文将详细讲解如何使用Java实现文件上传到服务器，包括使用Servlet、Apache Commons FileUpload、Spring MVC等技术，本文还将提供完整的源码示例，帮助读者更好地理解和应用。

使用Servlet实现文件上传

图片来源于网络，如有侵权联系删除

创建Servlet

我们需要创建一个Servlet来处理文件上传请求,以下是一个简单的文件上传Servlet示例：

import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
@WebServlet("/upload")
public class FileUploadServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        // 设置文件保存路径
        String uploadPath = getServletContext().getRealPath("/") + "uploads/";
        File uploadDir = new File(uploadPath);
        if (!uploadDir.exists()) {
            uploadDir.mkdirs();
        }
        // 获取上传文件
        Part filePart = request.getPart("file");
        String fileName = filePart.getSubmittedFileName();
        InputStream fileContent = filePart.getInputStream();
        // 保存文件
        File file = new File(uploadPath + fileName);
        OutputStream outputStream = new FileOutputStream(file);
        byte[] buffer = new byte[1024];
        int bytesRead;
        while ((bytesRead = fileContent.read(buffer)) != -1) {
            outputStream.write(buffer, 0, bytesRead);
        }
        outputStream.close();
        fileContent.close();
        // 返回上传结果
        response.getWriter().write("文件上传成功：" + fileName);
    }
}

配置web.xml

在web.xml中，我们需要配置Servlet映射：

<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>

前端HTML表单

创建一个HTML表单,用于上传文件：

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

使用Apache Commons FileUpload实现文件上传

添加依赖

在项目中添加Apache Commons FileUpload的依赖：

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

创建FileUploadServlet

图片来源于网络，如有侵权联系删除

修改FileUploadServlet,使用Apache Commons FileUpload实现文件上传：

import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;
@WebServlet("/upload")
public class FileUploadServlet extends HttpServlet {
    private static final long serialVersionUID = 1L;
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        // 设置文件保存路径
        String uploadPath = getServletContext().getRealPath("/") + "uploads/";
        File uploadDir = new File(uploadPath);
        if (!uploadDir.exists()) {
            uploadDir.mkdirs();
        }
        // 创建FileUpload对象
        DiskFileItemFactory factory = new DiskFileItemFactory();
        ServletFileUpload upload = new ServletFileUpload(factory);
        // 解析请求
        List<FileItem> items = upload.parseRequest(request);
        for (FileItem item : items) {
            if (!item.isFormField()) {
                String fileName = item.getName();
                InputStream fileContent = item.getInputStream();
                // 保存文件
                File file = new File(uploadPath + fileName);
                OutputStream outputStream = new FileOutputStream(file);
                byte[] buffer = new byte[1024];
                int bytesRead;
                while ((bytesRead = fileContent.read(buffer)) != -1) {
                    outputStream.write(buffer, 0, bytesRead);
                }
                outputStream.close();
                fileContent.close();
            }
        }
        // 返回上传结果
        response.getWriter().write("文件上传成功");
    }
}

使用Spring MVC实现文件上传

添加依赖

在项目中添加Spring MVC和Spring Boot的依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

创建Controller

创建一个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;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
@RestController
public class FileUploadController {
    private static final String UPLOAD_DIR = "/uploads/";
    @PostMapping("/upload")
    public String uploadFile(@RequestParam("file") MultipartFile file) throws IOException {
        Path path = Paths.get(UPLOAD_DIR + file.getOriginalFilename());
        Files.copy(file.getInputStream(), path);
        return "文件上传成功：" + file.getOriginalFilename();
    }
}

配置文件上传

在application.properties或application.yml中配置文件上传路径：

spring.servlet.multipart.location=/uploads/

本文详细讲解了使用Java实现文件上传到服务器的三种方法：Servlet、Apache Commons FileUpload和Spring MVC，通过本文的学习，读者可以掌握文件上传的基本原理和实现方法，并根据实际需求选择合适的技术方案，本文还提供了完整的源码示例，方便读者参考和借鉴。