IbatisNet的介绍和使用

时间:2022-08-12 21:39:45

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