Javadoc fixes and pruning of outdated references

spring-jdbc/src/main/java/org/springframework/jdbc/support/lob/DefaultLobHandler.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2014 the original author or authors.
+ * Copyright 2002-2016 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.
@@ -60,9 +60,8 @@ import org.apache.commons.logging.LogFactory;
  * argument directly. Consider switching the {@link #setStreamAsLob "streamAsLob"}
  * property to "true" when operating against a fully compliant JDBC 4.0 driver.
  *
- * <p>Finally, primarily as a direct equivalent to {@link OracleLobHandler},
- * this LobHandler also supports the creation of temporary BLOB/CLOB objects.
- * Consider switching the {@link #setCreateTemporaryLob "createTemporaryLob"}
+ * <p>Finally, this LobHandler also supports the creation of temporary BLOB/CLOB
+ * objects. Consider switching the {@link #setCreateTemporaryLob "createTemporaryLob"}
  * property to "true" when "streamAsLob" happens to run into LOB size limitations.
  *
  * <p>See the {@link LobHandler} interface javadoc for a summary of recommendations.

spring-jdbc/src/main/java/org/springframework/jdbc/support/lob/LobCreator.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2012 the original author or authors.
+ * Copyright 2002-2016 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.
@@ -48,7 +48,6 @@ import java.sql.SQLException;
  * @see #close()
  * @see LobHandler#getLobCreator()
  * @see DefaultLobHandler.DefaultLobCreator
- * @see OracleLobHandler.OracleLobCreator
  * @see java.sql.PreparedStatement#setBlob
  * @see java.sql.PreparedStatement#setClob
  * @see java.sql.PreparedStatement#setBytes

spring-jdbc/src/main/java/org/springframework/jdbc/support/lob/LobHandler.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2016 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.
@@ -24,9 +24,6 @@ import java.sql.SQLException;
 /**
  * Abstraction for handling large binary fields and large text fields in
  * specific databases, no matter if represented as simple types or Large OBjects.
- * Its main purpose is to isolate Oracle 9i's peculiar handling of LOBs in
- * {@link OracleLobHandler}; most other databases should be able to work
- * with the provided {@link DefaultLobHandler}.
  *
  * <p>Provides accessor methods for BLOBs and CLOBs, and acts as factory for
  * LobCreator instances, to be used as sessions for creating BLOBs or CLOBs.
@@ -41,15 +38,6 @@ import java.sql.SQLException;
  * {@code PreparedStatement.setBlob/setClob} (e.g. for PostgreSQL), through
  * setting the {@link DefaultLobHandler#setWrapAsLob "wrapAsLob"} property.
  *
- * <p>Unfortunately, Oracle 9i just accepts Blob/Clob instances created via its own
- * proprietary BLOB/CLOB API, and additionally doesn't accept large streams for
- * PreparedStatement's corresponding setter methods. Therefore, you need to use
- * {@link OracleLobHandler} there, which uses Oracle's BLOB/CLOB API for both types
- * of access. The Oracle 10g+ JDBC driver will work with {@link DefaultLobHandler}
- * as well, with some limitations in terms of LOB sizes depending on DBMS setup;
- * as of Oracle 11g (or actually, using the 11g driver even against older databases),
- * there should be no need to use {@link OracleLobHandler} at all anymore.
- *
  * <p>Of course, you need to declare different field types for each database.
  * In Oracle, any binary content needs to go into a BLOB, and all character content
  * beyond 4000 bytes needs to go into a CLOB. In MySQL, there is no notion of a
@@ -65,10 +53,7 @@ import java.sql.SQLException;
  * if you happen to run into LOB size limitations with your (Oracle) database setup.
  * <li><b>Oracle 10g driver:</b> Use {@link DefaultLobHandler} with standard setup.
  * On Oracle 10.1, set the "SetBigStringTryClob" connection property; as of Oracle 10.2,
- * DefaultLobHandler should work with standard setup out of the box. Alternatively,
- * consider using the proprietary {@link OracleLobHandler} (see below).
- * <li><b>Oracle 9i driver:</b> Use {@link OracleLobHandler} with a connection-pool-specific
- * {@link OracleLobHandler#setNativeJdbcExtractor NativeJdbcExtractor}.
+ * DefaultLobHandler should work with standard setup out of the box.
  * <li><b>PostgreSQL:</b> Configure {@link DefaultLobHandler} with {@code wrapAsLob=true},
  * and use that LobHandler to access OID columns (but not BYTEA) in your database tables.
  * <li>For all other database drivers (and for non-LOB fields that might potentially
@@ -78,7 +63,6 @@ import java.sql.SQLException;
  * @author Juergen Hoeller
  * @since 23.12.2003
  * @see DefaultLobHandler
- * @see OracleLobHandler
  * @see java.sql.ResultSet#getBlob
  * @see java.sql.ResultSet#getClob
  * @see java.sql.ResultSet#getBytes

spring-jdbc/src/main/java/org/springframework/jdbc/support/nativejdbc/Jdbc4NativeJdbcExtractor.java

@@ -42,7 +42,6 @@ import java.sql.Statement;
  * @see java.sql.Wrapper#unwrap
  * @see SimpleNativeJdbcExtractor
  * @see org.springframework.jdbc.core.JdbcTemplate#setNativeJdbcExtractor
- * @see org.springframework.jdbc.support.lob.OracleLobHandler#setNativeJdbcExtractor
  */
 public class Jdbc4NativeJdbcExtractor extends NativeJdbcExtractorAdapter {
 

spring-jdbc/src/main/java/org/springframework/jdbc/support/nativejdbc/NativeJdbcExtractor.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2015 the original author or authors.
+ * Copyright 2002-2016 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.
@@ -41,29 +41,17 @@ import java.sql.Statement;
  * <i>not</i> necessary to unwrap the Connection to retrieve a native ResultSet.
  *
  * <p>When working with a simple connection pool that wraps Connections but not
- * Statements, a {@link SimpleNativeJdbcExtractor} is often sufficient. However,
- * 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.
+ * Statements, a {@link SimpleNativeJdbcExtractor} is often sufficient.
  *
  * <p>{@link org.springframework.jdbc.core.JdbcTemplate} can properly apply a
  * {@code NativeJdbcExtractor} if specified, unwrapping all JDBC objects
  * that it creates. Note that this is just necessary if you intend to cast to
  * native implementations in your data access code.
  *
- * <p>{@link org.springframework.jdbc.support.lob.OracleLobHandler},
- * the Oracle-specific implementation of Spring's
- * {@link org.springframework.jdbc.support.lob.LobHandler} interface, requires a
- * {@code NativeJdbcExtractor} for obtaining the native {@code OracleConnection}.
- * This is also necessary for other Oracle-specific features that you may want
- * to leverage in your applications, such as Oracle InterMedia.
- *
  * @author Juergen Hoeller
  * @since 25.08.2003
  * @see SimpleNativeJdbcExtractor
- * @see CommonsDbcpNativeJdbcExtractor
  * @see org.springframework.jdbc.core.JdbcTemplate#setNativeJdbcExtractor
- * @see org.springframework.jdbc.support.lob.OracleLobHandler#setNativeJdbcExtractor
  */
 public interface NativeJdbcExtractor {
 

spring-jdbc/src/main/java/org/springframework/jdbc/support/nativejdbc/SimpleNativeJdbcExtractor.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2015 the original author or authors.
+ * Copyright 2002-2016 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.
@@ -58,7 +58,6 @@ package org.springframework.jdbc.support.nativejdbc;
  * @see #setNativeConnectionNecessaryForNativeCallableStatements
  * @see Jdbc4NativeJdbcExtractor
  * @see org.springframework.jdbc.core.JdbcTemplate#setNativeJdbcExtractor
- * @see org.springframework.jdbc.support.lob.OracleLobHandler#setNativeJdbcExtractor
  */
 public class SimpleNativeJdbcExtractor extends NativeJdbcExtractorAdapter {