Entity Framework Core で「勇者が左右の手に持つ装備を、装備マスタから選択する」モデルを実装する方法

架空のシナリオ -「勇者の冒険ゲーム」を制作中

リレーショナルデータベースへのアクセスに Entity Framework Core を使った、Code First スタイルによる、C# プログラミングの話。

架空のシナリオとして、「勇者の冒険ゲーム」を制作中だとする。

このゲームのモデリングにおいて、まず、以下のような「装備マスタ」のエンティティ型を用意する。

public class Equipment 

{

  public int Id { get; set; }

  [Required, StringLength(20)]

  public string Name { get; set; }

}

そして「勇者 (プレイヤー) 」は、左右の手それぞれに、上記「装備マスタ」に登録されている装備 (レコード) のうち、任意のひとつを持つものとする。

そのような「勇者 (プレイヤー)」のエンティティ型を、以下のように実装した。

public class Player

{

  public int Id { get; set; }

  // 左の手に持つ装備の装備マスタ上の ID

  public int LeftEquipmentId { get; set; }

  public virtual Equipment LeftEquipment { get; set; }

  // 左の手に持つ装備の装備マスタ上の ID

  public int RightEquipmentId { get; set; }

  public virtual Equipment RightEquipment { get; set; }

}

あとは上記2つのエンティティ型を使って、データベースコンテキスト型を構築すればよい。

public class MyGameDbContext : DbContext

{

  public DbSet<Equipment> Equipments { get; set; }

  public DbSet<Player> Players { get; set;}

  ...

}

以上のように実装することで、例えば以下のような感じで、「勇者 (プレイヤー)」のもつ装備を容易に参照可能となる。

var player = myGameAppDbContext.Players

  .Inclide(p => p.LeftEquipment)

  .Inclide(p => p.RightEquipment)

  .First(p=> ...);

// 👇 左手に持つ装備の名前が表示される

Console.WriteLine(player.LeftEquipment.Name);

各プロパティ名の命名則により、Entity Framework Core がよしなにエンティティモデルを構築してくれるおかげで、「装備マスタ」テーブルと「勇者 (プレイヤー)」テーブルとの、この2つのテーブル間の結合を、"ナビゲーションプロパティ" を参照するだけで直感的なコードで辿れるので便利である。

最後に、Code First スタイルなので、上記エンティティ周りの実装からデータベースを構築するよう、プログラムの開始時に以下のコードを実装する。

myGameAppDbContext.Database.EnsureCreated();

さてこれでよしよしと、ビルドもエラーなく成功。

さて、自分の場合はリレーショナルデータベースに SQL Server を使っていたので SQL Server に接続するよう構成して、いざ実行してみると、

あれ?

実行時例外になってしまった...

Unhandled exception. Microsoft.Data.SqlClient.SqlException (0x80131904):
Introducing FOREIGN KEY constraint 'FK_Players_Equipments_LeftEquipmentId' on table 'Players' may cause cycles or multiple cascade paths.
Specify ON DELETE NO ACTION or ON UPDATE NO ACTION, or modify other FOREIGN KEY constraints.
Could not create constraint or index. See previous errors.