8180728: DatabaseMeta.getRowIdLifetime returns an enum but javadoc refers to int

Reviewed-by: joehw, rriggs
This commit is contained in:
Lance Andersen 2017-05-23 16:14:02 -04:00
parent 0f5b1f5cf8
commit 7f5c2a5718

View File

@ -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 @@ public interface DatabaseMetaData extends Wrapper {
//------------------------- 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
*/