KeyHolder (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.support
Interface KeyHolder

All Known Implementing Classes:: GeneratedKeyHolder

public interface KeyHolder

Interface for retrieving keys, typically used for auto-generated keys as potentially returned by JDBC insert statements.

Implementations of this interface can hold any number of keys. In the general case, the keys are returned as a List containing one Map for each row of keys.

Most applications only use on key per row and process only one row at a time in an insert statement. In these cases, just call getKey to retrieve the key. The returned value is a Number here, which is the usual type for auto-generated keys.

Since:: 1.1
Author:: Thomas Risberg
See Also:: JdbcTemplate, SqlUpdate

Method Summary

Number getKey()
          Retrieve the first item from the first map, assuming that there is just one item and just one map, and that the item is a number.

List getKeyList()
          Return a reference to the List that contains the keys.

Map getKeys()
          Retrieve the first map of keys.

Method Summary
`Number`	`getKey()` Retrieve the first item from the first map, assuming that there is just one item and just one map, and that the item is a number.
`List`	`getKeyList()` Return a reference to the List that contains the keys.
`Map`	`getKeys()` Retrieve the first map of keys.

Method Detail

getKey

Number getKey()
              throws InvalidDataAccessApiUsageException

Retrieve the first item from the first map, assuming that there is just one item and just one map, and that the item is a number. This is the typical case: a single, numeric generated key.

Keys are held in a List of Maps, where each item in the list represents the keys for each row. If there are multiple columns, then the Map will have multiple entries as well. If this method encounters multiple entries in either the map or the list meaning that multiple keys were returned, then an InvalidDataAccessApiUsageException is thrown.

Returns:: the generated key
Throws:: InvalidDataAccessApiUsageException - if multiple keys are encountered.

getKeys

Map getKeys()
            throws InvalidDataAccessApiUsageException

Retrieve the first map of keys. If there are multiple entries in the list (meaning that multiple rows had keys returned), then an InvalidDataAccessApiUsageException is thrown.

Returns:: the Map of generated keys
Throws:: InvalidDataAccessApiUsageException - if keys for multiple rows are encountered

getKeyList

List getKeyList()

Return a reference to the List that contains the keys. Can be used for extracting keys for multiple rows (an unusual case), and also for adding new maps of keys.

Returns:: the List for the generated keys, with each entry being a Map of column names and key values