ASP.NET Core

控制器是一個繼承自 ControllerBase 的類別，[ApiController] 屬性會啟用多項便利功能，例如自動模型驗證 (返回 400 Bad Request) 和更詳細的問題描述。

using Microsoft.AspNetCore.Mvc;
using System.Collections.Generic;
using System.Linq;

[Route(“api/[controller]”)] // 定義路由範本為 /api/products
[ApiController]
public class ProductsController : ControllerBase
{
    // 使用靜態列表模擬資料庫
   private static List<Product> _products = new List<Product>
   {
       new Product { Id = 1, Name = “無線耳機”, Price = 99.99m },
       new Product { Id = 2, Name = “智慧手錶”, Price = 199.99m }
    };

    // 1. 獲取資源 (GET) api/products
   [HttpGet]
   public ActionResult<IEnumerable<Product>> Get()
   {
        return Ok(_products); // 返回 200 OK 狀態碼與所有產品列表
    }

    // GET api/products/1
   [HttpGet(“{id}”)]
   public ActionResult<Product> Get(int id)
   {
       var product = _products.FirstOrDefault(p => p.Id == id);
       if (product == null)
       {
            return NotFound(); // 若找不到，返回 404 Not Found
       }
        return Ok(product); // 找到產品，返回 200 OK
    }

    // 2. 創建資源 (POST) api/products
   [HttpPost]
   public IActionResult Post([FromBody] Product newProduct)
   {
       if (newProduct == null || string.IsNullOrEmpty(newProduct.Name))
       {
           return BadRequest(“產品名稱不可為空。”);
       }

       newProduct.Id = _products.Any() ? _products.Max(p => p.Id) + 1 : 1;
       _products.Add(newProduct);

      // 返回 201 Created，這是 RESTful API 的最佳實踐
    // 它告訴客戶端資源已成功創建，並在 Location 標頭中提供新資源的 URL
       return CreatedAtAction(nameof(Get), new { id = newProduct.Id }, newProduct);
    }

    // 3. 更新資源 (PUT) api/products/1
   [HttpPut(“{id}”)]
   public IActionResult Put(int id, [FromBody] Product updatedProduct)
   {
       var existingProduct = _products.FirstOrDefault(p => p.Id == id);
       if (existingProduct == null)
       {
           return NotFound();
       }
       existingProduct.Name = updatedProduct.Name;
       existingProduct.Price = updatedProduct.Price;
        return NoContent(); // 返回 204 No Content，表示操作成功，但伺服器無須返回任何內容
    }

  // 4. 刪除資源 (DELETE)  api/products/1
   [HttpDelete(“{id}”)]
   public IActionResult Delete(int id)
   {
       var productToRemove = _products.FirstOrDefault(p => p.Id == id);
       if (productToRemove == null)
       {
           return NotFound();
       }
       _products.Remove(productToRemove);
        return NoContent(); // 同樣返回 204 No Content
   }
}

• [FromBody]：指示框架從 HTTP 請求的 Body 中解析 JSON 或 XML 資料並綁定到方法參數。

• IActionResult / ActionResult<T>：作為方法的返回型別，允許返回包含 HTTP 狀態碼和可選內容的標準化響應。ActionResult<T> 提供了強型別的好處，同時保留了返回不同狀態碼的靈活性。