java 实现文件的上传下载

精选原创

小飞侠格鲁帅 2024-12-24 08:49:04 ©著作权

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

以下是使用 Java 实现文件上传和下载的基本示例代码，分别基于常见的 Web 应用场景（使用 Servlet 等技术）来介绍，这里假设使用的是 Java 的 Servlet 规范结合 Apache Commons FileUpload 组件来处理文件上传，使用简单的文件流来实现文件下载。

文件上传示例

添加依赖（如果使用 Maven 项目）
在pom.xml文件中添加以下依赖：

<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 javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.commons.fileupload.FileItem;
import org.apache.commons.fileupload.FileUploadException;
import org.apache.commons.fileupload.disk.DiskFileItemFactory;
import org.apache.commons.fileupload.servlet.ServletFileUpload;
import java.io.File;
import java.io.IOException;
import java.util.List;

@WebServlet("/upload")
public class FileUploadServlet extends HttpServlet {

    private static final long serialVersionUID = 1L;
    private static final String UPLOAD_DIRECTORY = "uploads";  // 上传文件保存的目录（相对路径，实际中可根据需求调整）

    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        if (!ServletFileUpload.isMultipartContent(request)) {
            response.getWriter().println("Error: 表单不是multipart/form-data类型");
            return;
        }

        // 创建文件项工厂
        DiskFileItemFactory factory = new DiskFileItemFactory();

        // 创建文件上传处理器
        ServletFileUpload upload = new ServletFileUpload(factory);

        try {
            // 解析请求中的文件项
            List<FileItem> items = upload.parseRequest(request);
            for (FileItem item : items) {
                if (item.isFormField()) {
                    // 处理普通表单字段（这里可以忽略，主要关注文件上传部分）
                } else {
                    // 获取文件名
                    String fileName = item.getName();
                    // 处理文件名（例如去除路径信息等，只保留文件名本身）
                    fileName = fileName.substring(fileName.lastIndexOf(File.separator) + 1);
                    // 构建保存文件的完整路径
                    String uploadPath = getServletContext().getRealPath("") + File.separator + UPLOAD_DIRECTORY + File.separator + fileName;
                    File uploadedFile = new File(uploadPath);
                    // 保存文件到服务器指定位置
                    item.write(uploadedFile);
                }
            }
            response.getWriter().println("文件上传成功");
        } catch (FileUploadException | Exception e) {
            response.getWriter().println("文件上传失败: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

上述代码实现了一个简单的 Servlet，用于处理文件上传。它首先判断请求是否是multipart/form-data类型（适合文件上传的表单类型），然后使用Apache Commons FileUpload组件解析请求中的文件项，将获取到的文件保存到服务器指定的目录中（这里是相对路径uploads目录，可根据实际情况调整为绝对路径等）。

文件下载示例

编写 Servlet 类用于处理文件下载

import javax.servlet.ServletException;
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.FileInputStream;
import java.io.IOException;
import java.io.OutputStream;

@WebServlet("/download")
public class FileDownloadServlet extends HttpServlet {

    private static final long serialVersionUID = 1L;

    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        // 假设要下载的文件在服务器上的相对路径（这里可根据实际情况修改为真实的文件路径，也可以从请求参数等获取具体要下载的文件名等信息）
        String filePath = "uploads" + File.separator + "example.txt";
        File file = new File(getServletContext().getRealPath("") + File.separator + filePath);
        if (file.exists()) {
            // 设置响应头，告诉浏览器这是一个文件下载，以及文件名等信息
            response.setContentType("application/octet-stream");
            response.setHeader("Content-Disposition", "attachment; filename=\"" + file.getName() + "\"");
            // 获取文件输入流
            FileInputStream fis = new FileInputStream(file);
            // 获取响应输出流
            OutputStream os = response.getOutputStream();
            byte[] buffer = new byte[1024];
            int bytesRead;
            while ((bytesRead = fis.read(buffer))!= -1) {
                os.write(buffer, 0, bytesRead);
            }
            fis.close();
            os.flush();
            os.close();
        } else {
            response.getWriter().println("要下载的文件不存在");
        }
    }
}

这段代码实现了一个简单的文件下载 Servlet。它首先根据指定的文件路径（这里是相对路径示例，实际中可灵活调整获取方式）判断文件是否存在，如果存在则设置合适的响应头信息（告知浏览器这是文件下载以及文件名等），然后通过文件输入流读取文件内容，并通过响应输出流将内容发送给浏览器，实现文件下载功能。

请注意：

上述代码只是简单示例，在实际应用中，需要考虑更多的异常处理、安全校验（比如文件类型验证、防止恶意文件上传等）、性能优化以及更灵活的配置（例如文件存储路径配置等）情况。
对于文件上传，要确保服务器端有足够的权限来创建文件和写入内容到指定的上传目录。
对于文件下载，要根据实际需求准确获取要下载的文件路径以及合理设置响应头信息等。