iBatis.Net(4):DataMapper API

在iBatis.Net中,可以通过SqlMapper实例访问DataMapper API,其实以前写的都是一些iBatis.Net的概念和一些配置的问题,从这一篇开始,才是真正的精髓,也是我们使用iBatis.NET真正开始完整我们对数据库的任务的开始,这一篇我主要写一些DataMapper API,的定义、作用、使用方式,很遗憾,这一篇应该还是不会出现任何实例,因为还没有数据实体类和映射文档,这将会在下一篇写到

Insert/Delete/Update

public object Insert(string statementName, object parameterObject);

public int Delete(string statementName, object parameterObject);
public int Update(string statementName, object parameterObject);

从方法名就可以看的出来他们要执行的操作,如果您没有使用过iBatis,肯定会疑惑为什么没有一个叫做Select的方法,的确,再我第一次接触他的时候,也这么想,不过如果您能完整的看完这一篇的话,就回觉得这个疑惑其实有点蠢啦 ,呵呵,谁没有蠢过呢

参数statementName:在映射文件中定义的节点id属性值(下篇详细写到)

参数parameterObject:输入参数,通常是一个实体类

返回值:在Delete和Update方法中,方法返回受影响的行数,如果在映射文件节点Insert中加入了selectKey,就可以产生主键并返回它

QueryForObject

public object QueryForObject(string statementName, object parameterObject);
public T QueryForObject<T>(string statementName, object parameterObject);
public T QueryForObject<T>(string statementName, object parameterObject, T instanceObject);
public object QueryForObject(string statementName, object parameterObject, object resultObject)

注意啦,Select来啦,这些方法的实质就是Select,如果我们查询的结果是一行数据,并且在映射文件中定义了与查询结果对应的实体类,那么执行此方法返回的就是一个这个实体类的对象,在实际引用中经常会用到组合的查询操作,那么就可以在程序运行中管理返回对象的类型,我们可以把对象作为第三个参数传递到方法中

QueryForList

public IList<T> QueryForList<T>(string statementName, object parameterObject);

public IList QueryForList(string statementName, object parameterObject);

public void QueryForList<T>(string statementName, object parameterObject, IList<T> resultObject);

public void QueryForList(string statementName, object parameterObject, IList resultObject);

public IList<T> QueryForList<T>(string statementName, object parameterObject, int skipResults,int maxResults);

public IList QueryForList(string statementName, object parameterObject, int skipResults, int maxResults);

QueryForObject方法是用来返回一行数据,那么这里的QueryForList就是返回多行结果啦,他返回的是一个实现了IList结构的列表对象,当然也可以是泛型类型的,这样就会省点装箱拆箱的过程啦,参数skipResults,表示从结果行掉过skipResults行后返回,maxResults表示返回的行数(当然,如果结果中根本没超过maxResults行,那么这个参数就失效啦)

QueryWithRowDelegate

public IList<T> QueryWithRowDelegate<T>(string statementName, object parameterObject, RowDelegate<T> rowDelegate);
public IList QueryWithRowDelegate(string statementName, object parameterObject, RowDelegate rowDelegate);

如果我们在我们返回结果集的时候,需要对结果集中的对象进行一些处理,比如类型转换,或者需要过滤到我们定义的某种规则的行,我们就可以使用这个方法,向方法中传递一个RowDelegate委托方法来处理这些事情

QueryForDictionary/QueryForMap

public IDictionary<K, V> QueryForDictionary<K, V>(string statementName, object parameterObject, string keyProperty);

public IDictionary QueryForDictionary(string statementName, object parameterObject, string keyProperty);

public IDictionary<K, V> QueryForDictionary<K, V>(string statementName, object parameterObject, string keyProperty, string valueProperty);

public IDictionary QueryForDictionary(string statementName, object parameterObject, string keyProperty, string valueProperty);

public IDictionary<K, V> QueryForDictionary<K, V>(string statementName, object parameterObject, string keyProperty, string valueProperty, DictionaryRowDelegate<K, V> rowDelegate);

public IDictionary QueryForMap(string statementName, object parameterObject, string keyProperty);

public IDictionary QueryForMap(string statementName, object parameterObject, string keyProperty, string valueProperty);

public IDictionary QueryForMapWithRowDelegate(string statementName, object parameterObject, string keyProperty, string valueProperty, DictionaryRowDelegate rowDelegate);

如果您理解了QueryForList,就不难理解QueryForDictionary,他返回一个实现了IDictionary接口的字典类型,他的key值是由keyProperty指定的,如果我们不需要结果集中存放的是整个对象,而是某一列值,还可以使用valueProperty指定一个值来确定返回结果中的列值

