计算机网络 / 系统课时
使用 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按自己的节奏,确认真正理解。