Ibatis学习总结7--SqlMapClient 执行 SQL 语句

SqlMapCient 类提供了执行所有 mapped statement 的 API。这些方法如下：

 public int insert(String statementName, Object parameterObject)
 throws SQLException

 public int update(String statementName, Object parameterObject)
 throws SQLException

 public int delete(String statementName, Object parameterObject)
 throws SQLException

 public Object queryForObject(String statementName, Object parameterObject)
 throws SQLException

 public Object queryForObject(String statementName, Object parameterObject, Object resultObject) throws SQLException

 public List queryForList(String statementName, Object parameterObject)
 throws SQLException

 public List queryForList(String statementName, Object parameterObject, int skipResults, int maxResults)
 throws SQLException

 public List queryForList (String statementName,

 Object parameterObject, RowHandler rowHandler)

 throws SQLException

 public PaginatedList queryForPaginatedList(String statementName, Object parameterObject, int pageSize)
 throws SQLException

 public Map queryForMap (String statementName, Object parameterObject, String keyProperty)
 throws SQLException

 public Map queryForMap (String statementName, Object parameterObject, String keyProperty, String valueProperty)
 throws SQLException

在上面的每个方法中，Mapped  Statement  的名称作为第一个参数。这个名称要对应<statement>的名称属性。另外，第二个参数总是参数对象。如果不需要参数对象，可以为

null。除了这些之外，上面的方法就没有相同的了。下面简单地介绍一下它们的不同之处。

* insert( )，update( )，delete( )

这些方法用于数据更新（即非查询语句）。这就是说，使用下面的查询方法来执行数据更新操作并不是不可能。但这显得很奇怪，并明显依赖于 JDBC 的驱动程序。执行 update()， 返回受影响数据记录的数目。

* queryForObject( )

queryForObject()方法有两个版本。一个返回查询得到的新对象，另一个用一个事先生成 的对象作为参数。后者对于使用多个查询为对象赋值很有用。

* queryForList( )

queryForList()方法也有三个版本。第一个执行一个查询并返回所有的查询结果。第二个 允许指定跳过结果的数目（即开始点）和返回结果的最大数目。对于查询一个数量很大的结 果集，并且不想返回所有的数据时很有用。最后一个版本的 queryForList()方法需要一个行处理器（row handler）作为输入参数。这 个方法可以让您使用结果对象，而不是数据表的行和列来逐行地处理查询结果集。这个方法 的参数除了例行的名称和参数对象外，还包括了一个实现了 RowHandler 接口的类的实例。 RowHandler 接口只有一个方法：

public void handleRow (Object object, List list);对于每一行从数据库中返回的数据，RowHandler 接口的方法都会被执行。这种处理数 据的方法，简洁而具有扩展性。

* queryForPaginatedList( )

对于要返回一个可以向前和向后翻页的数据子集，queryForPaginatedList()方法很有用， 它返回一个可管理的 List  对象。通常用于只显示一部分查询结果的用户界面。一个常见的 例子是，搜索引擎找到了 10000 条结果，但每次只显示其中的 100 条。PaginatedList 接口包 含了向前和向后翻页的方法（nextPage()，previousPage()，gotoPage()），并提供了检查翻页 状态的方 法（ isFirstPage() ， isMiddlePage() ， isLastPage() ， isPreviousPageAvailable() ， getPageIndex()，getPageSize()）。虽然不能从 PaginatedList 接口得到查询结果集的总数，但 这个总数可以再执行一个简单的语句 count()来得到。否则，PaginatedList 接口会大大的降低 性能。

* queryForMap( )

queryForMap()方法将结果集放在一个Map 对象中，这个 Map 对象用一个传入参数 keyProperty 作为 key 值。例如，要读入一批 Employee 对象，您可以将这些 Employee 对象放在一个用 employeeNumber 属性作为 key 值 的 Map 对象中。Map 对象的值可以是整个 Employee 对象，也可以是 Employee 对象的另一 个属性，属性的名称由第二个参数 valueProperty 指定。例如，您可能只是需要一个 Map 对 象，用员工号作为 key 值，员工姓名作为 value 值。不要把它和用 Map 作为结果对象的概念 混淆。这个方法可以使用 Java Bean 和 Map（或基本类型的包装类，但不可能这样用）作为 结果对象。

代码实例：

例子1：执行update（insert，update，delete）

 sqlMap.startTransaction();
 Product product = new Product(); product.setId (1); product.setDescription (“Shih Tzu”);
 int rows = sqlMap.insert (“insertProduct”, product);
 sqlMap.commitTransaction(); 

例子2：查询成对象（select）

 sqlMap.startTransaction();
 Integer key = new Integer (1);
 Product product = (Product)sqlMap.queryForObject (“getProduct”, key); sqlMap.commitTransaction(); 

例子3：用预赋值的结果对象查询成对象（select）

 sqlMap.startTransaction();
 Customer customer = new Customer(); sqlMap.queryForObject(“getCust”, parameterObject, customer); 
  sqlMap.queryForObject(“getAddr”, parameterObject, customer); sqlMap.commitTransaction(); 

例子4：查询成对象List（select）

 sqlMap.startTransaction();
 List list = sqlMap.queryForList (“getProductList”, null);
 sqlMap.commitTransaction();

例子5：用结果集边界查询成对象List（select）

 sqlMap.startTransaction();
 List list = sqlMap.queryForList (“getProductList”, null, 0, 40); sqlMap.commitTransaction();

例子6：用RowHandler执行查询（select）

 public class MyRowHandler implements RowHandler {
 public void handleRow (Object object, List list) throws SQLException { Product product = (Product) object;
 product.setQuantity (10000);
 sqlMap.update (“updateProduct”, product);
 // Optionally you could add the result object to the list.
 // The list is returned from the queryForList() method.
 }
 }
 sqlMap.startTransaction();
 RowHandler rowHandler = new MyRowHandler();
 List list = sqlMap.queryForList (“getProductList”, null, rowHandler);
 sqlMap.commitTransaction(); 

例子7：查询成Paginated List（select）

 PaginatedList list =
 sqlMap.queryForPaginatedList (“getProductList”, null, 10);
 list.nextPage(); list.previousPage(); 

例子9：查询成Map（select）

 sqlMap.startTransaction();
 Map map = sqlMap.queryForMap (“getProductList”, null, “productCode”);
 sqlMap.commitTransaction();
 Product p = (Product) map.get(“EST-93”);

注意：自动提交，当没调用 startTransaction 的情况下，statements 会自动提交。没必要 commit/rollback。