Spring Data JDBC Extensions Reference Documentation

Authors

Thomas Risberg

2.0.0.M1

Copies of this document may be made for your own use and for distribution to others, provided that you do not charge any fee for such copies and further provided that each copy contains this Copyright Notice, whether distributed in print or electronically.


Table of Contents

Preface
I. Core JDBC Extensions
Overview
1. Features provided
2. Requirements
1. Support classes that extend Spring features
1.1. Mapping a one-to-many relationship
II. JDBC Extensions for the Oracle Database
Overview
1. Features provided
2. Requirements
2. Oracle Pooling DataSource
2.1. Configuration using the traditional <bean> element
2.2. Using the "orcl" namespace to configure the OracleDataSource
2.3. Using a properties file directly for connection properties
2.4. Additional connection and cache properties
2.4.1. Using the property file for additional connection properties
2.4.2. Using the property file for additional cache properties
2.4.3. Using "connection-properties" element for additional connection properties
2.4.4. Using "connection-cache-properties" element for additional cache properties
2.4.5. Using "username-connection-proxy" element for proxy connections
2.5. Summary of configuration options for the "pooling-data-source"
3. Fast Connection Failover
3.1. DataSource Configuration
3.2. AOP Configuration for Fast Connection Failover Retry
3.2.1. Configuration when defining transactions using a <tx:advice> and an <aop:advisor>
3.2.2. Configuration when defining transactions using @Transactional annotation
3.3. Configuration options for <rac-failover-interceptor>
4. Oracle's Streams AQ (Advanced Queueing)
4.1. Supported payload types
4.2. Configuration of the Connection Factory using the "orcl" namespace
4.3. Configuring the Connection Factory to use the same local transaction as your data access code.
4.4. Configuration when using a SYS.XMLType payload
4.4.1. Enqueuing XML messages
4.4.2. Dequeuing XML messages
4.5. Configuration when using a custom ADT payload
4.5.1. Enqueuing ADT messages
4.5.2. Dequeuing ADT messages
5. XML Types
5.1. Dependencies
5.2. Writing XML to an XMLTYPE column
5.3. Reading XML from an XMLTYPE column
5.4. Marshalling an object to an XMLTYPE column
5.5. Unmarshalling an object from an XMLTYPE column
6. Advanced Data Types
6.1. Using a STRUCT parameter
6.1.1. Using an SQLData implementation for a STRUCT IN parameter
6.1.2. Using SqlReturnSqlData with an SQLData implementation from a STRUCT OUT parameter
6.1.3. Setting STRUCT attribute values using SqlStructValue for an IN parameter
6.1.4. Using SqlReturnStruct to access STRUCT data from an OUT parameter
6.2. Using an ARRAY parameter
6.2.1. Setting ARRAY values using SqlArrayValue for an IN parameter
6.2.2. Using SqlReturnArray to handle the ARRAY from an OUT parameter
6.3. Handling a REF CURSOR
6.3.1. Retrieving data using a ParameterizedBeanPropertyRowMapper from a REF CURSOR
7. Custom DataSource Connection Configurations
7.1. Configuration of a Proxy Authentication
7.2. Configuration of a Custom DataSource Connection Preparer