Интерфейс WebRowSet

public interface WebRowSet
extends CachedRowSet

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

1.0 Обзор

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

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

• http://java.sun.com/xml/ns/jdbc/webrowset.xsd

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

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

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

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

2.0 Состояния WebRowSet

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

2.1 Вывод объекта WebRowSet в XML

В этом примере создается и заполняется объект WebRowSet простой таблицей 2 столбца x 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 Удаление строки

Удаление строки в объекте 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 Вставка строки

Объект 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 Изменение строки

Изменение строки порождает конкретный 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>