iBatisNet 入门篇(DataMapper)

iBatisNet是一款轻量级的ORM开源框架，配置简单，上手容易。

iBatisNet的官方网址：http://ibatis.apache.org/dotnet.cgi

 

iBatisNet拥有两个工程：DataMapper和DataAccess，

DataMapper就相当于DAL(数据访问层)，提供数据访问的接口。将SQL从原来硬编码中分离到.xml文件中去。

查询出来的结果通过Map, List, Object方式返回调用层。.NET 2.0推出之后，iBatisNet的DataMapper也支持了泛型，

具有了更强的类型支持。其简单易上手的动态SQL(通过xml标签来配置)，使得iBatisNet更加灵活好用。

DataAccess则是临界于DAL和BLL(业务逻辑层)之间的，通过DataAccess你可以灵活的变化你的DAL，比如：

项目中同时要操作两个不同的DB。(可以是地址不同，或者是DB厂商不同)。DB的配置在providers.xml里，

DAL的配置在dao.config里。利用DataAccess，你可以使用DataMapper来操作DB，也可以使用自定的DAO对象来访问。

这也是特点之一。

 

先总结下 iBatisNet DataMapper 的配置：

 

1. 工程添加引用：

    IBatisNet.Common.dll

    IBatisNet.DataMapper.dll

 

2. 使用DataMapper, 需要添加配置文件：

    SqlMap.config (配置SQL文件的存放位置方式，对应的DB类型，连接字符串)

    providers.config(低层数据提供程序的DLL，不用特别关心)

 

详细说一下 SqlMap.xml 的配置。

   整体：
   <sqlMapConfig ... >
       <!-- 2. 参数文件的配置 -->
       <properties ... />
 
       <!-- 3. 数据库提供程序文件的配置 -->
       <provider ... />

       <settings>
          ...
       </settings>

       <!-- 4. 数据库连接配置 -->
       <database>
          <provider ... />
          <dataSource ... />
       </database>
      
       <!-- Sql Xml文件的配置 -->
       <sqlMaps>
          <sqlMap ... />
          <sqlMap ... />
       </sqlMaps>
      
   </sqlMapConfig>
 

   1） 项目参数的配置
      当遇到多个地方使用的名称(属性)或者容易发生变更的名称(属性)的时候，可以用参数来配置。
      比如：<dataSource connectionString="user id=${username};" />里的${username}
      这样整个iBatis里都可以使用${username}这个参数了。
      这样的参数是在参数文件里定义并赋值的，然后通过properties配置节引用进来。(2.参数文件的配置)

      参数文件(比如：2.中的properties.config)中的格式如下：
      <settings>
          <add key="username" value="sa" />
      </settings>

   2） 参数文件的配置
      properties配置节，配置SqlMap.xml以及其他Sql Xml中所使用到的项目参数。
      有以下三种方式将指定的文件中配置的属性引用进来。
      a) resource 方式(相对路径)，会在Application目录下寻找并加载指定名字的配置文件。
         <properties resource="properties.config" />

      b) url 方式(绝对路径)，会根据指定的url加载指定绝对路径的文件
         <properties url="c:/Web/MyApp/Resources/properties.config" />

      c) embedded 方式(嵌入资源)，会在嵌入的资源中寻找并加载指定的配置文件
         <properties embedded="Resources.properties.config, MyApp.Data" />
         说明：properties.config文件放在工程的Resources目录下，且该文件的“生成操作”属性为“嵌入的资源”

   3）数据库提供程序文件的配置
      provider配置节，配置数据库提供程序集(dll)的信息。
      和properties配置节一样，也有resource,url,embedded三种方式(1-2的a,b,c参考)。
      对应的provider.config，可以从Ibatis.DataMapper.1.6.2.bin里拷贝出来使用。
      例：<provider resource="provider.config" />
     【注意】provider.config里要使用的数据提供程序集的enabled属性设为"true"

   4. 数据库连接配置
      database配置节，配置数据库相关信息。

   5. typeHandler配置节

   6. sqlMaps配置节(声明Sql文件的位置)