Интерфейс WebRowSet

public interface WebRowSet extends CachedRowSet

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

1.0 Обзор

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

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

• http://xmlns.jcp.org/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 в трех разных областях:

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

2.0 Состояния WebRowSet

В следующих разделах показано, как реализация WebRowSet должна использовать XML-схему для описания операций обновления, вставки и удаления и для описания состояния объекта 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>