OpenJDK / amber / amber
changeset 44256:12050b22e372
8176721: @since value errors java.sql module
Reviewed-by: lancea
line wrap: on
line diff
--- a/jdk/src/java.sql/share/classes/java/sql/CallableStatement.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/Connection.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/DataTruncation.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/DatabaseMetaData.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/Date.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/Driver.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/DriverManager.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/DriverPropertyInfo.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/PreparedStatement.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/ResultSet.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/ResultSetMetaData.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/SQLException.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/SQLWarning.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/ShardingKeyBuilder.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/Statement.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/Time.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/Timestamp.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/java/sql/Types.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/javax/transaction/xa/XAException.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/javax/transaction/xa/XAResource.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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/jdk/src/java.sql/share/classes/javax/transaction/xa/Xid.java Tue Mar 14 19:23:37 2017 -0700 +++ b/jdk/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 {