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的方式使用事务,这些方法的使用,我觉得就没必要解释了吧,开始,执行,若不成功、抛出异常,则回滚事务,然后进行相应的操作,这就看你要怎么设计啦.
- JavaScript 教程
- JavaScript 编辑工具
- JavaScript 与HTML
- JavaScript 与Java
- JavaScript 数据结构
- JavaScript 基本数据类型
- JavaScript 特殊数据类型
- JavaScript 运算符
- JavaScript typeof 运算符
- JavaScript 表达式
- JavaScript 类型转换
- JavaScript 基本语法
- JavaScript 注释
- Javascript 基本处理流程
- Javascript 选择结构
- Javascript if 语句
- Javascript if 语句的嵌套
- Javascript switch 语句
- Javascript 循环结构
- Javascript 循环结构实例
- Javascript 跳转语句
- Javascript 控制语句总结
- Javascript 函数介绍
- Javascript 函数的定义
- Javascript 函数调用
- Javascript 几种特殊的函数
- JavaScript 内置函数简介
- Javascript eval() 函数
- Javascript isFinite() 函数
- Javascript isNaN() 函数
- parseInt() 与 parseFloat()
- escape() 与 unescape()
- Javascript 字符串介绍
- Javascript length属性
- javascript 字符串函数
- Javascript 日期对象简介
- Javascript 日期对象用途
- Date 对象属性和方法
- Javascript 数组是什么
- Javascript 创建数组
- Javascript 数组赋值与取值
- Javascript 数组属性和方法
- PBE加密 .net 实现
- .net Core 图片验证码 基于SkiaSharp实现
- 解决git/github下载速度缓慢的问题总汇------转
- C语言程序框架注释的一种模板
- Kryo 入门指南
- C# 通过T4自动生成代码
- Netty 主从多线程
- 斐波那契数组-递归和循环实现
- KMP算法 C#实现 字符串查找简单实现
- elasticsearch压力测试工具之ESrally使用说明
- BitMap算法 .net实现 用于去重并且排序,适用于大型权限管理 ,大数据去重排序
- 5.FFMPEG-Qt移植ffmpeg、ffmpeg结构体介绍
- winform总结6=>线程和委托的关系
- winform总结3> 有趣的bat/winform程序完成自己的任务,然后把自己删除
- winform总结2> Action<> ,Action,func<>,委托相关的理解