摘要:本文将会介绍使用ActiveRecord中的一些技巧。
主要内容
1.由实体类生成数据表
2.运行存在的SQL脚本
3.使用空属类型
4.使用枚举类型的属性
5.使用NHibernate中的日志记录
一.由实体类生成数据表
在前面所用到的例子中我们都是先有数据表结构,然后才有实体类,然而这会让很多朋友认为ORM怎么变成了ROM了,其实这只是我们平时的一个开发时的习惯问题,ActiveRecord是支持先有实体类,再由实体类生成数据库表。只不过我们可以在开发中根据项目的实际情况在这两种之间选择。看下面的代码,要生成数据库表结构,在实体类中需要多提供一些信息,是否为空,字段长度等。
public class Blog : ActiveRecordBase
{
private int _id;
private String _name;
private String _author;
[PrimaryKey(PrimaryKeyType.Native, "blog_id")]
public int Id
{
get { return _id; }
set { _id = value; }
}
[Property("blog_name", NotNull=true, Length=25)]
public String Name
{
get { return _name; }
set { _name = value; }
}
[Property("blog_author", NotNull=true, Length=50)]
public String Author
{
get { return _author; }
set { _author = value; }
}
}
要生成数据库表需要调用ActiveRecordStarter.CreateSchema()方法就可以了。
{
XmlConfigurationSource source = new XmlConfigurationSource("MyConfig.xml");
ActiveRecordStarter.Initialize( source, typeof(Blog),typeof(Post),typeof(Custom));
ActiveRecordStarter.CreateSchema();
}
这里需要注意两点:
1.生成数据库表时只有当该表不存在时ActiveRecord才会生成,否则表如果存在ActiveRecord不会做任何事情,也不会报任何错误。
2.如果在实体类中没有指定字段的长度和是否为空,则默认生成的字段是允许为空的,且字符类生成后的字段类型为Nvarchar,长度为255。
二.运行存在的SQL脚本
有时候我们会想在ActiveRecord框架启动时运行一个已经存在的SQL脚本来生成数据库表结构,ActiveRecord同样也提供了这样的功能,通过调用ActiveRecordStarter.CreateSchemaFromFile()来实现。示例代码如下:
{
XmlConfigurationSource source = new XmlConfigurationSource("MyConfig.xml");
ActiveRecordStarter.Initialize( source, typeof(Blog));
ActiveRecordStarter.CreateSchemaFromFile("MySqlScript.sql");
}
三.使用空属类型
在进行数据库操作时,有时候需要进行空值的处理,在ActiveRecord中给我们提供了一组空属类型,可以方便的进行处理,比如可以这样写属性:
public NullableDateTime CreatedDate
{
get { return _createdDate; }
set { _createdDate = value; }
}
[Property]
public NullableInt32 Count
{
get { return _count; }
set { _count = value; }
}
看一下ActiveRecord提供的空属类型与实际类型对照表
CLR Basic Type | Nullable Type |
System.Boolean | Nullables.NullableBoolean |
System.Byte | Nullables.NullableByte |
System.Char | Nullables.NullableChar |
System.DateTime | Nullables.NullableDateTime |
System.Decimal | Nullables.NullableDecimal |
System.Double | Nullables.NullableDouble |
System.Guid | Nullables.NullableGuid |
System.Int16 | Nullables.NullableInt16 |
System.Int32 | Nullables.NullableInt32 |
System.Int64 | Nullables.NullableInt64 |
System.SByte | Nullables.NullableSByte |
System.Single | Nullables.NullableSingle |
注意在使用空属类型时需要添加以下引用
Nullables.NHibernate.dll
四.使用枚举类型属性
在ActiveRecord中我们可以定义一个属性的类型为枚举类型,示例代码:
{
//
private StatusType _status_type_id;
public enum StatusType
{
Editing = 0,
Published = 1,
Archived = 2
}
[Property("status_id")]
public StatusType Status
{
get { return _status_type_id; }
set { _status_type_id = value; }
}
}
在使用该实体类的StatusType属性时,可以这样赋值:
五.使用NHibernate的日志记录
用过NHibernate的朋友都知道,NHibernate是用Log4net来记录日志的,在ActiveRecord中也可以通过简单的配置来使用Log4net记录。配置示例:
< configuration >
< configSections >
< section name ="nhibernate" type ="System.Configuration.NameValueSectionHandler, System, Version=1.0.5000.0,Culture=neutral, PublicKeyToken=b77a5c561934e089" />
< section name ="activerecord" type ="Castle.ActiveRecord.Framework.Config.ActiveRecordSectionHandler, Castle.ActiveRecord" />
< section name ="log4net" type ="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
</ configSections >
< activerecord >
</ activerecord >
< log4net >
<!-- Define some output appenders -->
< appener name ="trace" type ="log4net.Appender.TraceAppender, log4net" > Õ
< layout type ="log4net.Layout.PatternLayout,log4net" >
< param name ="ConversionPattern" value ="%d [%t] %-5p %c [%x] <%P{user}> - %m%n" />
</ layout >
</ appener > Õ
< appener name ="console" type ="log4net.Appender.ConsoleAppender, log4net" > Õ
< layout type ="log4net.Layout.PatternLayout,log4net" >
< param name ="ConversionPattern" value ="%d [%t] %-5p %c [%x] <%P{user}> - %m%n" />
</ layout >
</ appener > Õ
< appener name ="rollingFile" type ="log4net.Appender.RollingFileAppender,log4net" > Õ
< param name ="File" value ="log.txt" />
< param name ="AppendToFile" value ="true" />
< param name ="RollingStyle" value ="Date" />
< param name ="DatePattern" value ="yyyy.MM.dd" />
< param name ="StaticLogFileName" value ="true" />
< layout type ="log4net.Layout.PatternLayout,log4net" >
< param name ="ConversionPattern" value ="%d [%t] %-5p %c [%x] <%X{auth}> - %m%n" />
</ layout >
</ appener > Õ
< root >
<!-- priority value can be set to ALL|INFO|WARN|ERROR -->
< priority value ="ALL" />
< appener-ref ref ="rollingFile" /> Õ
</ root >
</ log4net >
< nhibernate >
<!-- with this set to true, SQL statements will output to the console window if it's a console app -->
< add key ="hibernate.show_sql" value ="true" />
</ nhibernate >
</ configuration >
初始化配置在调用ActiveRecordStarter.Initialize()方法之前
{
XmlConfigurationSource source = new XmlConfigurationSource("MyConfig.xml");
log4net.Config.XmlConfigurator.Configure();
ActiveRecordStarter.Initialize( source, typeof(Blog));
}
六. Hooks
有时候我们会在保存,加载,删除等操作时做一些必需的处理,这时可以通过重载以下三个方法来实现:
BeforeLoad(IDictionary state)
BeforeDelete(IDictionary state)
比如说我们想在保存的时候设置Post的创建时间为当前时间,可以这样去写
{
state["Created"] = DateTime.Now;
return true;
}
本文就到这里了,同时本篇也是Castle ActiveRecord学习实践系列的最后一篇,过几天我会提供一个完整的ActiveRecord的例子程序。下面有时间我会继续写Castle中的其他部分,包括IOC及Facility,Aspect#,DynamicProxy等。
参考资料
文中很多内容来自于Castle的官方网站http://www.castleproject.org
作者: TerryLee出处: http://terrylee.cnblogs.com