Castle 构建配置信息

因为ActiveRecord在底层封装了NHibernate,配置信息跟用NHibernate时的配置是一样

一．需要配置什么

1．配置NHibernate ADO.NET属性

 

属性名

说明

connection.provider_class

定制IConnectionProvider的类型.例如：full.classname.of.ConnectionProvider （如果提供者创建在NHibernate中）, 或者 full.classname.of.ConnectionProvider, assembly （如果使用一个自定义的IConnectionProvider接口的实现，它不属于NHibernate）。

connection.driver_class

定制IDriver的类型.full.classname.of.Driver （如果驱动类创建在NHibernate中）, 或者 full.classname.of.Driver, assembly （如果使用一个自定义IDriver接口的实现，它不属于NHibernate）。

connection.connection_string

用来获得连接的连接字符串。

connection.isolation

设置事务隔离级别. 请检查 System.Data.IsolationLevel 来得到取值的具体意义并且查看数据库文档以确保级别是被支持的。例如： Chaos, ReadCommitted, ReadUncommitted, RepeatableRead, Serializable, Unspecified




2．可选的配置属性
除了上面的ADO.NET属性之外，我们还有如下的可选属性


属性名

说明

hibernate.dialect

NHibernate方言（Dialect）的类名 - 可以让NHibernate使用某些特定的数据库平台的特性
例如： full.classname.of.Dialect（如果方言创建在NHibernate中）, 或者full.classname.of.Dialect, assembly （如果使用一个自定义的方言的实现，它不属于NHibernate）。

hibernate.default_schema

在生成的SQL中，scheml/tablespace的全限定名.
例如： SCHEMA_NAME

hibernate.prepare_sql

是否准备sql语句
例如： true | false

hibernate.session_factory_name

SessionFactory被创建后将自动绑定这个名称
.例如： some.name

hibernate.use_outer_join

允许使用外连接抓取。例如：true | false

hibernate.cache.provider_class

指定一个自定义的CacheProvider缓存提供者的类名
例如： full.classname.of.CacheProvider（如果ICacheProvider创建在NHibernate中）, 或full.classname.of.CacheProvider, assembly（如果使用一个自定义的ICacheProvider，它不属于NHibernate）。

hibernate.query.substitutions

把NHibernate查询中的一些短语替换为SQL短语（比如说短语可能是函数或者字符）。
例如： hqlLiteral=SQL_LITERAL, hqlFunction=SQLFUNC


可以数据库设置一个hibernate.dialect方言，它是NHibernate.Dialect.Dialect 的一个子类。如果不需要使用基于native或者sequence的主键自动生成算法，或者悲观锁定（使用ISession.Lock() 或者 IQuery.SetLockMode())的话，方言就可以不必指定。然而，假若你指定了一个方言，Hibernate会为上面列出的一些属性使用特殊默认值，省得我们手工指定。
NHibernate SQL 方言对照表：


数据库系统 SQL方言
DB2 NHibernate.Dialect.DB2Dialect
PostgreSQL NHibernate.Dialect.PostgreSQLDialect
MySQL NHibernate.Dialect.MySQLDialect
Oracle (any version) NHibernate.Dialect.OracleDialect
Oracle 9/10g NHibernate.Dialect.Oracle9Dialect
Sybase NHibernate.Dialect.SybaseDialect
Microsoft SQL Server 2000 NHibernate.Dialect.MsSql2000Dialect
Microsoft SQL Server 7 NHibernate.Dialect.MsSql7Dialect
Firebird NHibernate.Dialect.FirebirdDialect



二．如何去配置

