IBatisNet配置

1.一定要在官方网站看一下ibatis.net的两个文档

  DataMapper 1.6.1文档:http://ibatis.apache.org/docs/dotnet/datamapper/index.html
  DataAccess 1.9.1文档:http://ibatis.apache.org/docs/dotnet/dataaccess/index.html
  里面基本上有很多关键的问题都说的很清楚。

 

2.如果你下载了NPetShop或NPetShop2代码,或者参考一些朋友先前的配置文件,注意这些项目或者文章使用的配置文件很可能已经

   陈旧,不适用于ibatis.net 1.3以上版本了。一定按照官方的文档中的配置方式配置。切记不可运行的一切的根源可能不在于你的代

   码,而在于配置文件没有配置好。尤其要注意每个配置文件的头部信息,特别是xmlns和xmlns:xsi,切记对照官方文档检查清楚。

 

3.一定要正确的引用Castle.DynamicProxy类库,这个是关键的关键,在官方文档中有详细的描述。

 

4.当碰到这个出错提示ibatis.net This SQL map does not contain a MappedStatement named
   往往是没有加载SqlMap.config所导致,最简单的验证方法是将SqlMap.config中
   <sqlMaps>
      <sqlMap url="E:\Projet\NPetshop\Source\NPetshop.Web\Maps\Category.xml"/>
   </sqlMaps>
   url的配置改成一个不存在的.xml文件,这时启动项目后肯定报错找不到文件。

 

5.如果报System.NullReferenceException: 未将对象引用设置到对象的实例的错误,即:
      行 35: DomDaoManagerBuilder builder = new DomDaoManagerBuilder(); 
      行 36: builder.ConfigureAndWatch("dao.config", handler); 
   一般都是没有正确的引用Castle.DynamicProxy类库。


6.最佳参看的示例在http://www.cnblogs.com/anderslly/archive/2007/08/07/npetshopsourcecode.html感谢作者,重写了

   NPetShop的示例。

结合上面示例中的IbatisNet配置文件,下面对配置文件中各节点的说明:

<?xml version="1.0encoding="utf-8"?>

<sqlMapConfig xmlns="http://ibatis.apache.org/dataMapperxmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" >

 

  <!-- Rem : If used via a DataAccess context, properties tag will be ignored

  <properties resource="http://www.cnblogs.com/database.config"/> -->

  <properties embedded="database.config, IBatisNetDemo"/>

  <settings>

    <setting useStatementNamespaces="${useStatementNamespaces}"/>

    <setting cacheModelsEnabled="true"/>

    <setting validateSqlMap="false"/>

  </settings>

 

  <!-- Optional if resource -->

  <providers embedded="providers.config,IBatisNetDemo"/>

  <!-- ==== SqlClient configuration =========  -->

  <!-- Rem : If used via a DataAccess context, database tag will be ignored -->

  <database>

    <!-- Optional ( default ) -->

    <provider name="sqlServer1.1"/>

    <dataSource name="iBatisNetconnectionString="data source=${datasource};database=${database};user id=${userid};password=${password};connection reset=false;connection lifetime=5; min pool size=1; max pool size=50"/>

  </database>

 

  <sqlMaps>

    <!-- user via embedded-->

    <sqlMap embedded="Map.SqlClient.Person.xml,IBatisNetDemo"/>

  </sqlMaps>

</sqlMapConfig>

1.        properties节点

可以根据需要配置一些常量属性。如果这些属性有很多的话可以单独写一个文件里面,再通过resource(或url,embedded分别是引用url和编译在程序中的资源文件)属性引用进来

properties 节点参数

参数

描述

resource

指定the properties文件从application的根目录进行加载

resource="properties.config"

url

指定the properties文件从文件的绝对路径进行加载

url="c:\Web\MyApp\Resources\properties.config"

-or-

url="file://c:\Web\MyApp\Resources\properties.config"

embedded

指定文件可以作为程序集的资源文件进行加载'

embedded=" database.config, IBatisNetDemo

上面例子中Properties文件的配置如下:

<?xml version="1.0encoding="utf-8" ?>

<settings>

     <!--   User application and configured property settings go here.-->

     <!-- To run tests, create a file named DataBase.config

          with your own value for datasource.

          (don't included it in the solution and don't commit it in SVN)

     -->

     <add key="useridvalue="sa" />

     <add key="passwordvalue="" />

     <add key="databasevalue="Northwind" />

     <add key="datasourcevalue="localhost" />

     <add key="selectKeyvalue="select @@IDENTITY as value" />

     <add key="directoryvalue="Maps" />

     <add key="useStatementNamespacesvalue="false" />