Session

在iBatis.Net中,一个会话就是一个Connection和一个Transaction容器,使用一个using语句块打开一个Connection

using(IDalSession mySession=sqlMap.OpenConnection())
{
    //do something
}

Connection

public ISqlMapSession OpenConnection();

public ISqlMapSession OpenConnection(string connectionString);

public void CloseConnection();

可以使用一个Open和一个Close定界一个Connection,或者使用一个using语句块,在这个语句块执行完毕后就会自动调用一个CloseConnection方法

Transaction

public ISqlMapSession BeginTransaction();

public ISqlMapSession BeginTransaction(bool openConnection);

public ISqlMapSession BeginTransaction(IsolationLevel isolationLevel);

public ISqlMapSession BeginTransaction(string connectionString);

public ISqlMapSession BeginTransaction(bool openNewConnection, IsolationLevel isolationLevel);

public ISqlMapSession BeginTransaction(string connectionString, IsolationLevel isolationLevel);

public ISqlMapSession BeginTransaction(string connectionString, bool openNewConnection, IsolationLevel isolationLevel);

public void CommitTransaction();

public void CommitTransaction(bool closeConnection);

public void RollBackTransaction();

public void RollBackTransaction(bool closeConnection);

对数据库的操作,当然少不了对事务的支持啦,当然iBatis.Net也提供给了我们很好的对事务的支持,当然,我们还是可以使用TransactionScope的方式使用事务,这些方法的使用,我觉得就没必要解释了吧,开始,执行,若不成功、抛出异常,则回滚事务,然后进行相应的操作,这就看你要怎么设计啦.

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏一个会写诗的程序员的博客

Groovy&Java动态编译执行

工作中,遇到部分业务经常动态变化,或者在不发布系统的前提下,对业务规则进行调整。那么可以将这部分业务逻辑改写成Groovy脚本来执行,那么就可以在业务运行过程中...

942
来自专栏c#开发者

BizTalk Orchestration execute Flat file disassembler ReceivePipeline

需求是这样,在一个inbound XML中有个一点节点使用平文件的方式存放,还要解析比如固定长度或根据特殊字符截取字段 也就是需要在流程里面先把输入的XML的节...

35113
来自专栏Create Sun

基础拾遗------特性详解【含常用过滤器实例】

前言  本来7月份想着是用一个月把基础拾遗写完的,结果断断续续写了4个月了,才写了这几篇,这两天又规划着多写几篇,希望能坚持吧。前两天一次和同事聊天提到了特性...

34417
来自专栏跟着阿笨一起玩NET

SQL递归查询(with cte as)

  递归CTE最少包含两个查询(也被称为成员)。第一个查询为定点成员,定点成员只是一个返回有效表的查询,用于递归的基础或定位点。第二个查询被称为递归成员,使该查...

431
来自专栏XAI

微信二次开发Java自定义菜单事件实现

微信二次开发--java http://blog.csdn.net/lyq8479/ 这个是柳峰的CSDN博客。大家可以看大神的教程。里面有所有的代码。 项目整...

5166
来自专栏Java成长之路

二、OutOfMemoryError实战

本文通过一些可执行代码来验证异常发生的场景,并且会初步介绍几个与内存相关的最基本的虚拟机参数。 本文的主要目的有两个: 1. 通过代码验证Java虚拟机...

522
来自专栏Java学习网

高性能Java解析器实现过程详解

高性能Java解析器实现过程详解 如果你没有指定数据或语言标准的或开源的Java解析器, 可能经常要用Java实现你自己的数据或语言解析器。或者,可能有很多解析...

2906
来自专栏pangguoming

SpringBoot实战 之 异常处理篇

在互联网时代,我们所开发的应用大多是直面用户的,程序中的任何一点小疏忽都可能导致用户的流失,而程序出现异常往往又是不可避免的,那该如何减少程序异常对用户体验的影...

3527
来自专栏Golang语言社区

GoStub框架二次开发实践

序言 要写出好的测试代码,必须精通相关的测试框架。对于Golang的程序员来说,至少需要掌握下面四个测试框架: GoConvey GoStub GoMock M...

38611
来自专栏数据小魔方

左手用R右手Python系列之——noSQL基础与mongodb入门

12月的第一天,祝所有小伙伴儿的12月都能够被温柔以待。 能在学校悠哉写推送的日子所剩不多了,为了珍惜剩下所剩不多的推送机会,打算12月写一些实践性强一些的内...

4007

扫码关注云+社区