IBatis.Net 老技术新研究

我们现在用的数据访问组件封装了IBatis.Net框架，提供了标准的数据访问接口和服务。正好总结一下老技术IBatis.Net
在进行实际的数据访问开发之前，我们先了解一下：IBatis.Net中几个重要的配置文件和一些关键的技术原理：
4个重要的配置文件：

1. Providers.config：数据库连接驱动配置文件，我们主要用SQLServer数据库连接驱动
2. Mapper.xml，例如： DataPermissions.xml，定义SQL语句和结果集映射关系。
3. SqlMap.config：统一管理数据库连接驱动、连接信息、Mapper文件列表
4. Database_***.Config文件：存储数据库的连接信息

关键的技术特性

1. IBatis是一个半自动化的ORM框架，支持多种业界主流的数据库，支持开发人员写SQL，这样开发人员就可以写出尽可能优化的SQL
2. SqlMapper文件中主要包含alias类别名，ResultMaps结果集映射，Statements各类SQL语句
3. SqlMapper文件中，实体类的属性对应ResultMap中的Property，实体类的属性同时对应数据库表中的Column
4. IBatis中的SqlMapper文件中，#代表SQL绑定；$代表SQL拼接，有SQL注入风险，不建议使用
5. 基于Castle的代理类技术，支持Dao接口，Dao接口中的方法必须和SqlMapper文件中的SqlID保持一致。这样DaoService在构造Dao接口的代理实现类时才可以定位到指定的SQL，然后执行。
6. 支持批量SQL操作，例如Insert、Update和Delete
7. 支持返回一对多，多对多关联结果集
8. 支持数据库事务
9. 支持数据缓存：全局缓存和会话缓存

开发一个数据访问的业务功能，主要有以下4个步骤：

1. 梳理好业务需求，定义接口；
2. 定义IBatis Mapper文件，根据接口的方法一一实现SQL语句；
3. 设置好数据库连接，将IBatis Mapper文件的路径添加到SqlMap配置文件中；
4. 调用DaoService，获取接口的实现，访问数据库。