ActiveRecord为我们提供了三种方式的配置
1．XmlConfigurationSource配置
可以使用自己的XML文件来保存配置信息，例如有一个MyConfig.xml的文件

  1. <?xml version="1.0" encoding="utf-8" ?>
  3. <activerecord>
  5.     <config>
  7.         <add key="connection.driver_class" value="NHibernate.Driver.SqlClientDriver" />
  9.         <add key="dialect" value="NHibernate.Dialect.MsSql2000Dialect" />
  11.         <add key="connection.provider" value="NHibernate.Connection.DriverConnectionProvider" />
  13.         <add key="connection.connection_string" value="Data Source=.;Initial Catalog=ARDemo;UID=sa;Password=sa" />
  15.     </config>
  17. </activerecord>
复制代码

这时候我们在框架初始化的时候就应该这样写：


  1. XmlConfigurationSource source = new XmlConfigurationSource("MyConfig.xml");
  3. ActiveRecordStarter.Initialize(source,typeof(ActiveRecordBase));
复制代码

其中XmlConfigurationSource通过重载提供了如下三个公用的构造函数
public XmlConfigurationSource(String xmlFileName)
public XmlConfigurationSource(Stream stream)
public XmlConfigurationSource(TextReader reader)
不管是以文件名还是Stream形式或者TextReader，在XmlConfigurationSource的内部都会转换为XmlDocument。最后要注意xml文件的路径，可以用生成后事件命令拷贝.xml文件到bin目录下
copy "$(ProjectDir)\*.xml" "$(TargetDir)"


2．InPlaceConfigurationSource配置
这种实现是一种硬编码的方式，在实际的使用中并不推荐，但是有时候如果我们的配置信息是动态的获取，则这种方式就会变得非常有用。

  1. InPlaceConfigurationSource source = new InPlaceConfigurationSource();
  5. Hashtable properties = new Hashtable();
  9. properties.Add("connection.driver_class", "NHibernate.Driver.SqlClientDriver");
  11. properties.Add("dialect", "NHibernate.Dialect.MsSql2000Dialect");
  13. properties.Add("connection.provider", "NHibernate.Connection.DriverConnectionProvider");
  15. properties.Add("connection.connection_string", "UID=sa;Password=19811218;Initial Catalog=ARDemo;Data Source=.");
  19. source.Add( typeof(ActiveRecordBase), properties );
  23. ActiveRecordStarter.Initialize( source, typeof(ActiveRecordBase) );
复制代码

3．使用应用程序配置文件
这种方式是最为常见的一种，即使用应用程序的配置文件（Web.config 或者App.config），在配置文件中

  1. <configuration>
  2.   <configSections>
  3.     <section name="activerecord" type="Castle.ActiveRecord.Framework.Config.ActiveRecordSectionHandler, Castle.ActiveRecord" />
  4.   </configSections>
  5.   <activerecord>
  6.     <config>
  7.       <add key="connection.driver_class" value="NHibernate.Driver.SqlClientDriver" />
  8.       <add key="dialect" value="NHibernate.Dialect.MsSql2000Dialect" />
  9.       <add key="connection.provider" value="NHibernate.Connection.DriverConnectionProvider" />
  10.       <add key="proxyfactory.factory_class" value="NHibernate.ByteCode.Castle.ProxyFactoryFactory, NHibernate.ByteCode.Castle" />
  11.       <add key="connection.connection_string" value="UID=sa;Password=gh001;Initial Catalog=tempdb;Data Source=127.0.0.1" />
  12.     </config>
  13.   </activerecord>
  14. </configuration>
复制代码



这时候我们的框架初始化代码应该这样写

  1. IConfigurationSource source = System.Configuration. ConfigurationManager.GetSection ("activerecord") as IConfigurationSource;
  3. ActiveRecordStarter.Initialize( source, typeof(ActiveRecordBase) );
复制代码


4．在Web应用程序中的配置
如果我们是在Web应用程序中使用ActiveRecord，需要指定isWeb="true"，如下

  1. <activerecord isWeb="true">
  3.     <config>
  5.         <add key="connection.driver_class" value="NHibernate.Driver.SqlClientDriver" />
  7.         <add key="dialect" value="NHibernate.Dialect.MsSql2000Dialect" />
  9.         <add key="connection.provider" value="NHibernate.Connection.DriverConnectionProvider" />
  11.         <add key="connection.connection_string" value="UID=sa;Password=sa;Initial Catalog=ARDemo;Data Source=." />
  13.     </config>
  15. </activerecord>
