45  * The <code>Joinable</code> interface provides the methods for setting,

    45  * The <code>Joinable</code> interface provides the methods for setting,

    46  * retrieving, and unsetting a match column, the basis for

    46  * retrieving, and unsetting a match column, the basis for

    47  * establishing an SQL <code>JOIN</code> relationship. The match column may

    47  * establishing an SQL <code>JOIN</code> relationship. The match column may

    48  * alternatively be set by supplying it to the appropriate version of the

    48  * alternatively be set by supplying it to the appropriate version of the

    49  * <code>JointRowSet</code> method <code>addRowSet</code>.

    49  * <code>JointRowSet</code> method <code>addRowSet</code>.

    52  * <h3>1.0 Overview</h3>

    51  * <h3>1.0 Overview</h3>

    53  * Disconnected <code>RowSet</code> objects (<code>CachedRowSet</code> objects

    52  * Disconnected <code>RowSet</code> objects (<code>CachedRowSet</code> objects

    54  * and implementations extending the <code>CachedRowSet</code> interface)

    53  * and implementations extending the <code>CachedRowSet</code> interface)

    55  * do not have a standard way to establish an SQL <code>JOIN</code> between

    54  * do not have a standard way to establish an SQL <code>JOIN</code> between

    56  * <code>RowSet</code> objects without the expensive operation of

    55  * <code>RowSet</code> objects without the expensive operation of

    96  * </UL>

    95  * </UL>

    97  * Note that if no type is set, the <code>JOIN</code> will automatically be an

    96  * Note that if no type is set, the <code>JOIN</code> will automatically be an

    98  * inner join. The comments for the fields in the

    97  * inner join. The comments for the fields in the

    99  * <code>JoinRowSet</code> interface explain these <code>JOIN</code> types, which are

    98  * <code>JoinRowSet</code> interface explain these <code>JOIN</code> types, which are

   100  * standard SQL <code>JOIN</code> types.

    99  * standard SQL <code>JOIN</code> types.

   102  * <h3>2.0 Using a <code>JoinRowSet</code> Object for Creating a <code>JOIN</code></h3>

   101  * <h3>2.0 Using a <code>JoinRowSet</code> Object for Creating a <code>JOIN</code></h3>

   103  * When a <code>JoinRowSet</code> object is created, it is empty.

   102  * When a <code>JoinRowSet</code> object is created, it is empty.

   104  * The first <code>RowSet</code> object to be added becomes the basis for the

   103  * The first <code>RowSet</code> object to be added becomes the basis for the

   105  * <code>JOIN</code> relationship.

   104  * <code>JOIN</code> relationship.

   106  * Applications must determine which column in each of the

   105  * Applications must determine which column in each of the

   191  * <P>

   190  * <P>

   192  * The <code>JoinRowSet</code> object <i>jrs</i> now contains values from all three

   191  * The <code>JoinRowSet</code> object <i>jrs</i> now contains values from all three

   193  * tables. The data in each row in <i>four01k</i> in which the value for the

   192  * tables. The data in each row in <i>four01k</i> in which the value for the

   194  * <code>EMP_ID</code> column matches a value for the <code>EMP_ID</code> column

   193  * <code>EMP_ID</code> column matches a value for the <code>EMP_ID</code> column

   195  * in <i>jrs</i> has been added to <i>jrs</i>.

   194  * in <i>jrs</i> has been added to <i>jrs</i>.

   197  * <h3>4.0 <code>JoinRowSet</code> Methods</h3>

   196  * <h3>4.0 <code>JoinRowSet</code> Methods</h3>

   198  * The <code>JoinRowSet</code> interface supplies several methods for adding

   197  * The <code>JoinRowSet</code> interface supplies several methods for adding

   199  * <code>RowSet</code> objects and for getting information about the

   198  * <code>RowSet</code> objects and for getting information about the

   200  * <code>JoinRowSet</code> object.

   199  * <code>JoinRowSet</code> object.

   201  * <UL>

   200  * <UL>

   215  *       One method sets the <code>JOIN</code> type, and five methods find out whether

   214  *       One method sets the <code>JOIN</code> type, and five methods find out whether

   216  *       the <code>JoinRowSet</code> object supports a given type.

   215  *       the <code>JoinRowSet</code> object supports a given type.

   217  *   <LI>A method to make a separate copy of the <code>JoinRowSet</code> object<BR>

   216  *   <LI>A method to make a separate copy of the <code>JoinRowSet</code> object<BR>

   218  *       This method creates a copy that can be persisted to the data source.

   217  *       This method creates a copy that can be persisted to the data source.

   219  * </UL>

   218  * </UL>

   221  */

   220  */

   222 

   221 

   223 public interface JoinRowSet extends WebRowSet {

   222 public interface JoinRowSet extends WebRowSet {

   224 

   223 

   225     /**

   224     /**