当前页面: 在线文档首页 > Spring Framework 2.1.0 API 文档英文版

SqlRowSetResultSetExtractor (Spring Framework API 2.1) - Spring Framework 2.1.0 API 文档英文版

---

Overview  Package   Class  Use  Tree  Deprecated  Index  Help		The Spring Framework
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

org.springframework.jdbc.core
Class SqlRowSetResultSetExtractor

java.lang.Object
  org.springframework.jdbc.core.SqlRowSetResultSetExtractor

All Implemented Interfaces:

ResultSetExtractor

---

public class SqlRowSetResultSetExtractor
extends Object
implements ResultSetExtractor

ResultSetExtractor implementation that returns a Spring SqlRowSet representation for each given ResultSet.

The default implementation uses a standard JDBC CachedRowSet underneath. This means that JDBC RowSet support needs to be available at runtime: by default, Sun's com.sun.rowset.CachedRowSetImpl class is used, which is part of JDK 1.5+ and also available separately as part of Sun's JDBC RowSet Implementations download (rowset.jar).

Since:

1.2

Author:

Juergen Hoeller

See Also:

newCachedRowSet(), SqlRowSet, JdbcTemplate.queryForRowSet(String), CachedRowSet

---

Constructor Summary
SqlRowSetResultSetExtractor()

 

Method Summary
protected  SqlRowSet	createSqlRowSet(ResultSet rs)           Create a SqlRowSet that wraps the given ResultSet, representing its data in a disconnected fashion.
Object	extractData(ResultSet rs)           Implementations must implement this method to process the entire ResultSet.
protected  CachedRowSet	newCachedRowSet()           Create a new CachedRowSet instance, to be populated by the createSqlRowSet implementation.

 

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Constructor Detail

SqlRowSetResultSetExtractor

public SqlRowSetResultSetExtractor()

Method Detail

extractData

public Object extractData(ResultSet rs)
                   throws SQLException

Description copied from interface: ResultSetExtractor

Implementations must implement this method to process the entire ResultSet.

Specified by:

extractData in interface ResultSetExtractor

Parameters:

rs - ResultSet to extract data from. Implementations should not close this: it will be closed by the calling JdbcTemplate.

Returns:

an arbitrary result object, or null if none (the extractor will typically be stateful in the latter case).

Throws:

SQLException - if a SQLException is encountered getting column values or navigating (that is, there's no need to catch SQLException)

---

createSqlRowSet

protected SqlRowSet createSqlRowSet(ResultSet rs)
                             throws SQLException

Create a SqlRowSet that wraps the given ResultSet, representing its data in a disconnected fashion.

This implementation creates a Spring ResultSetWrappingSqlRowSet instance that wraps a standard JDBC CachedRowSet instance. Can be overridden to use a different implementation.

Parameters:

rs - the original ResultSet (connected)

Returns:

the disconnected SqlRowSet

Throws:

SQLException - if thrown by JDBC methods

See Also:

newCachedRowSet(), ResultSetWrappingSqlRowSet

---

newCachedRowSet

protected CachedRowSet newCachedRowSet()
                                throws SQLException

Create a new CachedRowSet instance, to be populated by the createSqlRowSet implementation.

The default implementation creates a new instance of Sun's com.sun.rowset.CachedRowSetImpl class, which is part of JDK 1.5+ and also available separately as part of Sun's JDBC RowSet Implementations download.

Returns:

a new CachedRowSet instance

Throws:

SQLException - if thrown by JDBC methods

See Also:

createSqlRowSet(java.sql.ResultSet), CachedRowSetImpl

---

Overview  Package   Class  Use  Tree  Deprecated  Index  Help		The Spring Framework
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

Copyright © 2002-2007 The Spring Framework.