# HG changeset patch # User lancea # Date 1552500618 14400 # Node ID 9a90236ab64c34aefddc5335e31e75ebcbfc793e # Parent d58599c7cdefa5a395574ce3eec79cdae3be5172 8220253: Fix Headings in java.sql.rowset Reviewed-by: darcy diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/com/sun/rowset/package-info.java --- a/src/java.sql.rowset/share/classes/com/sun/rowset/package-info.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/com/sun/rowset/package-info.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2018, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -30,7 +30,7 @@ * by the Test Compatibility Kit (TCK) as mandated by the Java Community Process. *
* - *

1.0 Available JDBC RowSet Reference Implementations

+ *

1.0 Available JDBC RowSet Reference Implementations

* The following implementations are provided:
* *
JdbcRowSetImpl - The javax.sql.rowset.JdbcRowSet @@ -53,7 +53,7 @@ * SPI and helper classes are provided in the interface definitions in the javax.sql.rowset * package specification.
* - *

2.0 Usage

+ *

2.0 Usage

* The reference implementations represent robust implementations of the standard * RowSet interfaces defined in the javax.sql.rowset package. * All disconnected RowSet implementations, such as the CachedRowSetImpl @@ -63,7 +63,7 @@ * to use these implementations and integrate them into their products just as they * can with to other components of the Java platform.
* - *

3.0 Extending the JDBC RowSet Implementations

+ *

3.0 Extending the JDBC RowSet Implementations

* * The JDBC RowSet reference implementations are provided as non-final * classes so that any developer can extend them to provide additional features diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/com/sun/rowset/providers/RIOptimisticProvider.java --- a/src/java.sql.rowset/share/classes/com/sun/rowset/providers/RIOptimisticProvider.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/com/sun/rowset/providers/RIOptimisticProvider.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -37,7 +37,7 @@ * providing optimistic synchronization with a relational datastore * using any JDBC technology-enabled driver. * - *

1.0 Backgroud

+ *

1.0 Backgroud

* This synchronization provider is registered with the * SyncFactory by default as the * com.sun.rowset.providers.RIOptimisticProvider. @@ -56,7 +56,7 @@ * RIOptimisticProvider will not write any of the changes to the data * source and will throw a SyncProviderException object. * - *

2.0 Usage

+ *

2.0 Usage

