做网站能申报只是产权么,泰州seo网站推广,logo查询网站,网页开发网站在本文中#xff0c;我们将研究如何测试你的 ASP .NET Core 2.0 Web API 解决方案。我们将了解使用单元测试进行内部测试#xff0c;使用全新的 ASP .NET Core 的集成测试框架来进行外部测试。本文要点正确理解并使用单元测试和你的 ASP .NET Core Web API 解决方案一样重要。… 在本文中我们将研究如何测试你的 ASP .NET Core 2.0 Web API 解决方案。我们将了解使用单元测试进行内部测试使用全新的 ASP .NET Core 的集成测试框架来进行外部测试。本文要点正确理解并使用单元测试和你的 ASP .NET Core Web API 解决方案一样重要。了解并使用模拟数据进行单元测试可以帮助你获得稳定的测试场景。为 ASP .NET Core Web API 解决方案在 .NET Core 2.1 中创建模拟数据项目。了解并设置集成测试来从外部测试 API这样可以帮助完整测试 ASP .NET Core 2.1 Web API 解决方案。.NET Core 最初是在 2016 年发布的随着 .NET Core 2.0 的发布微软拥有了下一个通用、模块化、跨平台和开源的平台主版本。.NET Core 已经创建了许多 API在当前版本的 .net 框架中均可用。它最初是为下一代 ASP .NET 解决方案而创建的但现在成了许多其他场景的驱动和基础包括物联网、云计算和下一代移动解决方案。在本系列文章中我们将探讨 .NET Core 的一些好处以及它如何不仅能使传统的 .NET 开发人员受益还能使所有需要为市场带来健壮、高效和经济的解决方案的技术人员受益。在使用 ASP .NET Core 2.1 Web API 构建并开发一组丰富的 API 的时候需要记住这只是实现稳定且高效的解决方案的第一步。为你的解决方案提供一个稳定的环境是非常重要的。获得优秀的解决方案不仅需要完整地构建 API还需要严格地测试你的 API保证用户有良好的体验。这篇文章是我之前为 InfoQ 写的《针对 ASP.NET Core Web API 的先进架构》的后续文章。请放心你不需要阅读另外一篇文章就可以从这篇文章了解到如何从测试中获得好处但读一下那篇文章可以帮助你更多了解我是如何构建我讨论的解决方案的。在过去的几年里我花了大量时间来思考在为客户构建 API 时进行测试。了解 ASP .NET Core 2.1 Web API 的架构可以帮助拓宽你的了解。本篇文章中的例子的解决方案和所有代码都可以在我的GitHub 库中找到。ASP .NET Core Web API 快速入门让我们一起来快速了解一下 .NET 和 ASP .NET Core。ASP .NET Core 是 Microsoft 创造的全新 Web 框架以便摆脱自 ASP .NET 1.0 以来一直存在的遗留技术。ASP .NET Core 2.1 摆脱这些遗留依赖从头开始开发框架因此可以给开发人员提供更高的性能并且它是为跨平台执行而构建的。什么是单元测试对有些人来说测试你的软件可能是一个新的概念但是它很简单。我们从单元测试开始。维基百科对于它的严格定义是“是一种软件测试方法对源代码的独立单元、一组或多组计算机程序模块以及相关的控制数据、使用程序和操作程序都进行测试以了解它们是否适合使用”。我比较喜欢的是一个外行的解释单元测试是保证在你添加了新的功能或进行了缺陷修复之后你的解决方案中的代码能像预期一样执行。我们测试了一个简单的代码示例来保证它符合我们的预期。让我们来看一下单元测试示例复制代码[Fact]public async Task AlbumGetAllAsync(){// Arrange// Actvar albums await _repo.GetAllAsync();// AssertAssert.Single(albums);}优秀的单元测试有三个部分组成。第一个是Arrange的部分用来设置测试中可能需要的任何资源。在上面的例子中我没有进行任何设置所以 Arrange 的部分是空的 (但我还是为它保留了注释)。第二个部分是Act的部分用来执行测试的部分。在我们的例子中我调用数据库中的专辑实体类型返回当前使用的库中的数据源完整的专辑实体。单元测试的最后一个部分是Assert的部分用来验证待测试的操作是否正确。对于该测试我检验是否从数据库中返回了一个专辑。在本文中我会使用 xUnit 工具进行单元测试。xUnit 是 .NET Framework 和现在的 .NET Core 的开源包。我们需要 .NET Core 版本的 xUnit在你安装 .NET Core 2.1 SDK 的时候就已经直接获得了。你可以通过 .NET Core cli 指令 dotnet test或是通过你喜欢的 IDE如 Visual Studio 2017、Visual Studio Code 或 JetBrain 的 Rider.中的项目模板来创造新的单元测试项目。图 1在 Visual Studio 2017 中创建新的单元测试项目现在让我们深入到测试你的 ASP .NET Core Web API 解决方案的单元测试中来。Web API 要单元测试一些什么我非常支持使用单元测试来为你的客户保证稳定和健壮的 API。但我清楚地知道要如何使用单元测试知道要测试什么东西。我相信你要恰到好处地对解决方案进行单元测试而不要做多余的测试。这是什么意思呢可能我的观点会引发很多评论但是我不太注重要 100% 覆盖你的测试。我是否认为我们需要能覆盖 API 解决方案重要部分的测试单独隔开每个区域保证每个代码段都是正确的当然我会这么做这也是我想要讨论的。由于我们的示例 Chinook.API 很小并且可以通过集成测试来完成测试本文稍后讨论我发现在 Domain 和 Data 项目中我最关注单元测试。我不会详细讨论单元测试的方法因为这个问题超出了本文讨论的范围。我想要让你不依赖于生产数据库的数据从而在 Domain 和 Data 项目中进行更多的测试。这是我们下一个要讨论的问题模拟数据和对象。为什么在单元测试中使用模拟数据和对象我们已经讨论了为什么我们要进行单元测试单元测试一些什么内容。接下来了解如何准确地单元测试 ASP .NET Core Web API 解决方案是非常重要的。数据是测试 API 的重点。测试可预测的数据集是非常重要的。这就是为什么我不推荐使用生产数据或者其他可能随着时间根据你的了解和认知会改变的数据。我们需要稳定的数据集来保证所有单元测试的运行确保代码段之间的测试是相同的。比如说在我测试 Chinook.Domain 项目的时候我想要得到 ID 是 42 的专辑我需要保证它的确存在并拥有类似专辑名称这样的细节和一条艺术家数据有关联关系。我还希望确保在我从数据源中得到一系列专辑时大小满足我编写的单元测试。许多业内人士使用“模拟数据”这一术语来表示这一类数据。有很多为单元测试产生模拟数据的方法我希望你能创造出尽可能“真实”的数据集。你给测试创造的数据越好测试效果也会越好。我会建议你确保数据没有隐私问题不包含公司或客户的个人数据或敏感数据。要满足我们对于干净、稳定数据的需求我单独创建了一个项目封装了单元测试项目的模拟数据。让我们称其为 Chinook.MockData就像你能在示例中看到的一样。我的 MockData 项目几乎和 Chinook.Data 项目相同。它们都拥有相同数量的数据库都和相同的接口依附。我希望 MockData 项目存储在依赖注入 (DI) 容器中这样 Chinook.Domain 项目就可以像连接到了生产数据源那样得到使用。这就是为什么我很喜欢依赖注入。它可以帮助我通过配置切换 Data 项目而不需要做任何代码变更。集成测试什么是针对 Web API 的新测试在我们为 ASP .NET Core Web API 解决方案执行并验证了单元测试之后我们要看一个完全不同类型的测试。我希望单元测试可以验证并确保对解决方案内部组件的期望。当我们对内部测试的质量满意的时候我们需要从外部接口进行 API 测试这就是我们所说的集成测试。集成测试需要在所有的组件完成的时候编写并执行所以你的 API 可以通过正确的 HTTP 响应来验证。单元测试时测试的是单独隔离开的代码段而集成测试时测试的是 HTTP 端点上每个 API 的整体逻辑。测试将会遵循 API 的完整工作流从 API 项目的控制器到域项目管理器最后到 Data 项目的库返回来响应。创造集成测试项目要使用你现有的测试知识集成测试功能是基于现有的单元测试库的。我将使用 xUnit 来创造我的集成测试。在我们创建了名为 Chinook.IntegrationTest 的新 xUnit 测试项目之后我们需要添加合适的 NuGet 包。将 Microsoft.AspNetCore.TestHost 包添加到 Chinook.IntegrationTest 项目中来。这个包中包含了执行集成测试的资源。图 2添加 Microsoft.AspNetCore.TestHost NuGet 包接下来我们可以创建第一个集成测试来从外部验证我们的 API。创建第一个集成测试要想进行我们解决方案中的所有 API 外部测试我要创建一个名为 API 的文件夹其中包含了测试。我还需要在 API 域中给每个实体类型创建新的测试类。我们的首个集成测试将会覆盖专辑实体类型。在 API 文件夹中创建新的类 AlbumAPITest.cs。之后我们会在文件中添加如下的命名空间。复制代码using Xunit;using Chinook.API;using Microsoft.AspNetCore.TestHost;using Microsoft.AspNetCore.Hosting;图 3使用指令进行集成测试现在我们要使用 TestServer 来设置类使用 HttpClient 来执行测试。我们需要名为 _client类型为 HttpClient 的私有变量它是基于在 AlbumAPITest 类中的构造函数中初始化的 TestServer 而创建的。TestServer 是小型 web 服务器的包装器是基于 Chinook.API Startup 和需要的开发环境创建的。在这个例子中我使用开发环境。我们现在具备了运行 API 的 web 服务器以及了解如何在 TestServer 中调用 API 的客户端。我们可以开始编写集成测试代码了。图 4我们第一个集成测试获得所有的专辑除了构造函数代码之外图 4 中还展示了第一个集成测试的代码。AlbumGetAllTestAsync 方法将会测试验证从 API 获取所有专辑的调用。就像之前讨论的单元测试一样集成测试的逻辑也是用了 Arrange、Act 和 Assert。我们首先创建 HttpRequestMessage 对象其中 HTTP 作为 InlineData 注释中的变量而提供URI 部分表示对于所有的专辑的调用 (“/api/Album/”)。之后我们会让 HttpClient _client 发送 HTTP 请求最后我们会检查验证 HTTP 响应是否满足我们的期望在本例中是 200。图 4 中我展示了两种检验 API 调用的方法。你可以使用其中任意一种但我更喜欢第二种方法因为它允许我用相同的模式来检验对特定 HTTP 响应代码的响应。 response.EnsureSuccessStatusCode();Assert.Equal(HttpStatusCode.OK, response.StatusCode);我们还可以创建需要从 API 测试特定实体键的集成测试。对于这类测试我们需要在 InlineData 注释中添加额外的值将会通过 AlbumGetTestAsync 方法参数传递。我们的新测试会使用相同的逻辑并使用和之前测试一样的资源但是我们为 HttpRequestMessage 对象在 API URI 端中传递实体键。你可以在图 5 中查看代码。图 5专辑的第二个集成测试在你为测试 API 创造了所有集成测试之后需要通过 Test Runner 来运行它们并保证它们全部通过。你创建的所有测试也可以在 DevOps 持续集成CI过程中执行这样可以在整体开发和部署过程中测试你的 API。现在需要有执行路径保证你的 API 在开发、质量保证和部署阶段都得到测试和维护让你的 API 使用者拥有良好体验的同时不发生意外情况。图 6在 Visual Studio 2017 中运行集成测试结论拥有良好设计的一套测试计划使用单元测试来做内部测试使用集成测试来验证 API 调用就和开发 ASP .NET Core Web API 阶段创建架构是一样重要的。本文作者Chris Woodruff (Woody) 拥有密歇根州立大学工程学院的计算机科学学位。Woody 已经开发和架构软件解决方案超过 20 年并且曾经致力于许多不同的平台和工具。他是一个社区领袖为 GRDevNight、GRDevDay、West Michigan Day of .NET 和 CodeMash 之类的活动贡献过力量。他还帮助把广受欢迎的 Give Camp 活动带到西密歇根那里的技术专业人士提供他们的时间和发展专业知识以帮助当地的非营利组织。作为一个演讲者和播客作者Woody 演讲和讨论过很多话题包括数据库设计和开源。他在 Visual C#、数据平台和 SQL 方面一直是微软的 MVP并在 2010 年被公认为全球最优秀的 20 个 MVPs 之一。Woody 是 JetBrains 的开发者并且在北美推广 .NET、.NET Core 和 JetBrains 的产品。.NET Core 最初是在 2016 年发布的随着 .NET Core 2.0 的发布微软拥有了一个通用、模块化、跨平台和开源的平台主版本。.NETCore 已经创建了许多 API在当前版本的 .net 框架中均可用。它最初是为下一代 ASP .NET 解决方案而创建的但现在成了许多其他场景的驱动和基础包括物联网、云计算和下一代移动解决方案。在本系列文章中我们将探讨 .NET Core 的一些好处以及它如何不仅能使传统的 .NET 开发人员受益还能使所有需要为市场带来健壮、高效和经济的解决方案的技术人员受益。原文地址:https://www.infoq.cn/article/4Z59Jy7ptKNERdv-o8Qp.NET社区新闻深度好文欢迎访问公众号文章汇总 http://www.csharpkit.com
