8029417: JDBC 4.2 javadoc updates

Reviewed-by: darcy
This commit is contained in:
Lance Andersen 2013-12-02 16:06:03 -05:00
parent 4a6aad2a5c
commit ff86cc7b7a
6 changed files with 27 additions and 26 deletions

View File

@ -1108,7 +1108,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified targetSqlType
* @see Types
* @see #getObject
* @since 1.4
@ -1131,7 +1131,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified targetSqlType
* @see #getObject
* @since 1.4
*/
@ -2536,7 +2536,7 @@ public interface CallableStatement extends PreparedStatement {
* or Reader object and the value of the scale parameter is less
* than zero
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified targetSqlType
* @see JDBCType
* @see SQLType
*
@ -2562,7 +2562,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs
* or this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified targetSqlType
* @see JDBCType
* @see SQLType
* @since 1.8
@ -2603,7 +2603,7 @@ public interface CallableStatement extends PreparedStatement {
* if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified sqlType
* @see JDBCType
* @see SQLType
* @since 1.8
@ -2639,7 +2639,7 @@ public interface CallableStatement extends PreparedStatement {
* if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified sqlType
* @see JDBCType
* @see SQLType
* @since 1.8
@ -2686,7 +2686,7 @@ public interface CallableStatement extends PreparedStatement {
* if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified sqlType
* @see JDBCType
* @see SQLType
* @since 1.8
@ -2725,7 +2725,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified sqlType
* or if the JDBC driver does not support
* this method
* @since 1.8
@ -2762,7 +2762,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified sqlType
* or if the JDBC driver does not support
* this method
* @since 1.8
@ -2811,7 +2811,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified sqlType
* or if the JDBC driver does not support this method
* @see JDBCType
* @see SQLType

View File

@ -213,8 +213,8 @@ public class DriverManager {
* The <code>DriverManager</code> attempts to select an appropriate driver from
* the set of registered JDBC drivers.
*<p>
* <B>Note:</B> If a property is specified as part of the {@code url} and
* is also specified in the {@code Properties} object, it is
* <B>Note:</B> If the {@code user} or {@code password} property are
* also specified as part of the {@code url}, it is
* implementation-defined as to which value will take precedence.
* For maximum portability, an application should only specify a
* property once.
@ -320,7 +320,7 @@ public class DriverManager {
* Registers the given driver with the {@code DriverManager}.
* A newly-loaded driver class should call
* the method {@code registerDriver} to make itself
* known to the {@code DriverManager}. If the driver had previously been
* known to the {@code DriverManager}. If the driver is currently
* registered, no action is taken.
*
* @param driver the new JDBC Driver that is to be registered with the
@ -338,7 +338,7 @@ public class DriverManager {
* Registers the given driver with the {@code DriverManager}.
* A newly-loaded driver class should call
* the method {@code registerDriver} to make itself
* known to the {@code DriverManager}. If the driver had previously been
* known to the {@code DriverManager}. If the driver is currently
* registered, no action is taken.
*
* @param driver the new JDBC Driver that is to be registered with the
@ -347,6 +347,7 @@ public class DriverManager {
* {@code DriverManager#deregisterDriver} is called
* @exception SQLException if a database access error occurs
* @exception NullPointerException if {@code driver} is null
* @since 1.8
*/
public static synchronized void registerDriver(java.sql.Driver driver,
DriverAction da)

View File

@ -218,8 +218,8 @@ public enum JDBCType implements SQLType {
}
/**
* Returns the name of the data type.
* @return The name of the data type.
*{@inheritDoc }
* @return The name of this {@code SQLType}.
*/
public String getName() {
return name();

View File

@ -401,7 +401,7 @@ public interface PreparedStatement extends Statement {
* marker in the SQL statement; if a database access error occurs or this
* method is called on a closed PreparedStatement
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified targetSqlType
* @see Types
*/
void setObject(int parameterIndex, Object x, int targetSqlType)
@ -951,7 +951,7 @@ public interface PreparedStatement extends Statement {
* or Reader object and the value of the scale parameter is less
* than zero
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified targetSqlType
* @see Types
*
*/
@ -1255,7 +1255,7 @@ public interface PreparedStatement extends Statement {
* or Reader object and the value of the scale parameter is less
* than zero
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified targetSqlType
* @see JDBCType
* @see SQLType
* @since 1.8
@ -1281,7 +1281,7 @@ public interface PreparedStatement extends Statement {
* parameter marker in the SQL statement; if a database access error occurs
* or this method is called on a closed {@code PreparedStatement}
* @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* the JDBC driver does not support the specified targetSqlType
* @see JDBCType
* @see SQLType
* @since 1.8

View File

@ -4178,7 +4178,7 @@ public interface ResultSet extends Wrapper, AutoCloseable {
* the result set concurrency is {@code CONCUR_READ_ONLY}
* or this method is called on a closed result set
* @exception SQLFeatureNotSupportedException if the JDBC driver does not
* support this method; if the JDBC driver does not support this data type
* support this method; if the JDBC driver does not support the specified targetSqlType
* @see JDBCType
* @see SQLType
* @since 1.8
@ -4221,7 +4221,7 @@ public interface ResultSet extends Wrapper, AutoCloseable {
* the result set concurrency is {@code CONCUR_READ_ONLY}
* or this method is called on a closed result set
* @exception SQLFeatureNotSupportedException if the JDBC driver does not
* support this method; if the JDBC driver does not support this data type
* support this method; if the JDBC driver does not support the specified targetSqlType
* @see JDBCType
* @see SQLType
* @since 1.8
@ -4249,7 +4249,7 @@ public interface ResultSet extends Wrapper, AutoCloseable {
* the result set concurrency is {@code CONCUR_READ_ONLY}
* or this method is called on a closed result set
* @exception SQLFeatureNotSupportedException if the JDBC driver does not
* support this method; if the JDBC driver does not support this data type
* support this method; if the JDBC driver does not support the specified targetSqlType
* @see JDBCType
* @see SQLType
* @since 1.8
@ -4279,7 +4279,7 @@ public interface ResultSet extends Wrapper, AutoCloseable {
* the result set concurrency is {@code CONCUR_READ_ONLY}
* or this method is called on a closed result set
* @exception SQLFeatureNotSupportedException if the JDBC driver does not
* support this method; if the JDBC driver does not support this data type
* support this method; if the JDBC driver does not support the specified targetSqlType
* @see JDBCType
* @see SQLType
* @since 1.8

View File

@ -122,7 +122,7 @@ public final class SQLPermission extends BasicPermission {
*
* @param name the name of this <code>SQLPermission</code> object, which must
* be either {@code setLog}, {@code callAbort}, {@code setSyncFactory},
* or {@code setNetworkTimeout}
* {@code deregisterDriver}, or {@code setNetworkTimeout}
* @throws NullPointerException if <code>name</code> is <code>null</code>.
* @throws IllegalArgumentException if <code>name</code> is empty.
@ -140,7 +140,7 @@ public final class SQLPermission extends BasicPermission {
*
* @param name the name of this <code>SQLPermission</code> object, which must
* be either {@code setLog}, {@code callAbort}, {@code setSyncFactory},
* or {@code setNetworkTimeout}
* {@code deregisterDriver}, or {@code setNetworkTimeout}
* @param actions should be <code>null</code>
* @throws NullPointerException if <code>name</code> is <code>null</code>.
* @throws IllegalArgumentException if <code>name</code> is empty.