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

Interface WebRowSet

  • All Superinterfaces:
    AutoCloseableCachedRowSetJoinableResultSetRowSetWrapper
    All Known Subinterfaces:
    FilteredRowSetJoinRowSet

    public interface WebRowSet
    extends CachedRowSet
    WebRowSet所有实现必须实现的标准接口。

    1.0概述

    WebRowSetImpl提供标准参考实现,如果需要可以扩展。

    标准的WebRowSet XML Schema定义可从以下URI获得:

    它描述了在XML中描述RowSet对象时所需的标准XML文档格式,并且必须用于WebRowSet接口的所有标准实现,以确保互操作性。 此外, WebRowSet模式使用特定的SQL / XML模式注释,从而确保更高的跨平台互操作性。 这是ISO组织目前正在进行的一项工作。 SQL / XML定义可在以下URI中获得: 模式定义在三个不同的区域中描述RowSet对象的内部数据:
    • properties - 除了更一般的RowSet属性之外,这些属性还描述了标准同步提供程序属性。
    • 元数据 - 这描述了与由WebRowSet对象控制的表格结构相关联的元数据。 所描述的元数据与底层java.sql.ResultSet界面中可访问的元数据紧密对齐。
    • data - 描述原始数据(自上次填充或上次同步WebRowSet对象以来的数据状态)和当前数据。 通过跟踪原始数据和当前数据之间的差值, WebRowSet保持了将其数据中的更改同步回原始数据源的能力。

    2.0 WebRowSet状态

    以下部分演示了WebRowSet实现应如何使用XML Schema来描述更新,插入和删除操作,以及如何描述XML中的WebRowSet对象的状态。

    2.1状态1 - 将WebRowSet对象输出到XML

    在此示例中,将创建一个WebRowSet对象,并使用数据源中的简单2列5行表填充该对象。 WebRowSet对象中有5行可以用XML描述它们。 描述RowSet接口中定义的各种标准JavaBeans属性的元数据加上CachedRowSet interface接口中定义的标准属性提供了描述WebRowSet属性的关键详细信息。 使用标准writeXml方法将WebRowSet对象输出到XML描述了内部属性,如下所示:
       <properties> <command>select co1, col2 from test_table</command> <concurrency>1</concurrency> <datasource/> <escape-processing>true</escape-processing> <fetch-direction>0</fetch-direction> <fetch-size>0</fetch-size> <isolation-level>1</isolation-level> <key-columns/> <map/> <max-field-size>0</max-field-size> <max-rows>0</max-rows> <query-timeout>0</query-timeout> <read-only>false</read-only> <rowset-type>TRANSACTION_READ_UNCOMMITTED</rowset-type> <show-deleted>false</show-deleted> <table-name/> <url>jdbc:thin:oracle</url> <sync-provider> <sync-provider-name>.com.rowset.provider.RIOptimisticProvider</sync-provider-name> <sync-provider-vendor>Oracle Corporation</sync-provider-vendor> <sync-provider-version>1.0</sync-provider-name> <sync-provider-grade>LOW</sync-provider-grade> <data-source-lock>NONE</data-source-lock> </sync-provider> </properties>  
    描述WebRowSet组成的元数据在XML中描述,如下所述。 请注意, column-definition标记之间描述了这两列。
       <metadata> <column-count>2</column-count> <column-definition> <column-index>1</column-index> <auto-increment>false</auto-increment> <case-sensitive>true</case-sensitive> <currency>false</currency> <nullable>1</nullable> <signed>false</signed> <searchable>true</searchable> <column-display-size>10</column-display-size> <column-label>COL1</column-label> <column-name>COL1</column-name> <schema-name/> <column-precision>10</column-precision> <column-scale>0</column-scale> <table-name/> <catalog-name/> <column-type>1</column-type> <column-type-name>CHAR</column-type-name> </column-definition> <column-definition> <column-index>2</column-index> <auto-increment>false</auto-increment> <case-sensitive>false</case-sensitive> <currency>false</currency> <nullable>1</nullable> <signed>true</signed> <searchable>true</searchable> <column-display-size>39</column-display-size> <column-label>COL2</column-label> <column-name>COL2</column-name> <schema-name/> <column-precision>38</column-precision> <column-scale>0</column-scale> <table-name/> <catalog-name/> <column-type>3</column-type> <column-type-name>NUMBER</column-type-name> </column-definition> </metadata>  
    详细说明了属性和元数据的描述方式,下面详细说明了如何用XML描述WebRowSet对象的内容。 请注意,这描述了自实例化以来未经过任何修改的WebRowSet对象。 currentRow标记映射到WebRowSet对象提供的表结构的每一行。 根据XML值映射回的SQL类型, columnValue标记可以包含stringDatabinaryData标记。 binaryData标记包含Base64编码的数据,通常用于BLOBCLOB类型数据。
       <data> <currentRow> <columnValue> firstrow </columnValue> <columnValue> 1 </columnValue> </currentRow> <currentRow> <columnValue> secondrow </columnValue> <columnValue> 2 </columnValue> </currentRow> <currentRow> <columnValue> thirdrow </columnValue> <columnValue> 3 </columnValue> </currentRow> <currentRow> <columnValue> fourthrow </columnValue> <columnValue> 4 </columnValue> </currentRow> </data>  

    2.2状态2 - 删除一行

    删除WebRowSet对象中的行只需移动到要删除的行,然后调用方法deleteRow ,就像在任何其他RowSet对象中一样。 以下两行代码,其中wrsWebRowSet对象,删除第三行。
      wrs.absolute(3);
         wrs.deleteRow(); 
    XML描述显示第三行标记为deleteRow ,这消除了WebRowSet对象中的第三行。
       <data> <currentRow> <columnValue> firstrow </columnValue> <columnValue> 1 </columnValue> </currentRow> <currentRow> <columnValue> secondrow </columnValue> <columnValue> 2 </columnValue> </currentRow> <deleteRow> <columnValue> thirdrow </columnValue> <columnValue> 3 </columnValue> </deleteRow> <currentRow> <columnValue> fourthrow </columnValue> <columnValue> 4 </columnValue> </currentRow> </data>  

    2.3状态3 - 插入一行

    WebRowSet对象可以通过移动到插入行来插入新行,为行中的每个列调用适当的更新程序方法,然后调用方法insertRow
       wrs.moveToInsertRow(); wrs.updateString(1, "fifththrow"); wrs.updateString(2, "5"); wrs.insertRow();  
    以下代码片段更改刚刚插入的行中的第二列值。 请注意,当在当前行之后插入新行时,此代码适用,这就是方法next将光标移动到正确行的原因。 调用方法acceptChanges将更改写入数据源。
      wrs.moveToCurrentRow(); wrs.next(); wrs.updateString(2, "V"); wrs.acceptChanges();  
    用XML描述这一点演示了Java代码在何处插入新行,然后对单个字段上新插入的行执行更新。
       <data> <currentRow> <columnValue> firstrow </columnValue> <columnValue> 1 </columnValue> </currentRow> <currentRow> <columnValue> secondrow </columnValue> <columnValue> 2 </columnValue> </currentRow> <currentRow> <columnValue> newthirdrow </columnValue> <columnValue> III </columnValue> </currentRow> <insertRow> <columnValue> fifthrow </columnValue> <columnValue> 5 </columnValue> <updateValue> V </updateValue> </insertRow> <currentRow> <columnValue> fourthrow </columnValue> <columnValue> 4 </columnValue> </currentRow> </date>  

    2.4国家4 - 修改一行

    修改行会生成特定的XML,该XML记录新值和替换的值。 替换的值将成为原始值,新值将成为当前值。 以下代码将光标移动到特定行,执行一些修改,并在完成时更新行。
       wrs.absolute(5); wrs.updateString(1, "new4thRow"); wrs.updateString(2, "IV"); wrs.updateRow();  
    在XML中,这由modifyRow标记描述。 原始行和新值都包含在标记中,用于原始行跟踪目的。
       <data> <currentRow> <columnValue> firstrow </columnValue> <columnValue> 1 </columnValue> </currentRow> <currentRow> <columnValue> secondrow </columnValue> <columnValue> 2 </columnValue> </currentRow> <currentRow> <columnValue> newthirdrow </columnValue> <columnValue> III </columnValue> </currentRow> <currentRow> <columnValue> fifthrow </columnValue> <columnValue> 5 </columnValue> </currentRow> <modifyRow> <columnValue> fourthrow </columnValue> <updateValue> new4thRow </updateValue> <columnValue> 4 </columnValue> <updateValue> IV </updateValue> </modifyRow> </data>  
    从以下版本开始:
    1.5
    另请参见:
    JdbcRowSetCachedRowSetFilteredRowSetJoinRowSet
    • 字段详细信息

      • PUBLIC_XML_SCHEMA

        static final String PUBLIC_XML_SCHEMA
        XML Schema定义的公共标识符,用于定义 WebRowSet实现的XML标记及其有效值。
        另请参见:
        常数字段值
      • SCHEMA_SYSTEM_ID

        static final String SCHEMA_SYSTEM_ID
        XML Schema定义文件的URL,用于定义 WebRowSet实现的XML标记及其有效值。
        另请参见:
        常数字段值
    • 方法详细信息

      • readXml

        void readXml​(Reader reader)
              throws SQLException
        读取 WebRowSet在从给定的XML格式对象 Reader对象。
        参数
        reader - 将从中填充此 WebRowSet对象的 java.io.Reader
        异常
        SQLException - 如果发生数据库访问错误
      • readXml

        void readXml​(InputStream iStream)
              throws SQLException,
                     IOException
        读取基于流的XML输入以填充此 WebRowSet对象。
        参数
        iStream -所述 java.io.InputStream从中此 WebRowSet对象将被填充
        异常
        SQLException - 如果发生数据源访问错误
        IOException - 如果发生IO异常
      • writeXml

        void writeXml​(ResultSet rs,
                      Writer writer)
               throws SQLException
        使用给定ResultSet对象的内容填充此WebRowSet对象,并将其数据,属性和元数据以XML格式写入给定的Writer对象。

        注意:可以移动WebRowSet游标以将内容写出到XML数据源。 如果以这种方式实现,则必须将光标返回到writeXml()调用之前的位置。

        参数
        rs -该 ResultSet对象与填充此 WebRowSet对象
        writer - 要写入的 java.io.Writer对象。
        异常
        SQLException - 如果以XML格式写出行集内容时发生错误
      • writeXml

        void writeXml​(ResultSet rs,
                      OutputStream oStream)
               throws SQLException,
                      IOException
        使用给定ResultSet对象的内容填充此WebRowSet对象,并将其数据,属性和元数据以XML格式写入给定的OutputStream对象。

        注意:可以移动WebRowSet游标以将内容写出到XML数据源。 如果以这种方式实现,则必须将光标返回到writeXml()调用之前的位置。

        参数
        rs -该 ResultSet对象与填充此 WebRowSet对象
        oStream - 要写入的 java.io.OutputStream
        异常
        SQLException - 如果发生数据源访问错误
        IOException - 如果发生IO异常
      • writeXml

        void writeXml​(Writer writer)
               throws SQLException
        将此 WebRowSet对象的数据,属性和元数据以XML格式写入给定的 Writer对象。
        参数
        writer - 要写入的 java.io.Writer
        异常
        SQLException - 如果在将行集内容写出到XML时发生错误
      • writeXml

        void writeXml​(OutputStream oStream)
               throws SQLException,
                      IOException
        将此 WebRowSet对象的数据,属性和元数据以XML格式写入给定的 OutputStream对象。
        参数
        oStream - 要写入的 java.io.OutputStream
        异常
        SQLException - 如果发生数据源访问错误
        IOException - 如果发生IO异常