Какво е RESTful и как се използва при разработката на…

RESTful е архитектурен стил за разработка на разпределени системи, като уеб услуги. Той се базира на принципите на REST (Representational State Transfer).

Основните принципи на REST:

Клиент-сървър: Ясно разделяне между клиента и сървъра.
Stateless (Без състояние): Сървърът не съхранява информация за състоянието на клиента между заявките. Всяка заявка съдържа цялата необходима информация.
Cacheable (Кешируем): Клиентите или междинните възли могат да кешират отговорите.
Layered System (Многослоен систем): Системата може да бъде организирана на слоеве, като всеки слой вижда само най-близкия до него.
Code-On-Demand (Код по искане - по избор): Сървърът може временно да разширява или конфигурира функционалността на клиента чрез пренос на изпълним код.
Uniform Interface (Единен интерфейс): Включва:
- Identification of Resources (Идентификация на ресурси): Ресурсите се идентифицират чрез URI.
- Manipulation of Resources through Representations (Манипулиране на ресурси чрез представяния): Клиентът взаимодейства с ресурса чрез неговото представяне (например JSON, XML).
- Self-descriptive Messages (Самоописващи се съобщения): Всяко съобщение съдържа достатъчно информация за обработка.
- Hypermedia as the Engine of Application State (HATEOAS - Гипермедия като двигател на състоянието на приложението): Отговорите на сървъра съдържат връзки към други ресурси, позволявайки на клиента да открива динамично достъпните действия и преходи.

В разработката на уеб услуги на C# RESTful архитектурата често се реализира с използване на ASP.NET Core Web API.

Пример за типично използване на RESTful в C#:

// Контролер за управление на ресурс "Продукт"
[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
    private readonly IProductRepository _productRepository;

    public ProductsController(IProductRepository productRepository)
    {
        _productRepository = productRepository;
    }

    // Получаване на всички продукти (GET /api/products)
    [HttpGet]
    public async Task<ActionResult<IEnumerable<Product>>> GetProducts()
    {
        var products = await _productRepository.GetAllAsync();
        return Ok(products);
    }

    // Получаване на продукт по ID (GET /api/products/{id})
    [HttpGet("{id}")]
    public async Task<ActionResult<Product>> GetProduct(int id)
    {
        var product = await _productRepository.GetByIdAsync(id);
        if (product == null)
        {
            return NotFound();
        }
        return Ok(product);
    }

    // Създаване на нов продукт (POST /api/products)
    [HttpPost]
    public async Task<ActionResult<Product>> CreateProduct(Product product)
    {
        await _productRepository.AddAsync(product);
        return CreatedAtAction(nameof(GetProduct), new { id = product.Id }, product);
    }

    // Актуализиране на съществуващ продукт (PUT /api/products/{id})
    [HttpPut("{id}")]
    public async Task<IActionResult> UpdateProduct(int id, Product product)
    {
        if (id != product.Id)
        {
            return BadRequest();
        }
        var existingProduct = await _productRepository.GetByIdAsync(id);
        if (existingProduct == null)
        {
            return NotFound();
        }
        await _productRepository.UpdateAsync(product);
        return NoContent();
    }

    // Изтриване на продукт (DELETE /api/products/{id})
    [HttpDelete("{id}")]
    public async Task<IActionResult> DeleteProduct(int id)
    {
        var product = await _productRepository.GetByIdAsync(id);
        if (product == null)
        {
            return NotFound();
        }
        await _productRepository.DeleteAsync(id);
        return NoContent();
    }
}

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
}

public interface IProductRepository
{
    Task<IEnumerable<Product>> GetAllAsync();
    Task<Product> GetByIdAsync(int id);
    Task AddAsync(Product product);
    Task UpdateAsync(Product product);
    Task DeleteAsync(int id);
}

Какво е RESTful и как се използва при разработката на уеб услуги?