「Fluent NHibernate/フルーエントマッピング」の版間の差分
imported>Administrator (→アプリを作る) |
imported>Administrator (→応用、その他) |
||
(同じ利用者による、間の1版が非表示) | |||
105行目: | 105行目: | ||
多対1(many to one)を表す。 | 多対1(many to one)を表す。 | ||
− | === HasMany | + | === HasMany === |
1対多(one to many)を表す。 | 1対多(one to many)を表す。 | ||
113行目: | 113行目: | ||
=== HasOne === | === HasOne === | ||
1対1(one to one)を表す。 | 1対1(one to one)を表す。 | ||
− | |||
== 応用、その他 == | == 応用、その他 == | ||
122行目: | 121行目: | ||
* [[Fluent NHibernate/フルーエントマッピング/日付型]] | * [[Fluent NHibernate/フルーエントマッピング/日付型]] | ||
* [[Fluent NHibernate/フルーエントマッピング/列挙型]] | * [[Fluent NHibernate/フルーエントマッピング/列挙型]] | ||
+ | * [[Fluent NHibernate/フルーエントマッピング/NOT NULL]] | ||
<!-- | <!-- |
2012年7月12日 (木) 09:07時点における最新版
Fluent NHibernateではオートマッピングに加えフルーエントマッピング(fluent mappings)という手動マッピング機能を用意している。NHibernateと違い、マッピング設定にXMLファイルではなくC#のソースコードを用いるというFluent NHibernateの主目的ともいえる機能である。
他サイトのサンプルを見る限り、大半の人はオートマッピングよりも細かく設定できるこちらを使っているようだ。 細かく設定できる分、相当難しい。 日本語の情報もほとんどない。
目次
超入門編集
エンティティを作る編集
まずエンティティとなるクラスを作る。
アプリケーションを作るプログラマーが直接操作するのはエンティティクラスとなる。 このアプリケーションを作るプログラマーがエンティティクラスをゴニョゴニョすることで、一般的なSELECT/UPDATE/INSERT/DELETE(俗にいうCRUD)などのDB操作を実現することになる。
プロジェクトの中に「Entities」というディレクトリを作り、その中に格納しておくとわかりやすいと思う。
// 従業員エンティティクラス
public class Employee
{
public virtual int Id { get; set; }
public virtual string FirstName { get; set; }
public virtual string LastName { get; set; }
}
マッピングを作る編集
次にマッピングを記述するクラスを作る。 マッピングクラスはClassMap<>クラスを継承して作る。
マッピングクラスは、Fluent NHibernateがエンティティがどういう設定かを記述するクラスであり、エンティティを利用するプログラマーが直接参照するようなものではない。
Fluent NHibernateの99%は、このマッピングクラスの記述方法を覚えることだと思われる。 まったく理解は出来ていない。
プロジェクト内に「Mappings」というディレクトリを作り、その中に格納しておくとわかりやすいと思う。
// 従業員マッピングクラス
public class EmployeeMap : ClassMap<Employee>
{
// デフォルトコンストラクタ
// この中でマッピングの詳細を記述する。
public EmployeeMap()
{
// プライマリキー
Id(x => x.Id);
// 普通のマッピング
Map(x => x.FirstName);
Map(x => x.LastName);
}
}
アプリを作る編集
次に実際にアプリケーションを作る。
Mappingの中身がFluentMappingsとなっているのが特徴。 オートマッピングの場合はAutoMappingsとなっていた部分である。
class AppMain
{
public static void Main(string[] args)
{
var config = Fluently.Configure()
// 接続設定
.Database(
SQLiteConfiguration.Standard
.UsingFile("firstProject.db")
)
// マッピングのありかを明示する。
// 適当なクラスを指定すると、そのクラスが属するアセンブリ内の
// マッピングクラスを自動検知して、あとは全自動でやってくれる。
.Mappings(map =>
map.FluentMappings.AddFromAssemblyOf<AppMain>())
// マッピングからスキーマを自動生成する。
.ExposeConfiguration(cfg =>
new SchemaExport(cfg).Create(false, true))
;
var factory = config.BuildSessionFactory();
// 実際に使ってみる
using (var session = factory.OpenSession())
using (var transaction = session.BeginTransaction())
{
// insertしてみる
var emp = new Expolyee();
emp.FirstName = "test";
emp.LastName = "tarou";
session.SaveOrUpdate(emp);
transaction.Commit();
}
}
}
基本編集
Id編集
プライマリーキーとなる。
Map編集
プロパティとマッピングする。
References編集
多対1(many to one)を表す。
HasMany編集
1対多(one to many)を表す。
HasManyToMany編集
多対多(many to many)を表す。
HasOne編集
1対1(one to one)を表す。
応用、その他編集
- Fluent NHibernate/フルーエントマッピング/自己参照
- Fluent NHibernate/フルーエントマッピング/複合主キー
- Fluent NHibernate/フルーエントマッピング/オートインクリメント
- Fluent NHibernate/フルーエントマッピング/テキスト長
- Fluent NHibernate/フルーエントマッピング/日付型
- Fluent NHibernate/フルーエントマッピング/列挙型
- Fluent NHibernate/フルーエントマッピング/NOT NULL
関連項目編集
参考文献編集