异常教程

HTTP 请求方法（保姆级教程）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

前言

在互联网的庞大生态系统中，HTTP 请求方法如同快递员手中的包裹单，决定了数据如何在网络中流动。无论是访问网页、提交表单，还是调用 API，HTTP 方法都是开发者与服务器对话的核心“语言”。对于编程初学者而言，理解这些方法如同掌握一门新语言的动词——它们决定了“动作”的意图和结果。本文将通过通俗的比喻、代码示例和实际场景，帮助读者系统掌握 HTTP 请求方法的原理与应用。

HTTP 的基础概念：网络通信的“交通规则”

什么是 HTTP？

HTTP（HyperText Transfer Protocol）是客户端（如浏览器）与服务器之间的通信协议，它定义了数据如何被请求、传输和接收。想象 HTTP 是一条高速公路，而 请求方法就是行驶在这条高速公路上的不同车辆（如小轿车、卡车、公交车），每种车辆对应不同的用途。

请求与响应的结构

一个完整的 HTTP 交互由三部分组成：

  1. 请求行：包含方法、路径和协议版本（如 GET /api/data HTTP/1.1）。
  2. 请求头：附加的元数据（如 Content-Type: application/json）。
  3. 请求体（可选）：仅在方法如 POST 中携带数据（如表单数据或 JSON）。

服务器收到请求后，会返回 状态码（如 200 OK）、响应头和响应体，形成完整的通信闭环。

主要 HTTP 请求方法详解

HTTP 标准定义了多种方法，其中 GET、POST、PUT、DELETE 是最常用的核心方法。以下将逐一解析它们的用途、语法及典型场景。

1. GET：获取资源的“快递员”

特点与使用场景

  • 用途：从服务器获取公开资源（如网页、图片、数据）。
  • 数据传输：参数通过 URL 的查询字符串（query string）传递（如 ?key=value）。
  • 安全性：数据暴露在 URL 中，不适合敏感信息（如密码）。

示例与代码

场景：用户查询天气信息，请求参数包括城市名和日期。

curl 命令示例：

curl "https://api.weather.com/data?city=Beijing&date=2023-10-01"

JavaScript 实现（Fetch API）：

fetch("https://api.weather.com/data?city=Shanghai", {  
  method: "GET",  
  headers: { "Content-Type": "application/json" },  
})  
  .then(response => response.json())  
  .then(data => console.log(data));

比喻：GET 方法如同快递员从仓库取出包裹并直接送达，无需额外操作。

2. POST：提交数据的“银行转账”

特点与使用场景

  • 用途：向服务器提交数据，常用于表单提交、创建资源（如注册用户、发布文章）。
  • 数据传输：数据放在请求体（request body）中，支持更大数据量。
  • 安全性：相比 GET，参数不暴露在 URL 中，适合敏感信息。

示例与代码

场景：用户注册新账号，需提交用户名、密码和邮箱。

curl 命令示例：

curl -X POST \  
  https://api.example.com/register \  
  -H "Content-Type: application/json" \  
  -d '{"username": "john_doe", "password": "secure_password", "email": "john@example.com"}'

Python 实现（Requests 库）：

import requests  

data = {  
    "username": "alice",  
    "password": "strong_password",  
    "email": "alice@example.com"  
}  
response = requests.post("https://api.example.com/register", json=data)  
print(response.status_code)

比喻：POST 方法如同银行转账，用户将资金（数据）通过安全通道发送到指定账户（服务器端点）。

3. PUT：覆盖资源的“完全替换”

特点与使用场景

  • 用途：向指定资源路径发送数据，完全替换现有内容。
  • 幂等性：多次相同的 PUT 请求效果等同于一次，适合更新资源。

示例与代码

场景：用户更新个人资料，需替换整个用户信息。

curl 命令示例：

curl -X PUT \  
  https://api.example.com/users/123 \  
  -H "Content-Type: application/json" \  
  -d '{"username": "alice", "email": "new_email@example.com"}'

Node.js 实现（Axios 库）：

const axios = require("axios");  

axios.put("https://api.example.com/users/123", {  
  username: "bob",  
  email: "bob@company.com"  
})  
.then(response => console.log("Update successful"));

比喻：PUT 方法如同用新书完全替换旧书，而非修补旧书的内容。

4. DELETE：删除资源的“粉碎机”

特点与使用场景

  • 用途：删除指定路径的资源。
  • 幂等性：多次请求效果一致，但需注意业务逻辑中的“软删除”。

示例与代码

场景：用户删除个人账户。

curl 命令示例：

curl -X DELETE https://api.example.com/users/123

JavaScript 实现（Fetch API）：

fetch("https://api.example.com/users/456", {  
  method: "DELETE"  
})  
  .then(response => console.log("Resource deleted"));

比喻：DELETE 方法如同将文件投入粉碎机，不可逆地移除资源。

其他 HTTP 方法：扩展与补充

5. HEAD：获取元数据的“快递单预览”

  • 用途：获取资源的响应头，而不返回主体内容。
  • 场景：检查资源是否存在或验证缓存状态。

6. OPTIONS：查询支持方法的“菜单查询”

  • 用途：获取服务器支持的请求方法列表。
  • 场景：前端在调用 API 前，确认服务器是否支持某方法。

7. PATCH：部分更新的“精准修补”

  • 用途：与 PUT 类似，但仅修改资源的部分字段。
  • 语法：需遵循 RFC 6902 或 RFC 6903 标准。

示例（JSON Patch）：

[  
  { "op": "replace", "path": "/email", "value": "new_email@example.com" }  
]

各方法的对比与选择指南

以下表格总结了核心方法的特性，帮助开发者快速决策：

方法安全性幂等性数据位置适用场景
GET高是URL获取公开资源
POST中否请求体提交敏感数据、创建资源
PUT高是请求体全量更新资源
DELETE高是无删除资源

选择原则：

  • GET：仅读取，参数简单且不敏感。
  • POST：提交新数据或敏感操作。
  • PUT/PATCH：更新资源（全量 vs 部分）。
  • DELETE：明确删除操作。

实战案例：电商系统的 API 设计

假设我们开发一个电商系统，以下是不同方法的典型应用：

场景 1：获取商品列表（GET）

curl "https://api.ecommerce.com/products?category=laptops&page=2"

场景 2：创建新订单（POST）

{  
  "user_id": 789,  
  "items": [  
    {"product_id": 101, "quantity": 2}  
  ]  
}

场景 3：更新用户地址（PUT）

curl -X PUT \  
  https://api.ecommerce.com/users/789/address \  
  -d '{"street": "123 Main St", "city": "New York"}'

场景 4：取消订单（DELETE）

curl -X DELETE https://api.ecommerce.com/orders/456

结论

掌握 HTTP 请求方法如同获得一把钥匙，能够解锁互联网的底层逻辑。从 GET 的“查询”到 POST 的“提交”，再到 PUT 和 DELETE 的“更新与删除”，每种方法都在特定场景中发挥独特作用。开发者需结合安全性、幂等性及业务需求，合理选择方法以构建健壮的 API。

随着实践深入，建议进一步探索 HTTP 状态码、身份验证（如 OAuth）、以及 RESTful 设计原则。记住：HTTP 不仅是一套技术规范，更是开发者与服务器“对话”的艺术——选择合适的方法，让数据流动更高效、更安全。

通过本文的系统讲解，希望读者能够将理论转化为代码实践，真正理解 HTTP 请求方法的核心价值。

最新发布

查看更多文章