8046389: Add missing @since tag under javax.sql.**
authorhenryjen
Mon, 16 Jun 2014 08:09:30 -0700
changeset 24968 3308660aa3f2
parent 24967 582420f5ab6c
child 24969 afa6934dd8e8
8046389: Add missing @since tag under javax.sql.** Reviewed-by: lancea
jdk/src/share/classes/javax/sql/CommonDataSource.java
jdk/src/share/classes/javax/sql/rowset/BaseRowSet.java
jdk/src/share/classes/javax/sql/rowset/CachedRowSet.java
jdk/src/share/classes/javax/sql/rowset/FilteredRowSet.java
jdk/src/share/classes/javax/sql/rowset/JdbcRowSet.java
jdk/src/share/classes/javax/sql/rowset/JoinRowSet.java
jdk/src/share/classes/javax/sql/rowset/Joinable.java
jdk/src/share/classes/javax/sql/rowset/Predicate.java
jdk/src/share/classes/javax/sql/rowset/RowSetMetaDataImpl.java
jdk/src/share/classes/javax/sql/rowset/RowSetWarning.java
jdk/src/share/classes/javax/sql/rowset/WebRowSet.java
jdk/src/share/classes/javax/sql/rowset/serial/SQLOutputImpl.java
jdk/src/share/classes/javax/sql/rowset/serial/SerialArray.java
jdk/src/share/classes/javax/sql/rowset/serial/SerialBlob.java
jdk/src/share/classes/javax/sql/rowset/serial/SerialClob.java
jdk/src/share/classes/javax/sql/rowset/serial/SerialDatalink.java
jdk/src/share/classes/javax/sql/rowset/serial/SerialException.java
jdk/src/share/classes/javax/sql/rowset/serial/SerialJavaObject.java
jdk/src/share/classes/javax/sql/rowset/serial/SerialRef.java
jdk/src/share/classes/javax/sql/rowset/serial/SerialStruct.java
jdk/src/share/classes/javax/sql/rowset/spi/SyncFactory.java
jdk/src/share/classes/javax/sql/rowset/spi/SyncFactoryException.java
jdk/src/share/classes/javax/sql/rowset/spi/SyncProvider.java
jdk/src/share/classes/javax/sql/rowset/spi/SyncProviderException.java
jdk/src/share/classes/javax/sql/rowset/spi/SyncResolver.java
jdk/src/share/classes/javax/sql/rowset/spi/TransactionalWriter.java
jdk/src/share/classes/javax/sql/rowset/spi/XmlReader.java
jdk/src/share/classes/javax/sql/rowset/spi/XmlWriter.java
--- a/jdk/src/share/classes/javax/sql/CommonDataSource.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/CommonDataSource.java	Mon Jun 16 08:09:30 2014 -0700
@@ -34,6 +34,7 @@
  * Interface that defines the methods which are common between <code>DataSource</code>,
  * <code>XADataSource</code> and <code>ConnectionPoolDataSource</code>.
  *