</settings>

下面解释一下这个文件的节点参数

Property节点参数

参数

描述

key

定义key (variable) 名字

key="username"

value

定义DataMapper 中使用的 key的值

value="mydbuser"

 

2.       setting节点

Setting节点参数

参数

描述

cacheModelsEnabled

是否启用sqlMap上的缓存机制

Example: cacheModelsEnabled=true
Default: true (enabled)

useStatementNamespaces

是否使用Satement命名空间,这里的命名空间指的是映射文件中sqlMap节点的namespace属性,如上例中针对Person表的映射文件sqlMap节点

<sqlMap namespace="Personxmlns="http://ibatis.apache.org/mapping"

xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance这里,指定了此sqlMap节点下定义的操作均丛属于“Person”命名空间在useStatementNamespaces=true的情况下,Statement调用需追加命名空间,如:sqlMap.Update(Person.UpdatePerson,person);否则直接通过Statement名称调用即可,如sqlMap.Update(UpdatePerson,person);但请注意此时需要保证所有映射文件中,statement定义无重名

Example: useStatementNamespaces=false
Default: false (disabled)

validateSqlMap

是配置要不要启示SqlMapConfig.xsd schema验证映射文件.

Example: validateSqlMap=false
Default: false (disabled)

 

3.       provider节点

配置数据驱动提供类配置文件的路径和文件名,通过resource(或url, embedded分别是引用url和编译在程序中的资源文件)属性引用进来,参数的含义同properties.

ADO.NET是通过数据访问提供程序(Provider)访问数据库。IBatisNet使用的是插件式结构来使用这些数据库提供程序,每一个Provider对应于providers.config文件中定义的一个provider项。1.3版本的Provider.config文件中定义了已经实现的16provider,通过设置这个文件中的几个参数来决定使用哪个数据库提供程序。

  • sqlServer1.0 - Microsoft SQL Server 7.0/2000 provider available with .NET Framework 1.0
  • sqlServer1.1 -Microsoft SQL Server 7.0/2000 provider available with .NET Framework 1.1
  • sqlServer2.0 - Microsoft SQL server 7.0/2000/2005 provider available with .NET Framework 2.0
  • OleDb1.1 - OleDb provider available with .NET Framework 1.1
  • Odbc1.1 - Odbc provider available with .NET Framework 1.1
  • oracle9.2 - Oracle provider V9.2.0.401
  • oracle10.1 - Oracle provider V10.1.0.301
  • oracleClient1.0 - MS Oracle provider V1.0.5 available with .NET Framework 1.1
  • ByteFx - ByteFx MySQL provider V0.7.6.15073
  • MySql - MySQL provider V1.0.4.20163
  • SQLite3 - SQLite.NET provider V0.21.1869.3794
  • Firebird1.7 - Firebird SQL .NET provider V1.7.0.33200
  • PostgreSql0.7 - Npgsql provider V0.7.0.0
  • PostgreSql0.7.1  - Npgsql provider V0.7.1.0
  • iDb2.10 - IBM DB2 iSeries provider V10.0.0.0
  • Informix -- informix NET Provider, 2.81.0.0

提供程序要求安装相关类库,每一个

provider  元素都有 "enabled"  属性来控制是否启用这个 providers.  一个 provider  可以通过  default “属性标识为默认的提供程序。

4.       database节点

数据库的信息,包括使用哪些数据库驱动和数据连接字符串的配置。

Database节点参数

参数

描述

provider

数据库访问所使用的provider.config文件定义的provider

dataSource

特定的数据库连接字符串

5.       typeHandler节点

定义数据库类型到dotnet数据类型的处理,不同的数据库都有一些特殊的数据库字段类型需要特殊处理,就可以通过这个功能实现。比如说Blob字段在不同的数据库中处理不一样。大家可以去看看Ibatisnet源代码就清楚这个功能的实现原理,对于我们的设计会有很大的启发

6.       sqlMaps节点

sqlMap节点指定了映射文件的位置,配置中可以出现多个sqlMap节点,以指定项目内所包含的所有映射文件

你可能感兴趣的:(ibatis)