IBATISNet是一个使得SQL 语句或者 stored procedures与实体对象容易映射起来、简洁完整的框架,iBATIS framework将是你用更少的代码获得更多的数据库访问功能。
在http://shanyou.cnblogs.com/archive/2006/04/29/388610.html上面已经有几介绍的文章,都不错,让我有自己写不出内容的感觉,思考再三,还是写一点东西,一是介绍下为什么使用IbatisNet,它为我们解决了什么问题,二是梳理一下使用步骤
为什么需要IbatisNet??
我们先假定几个过去和现在使用ADO.NET操作数据库的场景
1 场景一 我们很难将操作数据库的sql语句从代码中分离,在著名的petshop3.0等例子也使用数据访问层将sql集中到一起,为此当我们改变sql语句不得不重新编译整个项目的代码
2 场景二 我们很难将实际的外观层,业务逻辑层和数据访问层分离,举例,你通过查询语句”Select A.Name,B.Qty from Cart A ,CartQty B where A.ID=B.ID” ,你在界面进行数据绑定时写下入下代码
<asp:BoundColumn DataField="Name" HeaderText="First"></asp:BoundColumn>
现在,根据查询语句发生变化”Select C.Code,B.Qty from Cart2 C ,CartQty B where C.ID=B.ID”,我们不得不重新编写外界的代码或者写含有别名的sql语句
IbatisNet解决问题
iBATIS DataMapper通过使用XML文档在sql语句和实体对象之间建立映射。
基本的步骤如下:
1) 提供一个参数,无论是对象还是一个Native类型。参数将用于设置sql语句或存储过程在运行时的值,如果运行时不需要参数,将忽略参数
2) 通过传送参数和在你的xml配制中的声明名字或者存储过程来执行映射。这一步将是魔术般的步骤。框架将会准备sql声明或者存储过程,用你的参数设置运行时数据值,执行sql语句或者存储过程,返回结果。
3) 在更新的时候,更新的行数将会被返回。在查询的时候,返回的将是一个对象或者对象的集合。结果对象,可以是一个plan-old对象或者native类型。
上面的过程在代码中的实现
你可以这样写一条语句就将你在界面上建立的实体类插入数据库
Mapper.Instance().Insert("InsertLineItem",lineItem);
// lineItem 是一个实体类的对象
你需要配制一个InsertLineItem.xml文档
<insert id="InsertLineItem" parameterClass="LineItem">
INSERT INTO [LinesItem]
(Order_Id, LineItem_LineNum, Item_Id, LineItem_Quantity, LineItem_UnitPrice)
VALUES
(#Order.Id#, #LineNumber#, #Item.Id#, #Quantity#, #Item.ListPrice#)
<selectKey type="post" resultClass="int" property="Id" >
select @@IDENTITY as value
</selectKey>
</insert>
如果你需要获得多行或者单行的数据,你可以这样在外界调用
IList productList = Mapper.Instance().QueryForList("selectProduct",categoryKey);
Product product = Mapper.Instance().QueryForObject("SelectProduct",productKey) as Product;
IbatisNet的配制文件介绍
1 providers.config 提供配制 常用的数据库连接程序 的xml文件
2 SqlMap.xml SQL语句执行结果和实体对象之间的映射文件,在系统中将出现多个这样的文件
3 SqlMap.config – 决定在运行时加载sqlmap.xml与providers.config的文件
IbatisNet的使用
1 创建表Person 表
为了测试方便,我把Person放在了Northwind表中
Name Type Size
PER_ID Long Integer 4 not null
PER_FIRST_NAME nvarchar 40 not null
PER_LAST_NAME nvarchar 40 not null
PER_BIRTH_DATE DateTime 8
PER_WEIGHT_KG float 8
PER_HEIGHT_M float 8
CREATE TABLE [dbo].[Person] (
[PER_ID] [int] IDENTITY (1, 1) NOT NULL ,
[PER_FIRST_NAME] [nvarchar] (50) COLLATE Chinese_PRC_CI_AS NOT NULL ,
[PER_LAST_NAME] [nvarchar] (50) COLLATE Chinese_PRC_CI_AS NOT NULL ,
[PER_BIRTH_DATE] [datetime] NULL ,
[PER_WEIGHT_KG] [float] NULL ,
[PER_HEIGHT_M] [float] NULL
) ON [PRIMARY]
2 增加配制文件注意地方:所有配制文件都去看看其官方的文档为准
Person.xml
properties.config
sqlmap.config
Person.xml中插入的语句配制
<insert id="Insert" parameterClass="Person">
<selectKey property="Id" type="post" resultClass="int">select @@IDENTITY as value</selectKey>
insert into PERSON
( PER_FIRST_NAME, PER_LAST_NAME,
PER_BIRTH_DATE, PER_WEIGHT_KG, PER_HEIGHT_M)
values
( #FirstName#, #LastName#,_par #BirthDate#, #WeightInKilograms#, #HeightInMeters#)
</insert>
properties.config中的数据连接配置
如果遇到问题,最好先看其说明文档,再通过单步调试。
2 定义Helper.cs类 返回一个SqlMapper SQL映射类
public abstract class Helper
{
public SqlMapper Mapper ()
{
return IBatisNet.DataMapper.Mapper.Instance ();
}
}
4 继续编写代码,形成最后项目IbatisTest