如何实现类似Trello API的路由？Tour双端点接口实现疑问

1. 是否需要为两个端点分别创建控制器？ #

不需要强制分开，两种方案均可根据业务复杂度选择：

• 方案一：复用现有控制器
  在已有的ToursController中添加额外路由和方法，让同一个控制器同时支持两个端点。这种方式能避免控制器冗余，逻辑更集中。
  修改后的控制器示例：

  using BandManager.Domain;
  using Microsoft.AspNetCore.JsonPatch;
  using Microsoft.AspNetCore.Mvc;
  
  namespace BandManager.Api.Controllers
  {
      [ApiController]
      public class ToursController : ControllerBase
      {
          private readonly IBandInfoRepository _repo;
          private readonly IMapper _mapper;
  
          public ToursController(IBandInfoRepository repository, IMapper mapper)
          {
              _repo = repository ?? throw new ArgumentNullException(nameof(repository));
              _mapper = mapper ?? throw new ArgumentNullException(nameof(mapper));
          }
  
          // 对应 api/bands/{bandId}/tours
          [HttpGet("api/bands/{bandId}/tours")]
          public async Task<ActionResult<IEnumerable<TourDto>>> GetToursByBand(int bandId)
          {
              var band = await _repo.GetBandAsync(bandId);
              return band is null
                  ? NotFound()
                  : Ok(_mapper.Map<IEnumerable<TourDto>>(band.Tours));
          }
  
          // 对应 api/tours
          [HttpGet("api/tours")]
          public async Task<ActionResult<IEnumerable<TourDto>>> GetAllTours()
          {
              var tours = await _repo.GetAllToursAsync();
              return Ok(_mapper.Map<IEnumerable<TourDto>>(tours));
          }
      }
  }
  

• 方案二：独立控制器
  如果后续两个端点的业务逻辑差异增大（比如需要不同的权限校验、参数处理规则），可以新建AllToursController负责api/tours，原ToursController专注于乐队关联的端点。这种方式边界更清晰，适合复杂业务场景。

2. 是否需要两个独立的仓储？ #

完全不需要，复用现有仓储并扩展接口即可。两个端点都是获取Tour实体，仅查询条件不同（一个按乐队过滤，一个无过滤），底层可以共享数据访问逻辑。

扩展你的IBandInfoRepository接口，添加获取所有巡演的方法：

public interface IBandInfoRepository
{
    Task<Band> GetBandAsync(int bandId);
    // 新增获取所有巡演的方法
    Task<IEnumerable<Tour>> GetAllToursAsync();
}

然后在仓储实现类中完成该方法的数据库查询逻辑，这样两个API端点都能复用同一个仓储实例，避免重复编写数据操作代码。

参考Trello的设计思路 #

Trello的Card资源支持两种访问路径：从Board下获取指定Card，或直接获取单个Card。这和你的需求逻辑一致——同一个资源支持「关联路径」和「直接路径」两种访问方式，底层复用相同的数据查询逻辑，仅通过路由区分查询条件，既符合RESTful规范，又避免了代码冗余。

内容的提问来源于stack exchange，提问作者FlameHorizon