计算机网络 / 系统课时

使用 HTTP 请求方法

使用 HTTP 请求方法

HTTP 方法不是“不同写法的同一请求”,而是在协议层声明客户端想读取、创建、整体替换、局部修改或删除资源。本课将用语义、是否安全和是否幂等三个维度选择方法,并通过本地程序验证七种常见方法。

学习目标

  • 说清 GET、POST、PUT、PATCH、DELETE、HEAD 与 OPTIONS 的核心语义
  • 根据安全性和幂等性判断请求能否重试
  • 为常见资源操作选择合适的方法

方法语义与安全性

HTTP 方法描述的是操作意图,不是服务器内部必须执行的代码。接口设计应让方法语义与资源变化一致,否则缓存、重试、监控和调用方都会得到错误信号。

方法 典型语义 安全 幂等
GET 获取资源或查询结果 是 是
POST 创建子资源或触发处理 否 通常否
PUT 用完整表示替换指定资源 否 是
PATCH 局部修改资源 否 不保证
DELETE 删除指定资源 否 是
HEAD 只获取与 GET 对应的响应头 是 是
OPTIONS 查询资源支持的通信选项 是 是

“安全”表示按协议语义不应改变资源状态;日志、计费统计等附带行为不影响这个判断。HEAD 的响应不包含消息体,OPTIONS 常通过 Allow 响应头说明可用方法。

幂等性与重试边界

幂等表示同一请求执行一次或多次,目标资源的最终状态相同。它不保证每次响应状态码、响应体或日志完全一致。例如,第一次 DELETE 可能返回 204,第二次可能返回 404,但资源仍处于“已删除”状态。

PUT 只有在请求表示完整目标状态时才符合典型语义。PATCH 是否幂等取决于补丁内容:把 status 设为固定值通常可幂等;执行“余额加 10”则会因重复调用产生不同结果。POST 创建订单等操作需要幂等键或业务去重,不能仅依赖方法名称。

本地验证七种方法

下面的 Python 程序启动一个本地 HTTP 服务,再依次发送七种请求。它只使用标准库,可直接保存为 http_methods_demo.py 后运行。

python
from http.server import BaseHTTPRequestHandler, HTTPServer
from threading import Thread
from urllib.request import Request, urlopen

HOST = "127.0.0.1"
PORT = 18080

class Handler(BaseHTTPRequestHandler):
    # 统一生成响应,便于比较方法差异。
    def reply(self, method: str, send_body: bool = True) -> None:
        body = f"method={method}".encode()
        self.send_response(200)
        self.send_header("Content-Type", "text/plain; charset=utf-8")
        self.send_header("Content-Length", str(len(body)))
        if method == "OPTIONS":
            self.send_header("Allow", "GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS")
        self.end_headers()
        if send_body:
            self.wfile.write(body)

    def do_GET(self): self.reply("GET")
    def do_POST(self): self.reply("POST")
    def do_PUT(self): self.reply("PUT")
    def do_PATCH(self): self.reply("PATCH")
    def do_DELETE(self): self.reply("DELETE")
    def do_HEAD(self): self.reply("HEAD", send_body=False)
    def do_OPTIONS(self): self.reply("OPTIONS")

    def log_message(self, format, *args):
        pass

# 后台线程承载服务,主线程负责发起请求并打印结果。
server = HTTPServer((HOST, PORT), Handler)
Thread(target=server.serve_forever, daemon=True).start()

# 对同一资源依次发送七种方法。
for method in ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]:
    request = Request(f"http://{HOST}:{PORT}/items/42", method=method)
    with urlopen(request) as response:
        body = response.read().decode()
        allow = response.headers.get("Allow", "-")
        print(f"{method}: status={response.status}, body={body or '<empty>'}, allow={allow}")

server.shutdown()

预期输出如下;若本机端口被占用,可修改 PORT 后重新运行。

text
GET: status=200, body=method=GET, allow=-
POST: status=200, body=method=POST, allow=-
PUT: status=200, body=method=PUT, allow=-
PATCH: status=200, body=method=PATCH, allow=-
DELETE: status=200, body=method=DELETE, allow=-
HEAD: status=200, body=<empty>, allow=-
OPTIONS: status=200, body=method=OPTIONS, allow=GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 HTTP 请求方法

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通