✝️ 🤘🏼 🥃 Prueba de las API web de ASP.NET Core 🏅 ✊🏼 👗

¡Hola, Khabrovites! Para los futuros estudiantes del curso "C # ASP.NET Core Developer", publicamos una traducción de un artículo útil.

API ASP.NET Core 2.1 Web API , . . API, , API.

InfoQ « -API ASP.NET Core». , , , , . , API . -API ASP.NET Core 2.1 .

GitHub .

-API ASP.NET Core

.NET ASP.NET Core. ASP.NET Core — -, , ASP.NET 1.0. , ASP.NET Core 2.1 - .

?

, . ( -). — « , , , .» : , , . , , . :

[Fact]
public async Task AlbumGetAllAsync()
{
    // Arrange

    // Act
    var albums = await _repo.GetAllAsync();

    // Assert
    Assert.Single(albums);
}

. — Arrange , , . , Arrange ( ). , Act, — , . Album, , . (Assert) . , .

xUnit. xUnit — .NET Framework .NET Core. xUnit .NET Core, .NET Core 2.1 SDK. Unit Test cli .NET Core dotnet test, xUnit Test IDE, Visual Studio 2017, Visual Studio Code JetBrain's Rider.

Figura 1: Creación de un nuevo proyecto de prueba unitaria en Visual Studio 2017 — 1: Unit Test Visual Studio 2017

-API ASP.NET Core.

-API?

API . , . , , . ? , 100%- . , , API , , ? ! , .

Chinook.API , ( ), , Domain Data . , ( ). , Domain Data , , . , , « ».

/ ?

, . , -API ASP.NET Core. API. , . , . , , . , Chinook.Domain (Album) ID 42, , , , (Artist). , , , .

«» (mocks ) . , , «» . , , . , .

, , , Unit Test . Chinook.MockData ( ). MockData Chinook.Data. , . , MockData (Dependency Injection — DI), Chinook.Domain , Chinook.Data, . . Data - .

: -API?

, -API ASP.NET Core, . , . , API , .

, API HTTP- . , API HTTP . API API Domain , , Data ( ).

- . xUnit . , xUnit Chinook.IntegrationTest, NuGet. Microsoft.AspNetCore.TestHost Chinook.IntegrationTest. , .

Figura 2: Agregar el paquete NuGet Microsoft.AspNetCore.TestHost — 2: NuGet Microsoft.AspNetCore.TestHost

API.

API , API, . (Entity) API. «Album».

API AlbumAPITest.cs. .

using Xunit;
using Chinook.API;
using Microsoft.AspNetCore.TestHost;
using Microsoft.AspNetCore.Hosting;

Figura 3: Prueba de integración mediante directivas — 3:

TestServer HttpClient. _client HttpClient, TestServer, AlbumAPITest. TestServer — -, Startup Chinook.API . Development. -, API, , , API TestServer. .

Figura 4: Nuestra primera prueba de integración para obtener todos los álbumes — 4:

, 4 . AlbumGetAllTestAsync , API . , , Arrange/Act/Assert. HttpRequestMessage HTTP-, InlineData, URI, («/api/Album/»). _client HttpClient HTTP-, , , , HTTP- , — 200 OK. 4 API. , , HTTP-.

response.EnsureSuccessStatusCode();
Assert.Equal(HttpStatusCode.OK, response.StatusCode);

, API. InlineData, AlbumGetTestAsync. , , URI HttpRequestMessage. 5.

Figura 5: Segunda prueba de integración para la entidad de álbum — 5: Album

, , Test Runner , . DevOps (Continuous Integration - CI) — API . , , , API , , API .

Figura 6: Ejecución de pruebas de integración en Visual Studio 2017 — 6: Visual Studio 2017

, , API, , -API ASP.NET Core.

"C# ASP.NET Core ". " GraphQL API ASP.NET Core" .

Prueba de las API web de ASP.NET Core

-API ASP.NET Core

?

-API?

/ ?

: -API?

More articles: