changeset 16865:fccdf07c7c67

8176721: @since value errors java.sql module Reviewed-by: lancea
author mli
date Tue, 14 Mar 2017 19:44:52 -0700
parents 8ac762a3d4a4
children fc81607db2fb
files src/java.sql/share/classes/java/sql/CallableStatement.java src/java.sql/share/classes/java/sql/Connection.java src/java.sql/share/classes/java/sql/DataTruncation.java src/java.sql/share/classes/java/sql/DatabaseMetaData.java src/java.sql/share/classes/java/sql/Date.java src/java.sql/share/classes/java/sql/Driver.java src/java.sql/share/classes/java/sql/DriverManager.java src/java.sql/share/classes/java/sql/DriverPropertyInfo.java src/java.sql/share/classes/java/sql/PreparedStatement.java src/java.sql/share/classes/java/sql/ResultSet.java src/java.sql/share/classes/java/sql/ResultSetMetaData.java src/java.sql/share/classes/java/sql/SQLException.java src/java.sql/share/classes/java/sql/SQLWarning.java src/java.sql/share/classes/java/sql/ShardingKeyBuilder.java src/java.sql/share/classes/java/sql/Statement.java src/java.sql/share/classes/java/sql/Time.java src/java.sql/share/classes/java/sql/Timestamp.java src/java.sql/share/classes/java/sql/Types.java src/java.sql/share/classes/javax/transaction/xa/XAException.java src/java.sql/share/classes/javax/transaction/xa/XAResource.java src/java.sql/share/classes/javax/transaction/xa/Xid.java
diffstat 21 files changed, 39 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.sql/share/classes/java/sql/CallableStatement.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/CallableStatement.java	Tue Mar 14 19:44:52 2017 -0700
@@ -60,6 +60,7 @@
  *
  * @see Connection#prepareCall
  * @see ResultSet
+ * @since 1.1
  */
 
 public interface CallableStatement extends PreparedStatement {
--- a/src/java.sql/share/classes/java/sql/Connection.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/Connection.java	Tue Mar 14 19:44:52 2017 -0700
@@ -80,6 +80,7 @@
  * @see Statement
  * @see ResultSet
  * @see DatabaseMetaData
+ * @since 1.1
  */
 public interface Connection  extends Wrapper, AutoCloseable {
 
--- a/src/java.sql/share/classes/java/sql/DataTruncation.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/DataTruncation.java	Tue Mar 14 19:44:52 2017 -0700
@@ -34,6 +34,8 @@
  *
  * <P>The SQLstate for a <code>DataTruncation</code> during read is <code>01004</code>.
  * <P>The SQLstate for a <code>DataTruncation</code> during write is <code>22001</code>.
+ *
+ * @since 1.1
  */
 
 public class DataTruncation extends SQLWarning {
--- a/src/java.sql/share/classes/java/sql/DatabaseMetaData.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/DatabaseMetaData.java	Tue Mar 14 19:44:52 2017 -0700
@@ -68,6 +68,7 @@
  * argument is set to <code>null</code>, that argument's criterion will
  * be dropped from the search.
  *
+ * @since 1.1
  */
 public interface DatabaseMetaData extends Wrapper {
 
--- a/src/java.sql/share/classes/java/sql/Date.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/Date.java	Tue Mar 14 19:44:52 2017 -0700
@@ -41,6 +41,8 @@
  * must be 'normalized' by setting the
  * hours, minutes, seconds, and milliseconds to zero in the particular
  * time zone with which the instance is associated.
+ *
+ * @since 1.1
  */
 public class Date extends java.util.Date {
 
--- a/src/java.sql/share/classes/java/sql/Driver.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/Driver.java	Tue Mar 14 19:44:52 2017 -0700
@@ -54,6 +54,7 @@
  * @see DriverManager
  * @see Connection
  * @see DriverAction
+ * @since 1.1
  */
 public interface Driver {
 
--- a/src/java.sql/share/classes/java/sql/DriverManager.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/DriverManager.java	Tue Mar 14 19:44:52 2017 -0700
@@ -78,6 +78,7 @@
  *
  * @see Driver
  * @see Connection
+ * @since 1.1
  */
 public class DriverManager {
 
--- a/src/java.sql/share/classes/java/sql/DriverPropertyInfo.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/DriverPropertyInfo.java	Tue Mar 14 19:44:52 2017 -0700
@@ -31,6 +31,8 @@
  * who need to interact with a Driver via the method
  * <code>getDriverProperties</code> to discover
  * and supply properties for connections.
+ *
+ * @since 1.1
  */
 
 public class DriverPropertyInfo {
--- a/src/java.sql/share/classes/java/sql/PreparedStatement.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/PreparedStatement.java	Tue Mar 14 19:44:52 2017 -0700
@@ -56,6 +56,7 @@
  *
  * @see Connection#prepareStatement
  * @see ResultSet
+ * @since 1.1
  */
 
 public interface PreparedStatement extends Statement {
--- a/src/java.sql/share/classes/java/sql/ResultSet.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/ResultSet.java	Tue Mar 14 19:44:52 2017 -0700
@@ -143,6 +143,7 @@
  * @see Statement#executeQuery
  * @see Statement#getResultSet
  * @see ResultSetMetaData
+ * @since 1.1
  */
 
 public interface ResultSet extends Wrapper, AutoCloseable {
--- a/src/java.sql/share/classes/java/sql/ResultSetMetaData.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/ResultSetMetaData.java	Tue Mar 14 19:44:52 2017 -0700
@@ -40,6 +40,8 @@
  *     boolean b = rsmd.isSearchable(1);
  *
  * </PRE>
+ *
+ * @since 1.1
  */
 
 public interface ResultSetMetaData extends Wrapper {
--- a/src/java.sql/share/classes/java/sql/SQLException.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/SQLException.java	Tue Mar 14 19:44:52 2017 -0700
@@ -49,6 +49,8 @@
  *       error information.
  *   <LI> the causal relationship, if any for this <code>SQLException</code>.
  * </UL>
+ *
+ * @since 1.1
  */
 public class SQLException extends java.lang.Exception
                           implements Iterable<Throwable> {
--- a/src/java.sql/share/classes/java/sql/SQLWarning.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/SQLWarning.java	Tue Mar 14 19:44:52 2017 -0700
@@ -41,6 +41,7 @@
  * @see Connection#getWarnings
  * @see Statement#getWarnings
  * @see ResultSet#getWarnings
+ * @since 1.1
  */
 public class SQLWarning extends SQLException {
 
--- a/src/java.sql/share/classes/java/sql/ShardingKeyBuilder.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/ShardingKeyBuilder.java	Tue Mar 14 19:44:52 2017 -0700
@@ -42,6 +42,8 @@
  *                           .build();
  * }
  * </pre>
+ *
+ * @since 9
  */
 public interface ShardingKeyBuilder {
 
--- a/src/java.sql/share/classes/java/sql/Statement.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/Statement.java	Tue Mar 14 19:44:52 2017 -0700
@@ -42,6 +42,7 @@
  *
  * @see Connection#createStatement
  * @see ResultSet
+ * @since 1.1
  */
 public interface Statement extends Wrapper, AutoCloseable {
 
@@ -1399,6 +1400,8 @@
      * converted to two single quotes
      * @throws NullPointerException if val is {@code null}
      * @throws SQLException if a database access error occurs
+     *
+     * @since 9
      */
      default String enquoteLiteral(String val)  throws SQLException {
          return "'" + val.replace("'", "''") +  "'";
@@ -1503,6 +1506,8 @@
      * @throws SQLFeatureNotSupportedException if the datasource does not support
      * delimited identifiers
      * @throws NullPointerException if identifier is {@code null}
+     *
+     * @since 9
      */
     default String enquoteIdentifier(String identifier, boolean alwaysQuote) throws SQLException {
         int len = identifier.length();
@@ -1576,6 +1581,8 @@
      * @return  true if  a simple SQL identifier, false otherwise
      * @throws NullPointerException if identifier is {@code null}
      * @throws SQLException if a database access error occurs
+     *
+     * @since 9
      */
     default boolean isSimpleIdentifier(String identifier) throws SQLException {
         int len = identifier.length();
@@ -1617,6 +1624,8 @@
     * then prefixed with 'N'.
     * @throws NullPointerException if val is {@code null}
     * @throws SQLException if a database access error occurs
+    *
+    * @since 9
     */
     default String enquoteNCharLiteral(String val)  throws SQLException {
         return "N'" + val.replace("'", "''") +  "'";
--- a/src/java.sql/share/classes/java/sql/Time.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/Time.java	Tue Mar 14 19:44:52 2017 -0700
@@ -38,6 +38,8 @@
  * values.
  * <p>The date components should be set to the "zero epoch"
  * value of January 1, 1970 and should not be accessed.
+ *
+ * @since 1.1
  */
 public class Time extends java.util.Date {
 
--- a/src/java.sql/share/classes/java/sql/Timestamp.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/Timestamp.java	Tue Mar 14 19:44:52 2017 -0700
@@ -69,6 +69,8 @@
  * inheritance relationship between {@code Timestamp}
  * and {@code java.util.Date} really
  * denotes implementation inheritance, and not type inheritance.
+ *
+ * @since 1.1
  */
 public class Timestamp extends java.util.Date {
 
--- a/src/java.sql/share/classes/java/sql/Types.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/java/sql/Types.java	Tue Mar 14 19:44:52 2017 -0700
@@ -30,6 +30,8 @@
  * SQL types, called JDBC types.
  * <p>
  * This class is never instantiated.
+ *
+ * @since 1.1
  */
 public class Types {
 
--- a/src/java.sql/share/classes/javax/transaction/xa/XAException.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/javax/transaction/xa/XAException.java	Tue Mar 14 19:44:52 2017 -0700
@@ -29,6 +29,7 @@
  * The XAException is thrown by the Resource Manager (RM) to inform the
  * Transaction Manager of an error encountered by the involved transaction.
  *
+ * @since 1.4
  */
 public class XAException extends Exception {
 
--- a/src/java.sql/share/classes/javax/transaction/xa/XAResource.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/javax/transaction/xa/XAResource.java	Tue Mar 14 19:44:52 2017 -0700
@@ -56,6 +56,7 @@
  * the transaction manager to prepare, commit, or rollback a transaction
  * according to the two-phase commit protocol.</p>
  *
+ * @since 1.4
  */
 public interface XAResource {
 
--- a/src/java.sql/share/classes/javax/transaction/xa/Xid.java	Tue Mar 14 19:23:37 2017 -0700
+++ b/src/java.sql/share/classes/javax/transaction/xa/Xid.java	Tue Mar 14 19:44:52 2017 -0700
@@ -32,6 +32,8 @@
  * and branch qualifier. The Xid interface is used by the transaction
  * manager and the resource managers. This interface is not visible to
  * the application programs.
+ *
+ * @since 1.4
  */
 public interface Xid {