今天,Visual Studio中没有内置工具来测试WEB API。使用浏览器,只能测试http GET
请求。您需要使用,,或等第三方工具来执行WEB API的完整测试。在,引入了一个名为“http-repl”的基于CLI的新dotnet核心全局工具,用于与API端点交互。它是一个基于CLI的工具,可以列出所有路由并执行所有HTTP动词。在这篇文章中,让我们了解如何使用HTTP-REPL工具在ASP.NET Core 2.2中测试WEB API。
“http-repl”是一个dotnet核心全局工具,要安装此工具,请运行以下命令。
dotnet tool install -g dotnet-httprepl --version 2.2.0-* --add-source https://dotnet.myget.org/F/dotnet-core/api/v3/index.json
安装后,您可以使用以下命令验证安装。
dotnet tool list -g
1.现在安装了已经成功安装了这个程序,那么我们将要创建一个WebApi项目,来用于该工具的测试。
2.我们需要将此工具添加到Web浏览器列表中,以便我们可以使用此工具浏览API。为此,请按照下图中给出的步骤操作。
在宇宙最强IDE中依次打开这几个窗口,并设置浏览器位置。
HTTP-REPL工具可执行文件的位置是 "C:\Users\<username>\.dotnet\tools" 添加后,您可以在浏览器列表中进行验证。参数可以为空,名称随便。
运行应用程序(确保在浏览器列表中选择了HTTP REPL),您应该看到一个命令提示符窗口。正如前面提到的,这是一个基于命令行的工具,所以你可以用这样的命令dir
,ls
,cd
和cls
。下面是我启动Web API的示例运行。
这是一个简单的get 请求。
您可以使用所有HTTP谓词,并且在使用POST
动词时,您应该设置默认文本编辑器以提供JSON。您可以使用以下命令将Visual Studio代码设置为默认文本编辑器。
pref set editor.command.default "C:\Program Files (x86)\Microsoft VS Code\Code.exe" //当然你也可以手动设置(这个路径有可能不一样)
设置默认编辑器并触发POST
动词后,它将启动编辑器并为您编写JSON。见下面的GIF。
您还可以通过执行ui
命令从命令提示符导航到Swagger UI .
当您触发PUT
命令时,行为与POST
动词相同。文本编辑器将打开并为您编写JSON,只提供执行PUT
命令的更新值。
最后:
在玩了一段时间之后,我强烈地感觉它是Swagger UI的命令行版本,当有许多API端点时它会非常方便。您可以轻松地在API之间导航或切换并执行它。