* Standard disconnected RowSet implementations may opt to use this * SyncProvider implementation in one of two ways: *
    diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/com/sun/rowset/providers/RIXMLProvider.java --- a/src/java.sql.rowset/share/classes/com/sun/rowset/providers/RIXMLProvider.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/com/sun/rowset/providers/RIXMLProvider.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -37,7 +37,7 @@ * with the ability to read and write rowsets in well formed XML using the * standard WebRowSet schema. * - *

    1.0 Background

    + *

    1.0 Background

    * This synchronization provider is registered with the * SyncFactory by default as the * com.sun.rowset.providers.RIXMLProvider. @@ -51,7 +51,7 @@ * The RIXMLProvider implementation has a synchronization level of * GRADE_NONE, which means that it does no checking at all for conflicts. It * simply writes a WebRowSet object to a file. - *

    2.0 Usage

    + *

    2.0 Usage

    * A WebRowSet implementation is created with an RIXMLProvider * by default. *
    diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/com/sun/rowset/providers/package-info.java
    --- a/src/java.sql.rowset/share/classes/com/sun/rowset/providers/package-info.java	Wed Mar 13 10:37:30 2019 -0700
    +++ b/src/java.sql.rowset/share/classes/com/sun/rowset/providers/package-info.java	Wed Mar 13 14:10:18 2019 -0400
    @@ -1,5 +1,5 @@
     /*
    - * Copyright (c) 2003, 2018, Oracle and/or its affiliates. All rights reserved.
    + * Copyright (c) 2003, 2019, 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
    @@ -33,7 +33,7 @@
      * the default SyncProvider implementations and are accessible via the
      * SyncProvider SPI managed by the SyncFactory.
      *
    - * 

    1.0 SyncProvider Reference Implementations

    + *

    1.0 SyncProvider Reference Implementations

    * The main job of a SyncProvider implementation is to manage * the reader and writer mechanisms. * The SyncProvider SPI, as specified in the javax.sql.rowset.spi @@ -106,7 +106,7 @@ * definition.
    * * - *

    2.0 Basics in RowSet Population & Synchronization

    + *

    2.0 Basics in RowSet Population & Synchronization

    * A rowset's first task is to populate itself with rows of column values. * Generally, these rows will come from a relational database, so a rowset * has properties that supply what is necessary for making a connection to @@ -147,7 +147,7 @@ * once again disconnects itself.
    *

    * - *

    3.0 Other Possible Implementations

    + *

    3.0 Other Possible Implementations

    * There are many other possible implementations of the SyncProvider abstract * class. One possibility is to employ a more robust synchronization model, which * would give a RowSet object increased trust in the provider's diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/BaseRowSet.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/BaseRowSet.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/BaseRowSet.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2016, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -39,7 +39,7 @@ * The basic functions include having properties and sending event notifications, * which all JavaBeans™ components must implement. * - *

    1.0 Overview

    + *

    1.0 Overview

    * The BaseRowSet class provides the core functionality * for all RowSet implementations, * and all standard implementations may use this class in combination with @@ -72,7 +72,7 @@ * * * - *

    2.0 Setting Properties

    + *

    2.0 Setting Properties

    * All rowsets maintain a set of properties, which will usually be set using * a tool. The number and kinds of properties a rowset has will vary, * depending on what the RowSet implementation does and how it gets @@ -95,7 +95,7 @@ * Interface™ (JNDI) API. This registration * is usually done by a person acting in the capacity of a system administrator. * - *

    3.0 Setting the Command and Its Parameters

    + *

    3.0 Setting the Command and Its Parameters

    * When a rowset gets its data from a relational database, it executes a command (a query) * that produces a ResultSet object. This query is the command that is set * for the RowSet object's command property. The rowset populates itself with data by reading the @@ -143,7 +143,7 @@ * SerialArray, SerialClob, SerialBlob * and SerialRef objects respectively. * - *

    4.0 Handling of Parameters Behind the Scenes

    + *

    4.0 Handling of Parameters Behind the Scenes

    * * NOTE: The BaseRowSet class provides two kinds of setter methods, * those that set properties and those that set placeholder parameters. The setter @@ -227,7 +227,7 @@ * RowSet implementations extending this class; it is not normally called by an * application programmer directly. * -*

    5.0 Event Notification

    +*

    5.0 Event Notification

    * The BaseRowSet class provides the event notification * mechanism for rowsets. It contains the field * listeners, methods for adding and removing listeners, and @@ -255,7 +255,7 @@ * What the listener does with this information, which may be nothing, depends on how it was * implemented. * -*

    6.0 Default Behavior

    +*

    6.0 Default Behavior

    * A default BaseRowSet object is initialized with many starting values. * * The following is true of a default RowSet instance that extends diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/CachedRowSet.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/CachedRowSet.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/CachedRowSet.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -68,7 +68,7 @@ * over the wire to a thin client such as a personal digital assistant (PDA). * * - *

    1.0 Creating a CachedRowSet Object

    + *

    1.0 Creating a CachedRowSet Object

    * The following line of code uses the default constructor for * CachedRowSet * supplied in the reference implementation (RI) to create a default @@ -140,7 +140,7 @@ * more details. * * - *

    2.0 Retrieving Data from a CachedRowSet Object

    + *

    2.0 Retrieving Data from a CachedRowSet Object

    * Data is retrieved from a CachedRowSet object by using the * getter methods inherited from the ResultSet * interface. The following examples, in which crs is a @@ -171,7 +171,7 @@ * System.out.println(name + " " + id + " " + comment + " " + dept); * } *
    - *

    2.1 Retrieving RowSetMetaData

    + *

    2.1 Retrieving RowSetMetaData

    * An application can get information about the columns in a CachedRowSet * object by calling ResultSetMetaData and RowSetMetaData * methods on a RowSetMetaData object. The following code fragment, @@ -207,7 +207,7 @@ * override the getMetaData() method defined in * java.sql.ResultSet and return a RowSetMetaData object. * - *

    3.0 Updating a CachedRowSet Object

    + *

    3.0 Updating a CachedRowSet Object

    * Updating a CachedRowSet object is similar to updating a * ResultSet object, but because the rowset is not connected to * its data source while it is being updated, it must take an additional step @@ -261,7 +261,7 @@ * and insertRow have been made. If acceptChanges * is called only once, only one connection needs to be established. * - *

    4.0 Updating the Underlying Data Source

    + *

    4.0 Updating the Underlying Data Source

    * When the method acceptChanges is executed, the * CachedRowSet object's writer, a RowSetWriterImpl * object, is called behind the scenes to write the changes made to the @@ -305,7 +305,7 @@ * Whether a writer checks for conflicts, what degree of checking it does, and how * it handles conflicts all depend on how it is implemented. * - *

    5.0 Registering and Notifying Listeners

    + *

    5.0 Registering and Notifying Listeners

    * Being JavaBeans components, all rowsets participate in the JavaBeans event * model, inheriting methods for registering listeners and notifying them of * changes from the BaseRowSet class. A listener for a @@ -328,7 +328,7 @@ * table and barGraph will be notified when there is * a change in crs. * - *

    6.0 Passing Data to Thin Clients

    + *

    6.0 Passing Data to Thin Clients

    * One of the main reasons to use a CachedRowSet object is to * pass data between different components of an application. Because it is * serializable, a CachedRowSet object can be used, for example, @@ -344,7 +344,7 @@ * Thus, a CachedRowSet object provides a means to "get rows in" * without the need to implement the full JDBC API. * - *

    7.0 Scrolling and Updating

    + *

    7.0 Scrolling and Updating

    * A second major use for CachedRowSet objects is to provide * scrolling and updating for ResultSet objects that * do not provide these capabilities themselves. In other words, a @@ -378,7 +378,7 @@ * CachedRowSet object does have a limitation: It is limited in * size by the amount of data it can store in memory at one time. * - *

    8.0 Getting Universal Data Access

    + *

    8.0 Getting Universal Data Access

    * Another advantage of the CachedRowSet class is that it makes it * possible to retrieve and store data from sources other than a relational * database. The reader for a rowset can be implemented to read and populate @@ -391,7 +391,7 @@ * CachedRowSet objects will contain data that was fetched * from an SQL database using the JDBC API. * - *

    9.0 Setting Properties

    + *

    9.0 Setting Properties

    * All rowsets maintain a set of properties, which will usually be set using * a tool. The number and kinds of properties a rowset has will vary, * depending on what the rowset does and how it gets its data. For example, @@ -492,7 +492,7 @@ * crs.execute(); * } * - *

    10.0 Paging Data

    + *

    10.0 Paging Data

    * Because a CachedRowSet object stores data in memory, * the amount of data that it can contain at any one * time is determined by the amount of memory available. To get around this limitation, diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/FilteredRowSet.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/FilteredRowSet.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/FilteredRowSet.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -38,7 +38,7 @@ * Alternatively, a vendor is free to implement its own version * by implementing this interface. * - *

    1.0 Background

    + *

    1.0 Background

    * * There are occasions when a RowSet object has a need to provide a degree * of filtering to its contents. One possible solution is to provide @@ -56,14 +56,14 @@ * methods, which a FilteredRowSet implementation can override * to supply filtering support. * - *

    2.0 Predicate Sharing

    + *

    2.0 Predicate Sharing

    * * If a FilteredRowSet implementation is shared using the * inherited createShared method in parent interfaces, the * Predicate should be shared without modification by all * FilteredRowSet instance clones. * - *

    3.0 Usage

    + *

    3.0 Usage

    *

    * By implementing a Predicate (see example in Predicate * class JavaDoc), a FilteredRowSet could then be used as described @@ -92,7 +92,7 @@ * used in combination to achieved the required filtering result with * out the need for query language processing. * - *

    4.0 Updating a FilteredRowSet Object

    + *

    4.0 Updating a FilteredRowSet Object

    * The predicate set on a FilteredRowSet object * applies a criterion on all rows in a * RowSet object to manage a subset of rows in a RowSet @@ -113,7 +113,7 @@ * FilteredRowSet object, and all subsequent views and updates will be * subject to similar enforcement. * - *

    5.0 Behavior of Rows Outside the Filter

    + *

    5.0 Behavior of Rows Outside the Filter

    * Rows that fall outside of the filter set on a FilteredRowSet * object cannot be modified until the filter is removed or a * new filter is applied. diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/JdbcRowSet.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/JdbcRowSet.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/JdbcRowSet.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -36,7 +36,7 @@ * The standard interface that all standard implementations of * JdbcRowSet must implement. * - *

    1.0 Overview

    + *

    1.0 Overview

    * A wrapper around a ResultSet object that makes it possible * to use the result set as a JavaBeans™ * component. Thus, a JdbcRowSet object can be one of the Beans that @@ -60,7 +60,7 @@ * JdbcRowSet object as if it were the ResultSet * object. * - *

    2.0 Creating a JdbcRowSet Object

    + *

    2.0 Creating a JdbcRowSet Object

    * The reference implementation of the JdbcRowSet interface, * JdbcRowSetImpl, provides an implementation of * the default constructor. A new instance is initialized with diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/JoinRowSet.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/JoinRowSet.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/JoinRowSet.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -48,7 +48,7 @@ * alternatively be set by supplying it to the appropriate version of the * JointRowSet method addRowSet. * - *

    1.0 Overview

    + *

    1.0 Overview

    * Disconnected RowSet objects (CachedRowSet objects * and implementations extending the CachedRowSet interface) * do not have a standard way to establish an SQL JOIN between @@ -98,7 +98,7 @@ * JoinRowSet interface explain these JOIN types, which are * standard SQL JOIN types. * - *

    2.0 Using a JoinRowSet Object for Creating a JOIN

    + *

    2.0 Using a JoinRowSet Object for Creating a JOIN

    * When a JoinRowSet object is created, it is empty. * The first RowSet object to be added becomes the basis for the * JOIN relationship. @@ -126,7 +126,7 @@ * These four methods set or reset the match column at the time a RowSet * object is being added to a JoinRowSet object. * - *

    3.0 Sample Usage

    + *

    3.0 Sample Usage

    *

    * The following code fragment adds two CachedRowSet * objects to a JoinRowSet object. Note that in this example, @@ -193,7 +193,7 @@ * EMP_ID column matches a value for the EMP_ID column * in jrs has been added to jrs. * - *

    4.0 JoinRowSet Methods

    + *

    4.0 JoinRowSet Methods

    * The JoinRowSet interface supplies several methods for adding * RowSet objects and for getting information about the * JoinRowSet object. diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/Joinable.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/Joinable.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/Joinable.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -28,7 +28,7 @@ import java.sql.SQLException; /** - *

    1.0 Background

    + *

    1.0 Background

    * The Joinable interface provides the methods for getting and * setting a match column, which is the basis for forming the SQL JOIN * formed by adding RowSet objects to a JoinRowSet @@ -58,7 +58,7 @@ * } * * - *

    2.0 Usage Guidelines

    + *

    2.0 Usage Guidelines

    *

    * The methods in the Joinable interface allow a RowSet object * to set a match column, retrieve a match column, or unset a match column, which is @@ -98,7 +98,7 @@ * become part of an SQL JOIN directly without having to become part * of a JoinRowSet object. * - *

    3.0 Managing Multiple Match Columns

    + *

    3.0 Managing Multiple Match Columns

    * The index array passed into the setMatchColumn methods indicates * how many match columns are being set (the length of the array) in addition to * which columns will be used for the match. For example: diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/Predicate.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/Predicate.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/Predicate.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -32,7 +32,7 @@ * The standard interface that provides the framework for all * FilteredRowSet objects to describe their filters. * - *

    1.0 Background

    + *

    1.0 Background

    * The Predicate interface is a standard interface that * applications can implement to define the filter they wish to apply to a * a FilteredRowSet object. A FilteredRowSet @@ -43,7 +43,7 @@ * the constraints of the filter; and conversely, it inserts, modifies, or updates * only rows that are within the constraints of the filter. * - *

    2.0 Implementation Guidelines

    + *

    2.0 Implementation Guidelines

    * In order to supply a predicate for the FilteredRowSet. * this interface must be implemented. At this time, the JDBC RowSet * Implementations (JSR-114) does not specify any standard filters definitions. @@ -101,7 +101,7 @@ * */ - //

    3.0 FilteredRowSet Internals

    + //

    3.0 FilteredRowSet Internals

    // internalNext, First, Last. Discuss guidelines on how to approach this // and cite examples in reference implementations. public interface Predicate { diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/WebRowSet.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/WebRowSet.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/WebRowSet.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -36,7 +36,7 @@ * The standard interface that all implementations of a {@code WebRowSet} * must implement. * - *

    1.0 Overview

    + *

    1.0 Overview

    * The {@code WebRowSetImpl} provides the standard * reference implementation, which may be extended if required. *

    @@ -78,12 +78,12 @@ * * * - *

    2.0 WebRowSet States

    + *

    2.0 WebRowSet States

    * The following sections demonstrates how a {@code WebRowSet} implementation * should use the XML Schema to describe update, insert, and delete operations * and to describe the state of a {@code WebRowSet} object in XML. * - *

    2.1 State 1 - Outputting a {@code WebRowSet} Object to XML

    + *

    2.1 State 1 - Outputting a {@code WebRowSet} Object to XML

    * In this example, a {@code WebRowSet} object is created and populated with a simple 2 column, * 5 row table from a data source. Having the 5 rows in a {@code WebRowSet} object * makes it possible to describe them in XML. The @@ -216,7 +216,7 @@ * * * } - *

    2.2 State 2 - Deleting a Row

    + *

    2.2 State 2 - Deleting a Row

    * Deleting a row in a {@code WebRowSet} object involves simply moving to the row * to be deleted and then calling the method {@code deleteRow}, as in any other * {@code RowSet} object. The following @@ -265,7 +265,7 @@ * * *} - *

    2.3 State 3 - Inserting a Row

    + *

    2.3 State 3 - Inserting a Row

    * A {@code WebRowSet} object can insert a new row by moving to the insert row, * calling the appropriate updater methods for each column in the row, and then * calling the method {@code insertRow}. @@ -337,7 +337,7 @@ * * *} - *

    2.4 State 4 - Modifying a Row

    + *

    2.4 State 4 - Modifying a Row

    * Modifying a row produces specific XML that records both the new value and the * value that was replaced. The value that was replaced becomes the original value, * and the new value becomes the current value. The following diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialArray.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialArray.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialArray.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -50,7 +50,7 @@ * if necessary. At this time, logical pointers to the data in the data source, * such as locators, are not currently supported. * - *

    Thread safety

    + *

    Thread safety

    * * A SerialArray is not safe for use by multiple concurrent threads. If a * SerialArray is to be used by more than one thread then access to the diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialBlob.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialBlob.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialBlob.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2015, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -51,7 +51,7 @@ * Blob object within a SerialBlob object * and to update or truncate a Blob object. * - *

    Thread safety

    + *

    Thread safety

    * *

    A SerialBlob is not safe for use by multiple concurrent threads. If a * SerialBlob is to be used by more than one thread then access to the SerialBlob diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialClob.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialClob.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialClob.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2018, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -44,7 +44,7 @@ * from a SerialClob object or to locate the start of * a pattern of characters. * - *

    Thread safety

    + *

    Thread safety

    * *

    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 diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialDatalink.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialDatalink.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialDatalink.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -43,7 +43,7 @@ * java.net.URL url = rowset.getURL(1); * * - *

    Thread safety

    + *

    Thread safety

    * * 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 diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialJavaObject.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialJavaObject.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialJavaObject.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -47,7 +47,7 @@ * Static or transient fields cannot be serialized; an attempt to serialize * them will result in a SerialException object being thrown. * - *

    Thread safety

    + *

    Thread safety

    * * A SerialJavaObject is not safe for use by multiple concurrent threads. If a * SerialJavaObject is to be used by more than one thread then access to the diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialRef.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialRef.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialRef.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2014, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -37,7 +37,7 @@ * creating a SerialRef instance from a Ref * object and provides methods for getting and setting the Ref object. * - *

    Thread safety

    + *

    Thread safety

    * * A SerialRef is not safe for use by multiple concurrent threads. If a * SerialRef is to be used by more than one thread then access to the SerialRef diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialStruct.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialStruct.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/SerialStruct.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -51,7 +51,7 @@ * the SQL type name of the SQL structured type in the database, and methods * for retrieving its attribute values. * - *

    Thread safety

    + *

    Thread safety

    * * A SerialStruct is not safe for use by multiple concurrent threads. If a * SerialStruct is to be used by more than one thread then access to the diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/serial/package-info.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/package-info.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/serial/package-info.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2018, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -34,7 +34,7 @@ * a different VM or across layers within an application.
    *

    * - *

    1.0 SerialArray

    + *

    1.0 SerialArray

    * A serializable mapping in the Java programming language of an SQL ARRAY * value.
    *
    @@ -43,7 +43,7 @@ * the SQL name for the base type, and methods for copying all or part of a * SerialArray object.
    * - *

    2.0 SerialBlob

    + *

    2.0 SerialBlob

    * A serializable mapping in the Java programming language of an SQL BLOB * value.
    *
    @@ -60,7 +60,7 @@ * to locate a given pattern of bytes or a Blob object within a SerialBlob * object.
    * - *

    3.0 SerialClob

    + *

    3.0 SerialClob

    * A serializable mapping in the Java programming language of an SQL CLOB * value.
    *
    @@ -74,7 +74,7 @@ * SerialClob object or to locate the start of a pattern of characters. *
    * - *

    5.0 SerialDatalink

    + *

    5.0 SerialDatalink

    * A serializable mapping in the Java programming language of an SQL DATALINK * value. A DATALINK value references a file outside of the underlying data source * that the originating data source manages.
    @@ -85,7 +85,7 @@ *
    *       java.net.URL url = rowset.getURL(1);
    * - *

    6.0 SerialJavaObject

    + *

    6.0 SerialJavaObject

    * A serializable mapping in the Java programming language of an SQL JAVA_OBJECT * value. Assuming the Java object instance implements the Serializable interface, * this simply wraps the serialization process.
    @@ -96,7 +96,7 @@ * Static or transient fields cannot be serialized and attempting to do so * will result in a SerialException being thrown.
    * - *

    7.0 SerialRef

    + *

    7.0 SerialRef

    * A serializable mapping between the SQL REF type and the Java programming * language.
    *
    @@ -104,7 +104,7 @@ * instance from a Ref type and provides methods for getting * and setting the Ref object type.
    * - *

    8.0 SerialStruct

    + *

    8.0 SerialStruct

    * A serializable mapping in the Java programming language of an SQL structured * type. Each attribute that is not already serializable is mapped to a serializable * form, and if an attribute is itself a structured type, each of its attributes @@ -119,7 +119,7 @@ * type name of the SQL structured type in the database, and methods for retrieving * its attribute values.
    * - *

    9.0 SQLInputImpl

    + *

    9.0 SQLInputImpl

    * An input stream used for custom mapping user-defined types (UDTs). An * SQLInputImpl object is an input stream that contains a stream of * values that are @@ -142,7 +142,7 @@ * method SQLData.readSQL, which in turn calls the SQLInputImpl * methods to read the attributes from the input stream.
    * - *

    10.0 SQLOutputImpl

    + *

    10.0 SQLOutputImpl

    * The output stream for writing the attributes of a custom mapped user-defined * type (UDT) back to the database. The driver uses this interface internally, * and its methods are never directly invoked by an application programmer. @@ -160,7 +160,7 @@ * SQLOutputImpl * output stream as the representation of an SQL user-defined type. * - *

    Custom Mapping

    + *

    Custom Mapping

    * The JDBC API provides mechanisms for mapping an SQL structured type or DISTINCT * type to the Java programming language. Typically, a structured type is mapped * to a class, and its attributes are mapped to fields in the class. diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/spi/SyncFactory.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/spi/SyncFactory.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/spi/SyncFactory.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -59,7 +59,7 @@ * RowSet implementation can obtain its SyncProvider * implementation. * - *

    1.0 Overview

    + *

    1.0 Overview

    * The SyncFactory class provides an internal registry of available * synchronization provider implementations (SyncProvider objects). * This registry may be queried to determine which @@ -108,7 +108,7 @@ * SyncProvider implementations are available, the reference * implementation providers are supplied. *
