ASP.NET Core Web API中如何处理一对多关系并添加Round数据？

我有Person和Round两张表，关系是一个Person可参与多个Round，一个Round仅属于一个Person。想请教：

• 在ASP.NET Core Web API中如何处理该场景并将Round数据添加到数据库？
• 应该在Person控制器还是Round控制器中实现添加逻辑？
• 如何借助Entity Framework完成数据操作？
• Round的Post DTO类中是否需要包含PersonId属性？

现有实体类 #

Round类 #

public class Round
{
    [Key] public int RoundId { get; set; }
    [Required] public int RoundNumber { get; set; }
    [Required] public int HostScore { get; set; }

    public Person Person { get; set; }
}

Person类 #

public class Person
{
    [Key] public int PersonId { get; set; }
    [Required] public string Username { get; set; } = default!;
    [Required] public string Email { get; set; } = default!;
    [Required] public string Password { get; set; } = default!;

    public List<Round> Rounds { get; set; }
}

问题解答 #

1. 控制器选择：优先用Round控制器 #

从RESTful设计原则出发，Round是独立的资源，添加Round属于对Round资源的创建操作，应该放在RoundController中实现，这样职责更清晰，符合单一职责原则。如果业务上需要从Person视角关联创建Round，也可以在PersonController中新增关联接口，但核心创建逻辑建议放在RoundController。

2. Entity Framework的配置与数据添加 #

首先需要完善实体类的外键配置——当前Round类仅定义了导航属性Person，缺少显式外键字段，EF虽能自动生成，但显式定义更清晰：

修改Round类添加显式外键：

public class Round
{
    [Key] public int RoundId { get; set; }
    [Required] public int RoundNumber { get; set; }
    [Required] public int HostScore { get; set; }

    // 显式外键字段
    [Required] public int PersonId { get; set; }
    public Person Person { get; set; } = default!;
}

然后在DbContext中显式配置关系（可选，EF可通过约定自动识别，但显式配置更直观）：

public class AppDbContext : DbContext
{
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }

    public DbSet<Person> Persons { get; set; }
    public DbSet<Round> Rounds { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Round>()
            .HasOne(r => r.Person)
            .WithMany(p => p.Rounds)
            .HasForeignKey(r => r.PersonId)
            .OnDelete(DeleteBehavior.Cascade); // 可选：删除Person时级联删除其关联的Round
    }
}

实现Round添加逻辑（RoundController中）

先定义PostRoundDTO，必须包含PersonId：

public class PostRoundDto
{
    [Required] public int RoundNumber { get; set; }
    [Required] public int HostScore { get; set; }
    [Required] public int PersonId { get; set; } // 用于关联目标Person
}

然后实现POST接口：

[ApiController]
[Route("api/[controller]")]
public class RoundController : ControllerBase
{
    private readonly AppDbContext _context;

    public RoundController(AppDbContext context)
    {
        _context = context;
    }

    [HttpPost]
    public async Task<ActionResult<Round>> PostRound(PostRoundDto dto)
    {
        // 先验证关联的Person是否存在
        var personExists = await _context.Persons.AnyAsync(p => p.PersonId == dto.PersonId);
        if (!personExists)
        {
            return NotFound("指定的Person不存在");
        }

        var round = new Round
        {
            RoundNumber = dto.RoundNumber,
            HostScore = dto.HostScore,
            PersonId = dto.PersonId
        };

        _context.Rounds.Add(round);
        await _context.SaveChangesAsync();

        return CreatedAtAction(nameof(GetRound), new { id = round.RoundId }, round);
    }

    // 配合CreatedAtAction的查询接口（可选）
    [HttpGet("{id}")]
    public async Task<ActionResult<Round>> GetRound(int id)
    {
        var round = await _context.Rounds.FindAsync(id);
        if (round == null) return NotFound();
        return round;
    }
}

3. Post DTO是否需要PersonId #

必须包含。因为要确定Round所属的Person，必须通过PersonId关联对应实体，否则EF无法识别关联关系，会触发外键约束错误。

另外也可以通过URL参数传递PersonId（比如api/persons/{personId}/rounds），这种情况下DTO可去掉PersonId，从URL中获取参数，更符合RESTful嵌套资源设计：

// 修改RoundController的POST路由
[HttpPost("api/persons/{personId}/rounds")]
public async Task<ActionResult<Round>> PostRound(int personId, PostRoundDto dto)
{
    var personExists = await _context.Persons.AnyAsync(p => p.PersonId == personId);
    if (!personExists)
    {
        return NotFound("指定的Person不存在");
    }

    var round = new Round
    {
        RoundNumber = dto.RoundNumber,
        HostScore = dto.HostScore,
        PersonId = personId
    };

    _context.Rounds.Add(round);
    await _context.SaveChangesAsync();

    return CreatedAtAction(nameof(GetRound), new { id = round.RoundId }, round);
}

// 对应的DTO去掉PersonId
public class PostRoundDto
{
    [Required] public int RoundNumber { get; set; }
    [Required] public int HostScore { get; set; }
}

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