提交 977b56eb 编写于 作者: L lancea

8029417: JDBC 4.2 javadoc updates

Reviewed-by: darcy
上级 7bddf0a0
...@@ -1108,7 +1108,7 @@ public interface CallableStatement extends PreparedStatement { ...@@ -1108,7 +1108,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs or * parameter; if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if * @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support the specified targetSqlType
* @see Types * @see Types
* @see #getObject * @see #getObject
* @since 1.4 * @since 1.4
...@@ -1131,7 +1131,7 @@ public interface CallableStatement extends PreparedStatement { ...@@ -1131,7 +1131,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs or * parameter; if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if * @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support the specified targetSqlType
* @see #getObject * @see #getObject
* @since 1.4 * @since 1.4
*/ */
...@@ -2536,7 +2536,7 @@ public interface CallableStatement extends PreparedStatement { ...@@ -2536,7 +2536,7 @@ public interface CallableStatement extends PreparedStatement {
* or Reader object and the value of the scale parameter is less * or Reader object and the value of the scale parameter is less
* than zero * than zero
* @exception SQLFeatureNotSupportedException if * @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support the specified targetSqlType
* @see JDBCType * @see JDBCType
* @see SQLType * @see SQLType
* *
...@@ -2562,7 +2562,7 @@ public interface CallableStatement extends PreparedStatement { ...@@ -2562,7 +2562,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs * parameter; if a database access error occurs
* or this method is called on a closed {@code CallableStatement} * or this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if * @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support the specified targetSqlType
* @see JDBCType * @see JDBCType
* @see SQLType * @see SQLType
* @since 1.8 * @since 1.8
...@@ -2603,7 +2603,7 @@ public interface CallableStatement extends PreparedStatement { ...@@ -2603,7 +2603,7 @@ public interface CallableStatement extends PreparedStatement {
* if a database access error occurs or * if a database access error occurs or
* this method is called on a closed {@code CallableStatement} * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if * @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support the specified sqlType
* @see JDBCType * @see JDBCType
* @see SQLType * @see SQLType
* @since 1.8 * @since 1.8
...@@ -2639,7 +2639,7 @@ public interface CallableStatement extends PreparedStatement { ...@@ -2639,7 +2639,7 @@ public interface CallableStatement extends PreparedStatement {
* if a database access error occurs or * if a database access error occurs or
* this method is called on a closed {@code CallableStatement} * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if * @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support the specified sqlType
* @see JDBCType * @see JDBCType
* @see SQLType * @see SQLType
* @since 1.8 * @since 1.8
...@@ -2686,7 +2686,7 @@ public interface CallableStatement extends PreparedStatement { ...@@ -2686,7 +2686,7 @@ public interface CallableStatement extends PreparedStatement {
* if a database access error occurs or * if a database access error occurs or
* this method is called on a closed {@code CallableStatement} * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if * @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support the specified sqlType
* @see JDBCType * @see JDBCType
* @see SQLType * @see SQLType
* @since 1.8 * @since 1.8
...@@ -2725,7 +2725,7 @@ public interface CallableStatement extends PreparedStatement { ...@@ -2725,7 +2725,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs or * parameter; if a database access error occurs or
* this method is called on a closed {@code CallableStatement} * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if * @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 * or if the JDBC driver does not support
* this method * this method
* @since 1.8 * @since 1.8
...@@ -2762,7 +2762,7 @@ public interface CallableStatement extends PreparedStatement { ...@@ -2762,7 +2762,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs or * parameter; if a database access error occurs or
* this method is called on a closed {@code CallableStatement} * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if * @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 * or if the JDBC driver does not support
* this method * this method
* @since 1.8 * @since 1.8
...@@ -2811,7 +2811,7 @@ public interface CallableStatement extends PreparedStatement { ...@@ -2811,7 +2811,7 @@ public interface CallableStatement extends PreparedStatement {
* parameter; if a database access error occurs or * parameter; if a database access error occurs or
* this method is called on a closed {@code CallableStatement} * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if * @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 * or if the JDBC driver does not support this method
* @see JDBCType * @see JDBCType
* @see SQLType * @see SQLType
......
...@@ -213,8 +213,8 @@ public class DriverManager { ...@@ -213,8 +213,8 @@ public class DriverManager {
* The <code>DriverManager</code> attempts to select an appropriate driver from * The <code>DriverManager</code> attempts to select an appropriate driver from
* the set of registered JDBC drivers. * the set of registered JDBC drivers.
*<p> *<p>
* <B>Note:</B> If a property is specified as part of the {@code url} and * <B>Note:</B> If the {@code user} or {@code password} property are
* is also specified in the {@code Properties} object, it is * also specified as part of the {@code url}, it is
* implementation-defined as to which value will take precedence. * implementation-defined as to which value will take precedence.
* For maximum portability, an application should only specify a * For maximum portability, an application should only specify a
* property once. * property once.
...@@ -320,7 +320,7 @@ public class DriverManager { ...@@ -320,7 +320,7 @@ public class DriverManager {
* Registers the given driver with the {@code DriverManager}. * Registers the given driver with the {@code DriverManager}.
* A newly-loaded driver class should call * A newly-loaded driver class should call
* the method {@code registerDriver} to make itself * 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. * registered, no action is taken.
* *
* @param driver the new JDBC Driver that is to be registered with the * @param driver the new JDBC Driver that is to be registered with the
...@@ -338,7 +338,7 @@ public class DriverManager { ...@@ -338,7 +338,7 @@ public class DriverManager {
* Registers the given driver with the {@code DriverManager}. * Registers the given driver with the {@code DriverManager}.
* A newly-loaded driver class should call * A newly-loaded driver class should call
* the method {@code registerDriver} to make itself * 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. * registered, no action is taken.
* *
* @param driver the new JDBC Driver that is to be registered with the * @param driver the new JDBC Driver that is to be registered with the
...@@ -347,6 +347,7 @@ public class DriverManager { ...@@ -347,6 +347,7 @@ public class DriverManager {
* {@code DriverManager#deregisterDriver} is called * {@code DriverManager#deregisterDriver} is called
* @exception SQLException if a database access error occurs * @exception SQLException if a database access error occurs
* @exception NullPointerException if {@code driver} is null * @exception NullPointerException if {@code driver} is null
* @since 1.8
*/ */
public static synchronized void registerDriver(java.sql.Driver driver, public static synchronized void registerDriver(java.sql.Driver driver,
DriverAction da) DriverAction da)
......
...@@ -218,8 +218,8 @@ public enum JDBCType implements SQLType { ...@@ -218,8 +218,8 @@ public enum JDBCType implements SQLType {
} }
/** /**
* Returns the name of the data type. *{@inheritDoc }
* @return The name of the data type. * @return The name of this {@code SQLType}.
*/ */
public String getName() { public String getName() {
return name(); return name();
......
...@@ -401,7 +401,7 @@ public interface PreparedStatement extends Statement { ...@@ -401,7 +401,7 @@ public interface PreparedStatement extends Statement {
* marker in the SQL statement; if a database access error occurs or this * marker in the SQL statement; if a database access error occurs or this
* method is called on a closed PreparedStatement * method is called on a closed PreparedStatement
* @exception SQLFeatureNotSupportedException if * @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support the specified targetSqlType
* @see Types * @see Types
*/ */
void setObject(int parameterIndex, Object x, int targetSqlType) void setObject(int parameterIndex, Object x, int targetSqlType)
...@@ -951,7 +951,7 @@ public interface PreparedStatement extends Statement { ...@@ -951,7 +951,7 @@ public interface PreparedStatement extends Statement {
* or Reader object and the value of the scale parameter is less * or Reader object and the value of the scale parameter is less
* than zero * than zero
* @exception SQLFeatureNotSupportedException if * @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support the specified targetSqlType
* @see Types * @see Types
* *
*/ */
...@@ -1255,7 +1255,7 @@ public interface PreparedStatement extends Statement { ...@@ -1255,7 +1255,7 @@ public interface PreparedStatement extends Statement {
* or Reader object and the value of the scale parameter is less * or Reader object and the value of the scale parameter is less
* than zero * than zero
* @exception SQLFeatureNotSupportedException if * @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support the specified targetSqlType
* @see JDBCType * @see JDBCType
* @see SQLType * @see SQLType
* @since 1.8 * @since 1.8
...@@ -1281,7 +1281,7 @@ public interface PreparedStatement extends Statement { ...@@ -1281,7 +1281,7 @@ public interface PreparedStatement extends Statement {
* parameter marker in the SQL statement; if a database access error occurs * parameter marker in the SQL statement; if a database access error occurs
* or this method is called on a closed {@code PreparedStatement} * or this method is called on a closed {@code PreparedStatement}
* @exception SQLFeatureNotSupportedException if * @exception SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support the specified targetSqlType
* @see JDBCType * @see JDBCType
* @see SQLType * @see SQLType
* @since 1.8 * @since 1.8
......
...@@ -4178,7 +4178,7 @@ public interface ResultSet extends Wrapper, AutoCloseable { ...@@ -4178,7 +4178,7 @@ public interface ResultSet extends Wrapper, AutoCloseable {
* the result set concurrency is {@code CONCUR_READ_ONLY} * the result set concurrency is {@code CONCUR_READ_ONLY}
* or this method is called on a closed result set * or this method is called on a closed result set
* @exception SQLFeatureNotSupportedException if the JDBC driver does not * @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 JDBCType
* @see SQLType * @see SQLType
* @since 1.8 * @since 1.8
...@@ -4221,7 +4221,7 @@ public interface ResultSet extends Wrapper, AutoCloseable { ...@@ -4221,7 +4221,7 @@ public interface ResultSet extends Wrapper, AutoCloseable {
* the result set concurrency is {@code CONCUR_READ_ONLY} * the result set concurrency is {@code CONCUR_READ_ONLY}
* or this method is called on a closed result set * or this method is called on a closed result set
* @exception SQLFeatureNotSupportedException if the JDBC driver does not * @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 JDBCType
* @see SQLType * @see SQLType
* @since 1.8 * @since 1.8
...@@ -4249,7 +4249,7 @@ public interface ResultSet extends Wrapper, AutoCloseable { ...@@ -4249,7 +4249,7 @@ public interface ResultSet extends Wrapper, AutoCloseable {
* the result set concurrency is {@code CONCUR_READ_ONLY} * the result set concurrency is {@code CONCUR_READ_ONLY}
* or this method is called on a closed result set * or this method is called on a closed result set
* @exception SQLFeatureNotSupportedException if the JDBC driver does not * @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 JDBCType
* @see SQLType * @see SQLType
* @since 1.8 * @since 1.8
...@@ -4279,7 +4279,7 @@ public interface ResultSet extends Wrapper, AutoCloseable { ...@@ -4279,7 +4279,7 @@ public interface ResultSet extends Wrapper, AutoCloseable {
* the result set concurrency is {@code CONCUR_READ_ONLY} * the result set concurrency is {@code CONCUR_READ_ONLY}
* or this method is called on a closed result set * or this method is called on a closed result set
* @exception SQLFeatureNotSupportedException if the JDBC driver does not * @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 JDBCType
* @see SQLType * @see SQLType
* @since 1.8 * @since 1.8
......
...@@ -122,7 +122,7 @@ public final class SQLPermission extends BasicPermission { ...@@ -122,7 +122,7 @@ public final class SQLPermission extends BasicPermission {
* *
* @param name the name of this <code>SQLPermission</code> object, which must * @param name the name of this <code>SQLPermission</code> object, which must
* be either {@code setLog}, {@code callAbort}, {@code setSyncFactory}, * 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 NullPointerException if <code>name</code> is <code>null</code>.
* @throws IllegalArgumentException if <code>name</code> is empty. * @throws IllegalArgumentException if <code>name</code> is empty.
...@@ -140,7 +140,7 @@ public final class SQLPermission extends BasicPermission { ...@@ -140,7 +140,7 @@ public final class SQLPermission extends BasicPermission {
* *
* @param name the name of this <code>SQLPermission</code> object, which must * @param name the name of this <code>SQLPermission</code> object, which must
* be either {@code setLog}, {@code callAbort}, {@code setSyncFactory}, * be either {@code setLog}, {@code callAbort}, {@code setSyncFactory},
* or {@code setNetworkTimeout} * {@code deregisterDriver}, or {@code setNetworkTimeout}
* @param actions should be <code>null</code> * @param actions should be <code>null</code>
* @throws NullPointerException if <code>name</code> is <code>null</code>. * @throws NullPointerException if <code>name</code> is <code>null</code>.
* @throws IllegalArgumentException if <code>name</code> is empty. * @throws IllegalArgumentException if <code>name</code> is empty.
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册