- *

2.0 Registering SyncProvider Implementations

+ *

2.0 Registering SyncProvider Implementations

*

* Both vendors and developers can register SyncProvider * implementations using one of the following mechanisms. diff -r d58599c7cdef -r 9a90236ab64c src/java.sql.rowset/share/classes/javax/sql/rowset/spi/SyncProvider.java --- a/src/java.sql.rowset/share/classes/javax/sql/rowset/spi/SyncProvider.java Wed Mar 13 10:37:30 2019 -0700 +++ b/src/java.sql.rowset/share/classes/javax/sql/rowset/spi/SyncProvider.java Wed Mar 13 14:10:18 2019 -0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2003, 2019, 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 @@ -101,7 +101,7 @@ * providers for additional guidance on how to implement a new * SyncProvider implementation. * - *

2.0 How a RowSet Object Gets Its Provider

+ *

2.0 How a RowSet Object Gets Its Provider

* * A disconnected Rowset object may get access to a * SyncProvider object in one of the following two ways: @@ -130,7 +130,7 @@ * assigned the default provider in the reference implementation, which is * com.sun.rowset.providers.RIOptimisticProvider. * - *

3.0 Violations and Synchronization Issues

+ *

3.0 Violations and Synchronization Issues

* If an update between a disconnected RowSet object * and a data source violates * the original query or the underlying data source constraints, this will @@ -148,7 +148,7 @@ * all SyncProvider * objects must throw a SyncProviderException. * - *

4.0 Updatable SQL VIEWs

+ *

4.0 Updatable SQL VIEWs

* It is possible for any disconnected or connected RowSet object to be populated * from an SQL query that is formulated originally from an SQL VIEW. * While in many cases it is possible for an update to be performed to an @@ -168,7 +168,7 @@ * The default is for a RowSet object not to be updatable if it was * populated with data from an SQL VIEW. * - *

5.0 SyncProvider Constants

+ *

5.0 SyncProvider Constants

* The SyncProvider class provides three sets of constants that * are used as return values or parameters for SyncProvider methods. * SyncProvider objects may be implemented to perform synchronization