Интерфейс WebRowSet

public interface WebRowSet extends CachedRowSet

Стандартный интерфейс, который должны реализовывать все реализации WebRowSet.

1.0 Обзор

WebRowSetImpl предоставляет стандартную эталонную реализацию, которую при необходимости можно расширить.

Стандартное определение XML Schema для WebRowSet доступно по следующему URI:

• http://xmlns.jcp.org/xml/ns//jdbc/webrowset.xsd

Оно описывает стандартный формат XML-документа, необходимый для представления объекта RowSet в XML, и должно использоваться всеми стандартными реализациями интерфейса WebRowSet для обеспечения совместимости. Кроме того, схема WebRowSet использует специальные аннотации SQL/XML Schema, обеспечивая тем самым более широкую кроссплатформенную совместимость. В настоящее время эта работа ведется в организации ISO. Определение SQL/XML доступно по следующему URI:

• http://standards.iso.org/iso/9075/2002/12/sqlxml.xsd

Определение схемы описывает внутренние данные объекта RowSet в трех отдельных разделах:

• свойства — эти свойства описывают стандартные свойства поставщика синхронизации, а также более общие свойства RowSet.
• метаданные — здесь описываются метаданные, связанные с табличной структурой, которой управляет объект WebRowSet. Описанные метаданные тесно связаны с метаданными, доступными через базовый интерфейс java.sql.ResultSet.
• данные — здесь описываются исходные данные (состояние данных после последнего заполнения или последней синхронизации объекта WebRowSet) и текущие данные. Отслеживая различия между исходными и текущими данными, объект WebRowSet сохраняет возможность синхронизировать изменения данных с исходным источником данных.

2.0 Состояния WebRowSet

В следующих разделах показано, как реализация WebRowSet должна использовать XML Schema для описания операций обновления, вставки и удаления, а также для описания состояния объекта WebRowSet в XML.

2.1 Состояние 1 — вывод объекта WebRowSet в XML

В этом примере создается объект WebRowSet и заполняется простой таблицей из 2 столбцов и 5 строк из источника данных. Наличие 5 строк в объекте WebRowSet позволяет описать их в XML. Метаданные, описывающие различные стандартные свойства JavaBeans, определенные в интерфейсе RowSet, а также стандартные свойства, определенные в интерфейсе CachedRowSet, содержат важные сведения о свойствах WebRowSet. Вывод объекта WebRowSet в XML с использованием стандартных методов writeXml описывает внутренние свойства следующим образом:

 
 <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>
 

После подробного описания представления свойств и метаданных далее объясняется, как содержимое объекта WebRowSet описывается в XML. Обратите внимание, что здесь описан объект WebRowSet, который не изменялся с момента создания. Тег currentRow соответствует каждой строке табличной структуры, предоставляемой объектом WebRowSet. Тег columnValue может содержать тег stringData или binaryData в зависимости от типа SQL, которому соответствует значение XML. Тег binaryData содержит данные в кодировке Base64 и обычно используется для данных типов BLOB и CLOB.

 
 <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. Следующие две строки кода удаляют третью строку; здесь wrs — объект WebRowSet.

     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-структура, в которой записываются и новое значение, и замененное им значение. Замененное значение становится исходным, а новое значение — текущим. Следующий код перемещает курсор к определенной строке, выполняет несколько изменений и после этого обновляет строку.

 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>