模块 java.sql.rowset
包 javax.sql.rowset

接口 JoinRowSet

所有父级接口：
AutoCloseable , CachedRowSet , Joinable , ResultSet , RowSet , WebRowSet , Wrapper
public interface JoinRowSet extends WebRowSet
JoinRowSet 接口提供了一种机制，用于将来自不同 RowSet 对象的相关数据组合到一个 JoinRowSet 对象中，它代表一个 SQL JOIN 。换句话说，JoinRowSet 对象充当来自 RowSet 对象的数据的容器，这些对象形成 SQL JOIN 关系。

Joinable 接口提供设置、检索和取消设置匹配列的方法，这是建立 SQL JOIN 关系的基础。匹配列也可以通过将其提供给 JointRowSet 方法 addRowSet 的适当版本来设置。

1.0 概述

断开连接的 RowSet 对象（CachedRowSet 对象和扩展 CachedRowSet 接口的实现）没有标准方法来在 RowSet 对象之间建立 SQL JOIN 而无需重新连接到数据源的昂贵操作。 JoinRowSet 接口专为满足这一需求而设计。

任何 RowSet 对象都可以添加到 JoinRowSet 对象以成为 SQL JOIN 关系的一部分。这意味着连接和断开连接的 RowSet 对象都可以是 JOIN 的一部分。 RowSet 在连接环境中运行的对象（JdbcRowSet 对象）被鼓励使用它们已经连接到的数据库直接在表之间建立 SQL JOIN 关系。但是，如有必要，可以将 JdbcRowSet 对象添加到 JoinRowSet 对象。

可以将任意数量的 RowSet 对象添加到 JoinRowSet 的实例，前提是它们可以在 SQL JOIN 中关联。根据定义，SQL JOIN 语句用于根据公共属性组合两个或多个关系数据库表中包含的数据。 Joinable 接口提供了建立公共属性的方法，这是通过设置一个匹配列.匹配列通常与主键重合，但不要求匹配列与主键相同。通过建立然后强制执行列匹配，JoinRowSet 对象在 RowSet 对象之间建立 JOIN 关系，而无需可用关系数据库的帮助。

要建立的 JOIN 类型是通过使用方法 setJoinType 设置 JoinRowSet 常量之一来确定的。可以设置以下 SQL JOIN 类型：

  • CROSS_JOIN
  • FULL_JOIN
  • INNER_JOIN - 如果未设置 JOIN 类型则为默认值
  • LEFT_OUTER_JOIN
  • RIGHT_OUTER_JOIN
请注意，如果未设置类型，JOIN 将自动成为内部联接。 JoinRowSet 接口中字段的注释解释了这些 JOIN 类型，它们是标准 SQL JOIN 类型。

2.0 使用 JoinRowSet 对象创建 JOIN

创建 JoinRowSet 对象时，它是空的。要添加的第一个 RowSet 对象成为 JOIN 关系的基础。应用程序必须确定要添加到 JoinRowSet 对象的每个 RowSet 对象中的哪一列应该是匹配列。所有 RowSet 对象都必须包含一个匹配列，并且每个匹配列中的值必须是可以与其他匹配列中的值进行比较的值。这些列不必具有相同的名称，尽管它们经常如此，并且它们不必存储完全相同的数据类型，只要可以比较数据类型即可。

可以通过两种方式设置匹配列：

  • 通过调用Joinable方法setMatchColumn
    这是唯一可以在将 RowSet 对象添加到 JoinRowSet 对象之前设置匹配列的方法。 RowSet 对象必须实现了 Joinable 接口才能使用方法 setMatchColumn 。一旦设置了匹配列值，此方法可用于随时重置匹配列。
  • 通过调用 JoinRowSet 方法 addRowSet 的一个版本，它采用列名或数字（或列名或数字的数组）
    五个 addRowSet 方法中的四个将匹配列作为参数。这四种方法在将 RowSet 对象添加到 JoinRowSet 对象时设置或重置匹配列。

3.0 示例用法

以下代码片段将两个 CachedRowSet 对象添加到一个 JoinRowSet 对象。请注意，在此示例中，未设置 SQL JOIN 类型，因此默认的 JOIN 类型为INNER_JOIN， 成立。

