Polishing (in particular updating javadoc references to Apache Commons)
This commit is contained in:
@@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright 2002-2014 the original author or authors.
|
||||
* Copyright 2002-2015 the original author or authors.
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
@@ -83,7 +83,7 @@ import org.springframework.transaction.support.TransactionSynchronizationManager
|
||||
* <p>This transaction manager can be used as a replacement for the
|
||||
* {@link org.springframework.transaction.jta.JtaTransactionManager} in the single
|
||||
* resource case, as it does not require a container that supports JTA, typically
|
||||
* in combination with a locally defined JDBC DataSource (e.g. a Jakarta Commons
|
||||
* in combination with a locally defined JDBC DataSource (e.g. an Apache Commons
|
||||
* DBCP connection pool). Switching between this local strategy and a JTA
|
||||
* environment is just a matter of configuration!
|
||||
*
|
||||
@@ -126,8 +126,8 @@ public class DataSourceTransactionManager extends AbstractPlatformTransactionMan
|
||||
|
||||
/**
|
||||
* Set the JDBC DataSource that this instance should manage transactions for.
|
||||
* <p>This will typically be a locally defined DataSource, for example a
|
||||
* Jakarta Commons DBCP connection pool. Alternatively, you can also drive
|
||||
* <p>This will typically be a locally defined DataSource, for example an
|
||||
* Apache Commons DBCP connection pool. Alternatively, you can also drive
|
||||
* transactions for a non-XA J2EE DataSource fetched from JNDI. For an XA
|
||||
* DataSource, use JtaTransactionManager.
|
||||
* <p>The DataSource specified here should be the target DataSource to manage
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright 2002-2013 the original author or authors.
|
||||
* Copyright 2002-2015 the original author or authors.
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
@@ -53,7 +53,7 @@ import org.springframework.util.ClassUtils;
|
||||
* bean definition to a local DataSource (which is simpler and thus recommended).
|
||||
*
|
||||
* <p>If you need a "real" connection pool outside of a J2EE container, consider
|
||||
* <a href="http://jakarta.apache.org/commons/dbcp">Apache's Jakarta Commons DBCP</a>
|
||||
* <a href="http://commons.apache.org/proper/commons-dbcp">Apache Commons DBCP</a>
|
||||
* or <a href="http://sourceforge.net/projects/c3p0">C3P0</a>.
|
||||
* Commons DBCP's BasicDataSource and C3P0's ComboPooledDataSource are full
|
||||
* connection pool beans, supporting the same basic properties as this class
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright 2002-2012 the original author or authors.
|
||||
* Copyright 2002-2015 the original author or authors.
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
@@ -26,8 +26,8 @@ import org.springframework.util.Assert;
|
||||
|
||||
/**
|
||||
* Simple implementation of the standard JDBC {@link javax.sql.DataSource} interface,
|
||||
* configuring a plain old JDBC {@link java.sql.Driver} via bean properties, and returning
|
||||
* a new {@link java.sql.Connection} from every {@code getConnection} call.
|
||||
* configuring a plain old JDBC {@link java.sql.Driver} via bean properties, and
|
||||
* returning a new {@link java.sql.Connection} from every {@code getConnection} call.
|
||||
*
|
||||
* <p><b>NOTE: This class is not an actual connection pool; it does not actually
|
||||
* pool Connections.</b> It just serves as simple replacement for a full-blown
|
||||
@@ -40,7 +40,7 @@ import org.springframework.util.Assert;
|
||||
* for seamless switching to and from a local DataSource bean like this class.
|
||||
*
|
||||
* <p>If you need a "real" connection pool outside of a J2EE container, consider
|
||||
* <a href="http://jakarta.apache.org/commons/dbcp">Apache's Jakarta Commons DBCP</a>
|
||||
* <a href="http://commons.apache.org/proper/commons-dbcp">Apache Commons DBCP</a>
|
||||
* or <a href="http://sourceforge.net/projects/c3p0">C3P0</a>.
|
||||
* Commons DBCP's BasicDataSource and C3P0's ComboPooledDataSource are full
|
||||
* connection pool beans, supporting the same basic properties as this class
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright 2002-2012 the original author or authors.
|
||||
* Copyright 2002-2015 the original author or authors.
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
@@ -29,7 +29,7 @@ import org.springframework.util.ReflectionUtils;
|
||||
|
||||
/**
|
||||
* Implementation of the {@link NativeJdbcExtractor} interface for the
|
||||
* Jakarta Commons DBCP connection pool, version 1.1 or higher.
|
||||
* Apache Commons DBCP connection pool, version 1.1 or higher.
|
||||
*
|
||||
* <p>Returns the underlying native Connection, Statement, etc to application
|
||||
* code instead of DBCP's wrapper implementations. The returned JDBC classes
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright 2002-2012 the original author or authors.
|
||||
* Copyright 2002-2015 the original author or authors.
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
@@ -42,7 +42,7 @@ import java.sql.Statement;
|
||||
*
|
||||
* <p>When working with a simple connection pool that wraps Connections but not
|
||||
* Statements, a {@link SimpleNativeJdbcExtractor} is often sufficient. However,
|
||||
* some pools (like Jakarta's Commons DBCP) wrap <i>all</i> JDBC objects that they
|
||||
* some pools (like Apache's Commons DBCP) wrap <i>all</i> JDBC objects that they
|
||||
* return: Therefore, you need to use a specific {@code NativeJdbcExtractor}
|
||||
* (like {@link CommonsDbcpNativeJdbcExtractor}) with them.
|
||||
*
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
/*
|
||||
* Copyright 2002-2013 the original author or authors.
|
||||
* Copyright 2002-2015 the original author or authors.
|
||||
*
|
||||
* Licensed under the Apache License, Version 2.0 (the "License");
|
||||
* you may not use this file except in compliance with the License.
|
||||
@@ -17,7 +17,7 @@
|
||||
package org.springframework.jdbc.support.nativejdbc;
|
||||
|
||||
/**
|
||||
* Simple implementation of the {@link NativeJdbcExtractor} interface.
|
||||
* A simple implementation of the {@link NativeJdbcExtractor} interface.
|
||||
* Assumes a pool that wraps Connection handles but not DatabaseMetaData:
|
||||
* In this case, the underlying native Connection can be retrieved by simply
|
||||
* calling {@code conHandle.getMetaData().getConnection()}.
|
||||
@@ -35,10 +35,9 @@ package org.springframework.jdbc.support.nativejdbc;
|
||||
* flags to "true". If none of the statement types is wrapped - or you solely need
|
||||
* Connection unwrapping in the first place -, the defaults are fine.
|
||||
*
|
||||
* <p>SimpleNativeJdbcExtractor is a common choice for use with OracleLobHandler,
|
||||
* which just needs Connection unwrapping via the
|
||||
* {@link #getNativeConnectionFromStatement} method. This usage will work
|
||||
* with almost any connection pool.
|
||||
* <p>SimpleNativeJdbcExtractor is a common choice for use with OracleLobHandler, which
|
||||
* just needs Connection unwrapping via the {@link #getNativeConnectionFromStatement}
|
||||
* method. This usage will work with almost any connection pool.
|
||||
*
|
||||
* <p>For full usage with JdbcTemplate, i.e. to also provide Statement unwrapping:
|
||||
* <ul>
|
||||
@@ -47,8 +46,8 @@ package org.springframework.jdbc.support.nativejdbc;
|
||||
* <li>Use a SimpleNativeJdbcExtractor with all "nativeConnectionNecessaryForXxx"
|
||||
* flags set to "true" for C3P0 (all JDBC Statement objects are wrapped,
|
||||
* but none of the wrappers allow for unwrapping).
|
||||
* <li>Use a CommonsDbcpNativeJdbcExtractor for Jakarta Commons DBCP respectively
|
||||
* a JBossNativeJdbcExtractor for JBoss (all JDBC Statement objects are wrapped,
|
||||
* <li>Use a CommonsDbcpNativeJdbcExtractor for Apache Commons DBCP or a
|
||||
* JBossNativeJdbcExtractor for JBoss (all JDBC Statement objects are wrapped,
|
||||
* but all of them can be extracted by casting to implementation classes).
|
||||
* </ul>
|
||||
*
|
||||
|
||||
Reference in New Issue
Block a user