8180728: DatabaseMeta.getRowIdLifetime returns an enum but javadoc refers to int
authorlancea
Tue, 23 May 2017 16:14:02 -0400
changeset 45331 f829a12aff54
parent 45330 d33052a04c7b
child 45332 9c9e51c44638
8180728: DatabaseMeta.getRowIdLifetime returns an enum but javadoc refers to int Reviewed-by: joehw, rriggs
jdk/src/java.sql/share/classes/java/sql/DatabaseMetaData.java
--- a/jdk/src/java.sql/share/classes/java/sql/DatabaseMetaData.java	Tue May 23 11:47:52 2017 -0700
+++ b/jdk/src/java.sql/share/classes/java/sql/DatabaseMetaData.java	Tue May 23 16:14:02 2017 -0400
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2015, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -3199,22 +3199,10 @@
     //------------------------- JDBC 4.0 -----------------------------------
 
     /**
-     * Indicates whether or not this data source supports the SQL <code>ROWID</code> type,
-     * and if so  the lifetime for which a <code>RowId</code> object remains valid.
-     * <p>
-     * The returned int values have the following relationship:
-     * <pre>{@code
-     *     ROWID_UNSUPPORTED < ROWID_VALID_OTHER < ROWID_VALID_TRANSACTION
-     *         < ROWID_VALID_SESSION < ROWID_VALID_FOREVER
-     * }</pre>
-     * so conditional logic such as
-     * <pre>{@code
-     *     if (metadata.getRowIdLifetime() > DatabaseMetaData.ROWID_VALID_TRANSACTION)
-     * }</pre>
-     * can be used. Valid Forever means valid across all Sessions, and valid for
-     * a Session means valid across all its contained Transactions.
+     * Indicates whether this data source supports the SQL {@code  ROWID} type,
+     * and the lifetime for which a {@link  RowId} object remains valid.
      *
-     * @return the status indicating the lifetime of a <code>RowId</code>
+     * @return the status indicating the lifetime of a {@code  RowId}
      * @throws SQLException if a database access error occurs
      * @since 1.6
      */