asp.net core 8 中 .http 文件介绍

最新推荐文章于 2024-05-20 09:08:13 发布

dotNET跨平台

最新推荐文章于 2024-05-20 09:08:13 发布

阅读量331

点赞数

文章标签： asp.net http 后端网络协议网络

原文链接：https://mp.weixin.qq.com/s?__biz=MzAwNTMxMzg1MA==&mid=2654098462&idx=3&sn=65e8153b642f30f8a5718a7bf5140012&chksm=81bb2abddf18ace8c222eefef409b6a243cdbefda912862738e36ef7fa85f08e44804a4002d3&scene=126&sessionid=0

版权

今天冬至，你吃饺子了么? 学会 asp.net core 8 中的 .http 文件配置编写，吃饺子啧香，不信你试试。

.http 文件介绍

.http 是 Visual Studio 2022 17.6 版本或者更高版本提供的一种便捷的方式来测试 ASP.NET Core 项目的一种文本编辑器，主要用于测试 Web API。类似 swagger、k4 ui、postman 这类可以发起 HTTP 请求的工具，只不过需要我们自己编写相关的调试代码。

.http 文件和 Visual Studio Code 的 REST Client 插件一样，但 .http 文本编辑器只包含了一些常规的功能，没有 REST Client 插件的功能丰富。在 Visual Studio 2022 中可以以 .http 结尾，也可以以 .rest 文件格式结尾。

.http 文件式例

.http 文件语法介绍

1. 注释

以 # 或者 // 开头的语句是注释行：

# 注释1
// 注释2

2. 创建变量

定义格式：@VariableName=Value；
使用格式：{{VariableName}}，类似 vue、angular 中的插值表达式；

@hostname=localhost
@port=5000
Get http://{{hostname}}:{{port}}/weatherforecast

还可以将两个变量拼接后保存到一个变量中：

@hostname=localhost
@port=5000
@host={{hostname}}:{{port}}
Get http://{{host}}/weatherforecast

3. 请求

格式：HTTPMethod URL [HTTPVersion]，全部在一行上，中间用空格隔开。

Get http://localhost:5000/weatherforecast

HTTPMethod 表示要发起的 HTTP 谓词方法，支持：

- OPTIONS
  - GET
  - HEAD
  - POST
  - PUT
  - PATCH
  - DELETE
  - TRACE
  - CONNECT

URL 表示发起 HTTP 请求的 URL 地址，这里的 URL 不仅仅是你自己项目的 API，可以是任何可以访问到的 API，例如可以是：https://www.baidu.com；
HTTPVersion 是可选的，指定应使用的 HTTP 版本，即 HTTP/1.1、HTTP/1 或 HTTP/3；

一个 .http 文件中包含多个请求时使用 ### 作为分隔符：

GET http://localhost:5000/weatherforecast/getlist

###

GET http://localhost:5000/weatherforecast/getlist?id=1

###

GET http://localhost:5000/weatherforecast/getlist HTTP/3

###

建议每个请求下都加上 ###，它表示一个完整的请求块，即使是单个请求。

4. 请求头

请求头的语句紧接在请求行的后面一行，请求行和请求头之间不能包含空白行，请求头之间也不能有空白行。

GET http://localhost:5000/weatherforecast/getlist
Accept: application/json
Content-Type: application/json
Authorization：Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

###

上面的示例中，在 HTTP 请求头中设置 Accept、Content-Type、Authorization 等参数。

5. 请求正文

在请求头后面添加请求正文：

POST http://localhost:5000/weatherforecast/add
Accept: application/json
Content-Type: application/json
Authorization：Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

{
 "date": "2023-05-10",
    "temperatureC": 30,
    "summary": "Warm"
}

###

上面的示例中，{date:"2023-05-10","temperatureC":30,"summary":"Warm"} 为 POST 请求的请求参数。

6. 使用 .http 文件

如果是调试本地接口，则先点击调试，这里的调试和VS菜单栏的运行按钮的功能是一样，然后点击 发送请求。
如果是调试远程接口，则直接点击 发送请求。

调用示例如下：

.http 文件调试式例

右侧窗口为调用接口后的响应结果，其中：

- Status：接口调用状态，200 OK表示响应成功
- Time：1118.16ms，接口响应时间为1118.16毫秒
- Size：26 bytes，响应内容大小为26 bytes
- Formatted：格式化后的响应结果体
- Raw：原始的响应结果体
- Headers：响应头
- Request：本次请求的请求信息，包括请求地址，请求头，请求体等信息