复制代码

一般的初始化工作我们会放在Application_ Start中，示例代码

  1. protected void Application_Start(Object sender, EventArgs e)
  3. {
  5.     IConfigurationSource source = 
  7.         System.Configuration.ConfigurationSettings.GetConfig("activerecord") as IConfigurationSource;
  11.     ActiveRecordStarter.Initialize( source, typeof(ActiveRecordBase));
  13. }
复制代码

三．常见的配置示例
Castle网站为我们提供的几个常见的配置示例
1．MS SQLServer

  1. <activerecord>
  3.     <config>
  5.         <add key="connection.driver_class" value="NHibernate.Driver.SqlClientDriver" />
  7.         <add key="dialect" value="NHibernate.Dialect.MsSql2000Dialect" />
  9.         <add key="connection.provider" value="NHibernate.Connection.DriverConnectionProvider" />
  11.         <add key="connection.connection_string" value="Data Source=.;Initial Catalog=test;UID=sa;Password=sa" />
  13.     </config>
  15. </activerecord>
复制代码

 

2．Oracle

  1. <activerecord>
  3.     <config>
  5.         <add key="connection.driver_class" value="NHibernate.Driver.OracleClientDriver" />
  7.         <add key="dialect" value="NHibernate.Dialect.OracleDialect" />
  9.         <add key="connection.provider" value="NHibernate.Connection.DriverConnectionProvider" />
  11.         <add key="connection.connection_string" value="Data Source=dm;User ID=dm;Password=dm;" />
  13.     </config>
  15. </activerecord>
复制代码

 

3．MySQL

  1. <activerecord>
  3.     <config>
  5.         <add key="connection.driver_class" value="NHibernate.Driver.MySqlDataDriver" />
  7.         <add key="dialect" value="NHibernate.Dialect.MySQLDialect" />
  9.         <add key="connection.provider" value="NHibernate.Connection.DriverConnectionProvider" />
  11.         <add key="connection.connection_string" value="Database=test;Data Source=someip;User Id=blah;Password=blah" />
  13.     </config>
  15. </activerecord>
复制代码

 

4.SQLite

  1.   
  2.   <activerecord>
  3.     <config>
  4.         <add key="connection.driver_class" value="NHibernate.Driver.SQLite20Driver" />
  5.         <add key="dialect" value="NHibernate.Dialect.SQLiteDialect" />
  6.         <add key="connection.provider" value="NHibernate.Connection.DriverConnectionProvider" />
  7.         <add key="connection.connection_string" value="Data source={0}\Harp.db; Version=3" />
  8.         <add key='proxyfactory.factory_class' value="NHibernate.ByteCode.Castle.ProxyFactoryFactory, NHibernate.ByteCode.Castle"/>
  9.         <add key="default_schema" value="modal" />
  10.         <add key="connection.isolation" value="ReadCommitted" />
  11.         <add key="hibernate.show_sql" value="false" />
  12.     </config>
  13.   </activerecord>
复制代码

 

5.Access

  1.   <activerecord>
  2.     <config>
  3.       <add key="hibernate.connection.provider" value="NHibernate.Connection.DriverConnectionProvider" />
  4.       <add key="hibernate.dialect" value="NHibernate.JetDriver.JetDialect, NHibernate.JetDriver" />
  5.       <add key="hibernate.connection.driver_class" value="NHibernate.JetDriver.JetDriver, NHibernate.JetDriver" />
  6.       <add key="hibernate.connection.connection_string" value="Provider=Microsoft.Jet.OLEDB.4.0;Data Source=data.mdb" />
  7.     </config>
  8.   </activerecord>
复制代码

posted on 2012-11-21 16:16  一个石头  阅读(187)  评论(0)    收藏  举报