Nhibernate-data-types-mapping
NHibernate-データ型マッピング
この章では、マッピングデータ型について説明します。 エンティティのマッピングは簡単で、エンティティクラスは常に <class>、<subclass>、および<joined-subclass> マッピング要素を使用してデータベーステーブルにマッピングされます。 値型にはさらに何かが必要です。マッピング型が必要な場所です。
NHibernateは、さまざまなデータタイプをマップできます。 以下は、サポートされている最も一般的なデータ型のリストです。
Mapping type | .NET type | System.Data.DbType |
---|---|---|
Int16 | System.Int16 | DbType.Int16 |
Int32 | System.Int32 | DbType.Int32 |
Int64 | System.Int64 | DbType.Int64 |
Single | System.Single | DbType.Single |
Double | System.Double | DbType.Double |
Decimal | System.Decimal | DbType.Decimal |
String | System.String | DbType.String |
AnsiString | System.String | DbType.AnsiString |
Byte | System.Byte | DbType.Byte |
Char | System.Char | DbType.StringFixedLength—one character |
AnsiChar | System.Char | DbType.AnsiStringFixedLength—one character |
Boolean | System.Boolean | DbType.Boolean |
Guid | System.Guid | DbType.Guid |
PersistentEnum | System.Enum(an enumeration) | DbType for the underlying value |
TrueFalse | System.Boolean | DbType.AnsiStringFixedLength—either 'T' or 'F' |
YesNo | System.Boolean | DbType.AnsiStringFixedLength—either 'Y' or 'N' |
DateTime | DateTime | DbType.DateTime—ignores milliseconds |
Ticks | System.DateTime | DbType.Int64 |
TimeSpan | System.TimeSpan | DbType.Int64 |
Timestamp | System.DateTime | DbType.DateTime—as specific as the database supports |
Binary | System.Byte[] | DbType.Binary |
BinaryBlob | System.Byte[] | DbType.Binary |
StringClob | System.String | DbType.String |
Serializable | Any System.Object marked with SerializableAttribute | DbType.Binary |
CultureInfo | System.Globalization.CultureInfo | DbType.String—five characters for culture |
Type | System.Type | DbType.String holding the Assembly Qualified Name |
上記の表は、下記のポインターを詳細に説明しています。
- 単純な数値型から文字列まで、すべて varchars、chars などを使用してさまざまな方法でマッピングできます。 文字列blob、およびデータベースがサポートするすべてのさまざまなタイプ。
- また、ゼロと1を使用するフィールド、true、false、またはTとFを含む文字フィールドの両方に*ブール値*をマップすることもできます。
- データベース内のバックエンド、ブール値にマップする方法を定義するさまざまな方法があります。
- タイムゾーンオフセット、夏時間などを含めて、 DateTime のマッピングを処理できます。
- *列挙*をマップすることもできます。これらを文字列または基になる数値にマップできます。
データベースとStudentクラスの両方で同じプロパティ名を使用する簡単な例を見てみましょう。
では、学生クラスでFirstMidNameをFirstNameに変更します。FirstMidName列は変更しませんが、NHibernateにこの変換を実行することを知らせる方法を確認します。 以下は、更新された学生クラスです。
NHibernateマッピングファイルの実装を次に示します。
この例では、FirstNameフィールドが.NET文字列で、FirstMidName列が SQL nvarchar であると想定しています。 NHibernateにこの変換の実行方法を伝えるには、名前を FirstName に、列を FirstMidName に設定し、この特定の変換に適したマッピングタイプをStringに指定します。
以下は Program.cs ファイルの実装です。
これで、アプリケーションを実行すると、次の出力が表示されます。
ご覧のとおり、異なるプロパティ名がデータベースの列名にマッピングされています。
ご覧のとおり、列挙には、Excellent、Good、Fair、Poor、Terribleなどのさまざまな値が含まれている可能性があります。
マッピングファイルにジャンプすると、これらの各プロパティが、新しく追加された AcademicStanding プロパティを含むマッピングファイルにリストされていることがわかります。
データベースも変更する必要があるため、SQL Serverオブジェクトエクスプローラーに移動し、データベースを右クリックして[新しいクエリ]オプションを選択します。
クエリエディターを開き、次のクエリを指定します。
このクエリは、最初に既存の学生テーブルを削除してから、新しいテーブルを作成します。
上記のように、実行アイコンをクリックします。 クエリが正常に実行されると、メッセージが表示されます。
データベースとテーブルのドロップダウンを展開し、Studentテーブルを右クリックして、View Designerを選択します。
これで、新しく作成されたテーブルが表示されます。これには、新しいプロパティAcademicStandingもあります。
次の Program.cs ファイルに示すように、2つのレコードを追加しましょう。
アプリケーションを実行してみましょう。コンソールウィンドウに次の出力が表示されます。
では、Student Tableを右クリックして、データベースを見てみましょう。
[データの表示]を選択すると、次のスクリーンショットに示すように、学生テーブルに2つのレコードが表示されます。
2つのレコードが追加され、アランにはAcademicStanding 0があり、ジェリーにはAcademicStanding 1があることがわかります。 これは、.Netでは最初の列挙値のデフォルトが0であるためです。これは、 StudentAcademicStanding を見ると優れています。 一方、Student.csファイルではGoodが2番目であるため、値は1です。