跟初学者学习IbatisNet第一篇

    写在前面的话：我自己也是一个初学者，写这个专题只是为了对学过知识的巩固，如果有什么不对的地方，欢迎大家指正……………………

    第一篇就简单介绍一下什么是IbatisNet，然后写一个简单的Demo,在后面再详细介绍IbatisNet的工作原理和IbatisNet的优缺点。为什么按照这个顺序呢？举个简单的例子来说，我现在给你一辆自行车，你不可能一上来就开始分析它是怎么运动的吧，你得首先会骑它，等你会骑了你才会发现这个车子怎么好，怎么不好。这样你才有资格说它有什么优点，有什么缺点，好了， 不废话了，首先介绍一下什么是IbatisNet：

   应该有很多人都听说过Ibatis吧，没错IbatisNet就是Ibatis在.net上的一个移植版本，所以它们俩基本是差不多的。所以IbatisNet自然也是一个轻量级的ORM框架，于是我们又想起来了hibnate和Nhibnate，它们也是一个轻量级的ORM实体框架（关于IbatisNet和Nhibnate的优缺点我就不介绍了，如果想了解可以看这篇博客ibatis VS hibernate 经典论述http://www.cnblogs.com/tjsquall/archive/2009/06/23/1508977.html）不过严格的来说IbatisNet并不是一种很正统的ORM解决方案。因为它不像NHibernate那样，具备全自动的数据操作，包括查询，插入，更新，删除,也没有像它那样，与数据库的约束关系有紧密的联系。IbatisNet为我们提供了一种更为灵活的方便的可控的方式去实现类似与ORM的解决方案，在这里我们需要自己写全部的Sql语句，这样有好处也有坏处，好处是：

  1，允许sql以最自然的方式书写，没有字符串拼接，没有参数设置，没有结果获取。对应用程序的代码没有任何的影响。

  2，支持对存储过程的直接调用，业务逻辑从数据库中分离出来，程序有更强的移植性。

  3，IbatisNet有许多o/rm工具一样的特性，高速缓存，运行时生成代码，延迟加载等。（貌似不是写sql语句的好处…………）

  4，IbatisNet支持动态sql来处理查询。

最大的缺点就是我们还需要编写大量的sql语句，但是值得感到高兴的是，我们只需要提供这些SQL语句，和为它提供它所需的参数外，接下来的事情就无需我们参与了。这也是iBatis最核心的功能，它会根据具体传进来的参数值，动态生成一条可执行的SQL语句并且为这些SQL参数提供不同的具体值。然后根据配置好的数据访问驱动，自动为DbCommand添加DbParameter，自动执行SQL语句，使用IDataReader返回出数据集，生成并返回一个或多个强类型数据类对象。好了，介绍就先介绍到这儿吧，下面直接来个Demo吧，估计还是看着代码爽…………

 一，  准备工作

 软件下载

下载地址：http://code.google.com/p/mybatisnet/downloads/list?can=1

二，开始编码

  1， 首先我们要引用IbatisNet的两个DLL文件（创建项目和创建数据库我就不说了）他们分别是：

 

  2，添加IbatisNet默认的配置文件sqlmap.config和database.config和providers.config

   首先简单介绍一下database.config

  这个配置文件主要是配置数据库的连接，它是以键值对的形式存在。

  再来简单介绍一下providers.config

  该文件必须存在，并且不能改变它的文件名，该文件描述了如何连接数据库，无须配置。

  sqlmap.config配置文件简介：

 

  主要介绍一下这个配置文件的节点：

  1，properties节点：

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

resource	指定the properties文件从application的根目录进行加载 resource="properties.config"
url	指定the properties文件从文件的绝对路径进行加载 url="c:\Web\MyApp\Resources\properties.config" 或者 url="file://c:\Web\MyApp\Resources\properties.config"
embedded	指定文件可以作为程序集的资源文件进行加载' embedded=" database.config,SqlMaps”

   2，settings节点：