+ * @since 1.6
  */
 public interface CommonDataSource {
 
--- a/jdk/src/share/classes/javax/sql/rowset/BaseRowSet.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/BaseRowSet.java	Mon Jun 16 08:09:30 2014 -0700
@@ -291,6 +291,8 @@
 * extending class overrides and reimplements any <code>BaseRowSet</code> method and encounters
 * connectivity or underlying data source issues, that method <b>may</b> in addition throw an
 * <code>SQLException</code> object for that reason.
+*
+* @since 1.5
 */
 
 public abstract class BaseRowSet implements Serializable, Cloneable {
--- a/jdk/src/share/classes/javax/sql/rowset/CachedRowSet.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/CachedRowSet.java	Mon Jun 16 08:09:30 2014 -0700
@@ -626,6 +626,7 @@
  * </PRE>
  *
  * @author Jonathan Bruce
+ * @since 1.5
  */
 
 public interface CachedRowSet extends RowSet, Joinable {
--- a/jdk/src/share/classes/javax/sql/rowset/FilteredRowSet.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/FilteredRowSet.java	Mon Jun 16 08:09:30 2014 -0700
@@ -122,6 +122,7 @@
  * synchronized with the data source.
  *
  * @author Jonathan Bruce
+ * @since 1.5
  */
 
 public interface FilteredRowSet extends WebRowSet {
--- a/jdk/src/share/classes/javax/sql/rowset/JdbcRowSet.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/JdbcRowSet.java	Mon Jun 16 08:09:30 2014 -0700
@@ -118,6 +118,7 @@
  * requirements of connected and disconnected <code>RowSet</code> objects.
  *
  * @author Jonathan Bruce
+ * @since 1.5
  */
 
 public interface JdbcRowSet extends RowSet, Joinable {
--- a/jdk/src/share/classes/javax/sql/rowset/JoinRowSet.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/JoinRowSet.java	Mon Jun 16 08:09:30 2014 -0700
@@ -217,6 +217,7 @@
  *       This method creates a copy that can be persisted to the data source.
  * </UL>
  *
+ * @since 1.5
  */
 
 public interface JoinRowSet extends WebRowSet {
--- a/jdk/src/share/classes/javax/sql/rowset/Joinable.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/Joinable.java	Mon Jun 16 08:09:30 2014 -0700
@@ -129,6 +129,7 @@
  *
  * @see JoinRowSet
  * @author  Jonathan Bruce
+ * @since 1.5
  */
 public interface Joinable {
 
--- a/jdk/src/share/classes/javax/sql/rowset/Predicate.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/Predicate.java	Mon Jun 16 08:09:30 2014 -0700
@@ -97,6 +97,7 @@
  * applications that use both column identification conventions.
  *
  * @author Jonathan Bruce, Amit Handa
+ * @since 1.5
  *
  */
 
--- a/jdk/src/share/classes/javax/sql/rowset/RowSetMetaDataImpl.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/RowSetMetaDataImpl.java	Mon Jun 16 08:09:30 2014 -0700
@@ -48,6 +48,8 @@
  * Therefore, any <code>RowSetMetaDataImpl</code> method that retrieves information
  * is defined as having unspecified behavior when it is called
  * before the <code>RowSet</code> object contains data.
+ *
+ * @since 1.5
  */
 public class RowSetMetaDataImpl implements RowSetMetaData,  Serializable {
 
--- a/jdk/src/share/classes/javax/sql/rowset/RowSetWarning.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/RowSetWarning.java	Mon Jun 16 08:09:30 2014 -0700
@@ -50,6 +50,8 @@
  * The inherited methods <code>getMessage</code>, <code>getSQLState</code>,
  * and <code>getErrorCode</code> retrieve information contained in a
  * <code>RowSetWarning</code> object.
+ *
+ * @since 1.5
  */
 public class RowSetWarning extends SQLException {
 
--- a/jdk/src/share/classes/javax/sql/rowset/WebRowSet.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/WebRowSet.java	Mon Jun 16 08:09:30 2014 -0700
@@ -408,6 +408,7 @@
  * @see javax.sql.rowset.CachedRowSet
  * @see javax.sql.rowset.FilteredRowSet
  * @see javax.sql.rowset.JoinRowSet
+ * @since 1.5
  */
 
 public interface WebRowSet extends CachedRowSet {
--- a/jdk/src/share/classes/javax/sql/rowset/serial/SQLOutputImpl.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/serial/SQLOutputImpl.java	Mon Jun 16 08:09:30 2014 -0700
@@ -52,6 +52,8 @@
  * to write data from the <code>SQLData</code> object to
  * the <code>SQLOutputImpl</code> output stream as the
  * representation of an SQL user-defined type.
+ *
+ * @since 1.5
  */
 public class SQLOutputImpl implements SQLOutput {
 
--- a/jdk/src/share/classes/javax/sql/rowset/serial/SerialArray.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/serial/SerialArray.java	Mon Jun 16 08:09:30 2014 -0700
@@ -56,6 +56,7 @@
  * SerialArray is to be used by more than one thread then access to the
  * SerialArray should be controlled by appropriate synchronization.
  *
+ * @since 1.5
  */
 public class SerialArray implements Array, Serializable, Cloneable {
 
--- a/jdk/src/share/classes/javax/sql/rowset/serial/SerialBlob.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/serial/SerialBlob.java	Mon Jun 16 08:09:30 2014 -0700
@@ -58,6 +58,7 @@
  * should be controlled by appropriate synchronization.
  *
  * @author Jonathan Bruce
+ * @since 1.5
  */
 public class SerialBlob implements Blob, Serializable, Cloneable {
 
--- a/jdk/src/share/classes/javax/sql/rowset/serial/SerialClob.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/serial/SerialClob.java	Mon Jun 16 08:09:30 2014 -0700
@@ -49,7 +49,9 @@
  * <p> A SerialClob is not safe for use by multiple concurrent threads.  If a
  * SerialClob is to be used by more than one thread then access to the SerialClob
  * should be controlled by appropriate synchronization.
+ *
  * @author Jonathan Bruce
+ * @since 1.5
  */
 public class SerialClob implements Clob, Serializable, Cloneable {
 
--- a/jdk/src/share/classes/javax/sql/rowset/serial/SerialDatalink.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/serial/SerialDatalink.java	Mon Jun 16 08:09:30 2014 -0700
@@ -48,6 +48,8 @@
  * A SerialDatalink is not safe for use by multiple concurrent threads.  If a
  * SerialDatalink is to be used by more than one thread then access to the
  * SerialDatalink should be controlled by appropriate synchronization.
+ *
+ * @since 1.5
  */
 public class SerialDatalink implements Serializable, Cloneable {
 
--- a/jdk/src/share/classes/javax/sql/rowset/serial/SerialException.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/serial/SerialException.java	Mon Jun 16 08:09:30 2014 -0700
@@ -32,6 +32,7 @@
  * SQL types such as <code>BLOB, CLOB, STRUCT or ARRAY</code> in
  * addition to SQL types such as <code>DATALINK and JAVAOBJECT</code>
  *
+ * @since 1.5
  */
 public class SerialException extends java.sql.SQLException {
 
--- a/jdk/src/share/classes/javax/sql/rowset/serial/SerialJavaObject.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/serial/SerialJavaObject.java	Mon Jun 16 08:09:30 2014 -0700
@@ -54,6 +54,7 @@
  * SerialJavaObject should be controlled by appropriate synchronization.
  *
  * @author Jonathan Bruce
+ * @since 1.5
  */
 public class SerialJavaObject implements Serializable, Cloneable {
 
--- a/jdk/src/share/classes/javax/sql/rowset/serial/SerialRef.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/serial/SerialRef.java	Mon Jun 16 08:09:30 2014 -0700
@@ -43,6 +43,7 @@
  * SerialRef is to be used by more than one thread then access to the SerialRef
  * should be controlled by appropriate synchronization.
  *
+ * @since 1.5
  */
 public class SerialRef implements Ref, Serializable, Cloneable {
 
--- a/jdk/src/share/classes/javax/sql/rowset/serial/SerialStruct.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/serial/SerialStruct.java	Mon Jun 16 08:09:30 2014 -0700
@@ -57,6 +57,7 @@
  * SerialStruct is to be used by more than one thread then access to the
  * SerialStruct should be controlled by appropriate synchronization.
  *
+ * @since 1.5
  */
 public class SerialStruct implements Struct, Serializable, Cloneable {
 
--- a/jdk/src/share/classes/javax/sql/rowset/spi/SyncFactory.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/spi/SyncFactory.java	Mon Jun 16 08:09:30 2014 -0700
@@ -200,6 +200,7 @@
  * @author  Jonathan Bruce
  * @see javax.sql.rowset.spi.SyncProvider
  * @see javax.sql.rowset.spi.SyncFactoryException
+ * @since 1.5
  */
 public class SyncFactory {
 
--- a/jdk/src/share/classes/javax/sql/rowset/spi/SyncFactoryException.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/spi/SyncFactoryException.java	Mon Jun 16 08:09:30 2014 -0700
@@ -35,6 +35,7 @@
  * @author Jonathan Bruce
  * @see javax.sql.rowset.spi.SyncFactory
  * @see javax.sql.rowset.spi.SyncFactoryException
+ * @since 1.5
  */
 public class SyncFactoryException extends java.sql.SQLException {
 
--- a/jdk/src/share/classes/javax/sql/rowset/spi/SyncProvider.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/spi/SyncProvider.java	Mon Jun 16 08:09:30 2014 -0700
@@ -209,6 +209,7 @@
  * @author Jonathan Bruce
  * @see javax.sql.rowset.spi.SyncFactory
  * @see javax.sql.rowset.spi.SyncFactoryException
+ * @since 1.5
  */
 public abstract class SyncProvider {
 
--- a/jdk/src/share/classes/javax/sql/rowset/spi/SyncProviderException.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/spi/SyncProviderException.java	Mon Jun 16 08:09:30 2014 -0700
@@ -61,6 +61,7 @@
  * @see javax.sql.rowset.spi.SyncFactory
  * @see javax.sql.rowset.spi.SyncResolver
  * @see javax.sql.rowset.spi.SyncFactoryException
+ * @since 1.5
  */
 public class SyncProviderException extends java.sql.SQLException {
 
--- a/jdk/src/share/classes/javax/sql/rowset/spi/SyncResolver.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/spi/SyncResolver.java	Mon Jun 16 08:09:30 2014 -0700
@@ -231,7 +231,9 @@
  *          }
  *      }
  * }</PRE>
+ *
  * @author  Jonathan Bruce
+ * @since 1.5
  */
 
 public interface SyncResolver extends RowSet {
--- a/jdk/src/share/classes/javax/sql/rowset/spi/TransactionalWriter.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/spi/TransactionalWriter.java	Mon Jun 16 08:09:30 2014 -0700
@@ -44,6 +44,8 @@
  * the <code>CachedRowSet</code> constant <code>COMMIT_ON_ACCEPT_CHANGES</code>
  * to <code>false</code> and use the <code>commit</code> and <code>rollback</code>
  * methods defined in this interface to manage transaction boundaries.
+ *
+ * @since 1.5
  */
 public interface TransactionalWriter extends RowSetWriter {
 
--- a/jdk/src/share/classes/javax/sql/rowset/spi/XmlReader.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/spi/XmlReader.java	Mon Jun 16 08:09:30 2014 -0700
@@ -46,6 +46,8 @@
  * rowset's <code>xmlReader</code> field. When the <code>WebRowSet</code>
  * object's <code>readXml</code> method is invoked, it in turn invokes
  * its XML reader's <code>readXML</code> method.
+ *
+ * @since 1.5
  */
 public interface XmlReader extends RowSetReader {
 
--- a/jdk/src/share/classes/javax/sql/rowset/spi/XmlWriter.java	Mon Jun 16 07:25:11 2014 -0700
+++ b/jdk/src/share/classes/javax/sql/rowset/spi/XmlWriter.java	Mon Jun 16 08:09:30 2014 -0700
@@ -44,6 +44,8 @@
  * Writing a <code>WebRowSet</code> object includes printing the
  * rowset's data, metadata, and properties, all with the
  * appropriate XML tags.
+ *
+ * @since 1.5
  */
 public interface XmlWriter extends RowSetWriter {