「Fluent NHibernate/フルーエントマッピング」を編集中

[[Fluent NHibernate]]では[[Fluent NHibernate/オートマッピング|オートマッピング]]に加え'''フルーエントマッピング'''（fluent mappings）という手動マッピング機能を用意している。[[NHibernate]]と違い、マッピング設定に[[XML]]ファイルではなく[[C Sharp|C#]]の[[ソースコード]]を用いるというFluent NHibernateの主目的ともいえる機能である。

他サイトのサンプルを見る限り、大半の人は[[Fluent NHibernate/オートマッピング|オートマッピング]]よりも細かく設定できるこちらを使っているようだ。
細かく設定できる分、相当難しい。
日本語の情報もほとんどない。

== 超入門 ==
=== エンティティを作る ===
まずエンティティとなるクラスを作る。

[[アプリケーション]]を作る[[プログラマー]]が直接操作するのはエンティティクラスとなる。
この[[アプリケーション]]を作る[[プログラマー]]がエンティティクラスをゴニョゴニョすることで、一般的なSELECT/UPDATE/INSERT/DELETE（俗にいう[[CRUD]]）などのDB操作を実現することになる。

プロジェクトの中に「Entities」というディレクトリを作り、その中に格納しておくとわかりやすいと思う。
<source lang="csharp">
// 従業員エンティティクラス
public class Employee
{
    public virtual int Id { get; set; }
    public virtual string FirstName { get; set; }
    public virtual string LastName { get; set; }
}
</source>

=== マッピングを作る ===
次にマッピングを記述するクラスを作る。
マッピングクラスはClassMap<>クラスを継承して作る。

マッピングクラスは、Fluent NHibernateがエンティティがどういう設定かを記述するクラスであり、エンティティを利用する[[プログラマー]]が直接参照するようなものではない。

[[Fluent NHibernate]]の99％は、このマッピングクラスの記述方法を覚えることだと思われる。
まったく理解は出来ていない。

プロジェクト内に「Mappings」というディレクトリを作り、その中に格納しておくとわかりやすいと思う。
<source lang="csharp">
// 従業員マッピングクラス
public class EmployeeMap : ClassMap<Employee>
{
    // デフォルトコンストラクタ
    // この中でマッピングの詳細を記述する。
    public EmployeeMap()
    {
        // プライマリキー
        Id(x => x.Id);
        // 普通のマッピング
        Map(x => x.FirstName);
        Map(x => x.LastName);
    }
}
</source>

=== アプリを作る ===
次に実際にアプリケーションを作る。

<source lang="csharp">
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();
        }
    }
}
</source>

== 基本 ==
=== Id ===
プライマリーキーとなる。

=== Map ===
プロパティとマッピングする。

=== References ===
多対１（many to one）を表す。

=== HasMany ====
１対多（one to many）を表す。

=== HasManyToMany ===
多対多（many to many）を表す。

=== HasOne ===
１対１（one to one）を表す。


== 応用、その他 ==
* [[Fluent NHibernate/フルーエントマッピング/自己参照]]
* [[Fluent NHibernate/フルーエントマッピング/複合主キー]]
* [[Fluent NHibernate/フルーエントマッピング/オートインクリメント]]
* [[Fluent NHibernate/フルーエントマッピング/テキスト長]]
* [[Fluent NHibernate/フルーエントマッピング/日付型]]
* [[Fluent NHibernate/フルーエントマッピング/列挙型]]

<!--
{{stub}}
大雑把に言えばオートマッピングの記述例のAutoMappingsの部分がFluentMappingsになるような感じである。
<source lang="csharp">
                .Mappings(map => map.FluentMappings
                    .AddFromAssemblyOf<Product>()
                )
</source>
-->

== 関連項目 ==
* [[Fluent NHibernate]]
* [[Fluent NHibernate/データベース接続設定]]
* [[Fluent NHibernate/オートマッピング]]

== 参考文献 ==
<references/>

== 外部リンク ==

{{stub}}