Castle ActiveRecord学习实践（3）：映射基础

摘要：本文详细介绍了ActiveRecord中的基本映射，对于关联映射会在后续文章中通过一些具体的实例来说明。
主要内容[/b]
简单映射
1．ActiveRecordAttribute
2. PrimaryKeyAttribute
3．CompositeKeyAttribute
4．PropertyAttribute
5．FieldAttribute

一．ActiveRecordAttribute[/b]
每一个实体类都必须继承于基类ActiveRecordBase，并在实体类上设置特性ActiveRecordAttribute，示例代码


//指定数据库表名




[ActiveRecord("Blogs")]




public class Blog : ActiveRecordBase








{




//




}




//不指定数据库表名




[ActiveRecord]




public class Blog : ActiveRecordBase








{




//




}
[align=left] [/align]
ActiveRecordAttribute说明

[align=center]属性[/b][/align]	[align=center]说明[/b][/align]	[align=center]示例[/b][/align]
Table	指定持久化类所对应的数据库表名，如果表名与类名相同，可以省略	[ActiveRecord("Blogs")] [ActiveRecord(Table="Blogs")]
Schema	指定Schema的名字	Schema="ARDemo"
Proxy	指定一个接口，在延迟装载时作为代理使用
DiscriminatorColumn	识别器的字段名	DiscriminatorColumn="Blog"
DiscriminatorType	识别器的字段类型	DiscriminatorType="String"
DiscriminatorValue	识别器字段的值
Where	指定一个附加SQL的Where子句	Where="IsPost = 0"
Lazy	指定是否延迟加载	Lazy=true|false

二．PrimaryKeyAttribute[/b]
在实体类中，通过PrimaryKeyAttribute来指定表的主键，示例代码


//指定主键字段名




[ActiveRecord()]




public class Blog : ActiveRecordBase








{




private int id;








[PrimaryKey("blog_id")]




public int Id








{






get

{ return id; }






set

{ id = value; }




}




}




//不指定主键字段名




[ActiveRecord()]




public class Blog : ActiveRecordBase








{




private int id;








[PrimaryKey]




public int Id








{






get

{ return id; }






set

{ id = value; }




}




}



PrimaryKeyAttribute说明

[align=center]属性[/b][/align]	[align=center]说明[/b][/align]	[align=center]示例[/b][/align]
PrimaryKeyType	主键生成的方式，如果不指定，则默认的方式为PrimaryKeyType.Native	PrimaryKeyType.Native
Column	主键字段名称，如果跟属性名相同，可以不用指定	PrimaryKey("blog_id")
ColumnType	主键字段的类型
Generator	是一个.NET类的名字，用来为该持久化类的实例生成唯一的标识。
Params	用Params来提供Generator所需要的配置参数或初始化参数
Length	主键字段的长度	Length=10
SequenceName	当指定主键的生成方式为Sequence时，序列的名称	PrimaryKey(PrimaryKeyType.Sequence, SequenceName="myseqname")
UnsavedValue	用来标志该实例是刚刚创建的，尚未保存。

主键的生成方式介绍

[align=center]名称[/b][/align]	[align=center]说明[/b][/align]
Identity	对DB2,MySQL, MS SQL Server, Sybase和HypersonicSQL的内置标识字段提供支持，生成自增的整型
Sequence	序列，对DB2,MySQL, PostgreSQL, Oracle的内置标识字段提供支持，生成自增的整型。
HiLo	高低位,使用一个高/低位算法来高效的生成Int64, Int32 或者 Int16类型的标识符。
SeqHiLo	使用序列的高低位,使用一个高/低位算法来高效的生成Int64, Int32 或者 Int16类型的标识符，给定一个数据库序列（sequence)的名字。
UuidHex	用一个System.Guid和它的ToString(string format)方法生成字符串类型的标识符。
UuidString	用一个新的System.Guid产生一个byte[] ，把它转换成字符串。
Guid	用一个新的System.Guid 作为标识符。
GuidComb	用Jimmy Nilsso的一个算法产生一个新的System.Guid。
Native	根据底层数据库的能力选择 identity, sequence 或者 hilo中的一个。默认值。
Assigned	让应用程序在自己为对象分配一个标示符。
Foreign	使用另外一个相关联的对象的标识符。

三．CompositeKeyAttribute[/b]
如果使用组合键，需要我们自定义一个类来作为主键属性的类型。示例代码


[PrimaryKey]




public MyCompositeKey ID








{






get

{ return _key; }






set

{ _key = value; }




}
[align=left]
对于组合键类，除了需要加上CompositeKey特性之外，它还需要是可序列化的，并且要求实现Equals和GetHashCode方法。ActiveRecord官方网站上提供的一个组合键的示例程序如下：[/align]


[CompositeKey, Serializable]




public class MyCompositeKey








