使用HTTP-REPL工具测试ASP.NET Core 2.2中的WEB API项目
今天,visual studio中没有内置工具来测试web api。使用浏览器,只能测试http get
请求。您需要使用postman,soapui,fiddler或swagger等第三方工具来执行web api的完整测试。在asp.net core 2.2中,引入了一个名为“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之间导航或切换并执行它。
下一篇: 第一册:lesson1-2.