Интерфейс 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 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-схему для описания операций обновления, вставки и удаления, а также для описания состояния объекта 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>