{




private string _keyA;




private string _keyB;








[KeyProperty]




public virtual string KeyA








{






get

{ return _keyA; }






set

{ _keyA = value; }




}








[KeyProperty]




public virtual string KeyB








{






get

{ return _keyB; }






set

{ _keyB = value; }




}








public override string ToString()








{






return string.Join( ":", new string[]

{ _keyA, _keyB } );




}








public override bool Equals( object obj )








{




if( obj == this ) return true;




if( obj == null || obj.GetType() != this.GetType() ) return false;




MyCompositeKey test = ( MyCompositeKey ) obj;




return ( _keyA == test.KeyA || (_keyA != null && _keyA.Equals( test.KeyA ) ) ) &&




( _keyB == test.KeyB || ( _keyB != null && _keyB.Equals( test.KeyB ) ) );




}








public override int GetHashCode()








{




return _keyA.GetHashCode() ^ _keyB.GetHashCode();




}




}
[align=left] [/align]
四．PropertyAttribute[/b]
[align=left]在ActiveRecord中通过PropertyAttribute来指定实体类属性与数据库中的字段映射。[/align]


[ActiveRecord()]




public class Blog : ActiveRecordBase








{




//不指定字段名




[Property]




public int Name








{






get

{ return _name; }






set

{ _name = value; }




}




}








[ActiveRecord()]




public class Blog : ActiveRecordBase








{




//指定字段名




[Property("blog_name")]




public int Name








{






get

{ return _name; }






set

{ _name = value; }




}




}

PropertyAttribute说明

[align=center]属性[/b][/align]	[align=center]说明[/b][/align]	[align=center]示例[/b][/align]
Column	对应的数据库字段名	Property("blog_name")
ColumnType	对应的字段类型
Formula	一个SQL表达式，定义了这个计算（computed） 属性的值。计算属性没有和它对应的数据库字段。
UnsavedValue	用来标志该实例是刚刚创建的，尚未保存。
Length	字段的长度	Length=10
NotNull	是否可以为空	NotNull=true|false
Unique	是否允许重复	Unique=true|false
Update	表明在用于UPDATE 的SQL语句中是否包含这个字段。默认为true	Update=true|false
Insert	表明在用于INSERT的SQL语句中是否包含这个字段。默认为true	Insert=true|false

五．FieldAttribute[/b]
在ActiveRecord中，允许我们直接对Field进行映射，使用FieldAttribute


[ActiveRecord()]




public class Blog : ActiveRecordBase








{




//不指定字段名称




[Field]




string _name;




}








[ActiveRecord()]




public class Blog : ActiveRecordBase








{




//指定字段名称




[Field("blog_name")]




string _name;




}

FieldAttribute说明

[align=center]属性[/b][/align]	[align=center]说明[/b][/align]	[align=center]示例[/b][/align]
Column	对应的数据库字段名	Property("blog_name")
ColumnType	对应的字段类型
Formula	一个SQL表达式，定义了这个计算（computed） 属性的值。计算属性没有和它对应的数据库字段。
UnsavedValue	用来标志该实例是刚刚创建的，尚未保存。
Length	字段的长度	Length=10
NotNull	是否可以为空	NotNull=true|false
Unique	是否允许重复	Unique=true|false
Update	表明在用于UPDATE 的SQL语句中是否包含这个字段。默认为true	Update=true|false
Insert	表明在用于INSERT的SQL语句中是否包含这个字段。默认为true	Insert=true|false

六．NestedAttribute[/b]
在映射的时候我们也可以用子对象来映射数据库中的字段，示例代码


[ActiveRecord]




public class Company : ActiveRecordBase








{




private PostalAddress _address;








[Nested]




public PostalAddress Address








{






get

{ return _address; }






set

{ _address = value; }




}




}








public class PostalAddress








{




private String _address;




private String _city;




private String _state;




private String _zipcode;








public PostalAddress()








{




}








public PostalAddress(String address, String city,




String state, String zipcode)








{




_address = address;




_city = city;




_state = state;




_zipcode = zipcode;




}








[Property]




public String Address








{






get

{ return _address; }






set

{ _address = value; }




}








[Property]




public String City








{






get

{ return _city; }






set

{ _city = value;}




}








[Property]




public String State








{






get

{ return _state; }






set

{ _state = value; }




}








[Property]




public String ZipCode








{






get

{ return _zipcode; }






set

{ _zipcode = value; }




}




}

NestedAttribute说明

[align=center]属性[/b][/align]	[align=center]说明[/b][/align]	[align=center]示例[/b][/align]
Update	表明在用于UPDATE 的SQL语句中是否包含这个字段。默认为true	Update=true|false
Insert	表明在用于INSERT的SQL语句中是否包含这个字段。默认为true	Insert=true|false

基本的映射就介绍这么多了，剩下的还有版本（VersionAttribute），时间戳（TimestampAttribute）等映射大家可以参考相关的文档。在下篇文章中我会通过一个具体的实例介绍实现One-Many/Many-One映射。