IBatis.net初步使用

最近加班比较忙，时间也比较琐碎，蛮久没有写东西了。这次就总结一下自己使用IBatis.net的一些总结吧。

IBatis简介

IBatis.net是一款开源的Orm框架，应该算是从java的IBatis项目演化而来的基于C#的Orm框架。

官方网站:http://www.mybatis.org/

项目下载地址:http://code.google.com/p/mybatisnet/

IBatis使用

1）、配置文件：providers.config---数据库提供者的配置文件，主要用于配置使用的数据库类型；SqlMap.config：配置入口文件，用于配置指向的数据提供者文件和各类sql映射文件。配置文件名称可自行设定（SqlMap.Config为默认的配置文件名）.

2）、配置文件的初始化：

public class MyMapper
{
public static string DbMapperFile = @"ConfigFile\SqlMap.config"; ///配置文件名
private static object mLock = new object();

private static volatile ISqlMapper _mapper = null;
/// <summary>
///
/// </summary>
/// <param name="obj"></param>
public static void Configure(object obj)
{
_mapper = null;
}

public static ISqlMapper SqlMapper
{
get
{
if (_mapper == null)
{
lock (mLock)
{
if (_mapper == null)
{
ConfigureHandler handler = new ConfigureHandler(Configure);
DomSqlMapBuilder builder = new DomSqlMapBuilder();
_mapper = builder.ConfigureAndWatch(DbMapperFile, handler);    //监视配置文件，不监视：builder.Configure();
}
}
}
return _mapper;
}
}
}

　初始化一个Dal'操作基类：

/// <summary>
/// Dal抽象基类
/// </summary>
/// <typeparam name="T"></typeparam>
public abstract class BaseDal<T> where T : class
{
protected ISqlMapper sqlMapper = null;
public BaseDal()
{
sqlMapper = HisMapper.SqlMapper;

}
public BaseDal(string configFile)
{
MyMapper.DbMapperFile = configFile;
sqlMapper = MyMapper.SqlMapper;
}
/// <summary>
/// 新增，底层默认返回Object
/// </summary>
/// <param name="statement"></param>
/// <param name="parameters"></param>
/// <returns></returns>
public object Add(string statement, object parameters)
{
return sqlMapper.Insert(statement, parameters);
}
/// <summary>
/// 删除
/// </summary>
/// <param name="statement"></param>
/// <param name="parameters"></param>
/// <returns></returns>
public int Delete(string statement, object parameters)
{
return sqlMapper.Delete(statement, parameters);
}
/// <summary>
/// 更新
/// </summary>
/// <param name="statement"></param>
/// <param name="parameters"></param>
/// <returns></returns>
public int Update(string statement, object parameters)
{
return sqlMapper.Update(statement, parameters);
}
/// <summary>
/// 查询返回集合
/// </summary>
/// <param name="statement"></param>
/// <param name="parameters"></param>
/// <returns></returns>
public IList<T> QueryForList(string statement, object parameters)
{
return sqlMapper.QueryForList<T>(statement, parameters);
}
/// <summary>
/// 查询返回对象
/// </summary>
/// <param name="statement"></param>
/// <param name="parameters"></param>
/// <returns></returns>
public object QueryForObj(string statement, object parameters)
{
return sqlMapper.QueryForObject(statement, parameters);
}
}

　　3）、实体Orm操作实现：

一、创建实体类，包含实体对应字段的定义（略）

二、创建对应的Xml映射文件，例子如下

<?xml version="1.0" encoding="utf-8" ?>
<sqlMap namespace="MyBatis3Sample.Model" xmlns="http://ibatis.apache.org/mapping" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<alias>
<typeAlias alias="Customer" type="MySample.Model.Customer, MySample.Model" />
</alias>

<!--Mapping Class To Sql Realation Teable-->
<resultMaps>
<resultMap id="CustomerResult" class="Customer">
<result property="CustomerId" column="CustomerId"/>
<result property="FirstName" column="FirstName"/>
<result property="LastName" column="LastName"/>
</resultMap>
</resultMaps>

<!--Mapping The SQl StateMent about CRUD chenkai-->
<statements>
<insert id="New_Customer"  parameterClass="Customer">
<![CDATA[INSERT INTO  tbCustomer
( FirstName ,
LastName
)
VALUES  ( #FirstName# , #LastName# )]]>
</insert>
<update id="Update_CustomerById">
<![CDATA[
update tbCustomer  set FirstName=#FirstName#,SecondName=#SecondName#
where CustomerId=#CustomerId#
]]>
</update>
<select id ="Select_All_Customer" resultMap="CustomerResult">
<![CDATA[
select CustomerId,FirstName,LastName from tbCustomer
]]>
</select>
<select id="Select_CustomerById" extends="Select_All_Customer" resultMap="CustomerResult">
<![CDATA[
where CustomerId=#CustomerId#
]]>
</select>
<select id="Select_CustomerByNamePrefix" extends="Select_All_Customer" resultMap="CustomerResult">
<dynamic prepend=" where ">
<isNotEmpty prepend =" and ">
FirstName like '$FirstNamePrefix$%'
</isNotEmpty>
<isNotEmpty prepend =" and ">
LastName like '$LastNamePrefix$%'
</isNotEmpty>
</dynamic>
</select>

<select id="Select_CustomerTotalCount"  resultClass="int">
<![CDATA[
select count(CustomerId) from tbCustomer
]]>
</select>
</statements>
</sqlMap>

　　分解：

a、<resultMaps>可包含多个resultmap---字段配置映射关系，将查出的字段映射到对应的类的对应字段

b、<statements>可包含多个statement---配置Sql语句，大致为select、insert 、update、delete，其他的没有太过深究。

c、“#FirstName#”其中FirstName为传递的参数，IBatis会自动解析其类型，“'$FirstNamePrefix$%'” 为模糊查询时参数的编写方式，也可以通过参数拼接的方式实现。参数在传递时大小写敏感，这点要注意

d、注意<dymanic>的动态sql实现，主要是写法。

e、每个statement的Id必须为一，不可存在重复，即使是在同一项目的其他的xml配置中也不可存在和当前statement的Id一致的statement，否则会报错。因为在ibatis进行配置读取时，会将各个statement加载，要求statement的id必须为一

f、statement中配置resultMap和resultClass的区别，如果不配置resultMap和resultClass会默认返回object类型，resultMap一般是用于配置到对应的映射配置；resultClass一般用于指向指定的类型，例如string/object等。

g、 <![CDATA[]]>类似于@“”，将语句标识为不转义。

总结

用Ibatis有一段时间了，基于sql编写的实现感觉上还是不错的。

附上部分帮助文件，例子代码就不上传了，因为是在实现的部分很简单也没有明确的测过。

Mapper提示文件