nhibernate配置和持久对象映射文件
nhibernate配置
有三种方式来存放nhibernate的配置
1, 作为单独的一节放在相应程序的配置文件中,对于执行文件或类库为文件名称后加.config,对于asp.net则是放在web.config中。这种方式必须在配置文件的configSetions中声明nhibernate的配置节,
配置内容由Cfg.Environment类来读取,该类所有成员均为静态的,另外它还定义了配置中key值的常数。
2. 放在一个单独的配置文件中,默认为hibernate.cfg.xml,使用时必须调用Cfg.Configuration.Config()。如不是默认的配置文件名,还必须指明配置文件名称。这种方式最适合多数据库的情况,可以为每个数据库建立一个配置文件。
3. 手工在程序中加入,配置内容最后将加入到Cfg.Configuration.Properties属性中,此属性为一IDictionary对象,并且为public,其余的就不用多话了吧。
下面对几个重要的key值说明一下:
- hibernate.connection.provider
- 连接提供者,取值必须是实现了IConnectionProvider接口的类的全名,当前版本只能取值NHibernate.Connection.DriverConnectionProvider;
- hibernate.connection.driver_class
- 数据驱动类,取值必须是实现了IDriver接口的类的全名,常用的选择有NHibernate.Driver.SqlClientDriver, NHibernate.Driver.OleDbDriver等;
- hibernate.dialect
- 数据库方言,取值必须是继承之Dialect的类的全名,最常用的就是NHibernate.Dialect.MsSql2000Dialect了, 其它的没用过,不清楚能不能正常使用;
- hibernate.connection.connection_string
- 连接字符串,取值与driver_class对应即可;
- hibernate.show_sql
- 指明是否在log4net日志中显示sql语句,主要用于调试,取值为true或false;
完整的配置key列表请查看Cfg.Environment类中的常数声明。
持久对象映射文件
nhibernate为我们提供了很多方式将持久对象映射文件加入到Cfg.Configuration类,下面将其一一列出:
AddXmlFile:加入包括对象映射信息的文件;
AddXmlString:加入包含映射信息的字符串;
AddDocument:加入包含映射信息的Xmldocument;
AddInputStream:加入包含映射信息的输入流;
AddXmlReader:加入包含映射信息的XmlReader;
AddResource:加入指定程序集的映射信息资源;
AddClass:加入以类名指定的映射信息资源,映射文件必须为classname.hbm.xml;
AddAssembly:加入指定程序集名称的映射信息资源
注意:如果映射信息为文件形式,包括加入到程序集资源的文件,那么文件名必须以.hbm.xml结尾。