W ASP.NET Core Web API kontrolery i akcje są kluczowymi elementami do tworzenia interfejsów API. Pozwalają one na przetwarzanie żądań HTTP i udzielanie odpowiedzi. Oto krótka charakteryzacja tych dwóch pojęć:

1. Kontrolery:
   • Kontroler to klasa w ASP.NET Core Web API, która obsługuje żądania HTTP od klientów.
   • Kontrolery są odpowiedzialne za przetwarzanie żądań i generowanie odpowiedzi, które są zwracane do klienta.
   • Kontroler to część aplikacji, która mapuje żądania HTTP na konkretne akcje.
   • Każdy kontroler jest odpowiedzialny za konkretne zadania lub obszar funkcjonalności w aplikacji.
   • Kontrolery są często nazwane zgodnie z rodzajem zasobów, które obsługują, na przykład "ProductsController" do obsługi produktów w sklepie internetowym.
2. Akcje:
   • Akcje to metody publiczne w kontrolerze, które obsługują konkretne rodzaje żądań HTTP, takie jak GET, POST, PUT lub DELETE.
   • Akcje są odpowiedzialne za przetwarzanie konkretnych żądań i generowanie odpowiedzi.
   • Każda akcja jest mapowana do określonej ścieżki URL i metody HTTP.
   • Przykładowe akcje to: GetAllProducts, CreateProduct, UpdateProduct, DeleteProduct, itp.
   • Akcje zazwyczaj zwracają obiekt ActionResult, który może reprezentować dane do zwrócenia jako odpowiedź HTTP, takie jak JSON lub widok HTML.

Przykład kontrolera i akcji w ASP.NET Core Web API:

[Route("api/[controller]")]
[ApiController]
public class ProductsController : ControllerBase
{
    private readonly IProductService _productService;

    public ProductsController(IProductService productService)
    {
        _productService = productService;
    }

    // Akcja do pobierania wszystkich produktów (HTTP GET)
    [HttpGet]
    public IActionResult GetAllProducts()
    {
        var products = _productService.GetAllProducts();
        return Ok(products);
    }

    // Akcja do tworzenia nowego produktu (HTTP POST)
    [HttpPost]
    public IActionResult CreateProduct([FromBody] ProductDto productDto)
    {
        if (productDto == null)
        {
            return BadRequest();
        }

        var newProduct = _productService.CreateProduct(productDto);
        return CreatedAtAction(nameof(GetProductById), new { id = newProduct.Id }, newProduct);
    }

    // Inne akcje do aktualizacji i usuwania produktów
}

W powyższym przykładzie ProductsController zawiera akcje do obsługi operacji CRUD (Create, Read, Update, Delete) dla produktów. Każda akcja jest opisana adresem URL i metodą HTTP, którą obsługuje, oraz generuje odpowiednie odpowiedzi.

Kontrolery i akcje są kluczowymi komponentami w tworzeniu interfejsów API w ASP.NET Core Web API, umożliwiając obsługę żądań HTTP i dostarczanie odpowiedzi klientom.

Materiały

Create web APIs with ASP.NET Core

Controller action return types in ASP.NET Core web API