HTTP POST与PUT工作原理解析及PUT请求替代POST的实现方法

一、POST与PUT的核心工作机制 #

• POST：非幂等请求，用于向服务端的集合资源提交数据，由服务端决定资源的存储位置/后续处理逻辑。常见场景包括提交表单、创建新的未指定ID的资源、触发业务流程。重复发送相同的POST请求，会导致多次创建资源或执行业务逻辑，产生额外副作用。
• PUT：幂等请求，用于向客户端指定的具体资源URI上传/全量更新资源，客户端明确控制资源的存储位置。重复发送相同的PUT请求，最终服务端的资源状态与单次请求执行后的状态完全一致，不会产生额外副作用。

二、PUT替代POST的实现方案 #

如果是静态文件上传、指定位置资源更新这类业务，完全可以用PUT替代POST实现，核心是在服务端处理逻辑中适配PUT请求的幂等特性，直接根据请求URI定位资源位置，用请求体内容覆盖对应资源。

基于你提供的StaticFileHandler，改造后支持PUT请求的代码如下：

import java.nio.file.StandardCopyOption;

public class StaticFileHandler implements HttpHandler {

    private final String baseDir;

    public StaticFileHandler(String baseDir) {
        this.baseDir = baseDir;
    }

    @Override
    public void handle(HttpExchange ex) throws IOException {
        String method = ex.getRequestMethod();
        File path = new File(Config.getInstance().getFile_path() + Config.getInstance().getFile_name());
        Headers h = ex.getResponseHeaders();
        h.add("Content-Type", Config.getInstance().getContent_type());
        OutputStream out = ex.getResponseBody();

        // 处理GET请求（原有逻辑）
        if ("GET".equals(method)) {
            if (path.exists()) {
                ex.sendResponseHeaders(200, path.length());
                out.write(Files.readAllBytes(path.toPath()));
            } else {
                System.err.println("File not found: " + path.getAbsolutePath());
                ex.sendResponseHeaders(404, 0);
                out.write("404 File not found.".getBytes());
            }
        }
        // 新增PUT请求处理逻辑，可替代POST实现文件上传
        else if ("PUT".equals(method)) {
            boolean fileExisted = path.exists();
            // 读取请求体的文件内容写入到目标路径，重复执行不会产生额外资源
            try (InputStream in = ex.getRequestBody()) {
                Files.copy(in, path.toPath(), StandardCopyOption.REPLACE_EXISTING);
            }
            // 符合HTTP规范：新建资源返回201，覆盖已有资源返回200
            int statusCode = fileExisted ? 200 : 201;
            ex.sendResponseHeaders(statusCode, -1);
            out.write(("File " + (fileExisted ? "updated" : "created") + " successfully").getBytes());
        }
        // 不支持的请求方法返回405
        else {
            ex.sendResponseHeaders(405, 0);
            out.write("405 Method Not Allowed".getBytes());
        }
        out.close();
    }
}

改造说明 #

• 保留了原有GET请求读取静态文件的逻辑不变
• 新增PUT处理逻辑完全符合幂等要求，重复上传相同文件到同一地址，最终文件状态和单次上传完全一致，可直接替代POST实现文件上传类业务
• 严格遵循HTTP协议状态码规范，不同处理场景返回对应响应标识

内容的提问来源于stack exchange，提问作者Dincher Selimov