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

MappingSqlQuery (Spring Framework) - Spring Framework 1.2.9 API 文档英文版

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

---

org.springframework.jdbc.object
Class MappingSqlQuery

java.lang.Object
  org.springframework.jdbc.object.RdbmsOperation
      org.springframework.jdbc.object.SqlOperation
          org.springframework.jdbc.object.SqlQuery
              org.springframework.jdbc.object.MappingSqlQueryWithParameters
                  org.springframework.jdbc.object.MappingSqlQuery

All Implemented Interfaces:

InitializingBean

Direct Known Subclasses:

SqlFunction

---

public abstract class MappingSqlQuery
extends MappingSqlQueryWithParameters

Reusable query in which concrete subclasses must implement the abstract mapRow(ResultSet, int) method to convert each row of the JDBC ResultSet into an object.

Simplifies MappingSqlQueryWithParameters API by dropping parameters and context. Most subclasses won't care about parameters. If you don't use contextual information, subclass this instead of MappingSqlQueryWithParameters.

Author:

Rod Johnson, Thomas Risberg, Jean-Pierre Pawlak

See Also:

MappingSqlQueryWithParameters

---

Nested Class Summary

 

Nested classes/interfaces inherited from class org.springframework.jdbc.object.MappingSqlQueryWithParameters
MappingSqlQueryWithParameters.ResultReaderImpl

 

Field Summary

 

Fields inherited from class org.springframework.jdbc.object.RdbmsOperation
logger

 

Constructor Summary
MappingSqlQuery()           Constructor that allows use as a JavaBean.
MappingSqlQuery(DataSource ds, String sql)           Convenient constructor with DataSource and SQL string.

 

Method Summary
protected abstract  Object	mapRow(ResultSet rs, int rowNum)           Subclasses must implement this method to convert each row of the ResultSet into an object of the result type.
protected  Object	mapRow(ResultSet rs, int rowNum, Object[] parameters, Map context)           This method is implemented to invoke the simpler mapRow template method, ignoring parameters.

 

Methods inherited from class org.springframework.jdbc.object.MappingSqlQueryWithParameters
newResultReader

 

Methods inherited from class org.springframework.jdbc.object.SqlQuery
execute, execute, execute, execute, execute, execute, execute, execute, execute, execute, execute, execute, findObject, findObject, findObject, findObject, findObject, findObject, findObject, findObject, findObject, findObject, getRowsExpected, setRowsExpected

 

Methods inherited from class org.springframework.jdbc.object.SqlOperation
compileInternal, newPreparedStatementCreator, newPreparedStatementSetter, onCompileInternal

 

Methods inherited from class org.springframework.jdbc.object.RdbmsOperation

afterPropertiesSet, allowsUnusedParameters, checkCompiled, compile, declareParameter, getDeclaredParameters, getGeneratedKeysColumnNames, getJdbcTemplate, getResultSetType, getSql, isCompiled, isReturnGeneratedKeys, isUpdatableResults, setDataSource, setFetchSize, setGeneratedKeysColumnNames, setJdbcTemplate, setMaxRows, setResultSetType, setReturnGeneratedKeys, setSql, setTypes, setUpdatableResults, supportsLobParameters, validateParameters

 

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

 

Constructor Detail

MappingSqlQuery

public MappingSqlQuery()

Constructor that allows use as a JavaBean.

---

MappingSqlQuery

public MappingSqlQuery(DataSource ds,
                       String sql)

Convenient constructor with DataSource and SQL string.

Parameters:

ds - DataSource to use to obtain connections

sql - SQL to run

Method Detail

mapRow

protected final Object mapRow(ResultSet rs,
                              int rowNum,
                              Object[] parameters,
                              Map context)
                       throws SQLException

This method is implemented to invoke the simpler mapRow template method, ignoring parameters.

Specified by:

mapRow in class MappingSqlQueryWithParameters

Parameters:

rs - ResultSet we're working through

rowNum - row number (from 0) we're up to

parameters - to the query (passed to the execute() method). Subclasses are rarely interested in these. It can be null if there are no parameters.

context - passed to the execute() method. It can be null if no contextual information is need.

Returns:

an object of the result type

Throws:

SQLException - if there's an error extracting data. Subclasses can simply not catch SQLExceptions, relying on the framework to clean up.

See Also:

mapRow(ResultSet, int)

---

mapRow

protected abstract Object mapRow(ResultSet rs,
                                 int rowNum)
                          throws SQLException

Subclasses must implement this method to convert each row of the ResultSet into an object of the result type.

Subclasses of this class, as opposed to direct subclasses of MappingSqlQueryWithParameters, don't need to concern themselves with the parameters to the execute method of the query object.

Parameters:

rs - ResultSet we're working through

rowNum - row number (from 0) we're up to

Returns:

an object of the result type

Throws:

SQLException - if there's an error extracting data. Subclasses can simply not catch SQLExceptions, relying on the framework to clean up.

---

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

---

Copyright (c) 2002-2007 The Spring Framework Project.