在下面的代码片段中，将匹配列设置为第一列 (EMP_ID) 的表 EMPLOYEES 添加到 JoinRowSet 对象jrs.然后添加表 ESSP_BONUS_PLAN，其匹配列同样是 EMP_ID 列。当第二个表被添加到jrs，仅添加 ESSP_BONUS_PLAN 中其 EMP_ID 值与 EMPLOYEES 表中的 EMP_ID 值匹配的行。在本例中，奖金计划中的每个人都是雇员，因此表 ESSP_BONUS_PLAN 中的所有行都添加到 JoinRowSet 对象中。在此示例中，添加的两个 CachedRowSet 对象都实现了 Joinable 接口，因此可以调用 Joinable 方法 setMatchColumn 。

   JoinRowSet jrs = new JoinRowSetImpl();

   ResultSet rs1 = stmt.executeQuery("SELECT * FROM EMPLOYEES");
   CachedRowSet empl = new CachedRowSetImpl();
   empl.populate(rs1);
   empl.setMatchColumn(1);
   jrs.addRowSet(empl);

   ResultSet rs2 = stmt.executeQuery("SELECT * FROM ESSP_BONUS_PLAN");
   CachedRowSet bonus = new CachedRowSetImpl();
   bonus.populate(rs2);
   bonus.setMatchColumn(1); // EMP_ID is the first column
   jrs.addRowSet(bonus);

在此刻，jrs是两个 RowSet 对象基于它们的 EMP_ID 列的内部 JOIN。应用程序现在可以浏览合并的数据，就像浏览一个单独的 RowSet 对象一样。因为jrs本身是一个 RowSet 对象，应用程序可以使用 RowSet 方法导航或修改它。

   jrs.first();
   int employeeID = jrs.getInt(1);
   String employeeName = jrs.getString(2);

请注意，由于当应用程序添加第二个或后续 RowSet 对象时必须强制执行 SQL JOIN，因此在执行 JOIN 时性能可能会出现初始下降。

以下代码片段添加了一个额外的 CachedRowSet 对象。在这种情况下，匹配列 (EMP_ID) 在将 CachedRowSet 对象添加到 JoinRowSet 对象时设置。

   ResultSet rs3 = stmt.executeQuery("SELECT * FROM 401K_CONTRIB");
   CachedRowSet fourO1k = new CachedRowSetImpl();
   four01k.populate(rs3);
   jrs.addRowSet(four01k, 1);

JoinRowSet 对象jrs现在包含来自所有三个表的值。中每一行的数据four01k其中 EMP_ID 列的值与 EMP_ID 列的值匹配jrs已添加到jrs.

4.0JoinRowSet方法

JoinRowSet 接口提供了几种方法来添加 RowSet 对象和获取有关 JoinRowSet 对象的信息。
  • 添加一个或多个RowSet对象的方法
    这些方法允许应用程序一次添加一个 RowSet 对象或一次添加多个 RowSet 对象。在任何一种情况下，这些方法都可以为添加的每个 RowSet 对象指定匹配列。
  • 获取信息的方法
    一种方法检索 JoinRowSet 对象中的 RowSet 对象，另一种方法检索 RowSet 名称。第三种方法检索在幕后用于形成 JOIN 的 SQL WHERE 子句或 WHERE 子句的作用的文本描述。
  • JOIN类型相关的方法
    一种方法设置 JOIN 类型，五种方法确定 JoinRowSet 对象是否支持给定类型。
  • 制作 JoinRowSet 对象的单独副本的方法
    此方法创建一个可以持久保存到数据源的副本。
