「Entity Framework Coreを使ってみる」公開用

Entity Framework Coreを使ってみる
Core 1.1.0／SQLite編
2017/3/10 1Copyright (c) 2017 Eiwa System Management, Inc.
株式会社永和システムマネジメント
コンサルティングセンター
センター長天野勝
http://www.esm.co.jp/service/consulting/

 作成アプリケーション
 KPTボード
 動作確認環境
 対象：Entity Framework Core 1.1.0
 OS：Windows10 64bit
 IDE：Visual Studio 2015 Community
 RDBMS：SQLite3
 EntityFramework Core SQLiteをインストールする際にインストールされる
 DB操作ツール：DB Browser for SQLite
2Copyright (c) 2017 Eiwa System Management, Inc.2017/3/10
概要

 以下のサイトを参考にさせていただきました。
 ありがとうございます。
 Logging | Microsoft Docs
https://docs.microsoft.com/en-us/ef/core/miscellaneous/logging
 Part 2. Entity Framework Core 1.0 の基本的な使い方 – とあるコン
サルタントのつぶやき
https://blogs.msdn.microsoft.com/nakama/2016/07/07/aspnetcore10-part2/
 Entity Framework Core 1.0 で SQLite を使ってみる - ROMANCE
DAWN for the new world
http://gooner.hateblo.jp/entry/2016/03/04/071400
謝辞

プロジェクトの作成

 クラスライブラリ
 プロジェクト名「KptBoardSystem」
 「Microsoft.EntityframeworkCore.Sqlite」
「Microsoft.EntityframewordCore.Tools」をNuGetでインス
トール
Modelプロジェクトの作成

 クラスライブラリ
 プロジェクト名「KptBoardSystemTest」
 「Microsoft.EntityframeworkCore」「xunit」
「xunit.runner.visualstudio」「Moq」をNuGetでインストール
テストプロジェクトの作成

インストール

 「Microsoft.EntityframeworkCore.Sqlite」をインストール
NuGetでインストール

 「Microsoft.EntityframeworkCore.Tools」をインストール
 インストールすると、マイグレーション機能が使えるようになる

 インストール時にセキュリティエラーが出るのは、スクリプト
実行権限がないため。
 Visual Studioを管理者権限で実行して、再度インストールす
る。

データモデルとテーブルの作成

Userクラスの作成
using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
namespace KptBoardSystem
{
[Table("Users")] // テーブル名をクラス名の複数形に指定
public class User
{
public int UserId { get; set; }
[Required] // Nameフィールドは必須
public string Name { get; set; }
}
}
User.cs

KptBoardModelクラスの作成
using Microsoft.Data.Sqlite;
using Microsoft.EntityFrameworkCore;
{
public class KptBoardModel : DbContext
{
public DbSet<User> Users { get; internal set; }
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
var connectionString =
new SqliteConnectionStringBuilder { DataSource = "../../../kpt.db" }.ToString();
optionsBuilder.UseSqlite(new SqliteConnection(connectionString));
}
}
}
KptBoardModel.cs

 パッケージマネージャコンソールにて、コマンドを実行する
 > Enable-Migrations
 マイグレーションができるようにする
 パスに日本語が含まれていたり、スタートアッププロジェクトに設定していないとエ
ラーになる
 > Add-Migration step00
 マイグレーション用のコード「XXX_step00.cs」が作成される
マイグレーションの準備

 > Update-Database
 ソリューションの直下に「kpt.db」が作成される
マイグレーションの実施

 DB Browser for SQLiteにて「kpt.db」を開く
 「Users」テーブルが作成できていることを確認
データベースの確認

テストからのレコード作成

 KptBoardSystemTestプロジェクトで[参照の追加]
 [プロジェクト]>[KpｔBoardSystem]をチェックして[OK]
テスト対象の参照設定をする

テストコードの作成
using Xunit;
namespace KptBoardSystem.Test // Testの前に「.」を追加する
{
public class KptBoardModelTest
{
[Fact]
public void TestInsertUser()
{
using (var db = new KptBoardModel())
{
var user = new User
{
Name = "User01"
};
db.Add(user);
db.SaveChanges();
}
}
}
}
KptBoardModelTest.cs

 作成したテストを実行する
 DB Browser for SQLでレコードが挿入されているのを確認
する
テストの実施

データモデルの変更と
マイグレーション

Userクラスの修正
{
[Table("Users")]
public class User
{
[Required]
public int? Age { get; set; } // プロパティを追加。nullも可能な「int?」型にする
}
}
User.cs

 「Users」テーブルに列が追加される
 「Age」列が追加されたのを確認する
マイグレーションの実行

テストコードの修正
using Xunit;
using System.Linq;
namespace KptBoardSystem.Test
{
{
[Fact]
{
{
// 全レコードを削除
foreach (var u in db.Users.ToArray())
{
db.Remove<User>(u);
}
db.Add(new User { Name = "User01" });
db.Add(new User { Name = "User02", Age = 2 });
db.SaveChanges();
}
}
}
}

 修正したテストを実行する
する
 レコードを削除しているので、UserIdが新しくなっている
テストの実施

関連テーブル