cacheModelsEnabled	是否启用sqlMap上的缓存机制 Example: cacheModelsEnabled=”true” Default: true (enabled)
useStatementNamespaces	是否使用Satement命名空间，这里的命名空间指的是映射文件中sqlMap节点的namespace属性，如上例中针对Person表的映射文件sqlMap节点 <sqlMap namespace="Person" xmlns="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文件中定义了已经实现的16个provider（如上图）,通过设置这个文件中的几个参数来决定使用哪个数据库提供程序。

   4，database节点 ：

    主要指定数据库驱动，和数据库连接字符串

<database>

<provider name="${provider}"/>
        <dataSource name="iBatisNet" connectionString="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>

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

 

  1，创建实体（要养成一个良好的编码习惯，代码一定要加上注释）

 

 2,XML配置文件解释

这里见简单介绍一下常用的配置（至少我常用配置（菜鸟级程序员）），具体其他的配置在后面再讲。

 3，简单看一下IbatisNet的ISqlMapper

       在IbatisNet中，我们把所有的配置和映射都放在XML文件里（当然，这未必是一定需要的），但是，XML文件不是可执行的，所以，如果我们要在我们的c#代码里使用IbatisNet的映射，就必须通过一个类来加载、分析、使用它。

      所以在IbatisNet中，提供给了我们很多的API来做这些事情，配置以及映射文件的加载和监视是在 创建SqlMapper实例的时候进行的，而所有的数据映射的工作以及我们对数据库的操作，是需要在SqlMapper实例上调用方法来完成 的,SqlMapper实例具有多线程并且长期活动的性质，在IbatisNet外界，可以随处使用这样的方法来调用得到SqlMapper实例ISqlMapper mapper=Mapper.Instance();在我们第一次调用Mapper.Instance()的时候，DomSqlMapBuilder对象会通过解析SqlMap.config（默认路径和命名）文件来出创建SqlMapper实例，在 以后的调用中，则会使用缓存中的mapper对象，那么，如果我们在应用程序运行期间，修改了我们的映射文档，结果是怎样的呢。如果我们使用Mapper.Instance()的方法来得到mapper对象，则在这个过程中，默认使用了DomSqlMapBuilder.ConfigureAndWatch的方法来监视配置文件的状况，如果期间出现了改动，SqlMapper对象会被安全的重新载入，当然，如果你不喜欢IbatisNet替你做这件事情，则可以通过ISqlMapper mapper=builder.Configure()来获取sqlMapper实例。

iBatis提供了多种方法对SqlMapper.Config文档的内容进行加载，前面我们讲过默认情况下SqlMapper.Config的存放位置，那么如果我们不是放在了默认位置或者不是默认的文件名该怎么办呢？在默认情况下，我们可以使用这样的方法得到SqlMapper实例 ISqlMapper mapper=builder.Configure()，其实这个Configure可以接受一个参数，他可以是String类型，FilePath对象，Uri对象XmlDocument对象，甚至是Stream类型 比如：

String str=”file://F:/databse.config”;

builder.Configure(str);

我就采用传参数的方式：

这是一个简单的单例模式。通过反射找到那个配置文件然后传给builder.Configure（）；

4，简单看一下操作类是如何来执行增删改查的。

这里主要简单的提供了几个简单的方法，对于一些其它的方法的调用将在后面讲。第一篇就简单的介绍的这里，主要是为了让初学者可以快速的用起来。下面有一个简单的Demo可以下载，供初学者参考使用…………

注意的一些细节（作为初学者可能会碰到的问题）

1，配置没有设置为嵌入的资源，导致找不到文件

2，写错应用程序集的名字，或者命名空间不统一。

好了……就写到这儿吧……自己也是一个菜鸟，写它只是为了巩固一下自己学到的知识（上一个项目中刚用的，属于短平快的学习方式），肯定有很多不对的地方，欢迎大家指正………………

源码下载地址：http://download.csdn.net/detail/woaixiaozhi/5822555