示例几个关键的写法
1. 一对多关系，批量Insert

  <insert id="SaveDomainModel" parameterClass="DomainModel">
      begin
      INSERT INTO Meta_DomainModel(ID,Name,RootDomainObjectID, IsCache, CacheStrategy, IsLogicallyDeleted, DataLoaderConfig, Version,Creator,LastModifier)VALUES(
      #ID#,#Name#,#RootDomainObjectID#,#IsCache:VarChar#,#CacheStrategy#,#IsLogicDelete:VarChar#,#DataLoaderConfig#,#Version#,#Creator#,#LastModifier#)
      <iterate conjunction=" " open="" close=""  property="DomainObjects">
        INSERT INTO Meta_DomainObject(ID,Name,DomainModelID,IsRootObject,ParentObjectID,ClazzReflectType,PropertyName,IsLazyLoad,DataObjectID,Creator,LastModifier)
        VALUES(#DomainObjects[].ID#,#DomainObjects[].Name#,#DomainObjects[].DomainModelID#,#DomainObjects[].IsRootObject:VarChar#,#DomainObjects[].ParentObjectID#,#DomainObjects[].ClazzReflectType#,
        #DomainObjects[].PropertyName#,#DomainObjects[].IsLazyLoad:VarChar#,#DomainObjects[].DataObjectID#,#DomainObjects[].Creator#,#DomainObjects[].LastModifier#)
      </iterate>
      end;
    </insert>

2. 简单批量Insert插入

    <insert id="SaveDomainObjectElements" parameterClass="ArrayList">
      begin
      <iterate conjunction=" " open="" close="" >
        INSERT INTO Meta_DomainObjectElement(ID,Name,Alias,DisplayName,DomainObjectID,DataType,Length,Precision,DefaultValue,IsAllowNull,ElementType,DataColumnID,
        PropertyType,PropertyName,IsForQuery,Creator,LastModifier)
        VALUES(#[].ID#,#[].Name#,#[].Alias#,#[].DisplayName#,#[].DomainObjectID#,#[].DataType#,#[].Length#,#[].Precision#,#[].DefaultValue#,#[].IsAllowNull:VarChar#,#[].ElementType#,#[].DataColumnID#,
        #[].PropertyType#,#[].PropertyName#,#[].IsForQuery:VarChar#,#[].Creator#,#[].LastModifier#)
      </iterate>
      end;
    </insert>

3. 查询一对多结果集

  <resultMap id="DataObjectResultMap" class="DataObject" groupby="ID">
      <result property="ID" column="ID" />
      <result property="Name" column="Name" />
      <result property="Descriptions" column="Descriptions" />
      <result property="DataSourceName" column="DataSourceName" />
      <result property="LogicTableName" column="LogicTableName" />
      <result property="IsTableSharding" column="IsTableSharding" />
      <result property="IsDatabaseSharding" column="IsDatabaseSharding" />
      <result property="TableShardingStrategyID" column="TableShardingStrategy" />
      <result property="DatabaseShardingStrategyID" column="DatabaseShardingStrategy" />
      <result property="IsView" column="IsView" />
      <result property="IsLogicallyDeleted" column="IsLogicallyDeleted" />
      <result property="Version" column="Version" />
      <result property="Columns" resultMapping="MetadataMapper.DataColumnResultMap"></result>
      <result property="Creator" column="Creator" />
      <result property="CreateTime" column="CreateTime" />
      <result property="LastModifier" column="LastModifier" />
      <result property="LastModifyTime" column="LastModifyTime" />
    </resultMap>
    <resultMap id="DataColumnResultMap" class="DataColumn">
      <result property="ID" column="C_ID" />
      <result property="ColumnName" column="ColumnName" />
      <result property="DisplayName" column="DisplayName" />
      <result property="DataObjectID" column="DataObjectID" />
      <result property="DataTypeID" column="DataType" />
      <result property="Length" column="Length" />
      <result property="Precision" column="Precision" />
      <result property="DefaultValue" column="DefaultValue" />
      <result property="IsNullable" column="IsNullable" />
      <result property="IsPkColumn" column="IsPkColumn" />
      <result property="IsSystem" column="IsSystem" />
      <result property="IsShardingColumn" column="IsShardingColumn" />      
      <result property="ColumnOrder" column="ColumnOrder" />
      <result property="Creator" column="C_Creator" />
      <result property="CreateTime" column="C_CreateTime" />
      <result property="LastModifier" column="C_LastModifier" />
      <result property="LastModifyTime" column="C_LastModifyTime" />
    </resultMap>
  

对应的Select 语句

    <select id="GetDataObject" resultMap="DataObjectResultMap" parameterClass="string">
      SELECT Meta_DataObject.ID,Meta_DataObject.Name,Descriptions, DataSourceName, LogicTableName, IsTableSharding, IsDatabaseSharding, TableShardingStrategy,DatabaseShardingStrategy,IsView,IsLogicallyDeleted,Version,Meta_DataObjectColumn.Creator,Meta_DataObjectColumn.LastModifier,Meta_DataObjectColumn.CreateTime,Meta_DataObjectColumn.LastModifyTime,
      Meta_DataObjectColumn.ID as C_ID,ColumnName,DisplayName,DataObjectID,DataType,Length,Precision,DefaultValue,IsNullable,IsPkColumn,IsShardingColumn,IsSystem,ColumnOrder,
      Meta_DataObjectColumn.Creator as C_Creator,Meta_DataObjectColumn.LastModifier as C_LastModifier,Meta_DataObjectColumn.CreateTime as C_CreateTime,Meta_DataObjectColumn.LastModifyTime as C_LastModifyTime
      FROM Meta_DataObject
      LEFT JOIN Meta_DataObjectColumn on Meta_DataObjectColumn.DataObjectID = Meta_DataObject.ID
      WHERE Meta_DataObject.ID=#id#
    </select>

4. 批量删除多张表

   <delete id="DeleteShardingStrategy" parameterClass="string">
      begin
      DELETE FROM Meta_ShardingColumn WHERE ShardingStrategyID=#id#
      DELETE FROM Meta_ShardingStrategy WHERE ID=#id#
      end;
    </delete>

5. 删除指定数据

 <delete id="DeleteShardingColumns" parameterClass="string">
      DELETE FROM Meta_ShardingColumn WHERE DataObjectID=#id#
    </delete>

6. 查询数据行数

<select id="IsTaskExist" resultClass="int" parameterClass="string">
      SELECT COUNT(1) FROM TableTask WHERE name=#Name#
    </select>

以上就是一些简单的IBatis.Net总结。

周国庆

2017/10/14