クラス図
KptBoardModel
<<Table("Users")>>
+ <<get, set>> KptBoards : List<KptBoard>
+ AddKptBoard(kptBoard : int) : KptBoard
+ <<get, set>> UserId : int
+ <<get, set>> Age : int
+ <<get, set>> Name : string
User
<<Table("KptBoards")>>
+ <<get, set>> UserId : int
+ <<get, set>> KptBoardId : int
+ <<get, set>> Problem : string
+ <<get, set>> Try : string
+ <<get, set>> Keep : string
+ <<get, set>> Time : DateTime
KptBoard
- _kptBoards
0..*1

KptBoardクラスを追加
using System;
{
[Table("KptBards")] // テーブル名をクラス名の複数形に指定
public class KptBoard
{
public int KptBoardId { get; set; }
[Required]
public DateTime Time { get; set; }
public string Keep { get; set; }
public string Problem { get; set; }
public string Try { get; set; }
public int UserId { get; set; } // 外部キーとして、UserクラスのUserIdと同じ名称を指定
}
}
KptBoard.cs

Userクラスを修正
using System.Collections.Generic;
{
[Table("Users")]
public class User
{
private List<KptBoard> _kptBoards = new List<KptBoard>(); //KptBoardを複数持てるようにListを使用
[Required]
public int? Age { get; set; }
public List<KptBoard> KptBoards
{
get { return _kptBoards; }
set { _kptBoards = value; }
}
public void AddKptBoard(KptBoard kptBoard)
{
_kptBoards.Add(kptBoard);
}
}
}
User.cs

KptBoardModelクラスを修正
using Microsoft.Data.Sqlite;
{
public class KptBoardModel : DbContext
{
public DbSet<User> Users { get; internal set; }
public DbSet<KptBoard> KptBoards { get; internal set; }
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
var connectionString =
new SqliteConnectionStringBuilder { DataSource = "../../../kpt.db" }.ToString();
optionsBuilder.UseSqlite(new SqliteConnection(connectionString));
}
}
}
KptBoardModel.cs

 「KptBoards」テーブルが追加される
マイグレーションの実行

テストメソッドを追加
using Xunit;
using System;
using System.Linq;
{
{
[Fact(DisplayName = "既存のユーザーにKptBoardを追加する")]
public void TestInsertKptBoard()
{
{
var user02 = db.Users.Where((u) => u.Name == "User02").Include("KptBoards").First();
user02.AddKptBoard(new KptBoard
{
Time = DateTime.Now,
Keep = "続けること", Problem = "不満なこと", Try = "Tryは次に試すこと。"
});
db.Update(user02); // 更新
db.SaveChanges();
}
}
[Fact]

 追加したテストを単体で実行する
する
テストの実施

using Xunit;
using System;
using System.Linq;
{
{
[Fact(DisplayName = "新規にユーザーとKptBoardを追加する")]
public void TestInsertUserAndKptBoard()
{
{
var user = new User // Userが1つ、KptBoardが3つのインスタンスを作り上げる
{
Name = "User03", Age = 3,
KptBoards =
{
new KptBoard { Time = DateTime.Now, Keep = "続けることだけ" },
new KptBoard { Time = DateTime.Now, Problem = "続けることだけ" },
new KptBoard { Time = DateTime.Now, Try = "試すことだけ" },
}
};
db.Add(user); // 追加
db.SaveChanges();
}
}

する
テストの実施

using Xunit;
using System;
using System.Linq;
{
{
[Fact(DisplayName = "KptBoardを修正する")]
public void TestUpdateKptBoard()
{
{
var kptBoard = db.KptBoards.Where(b => b.Problem.Contains("続ける")).First();
kptBoard.Problem = "問題だけ";
db.Update(kptBoard); // 更新
db.SaveChanges();
}
}

 DB Browser for SQLでレコードが更新されているのを確認
する
テストの実施

using Xunit;
using System;
using System.Linq;
namespace KptBoardModel.Test
{
{
[Fact(DisplayName = "KptBoardを削除する")]
public void TestDeleteKptBoard()
{
{
var kptBoard = db.KptBoards.Where(b => b.Problem == "問題だけ").First();
db.Remove(kptBoard); // 削除
db.SaveChanges();
}
}

 DB Browser for SQLでレコードが削除されているのを確認
する
テストの実施

using Xunit;
using System;
using System.Linq;
namespace KptBoardModel.Test
{
{
[Fact(DisplayName = "KptBoardを持っているUserを削除する")]
public void TestDeleteUserHasKptBoard()
{
{
// Includeしていないので、Userの情報しか取れない
var user = db.Users.Where((u) => u.Name == "User03").First();
db.Remove(user); // 削除
db.SaveChanges();
}
}

 DB Browser for SQLでレコードが削除されているのを確認
する
 Userを消しただけだが、KptBoardも一緒に消える
テストの実施

「Entity Framework Coreを使ってみる」公開用

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Viewers also liked

Viewers also liked (20)

Similar to 「Entity Framework Coreを使ってみる」公開用

Similar to 「Entity Framework Coreを使ってみる」公開用 (20)

More from ESM SEC

More from ESM SEC (20)