自从：
1.5

  • 字段详细信息

    • CROSS_JOIN

      static final int CROSS_JOIN
      ANSI 风格的 JOIN 提供两个表的叉积
      参见：

    • INNER_JOIN

      static final int INNER_JOIN
      ANSI 样式JOIN 提供两个表之间的内部连接。连接的任一表中的任何不匹配的行都应该被丢弃。
      参见：

    • LEFT_OUTER_JOIN

      static final int LEFT_OUTER_JOIN
      一个 ANSI 风格的 JOIN 提供两个表之间的左外连接。在 SQL 中，这描述了应从 JOIN 语句左侧返回所有记录的位置。
      参见：

    • RIGHT_OUTER_JOIN

      static final int RIGHT_OUTER_JOIN
      ANSI 风格的 JOIN 提供两个表之间的右外连接。在 SQL 中，这被描述为 JOIN 语句右侧的表中的所有记录，即使左侧的表没有匹配的记录。
      参见：

    • FULL_JOIN

      static final int FULL_JOIN
      提供完整 JOIN 的 ANSI 样式 JOIN。指定返回任一表中的所有行，而不管另一个表中的匹配记录。
      参见：

  • 方法详情

    • addRowSet

      void addRowSet(Joinable  rowset) throws SQL异常
      将给定的 RowSet 对象添加到此 JoinRowSet 对象。如果 RowSet 对象是第一个添加到此 JoinRowSet 对象的对象，则它构成要建立的 JOIN 关系的基础。

      仅当给定的 RowSet 对象已经具有使用 Joinable 方法 setMatchColumn 设置的匹配列时，才应使用此方法。

      注意：Joinable 对象是任何已实现 Joinable 接口的 RowSet 对象。

      参数：
      rowset - 要添加到此 JoinRowSet 对象的 RowSet 对象；它必须实现 Joinable 接口并设置匹配列
      抛出：
      SQLException - 如果 (1) 一个空行集被添加到这个 JoinRowSet 对象，(2) 没有设置匹配列行集, 或 (3)行集违反活动 JOIN
      参见：

    • addRowSet

      void addRowSet(RowSet  rowset, int columnIdx) throws SQL异常
      将给定的 RowSet 对象添加到此 JoinRowSet 对象并将指定列设置为 RowSet 对象的匹配列。如果 RowSet 对象是第一个添加到此 JoinRowSet 对象的对象，则它构成要建立的 JOIN 关系的基础。

      这个方法应该在什么时候使用RowSet还没有设置匹配列。

      参数：
      rowset - 要添加到此 JoinRowSet 对象的 RowSet 对象；它可以实现 Joinable 接口
      columnIdx - 一个 int 标识要成为匹配列的列
      抛出：
      SQLException - 如果 (1)行集是空行集或 (2)行集违反活动 JOIN
      参见：

    • addRowSet

      void addRowSet(RowSet  rowset, String  columnName) throws SQL异常
      添加行集到这个 JoinRowSet 对象并将指定的列设置为匹配列。如果行集是第一个添加到这个 JoinRowSet 对象的，它构成了要建立的 JOIN 关系的基础。

      当给定的 RowSet 对象还没有匹配列时，应使用此方法。

      参数：
      rowset - 要添加到此 JoinRowSet 对象的 RowSet 对象；它可以实现 Joinable 接口
      columnName - String 对象给出要设置为匹配列的列的名称
      抛出：
      SQLException - 如果 (1)行集是空行集或 (2) 的匹配列行集不满足JOIN的条件

    • addRowSet

      void addRowSet(RowSet [] rowset, int[] columnIdx) throws SQL异常
      将给定 RowSet 对象数组中包含的一个或多个 RowSet 对象添加到此 JoinRowSet 对象，并将每个 RowSet 对象的匹配列设置为给定列索引数组中的匹配列。中的第一个元素columnIdx被设置为第一个 RowSet 对象的匹配列行集, 第二个元素columnIdx被设置为第二个元素的匹配列行集， 等等。

      添加到此 JoinRowSet 对象的第一个 RowSet 对象构成了 JOIN 关系的基础。

      当给定的 RowSet 对象还没有匹配列时，应使用此方法。

      参数：
      rowset - 要添加到 JOIN 的一个或多个 RowSet 对象的数组；它可以实现 Joinable 接口
      columnIdx - 一个 int 值数组，指示要设置为 RowSet 对象的匹配列的列的索引行集
      抛出：
      SQLException - 如果 (1) 向此 JoinRowSet 对象添加一个空行集，(2) 未为 RowSet 对象设置匹配列行集，或者 (3) 添加的 RowSet 对象违反了活动的 JOIN

    • addRowSet

      void addRowSet(RowSet [] rowset, String [] columnName) throws SQL异常
      将给定 RowSet 对象数组中包含的一个或多个 RowSet 对象添加到此 JoinRowSet 对象，并将每个 RowSet 对象的匹配列设置为给定列名数组中的匹配列。中的第一个元素列名被设置为第一个 RowSet 对象的匹配列行集, 第二个元素列名被设置为第二个元素的匹配列行集， 等等。

      添加到此 JoinRowSet 对象的第一个 RowSet 对象构成了 JOIN 关系的基础。

      当给定的 RowSet 对象还没有匹配列时，应使用此方法。

      参数：
      rowset - 要添加到 JOIN 的一个或多个 RowSet 对象的数组；它可以实现 Joinable 接口
      columnName - 一个 String 值数组，指示要设置为 RowSet 对象的匹配列的列的名称行集
      抛出：
      SQLException - 如果 (1) 向此 JoinRowSet 对象添加一个空行集，(2) 未为 RowSet 对象设置匹配列行集，或者 (3) 添加的 RowSet 对象违反了活动的 JOIN

    • getRowSets

      Collection <?> getRowSets() throws SQL异常
      返回一个 Collection 对象，其中包含已添加到此 JoinRowSet 对象的 RowSet 对象。这应该返回 JOIN 中包含的“n”个 RowSet 并维护在此联合中发生的任何更新。
      返回：
      一个 Collection 对象，由添加到此 JoinRowSet 对象的 RowSet 对象组成
      抛出：
      SQLException - 如果发生错误生成要返回的 Collection 对象

    • getRowSetNames

      String [] getRowSetNames() throws SQL异常
      返回一个 String 数组，其中包含添加到此 JoinRowSet 对象的 RowSet 对象的名称。
      返回：
      这个 JoinRowSet 对象中的 RowSet 对象的名称的 String 数组
      抛出：
      SQLException - 如果检索 RowSet 对象的名称时发生错误
      参见：

    • toCachedRowSet

      CachedRowSet  toCachedRowSet() throws SQL异常
      创建一个包含此 JoinRowSet 对象中数据的新 CachedRowSet 对象，可以使用 CachedRowSet 对象的 SyncProvider 对象将其保存到数据源。

      如果对 JoinRowSet 应用了任何更新或修改，则该方法返回的 CachedRowSet 将无法将其更改保存回数据源中的原始行和表。返回的 CachedRowSet 实例不应包含修改数据，并且应清除其原始 SQL 语句的所有属性。应用程序应使用 RowSet.setCommand 方法重置 SQL 语句。

      为了允许将更改持久保存回原始表的数据源，应该在 JoinRowSet 对象实例上使用和调用 acceptChanges 方法。实现可以利用其实现中的内部数据和更新跟踪来与 SyncProvider 交互以保留任何更改。

      返回：
      包含 JoinRowSet 内容的 CachedRowSet
      抛出：
      SQLException - 如果组装 CachedRowSet 对象时发生错误
      参见：

    • supportsCrossJoin

      boolean supportsCrossJoin()
      指示 JoinRowSet 实现是否支持 CROSS_JOIN
      返回：
      如果支持 CROSS_JOIN，则为真；否则为假

    • supportsInnerJoin

      boolean supportsInnerJoin()
      指示 INNER_JOIN 是否受 JoinRowSet 实现支持
      返回：
      true 是支持 INNER_JOIN；否则为假

    • supportsLeftOuterJoin

      boolean supportsLeftOuterJoin()
      指示 LEFT_OUTER_JOIN 是否受 JoinRowSet 实现支持
      返回：
      true 是支持 LEFT_OUTER_JOIN；否则为假

    • supportsRightOuterJoin

      boolean supportsRightOuterJoin()
      指示 JoinRowSet 实现是否支持 RIGHT_OUTER_JOIN
      返回：
      true 是支持 RIGHT_OUTER_JOIN；否则为假

    • supportsFullJoin

      boolean supportsFullJoin()
      指示 JoinRowSet 实现是否支持 FULL_JOIN
      返回：
      true 是支持 FULL_JOIN；否则为假

    • setJoinType

      void setJoinType(int joinType) throws SQL异常
      允许应用程序调整对包含在 JoinRowSet 对象实例中的表施加的 JOIN 类型。如果实现不支持给定的 JOIN 类型，则应抛出 SQLException。
      参数：
      joinType - SQL JOIN 的标准 JoinRowSet.XXX 静态字段定义，用于动态重新配置 JoinRowSet 实例。
      抛出：
      SQLException - 如果设置了不受支持的 JOIN 类型
      参见：

    • getWhereClause

      String  getWhereClause() throws SQL异常
      返回在 JoinRowSet 对象中使用的 WHERE 子句的类似 SQL 的描述。实现可以通过提供 JOIN 的 SQL 字符串描述来描述 SQL JOIN 的 WHERE 子句，或者提供文本描述来帮助使用 JoinRowSet 的应用程序
      返回：
      whereClause JoinRowSet 实例中使用的逻辑 WHERE 子句的文本或 SQL 描述
      抛出：
      SQLException - 如果在生成 WHERE 子句的表示时发生错误。

    • getJoinType

      int getJoinType() throws SQL异常
      返回一个 int 描述管理此 JoinRowSet 实例的集合 SQL JOIN 类型。返回的类型将是标准 JoinRowSet 类型之一：CROSS_JOIN、INNER_JOIN、LEFT_OUTER_JOIN、RIGHT_OUTER_JOIN 或 FULL_JOIN。
      返回：
      joinType SQL JOIN 的标准 JoinRowSet 静态字段定义之一。 JoinRowSet.INNER_JOIN 作为默认值返回 JOIN 类型是未明确设置的类型。
      抛出：
      SQLException - 如果在确定 JoinRowSet 实例支持的 SQL JOIN 类型时发生错误。
      参见：