55  *     class MyRowSetImpl extends BaseRowSet implements CachedRowSet, Joinable {

    55  *     class MyRowSetImpl extends BaseRowSet implements CachedRowSet, Joinable {

    56  *         :

    56  *         :

    57  *         :

    57  *         :

    58  *     }

    58  *     }

    59  * </pre>

    59  * </pre>

    61  * <h3>2.0 Usage Guidelines</h3>

    61  * <h3>2.0 Usage Guidelines</h3>

    62  * <P>

    62  * <P>

    63  * The methods in the <code>Joinable</code> interface allow a <code>RowSet</code> object

    63  * The methods in the <code>Joinable</code> interface allow a <code>RowSet</code> object

    64  * to set a match column, retrieve a match column, or unset a match column, which is

    64  * to set a match column, retrieve a match column, or unset a match column, which is

    65  * the column upon which an SQL <code>JOIN</code> can be based.

    65  * the column upon which an SQL <code>JOIN</code> can be based.

    66  * An instance of a class that implements these methods can be added to a

    66  * An instance of a class that implements these methods can be added to a

    67  * <code>JoinRowSet</code> object to allow an SQL <code>JOIN</code> relationship to

    67  * <code>JoinRowSet</code> object to allow an SQL <code>JOIN</code> relationship to

    68  *  be established.

    68  *  be established.

    70  * <pre>

    70  * <pre>

    71  *     CachedRowSet crs = new MyRowSetImpl();

    71  *     CachedRowSet crs = new MyRowSetImpl();

    72  *     crs.populate((ResultSet)rs);

    72  *     crs.populate((ResultSet)rs);

    73  *     (Joinable)crs.setMatchColumnIndex(1);

    73  *     (Joinable)crs.setMatchColumnIndex(1);

    74  *

    74  *

    95  * <code>RowSet</code> object <b>may</b> implement this interface

    95  * <code>RowSet</code> object <b>may</b> implement this interface

    96  * regardless of whether it is connected or disconnected. Note that a

    96  * regardless of whether it is connected or disconnected. Note that a

    97  * <code>JdbcRowSet</code> object, being always connected to its data source, can

    97  * <code>JdbcRowSet</code> object, being always connected to its data source, can

    98  * become part of an SQL <code>JOIN</code> directly without having to become part

    98  * become part of an SQL <code>JOIN</code> directly without having to become part

    99  * of a <code>JoinRowSet</code> object.

    99  * of a <code>JoinRowSet</code> object.

   101  * <h3>3.0 Managing Multiple Match Columns</h3>

   101  * <h3>3.0 Managing Multiple Match Columns</h3>

   102  * The index array passed into the <code>setMatchColumn</code> methods indicates

   102  * The index array passed into the <code>setMatchColumn</code> methods indicates

   103  * how many match columns are being set (the length of the array) in addition to

   103  * how many match columns are being set (the length of the array) in addition to

   104  * which columns will be used for the match. For example:

   104  * which columns will be used for the match. For example:

   105  * <pre>

   105  * <pre>