iBatis中的重要接口SqlMapClient （一）

SqlMapClient，是iBatis中的重要接口，这个接口涉及到对SQL映射的执行和批处理。

 

现在，就先了解它的对query开头方法的定义。

 

首先是 queryForList 方法：

//指定SQL的ID，执行的结果返回List
queryForList(java.lang.String id) ;

//指定SQL的ID，并指定返回的行数
queryForList(java.lang.String id, int skip, int max) ;

//指定SQL的ID，并指定传入参数
queryForList(java.lang.String id, java.lang.Object parameterObject) ;

//指定SQL的ID，并指定传入参数，再指定返回的行数
queryForList(java.lang.String id, java.lang.Object parameterObject, int skip, int max) ;

 

接着是 queryForMap 方法：

//执行SQL的ID，并把结果中的某一字段作为map的key
queryForMap(java.lang.String id, java.lang.Object parameterObject, java.lang.String keyProp) ;

//同上，并且map中的value是指定的字段，而不是整个返回对象
queryForMap(java.lang.String id, java.lang.Object parameterObject, java.lang.String keyProp, java.lang.String valueProp) ;

 

再是queryForObject 方法：

//执行指定的SQL ID，并返回一个对象，如果查询出的函数过多，会有异常SQLException抛出
queryForObject(java.lang.String id) ;

//同上，并加上了传递的参数
queryForObject(java.lang.String id, java.lang.Object parameterObject) ;

//同上，并执行的返回对象的引用
queryForObject(java.lang.String id, java.lang.Object parameterObject, java.lang.Object resultObject) ;

 

最后，是 queryForPaginatedList 方法，也就是针对分页的方法： 但是这个方法已经Deprecated 了， 也就是不赞成使用这个方法了

 

//这两个方法返回的是 PaginatedList 接口。

//指定查询的SQL ID，并且规定了每页的数量 
queryForPaginatedList(java.lang.String id, int pageSize) ;

//同上，并且加上了指定的传参
queryForPaginatedList(java.lang.String id, java.lang.Object parameterObject, int pageSize) ;

 

最后一个，那就是 queryWithRowHandler，对查询的每一个结果进行处理：

//指定SQL id ，指定传参，并指定处理器
queryWithRowHandler(java.lang.String id, java.lang.Object parameterObject, RowHandler rowHandler) ;

//指定SQL id，指定处理器
queryWithRowHandler(java.lang.String id, RowHandler rowHandler) ;

 

现在了解一下这个 RowHandler 这个接口。

此接口只有一个定义方法：handlerRow(java.lang.Object valueObject)

 

所以，通常我们都实现这个接口，因为对每一个处理都是我们自己的需求。

其中的传入属性就是每一行的对象。