老子影院午夜伦不卡不四虎卡,久久99精品久久只有精品,中文字幕日本不卡一二三区

2. 前置條件與項目結構

技術棧：.NET 6+、C#、Entity Framework Core、AutoMapper

項目結構：

/Interfaces

IPokemonRepository.cs

/Repositories

PokemonRepository.cs

/DTOs

PokemonDto.cs

/Helpers

MappingProfiles.cs

/Controllers

PokemonController.cs

/Data

AppDbContext.cs

已在 Program.cs 中添加 DbContext、AutoMapper 及倉儲依賴注入。

3. 接口層設計（Interfaces）

在 Interfaces/IPokemonRepository.cs 中，定義 GET 相關方法：

public interface IPokemonRepository
{
    IReadOnlyCollection <Pokemon > GetPokemons();              // 列表查詢
    Pokemon GetPokemon(int id);                              // 詳情查詢
    Pokemon GetPokemon(string name);                         // 按名稱查詢
    decimal GetPokemonRating(int id);                        // 評分統計
    bool PokemonExists(int id);                              // 存在性檢測
}

3.1 列表查詢：GetPokemons

返回所有寶可夢，適用于首頁或 Feed 場景。

3.2 詳情查詢：GetPokemon(int id)

根據 ID 返回單個寶可夢詳情，對應產品詳情頁。

3.3 按名稱查詢：GetPokemon(string name)

支持按名稱搜索，適合前端實現搜索或模糊匹配功能。

3.4 評分統計：GetPokemonRating(int id)

根據評論表計算平均評分，返回 decimal。

3.5 存在性檢測：PokemonExists(int id)

簡單布爾檢測，常用于提前判斷資源是否存在。

4. 倉儲層實現（Repositories）

在 Repositories/PokemonRepository.cs 中實現接口方法：

public class PokemonRepository : IPokemonRepository
{
    private readonly AppDbContext _context;
    public PokemonRepository(AppDbContext context) = > _context = context;

    public IReadOnlyCollection < Pokemon > GetPokemons() = >
        _context.Pokemons.OrderBy(p = > p.Id).ToList();

    public Pokemon GetPokemon(int id) = >
        _context.Pokemons.FirstOrDefault(p = > p.Id == id);

    public Pokemon GetPokemon(string name) = >
        _context.Pokemons.FirstOrDefault(p = > p.Name == name);

    public decimal GetPokemonRating(int id)
    {
        var reviews = _context.Reviews.Where(r = > r.Pokemon.Id == id).ToList();
        if (reviews.Count == 0) return 0m;
        return reviews.Sum(r = > r.Rating) / (decimal)reviews.Count;
    }

    public bool PokemonExists(int id) = >
        _context.Pokemons.Any(p = > p.Id == id);
}

5. DTO 設計與 AutoMapper 配置

DTO：限制返回字段，避免泄露敏感信息；
AutoMapper：簡化模型到 DTO 的轉換。

public class PokemonDto { … }
public class MappingProfiles : Profile { … }

6. 控制器層實現（Controllers）

在 Controllers/PokemonController.cs 中，注入倉儲與映射器，并實現各個 GET Endpoint。

6.1 注入倉儲與映射器

public class PokemonController : ControllerBase
{
    private readonly IPokemonRepository _repo;
    private readonly IMapper _mapper;
    …
}

6.2 列表與詳情 Endpoint

// GET api/pokemon
[HttpGet]
public ActionResult < IReadOnlyCollection < PokemonDto > > GetPokemons()
{
    var pokemons = _repo.GetPokemons();
    var dtos = _mapper.Map < IReadOnlyCollection < PokemonDto > > (pokemons);
    return Ok(dtos);
}

// GET api/pokemon/{id}
[HttpGet("{id}")]
public ActionResult < PokemonDto > GetPokemon(int id)
{
    if (!_repo.PokemonExists(id))
        return NotFound($"Pokemon {id} 未找到。");

    var pokemon = _repo.GetPokemon(id);
    var dto = _mapper.Map < PokemonDto > (pokemon);
    return Ok(dto);
}

6.3 名稱查詢與存在性校驗

// GET api/pokemon/name/{name}
[HttpGet("name/{name}")]
public ActionResult < PokemonDto > GetPokemonByName(string name)
{
    var pokemon = _repo.GetPokemon(name);
    if (pokemon == null) return NotFound($"Name={name} 的 Pokemon 未找到。");
    return Ok(_mapper.Map < PokemonDto > (pokemon));
}

// GET api/pokemon/exists/{id}
[HttpGet("exists/{id}")]
public ActionResult < bool > PokemonExists(int id)
{
    return Ok(_repo.PokemonExists(id));
}

6.4 評分統計 Endpoint

// GET api/pokemon/rating/{id}
[HttpGet("rating/{id}")]
public ActionResult < decimal > GetPokemonRating(int id)
{
    if (!_repo.PokemonExists(id))
        return NotFound($"Pokemon {id} 未找到。");

    var rating = _repo.GetPokemonRating(id);
    return Ok(rating);
}