Интерфейс CachedRowSet

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

Реализация по умолчанию интерфейса CachedRowSet, предоставляемая компанией Oracle Corporation, является стандартной реализацией. Разработчики могут использовать эту реализацию как есть, расширить ее или написать собственные реализации этого интерфейса.

Объект CachedRowSet — это контейнер для строк данных, который кэширует свои строки в памяти, что позволяет работать без постоянного подключения к источнику данных. Кроме того, это компонент JavaBeans™ и обладает возможностями прокрутки, обновления и сериализации. Объект CachedRowSet обычно содержит строки из набора результатов, но также может содержать строки из любого файла с табличной структурой, например, электронную таблицу. Реализация по умолчанию поддерживает получение данных только из объекта ResultSet, но разработчики могут расширить реализации SyncProvider для предоставления доступа к другим источникам табличных данных.

Приложение может изменять данные в объекте CachedRowSet, и эти изменения могут быть затем переданы обратно в источник данных.

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

1.0 Создание объекта CachedRowSet

CachedRowSetImpl crs = new CachedRowSetImpl();

Объект SyncProvider предоставляет объекту CachedRowSet чтец (объект RowSetReader) для чтения данных из источника данных, чтобы заполнить себя данными. Чтец может быть реализован для чтения данных из объекта ResultSet или из файла с табличной структурой. Объект SyncProvider также предоставляет писатель (объект RowSetWriter) для синхронизации любых изменений в данных объекта CachedRowSet, внесенных во время отключения, с данными в базовом источнике данных.

Писатель может быть реализован для выполнения различных степеней проверки на конфликты и их предотвращения. (Конфликт возникает, когда значение в источнике данных было изменено после того, как набор строк заполнил себя этим значением.) Реализация RIOptimisticProvider предполагает, что конфликтов будет мало или вообще не будет, и поэтому не устанавливает блокировки. Он обновляет источник данных значениями из объекта CachedRowSet только в том случае, если конфликтов нет. Другие писатели могут быть реализованы таким образом, чтобы они всегда записывали изменённые данные в источник данных, что может быть достигнуто либо путём отсутствия проверки конфликтов, либо, с другой стороны, путём установки блокировок, достаточных для предотвращения изменения данных в источнике данных. Другие реализации писателей могут быть где-то посередине.

Объект CachedRowSet может использовать любую реализацию SyncProvider, которая была зарегистрирована в синглтоне SyncFactory. Приложение может узнать, какие реализации SyncProvider были зарегистрированы, вызвав следующую строку кода.

java.util.Enumeration providers = SyncFactory.getRegisteredProviders();

Существует два способа, которыми объект CachedRowSet может указать, какой объект SyncProvider он будет использовать.

• Указание имени реализации в конструктор
  Следующая строка кода создаёт объект CachedRowSet crs2, который инициализируется значениями по умолчанию, за исключением того, что его объект SyncProvider является указанным.

  CachedRowSetImpl crs2 = new CachedRowSetImpl(
                                   "com.fred.providers.HighAvailabilityProvider");

• Установка объекта SyncProvider с помощью метода CachedRowSet setSyncProvider
  Следующая строка кода сбрасывает объект SyncProvider для объекта crs, созданного с конструктором по умолчанию.

  crs.setSyncProvider("com.fred.providers.HighAvailabilityProvider");

2.0 Получение данных из объекта CachedRowSet

while (crs.next()) {
        String name = crs.getString(1);
        int id = crs.getInt(2);
        Clob comment = crs.getClob(3);
        short dept = crs.getShort(4);
        System.out.println(name + "  " + id + "  " + comment + "  " + dept);
    }

while (crs.next()) {
        String name = crs.getString("NAME");
        int id = crs.getInt("ID");
        Clob comment = crs.getClob("COM");
        short dept = crs.getShort("DEPT");
        System.out.println(name + "  " + id + "  " + comment + "  " + dept);
    }

2.1 Получение RowSetMetaData

RowSetMetaData rsmd = (RowSetMetaData)crs.getMetaData();
     int count = rsmd.getColumnCount();
     int type = rsmd.getColumnType(2);

• Он включает методы setter: Объект RowSet использует эти методы внутри, когда он заполняется данными из другого объекта ResultSet.
• Он содержит меньше методов getter: Некоторые методы ResultSetMetaData не применяются к объекту RowSet. Например, методы получения информации о том, является ли значение столбца изменяемым или только для чтения, не применяются, потому что все столбцы объекта RowSet будут изменяемыми или только для чтения, в зависимости от того, обновляемый ли набор строк.

3.0 Обновление объекта CachedRowSet

crs.updateShort(3, 58);
     crs.updateInt(4, 150000);
     crs.updateRow();
     crs.acceptChanges();

Следующий пример демонстрирует перемещение к строке вставки, создание новой строки в строке вставки, её вставку в набор строк и затем вызов метода acceptChanges для добавления новой строки в базовый источник данных. Обратите внимание, что, как и в случае с методами-получателями, методы-обновлятели могут принимать либо индекс столбца, либо имя столбца для обозначения обрабатываемого столбца.

crs.moveToInsertRow();
     crs.updateString("Name", "Shakespeare");
     crs.updateInt("ID", 10098347);
     crs.updateShort("Age", 58);
     crs.updateInt("Sal", 150000);
     crs.insertRow();
     crs.moveToCurrentRow();
     crs.acceptChanges();

ПРИМЕЧАНИЕ: То, куда метод insertRow() вставляет содержимое строки вставки объекта CachedRowSet, определяется реализацией. Реализация по умолчанию для интерфейса CachedRowSet вставляет новую строку сразу после текущей, но она может быть реализована для вставки новых строк в любое количество других мест.

Ещё одна вещь, которую стоит отметить в этих примерах, — это то, как они используют метод acceptChanges. Именно этот метод распространяет изменения в объекте CachedRowSet обратно в базовый источник данных, вызывая внутренний метод писателя объекта RowSet для записи изменений в источник данных. Для этого писателю необходимо потратить время на установление соединения с этим источником данных. В предыдущих двух фрагментах кода метод acceptChanges вызывается сразу после вызова updateRow или insertRow. Однако, когда меняется несколько строк, более эффективно вызвать acceptChanges после всех вызовов updateRow и insertRow. Если acceptChanges вызывается только один раз, устанавливать соединение нужно только один раз.

4.0 Обновление базового источника данных

Писатель доступен через реализацию интерфейса SyncProvider, как описано в разделе 1, "Создание объекта CachedRowSet". Поставщик реализации по умолчанию RIOptimisticProvider реализовал своего писателя для использования механизма оптимистического управления конкурентностью. То есть он не поддерживает блокировки в базе данных во время отключения набора строк от базы данных и просто проверяет наличие конфликтов перед записью данных в источник данных. Если конфликты есть, он ничего не записывает в источник данных.

Утилита чтение/запись, предоставляемая классом SyncProvider, является подключаемой, что позволяет настраивать извлечение и обновление данных. Если требуется другой механизм управления конкурентностью, можно подключить другую реализацию SyncProvider с помощью метода setSyncProvider.

Для использования процедуры оптимистического управления конкурентностью, объект RIOptismisticProvider сохраняет как своё текущее значение, так и своё исходное значение (значение, которое имело место непосредственно перед текущим значением). Обратите внимание, что если изменения данных в объекте RowSet не вносились, текущие значения и исходные значения совпадают, оба являются значениями, с которыми объект RowSet был первоначально заполнен. Однако, как только любые значения в объекте RowSet были изменены, текущие значения и исходные значения будут отличаться, хотя на данном этапе исходные значения всё ещё являются начальными значениями. При последующих изменениях данных в объекте RowSet, его исходные значения и текущие значения будут по-прежнему отличаться, но исходные значения будут значениями, которые ранее были текущими значениями.

Отслеживание исходных значений позволяет автору сравнить исходное значение объекта RowSet со значением в базе данных. Если значения в базе данных отличаются от исходных значений объекта RowSet, что означает, что значения в базе данных были изменены, возникает конфликт. Проверка конфликтов, степень этой проверки и способ обработки конфликтов зависят от реализации.

5.0 Регистрация и уведомление слушателей

crs.addRowSetListener(table);
    crs.addRowSetListener(barGraph);

6.0 Передача данных тонким клиентам

Пока объект CachedRowSet отключён, он может быть намного меньше, чем объект ResultSet с теми же данными. В результате он может быть особенно подходящим для отправки данных тонкому клиенту, такому как КПК, где использование драйвера JDBC было бы неуместным из-за ограничений ресурсов или соображений безопасности. Таким образом, объект CachedRowSet предоставляет способ "получить строки" без необходимости реализации полного API JDBC.

7.0 Прокрутка и обновление

ResultSet rs = stmt.executeQuery("SELECT * FROM EMPLOYEES");
    CachedRowSetImpl crs = new CachedRowSetImpl();
    crs.populate(rs);

Объект crs теперь содержит данные из таблицы EMPLOYEES, так же, как и объект rs. Разница заключается в том, что указатель для crs можно перемещать вперед, назад или к определённой строке, даже если указатель для rs может перемещаться только вперед. Кроме того, crs обновляемый, даже если rs нет, потому что по умолчанию объект CachedRowSet является как прокручиваемым, так и обновляемым.

Вкратце, объект CachedRowSet можно рассматривать как просто отключенный набор строк, кэшируемых вне источника данных. Он тонкий и сериализуемый, поэтому его легко отправлять по сети, и он хорошо подходит для отправки данных тонкому клиенту. Однако объект CachedRowSet имеет ограничение: его размер ограничен объёмом данных, которые он может хранить в памяти одновременно.

8.0 Получение универсального доступа к данным

9.0 Установка свойств

ПРИМЕЧАНИЕ: Для использования объекта DataSource для создания подключения, объект DataSource должен быть зарегистрирован в службе именования, использующей API Java Naming and Directory Interface™ (JNDI). Эта регистрация обычно выполняется системным администратором.

Для того, чтобы набор строк смог заполниться данными из базы данных, ему нужно установить свойство команды. Это свойство — запрос, который является объектом PreparedStatement, что позволяет запросу иметь параметры-заменители, устанавливаемые во время выполнения, а не на этапе проектирования. Для установки этих параметров-заменителей со значениями, набор строк предоставляет методы установщика для установки значений каждого типа данных, аналогично методам установщика, предоставленным интерфейсом PreparedStatement.

Следующий фрагмент кода демонстрирует, как установить свойство команды для объекта CachedRowSet crs. Обратите внимание, что при использовании инструмента для установки свойств, именно этот код будет использоваться инструментом.

crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS " +
                   "WHERE CREDIT_LIMIT > ? AND REGION = ?");

Значения, которые будут использоваться для установки параметров-заменителей команды, содержатся в поле RowSet объекта params, которое является объектом Vector. Класс CachedRowSet предоставляет набор методов установщика для установки элементов в поле params. Следующий фрагмент кода демонстрирует установку двух параметров в запросе из предыдущего примера.

crs.setInt(1, 5000);
    crs.setString(2, "West");

Поле params теперь содержит два элемента, каждый из которых является массивом из двух элементов. Первый элемент — номер параметра, второй — значение, которое нужно установить. В этом случае первый элемент params равен 1, 5000, а второй — 2, "West". Когда приложение вызывает метод execute, оно, в свою очередь, обратится к чтецу этого объекта RowSet, который, в свою очередь, вызовет метод readData. В рамках своей реализации readData получит значения в params и использует их для установки параметров-заменителей команды. Следующий фрагмент кода дает представление о том, как это делает чтец после получения объекта Connection con.

PreparedStatement pstmt = con.prepareStatement(crs.getCommand());
    reader.decodeParams();
    // decodeParams figures out which setter methods to use and does something
    // like the following:
    //    for (i = 0; i < params.length; i++) {
    //        pstmt.setObject(i + 1, params[i]);
    //    }

На этом этапе команда для crs — это запрос "SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS WHERE CREDIT_LIMIT > 5000 AND REGION = "West". После выполнения методом readData этой команды с помощью следующей строки кода, он получит данные из rs для заполнения crs.

ResultSet rs = pstmt.executeQuery();

Представленные фрагменты кода дают представление о том, что происходит за кулисами; они не будут появляться в приложении, которое не будет вызывать методы, такие как readData и decodeParams. Напротив, следующий фрагмент кода демонстрирует, что может делать приложение. Он устанавливает команду набора строк, устанавливает параметры команды и выполняет команду. Простым вызовом метода execute, объект crs заполнится запрошенными данными из таблицы CUSTOMERS.

crs.setCommand("SELECT FIRST_NAME, LAST_NAME, ADDRESS FROM CUSTOMERS" +
                   "WHERE CREDIT_LIMIT > ? AND REGION = ?");
    crs.setInt(1, 5000);
    crs.setString(2, "West");
    crs.execute();

10.0 Выборка данных по страницам

После установки свойств, объект CachedRowSet должен быть заполнен данными с использованием метода populate или метода execute. Следующие строки кода демонстрируют использование метода populate. Обратите внимание, что этот вариант метода принимает два параметра, дескриптор ResultSet и строку в объекте ResultSet с которой начать извлечение строк.

CachedRowSet crs = new CachedRowSetImpl();
     crs.setMaxRows(20);
     crs.setPageSize(4);
     crs.populate(rsHandle, 10);

Следующий фрагмент кода демонстрирует заполнение объекта CachedRowSet с помощью метода execute, который может или не может принимать объект Connection в качестве параметра. В этом коде передаётся объекту execute объект conHandle.

Обратите внимание, что между этим фрагментом кода и предыдущим есть две разницы. Во-первых, метод setMaxRows не вызывается, поэтому нет предела для количества строк, которые может содержать crs. (Помните, что crs всегда имеет ограничение, определяемое размером памяти, который он может использовать.) Вторая разница заключается в том, что методу execute нельзя передать номер строки в объекте ResultSet, с которой начать извлечение строк. Этот метод всегда начинает с первой строки.

CachedRowSet crs = new CachedRowSetImpl();
     crs.setPageSize(5);
     crs.execute(conHandle);

Для доступа к следующей странице (фрагменту данных) приложение вызывает метод nextPage. Этот метод создаёт новый объект CachedRowSet и заполняет его следующей частью данных. Например, предположим, что команда объекта CachedRowSet возвращает объект ResultSet rs с 1000 строками данных. Если размер страницы задан как 100, первый вызов метода nextPage создаст объект CachedRowSet содержащий первые 100 строк из rs. После обработки данных первых 100 строк, приложение может снова вызвать метод nextPage для создания другого объекта CachedRowSet со вторыми 100 строками из rs. Данные из первого объекта CachedRowSet больше не будут находиться в памяти, так как они замещаются данными из второго объекта CachedRowSet. После десятого вызова метода nextPage десятый объект CachedRowSet будет содержать последние 100 строк данных из rs, которые хранятся в памяти. В любой момент времени данные только одного объекта CachedRowSet хранятся в памяти.

Метод nextPage возвращает true, пока текущая страница не является последней страницей строк, и false, когда больше нет страниц. Таким образом, он может использоваться в цикле while для получения всех страниц, как показано в следующих строках кода.

CachedRowSet crs = CachedRowSetImpl();
     crs.setPageSize(100);
     crs.execute(conHandle);

     while(crs.nextPage()) {
         while(crs.next()) {
             . . . // operate on chunks (of 100 rows each) in crs,
                   // row by row
         }
     }

Интерфейс CachedRowSet также определяет метод previousPage. Так же, как метод nextPage аналогичен методу ResultSet next, метод previousPage аналогичен методу ResultSet previous. Подобно методу nextPage, previousPage создаёт объект CachedRowSet, содержащий количество строк, заданное как размер страницы. Например, метод previousPage может использоваться в цикле while в конце предыдущего фрагмента кода для навигации назад по страницам от последней к первой. Метод previousPage также похож на nextPage, и он может быть использован в цикле while, за исключением того, что он возвращает true, пока существует предыдущая страница, и false, если нет больше предшествующих страниц.

Позиционируя курсор после последней строки каждой страницы, как это делается в следующем фрагменте кода, метод previous перемещается от последней строки к первой строке на каждой странице. Код также мог оставить курсор перед первой строкой на каждой странице и затем использовать метод next в цикле while для навигации по каждой странице от первой строки к последней строке.

Следующий фрагмент кода предполагает продолжение от предыдущего фрагмента, что означает, что курсор десятого объекта CachedRowSet находится на последней строке. Код перемещает курсор после последней строки, чтобы первый вызов метода previous поместил курсор обратно на последнюю строку. После прохождения всех строк на последней странице (объект CachedRowSet crs) код затем входит в цикл while для перехода к девятой странице, прохода по строкам в обратном порядке, перехода к восьмой странице, прохода по строкам в обратном порядке и так далее до первой строки первой страницы.

crs.afterLast();
     while(crs.previous())  {
         . . . // navigate through the rows, last to first
     {
     while(crs.previousPage())  {
         crs.afterLast();
         while(crs.previous())  {
             . . . // go from the last row to the first row of each page
         }
     }

Поля

COMMIT_ON_ACCEPT_CHANGES

@Deprecated
static final boolean COMMIT_ON_ACCEPT_CHANGES

Устаревшее. Поскольку это поле является final (оно является частью интерфейса), его значение изменить нельзя.

Вызывает, чтобы объект CachedRowSet выполнил коммит изменений при вызове метода acceptChanges(). Если установлено в false, изменения не будут сохранены до вызова одного из методов транзакции интерфейса CachedRowSet.

См. также:

commit(), rollback(), Значения константных полей

Методы

populate

void populate(ResultSet data)
       throws SQLException

Параметры:

data - объект ResultSet, содержащий данные, которые необходимо считать в этот объект CachedRowSet

Исключения:

SQLException - если предоставлен нулевой объект ResultSet или этот объект CachedRowSet не может получить связанный объект ResultSetMetaData

См. также:

execute(java.sql.Connection), ResultSet, ResultSetMetaData

execute

void execute(Connection conn)
      throws SQLException

Параметры:

conn - стандартный объект JDBC Connection с допустимыми свойствами

Исключения:

SQLException - если предоставлен недопустимый объект Connection или произошла ошибка при установлении соединения с источником данных

См. также:

populate(java.sql.ResultSet), Connection

acceptChanges

void acceptChanges()
            throws SyncProviderException

Исключения:

SyncProviderException - если записыватель базового поставщика синхронизации не может записать обновления обратно в источник данных

См. также:

acceptChanges(java.sql.Connection), RowSetWriter, SyncFactory, SyncProvider, SyncProviderException, SyncResolver

acceptChanges

void acceptChanges(Connection con)
            throws SyncProviderException

Параметры:

con - стандартный объект JDBC Connection

Исключения:

SyncProviderException - если записыватель базового поставщика синхронизации не может записать обновления обратно в источник данных

См. также:

acceptChanges(), RowSetWriter, SyncFactory, SyncProvider, SyncProviderException, SyncResolver

restoreOriginal

void restoreOriginal()
              throws SQLException

Исключения:

SQLException - если произошла ошибка при откате текущего значения этого объекта CachedRowSet к его предыдущему значению

См. также:

RowSetListener.rowSetChanged(javax.sql.RowSetEvent)

release

void release()
      throws SQLException

Возбуждает:

SQLException - если произошла ошибка при сбросе содержимого этого объекта CachedRowSet

См. также:

RowSetListener.rowSetChanged(javax.sql.RowSetEvent), ResultSet.close()

undoDelete

void undoDelete()
         throws SQLException

Возбуждает:

SQLException - если (1) текущая строка не была удалена или (2) курсор находится в строке вставки, перед первой строкой или после последней строки

См. также:

undoInsert(), ResultSet.cancelRowUpdates()

undoInsert

void undoInsert()
         throws SQLException

Возбуждает:

SQLException - если (1) текущая строка не была вставлена или (2) курсор находится перед первой строкой, после последней строки или в строке вставки

См. также:

undoDelete(), ResultSet.cancelRowUpdates()

undoUpdate

void undoUpdate()
         throws SQLException

Возбуждает:

SQLException - если курсор находится перед первой строкой или после последней строки в этом объекте CachedRowSet

См. также:

undoDelete(), undoInsert(), ResultSet.cancelRowUpdates()

columnUpdated

boolean columnUpdated(int idx)
               throws SQLException

Указывает, был ли обновлен указанный столбец в текущей строке этого объекта CachedRowSet.

Параметры:

idx - идентификатор столбца, подлежащий проверке на наличие обновлений

Возвращает:

true если указанный столбец был явно обновлен; false в противном случае

Возбуждает:

SQLException - если курсор находится в строке вставки, перед первой строкой или после последней строки

См. также:

DatabaseMetaData.updatesAreDetected(int)

columnUpdated

boolean columnUpdated(String columnName)
               throws SQLException

Указывает, был ли обновлен указанный столбец в текущей строке этого объекта CachedRowSet.

Параметры:

columnName - объект, содержащий имя столбца, подлежащий проверке на наличие обновлений

Возвращает:

true если столбец был явно обновлен; false в противном случае

Возбуждает:

SQLException - если курсор находится в строке вставки, перед первой строкой или после последней строки

См. также:

DatabaseMetaData.updatesAreDetected(int)

toCollection

Collection<?> toCollection()
                    throws SQLException

Возвращает:

объект Collection, содержащий значения в каждой строке в этом объекте CachedRowSet

Возбуждает:

SQLException - если произошла ошибка при создании коллекции

См. также:

toCollection(int), toCollection(String)

toCollection

Collection<?> toCollection(int column)
                    throws SQLException

Параметры:

column - целое число, обозначающее столбец, чьи значения должны быть представлены в объекте Collection

Возвращает:

объект Collection, содержащий значения, хранящиеся в указанном столбце этого объекта CachedRowSet

Возбуждает:

SQLException - если при создании коллекции произошла ошибка или был предоставлен недопустимый идентификатор столбца

См. также:

toCollection(), toCollection(String)

toCollection

Collection<?> toCollection(String column)
                    throws SQLException

Параметры:

column - объект, содержащий имя столбца, чьи значения должны быть представлены в коллекции

Возвращает:

объект Collection, содержащий значения, хранящиеся в указанном столбце этого объекта CachedRowSet

Возбуждает:

SQLException - если при создании коллекции произошла ошибка или был предоставлен недопустимый идентификатор столбца

См. также:

toCollection(), toCollection(int)

getSyncProvider

SyncProvider getSyncProvider()
                      throws SQLException

RowSetReader rowsetReader = null;
     SyncProvider provider =
         SyncFactory.getInstance("javax.sql.rowset.provider.RIOptimisticProvider");
         if (provider instanceof RIOptimisticProvider) {
             rowsetReader = provider.getRowSetReader();
         }

rowsetReader.readData((RowSetInternal)this);

Возвращает:

объект SyncProvider, который был установлен при создании набора строк, или, если он не был установлен, — поставщик по умолчанию

Выбрасывает:

SQLException - если при возвращении объекта SyncProvider произошла ошибка

См. также:

setSyncProvider(java.lang.String)

setSyncProvider

void setSyncProvider(String provider)
              throws SQLException

Параметры:

provider - объект String, содержащий полное квалифицированное имя реализации SyncProvider

Выбрасывает:

SQLException - если при попытке сбросить реализацию SyncProvider произошла ошибка

См. также:

getSyncProvider()

size

int size()

Возвращает количество строк в этом объекте CachedRowSet.

Возвращает:

количество строк в наборе строк

setMetaData

void setMetaData(RowSetMetaData md)
          throws SQLException

Устанавливает метаданные для этого объекта CachedRowSet с помощью данного объекта RowSetMetaData. Когда объект RowSetReader читает содержимое набора строк, он создает объект RowSetMetaData и инициализирует его с помощью методов реализации RowSetMetaData. Реализация использует класс RowSetMetaDataImpl. Когда чтение содержимого набора строк завершено, этот метод вызывается для передачи объекта RowSetMetaData в набор строк.

Параметры:

md - объект RowSetMetaData, содержащий метаданные о столбцах в этом объекте CachedRowSet.

Выбрасывает:

SQLException - если в набор строк переданы некорректные метаданные

getOriginal

ResultSet getOriginal()
               throws SQLException

Возвращает:

объект ResultSet, содержащий исходное значение для этого объекта CachedRowSet

Выбрасывает:

SQLException - если при создании объекта ResultSet произошла ошибка

getOriginalRow

ResultSet getOriginalRow()
                  throws SQLException

Возвращает:

исходный набор результатов строки

Выбрасывает:

SQLException - если текущей строки нет

См. также:

setOriginalRow()

setOriginalRow

void setOriginalRow()
             throws SQLException

Выбрасывает:

SQLException - если текущей строки нет или при сбросе содержимого исходной строки произошла ошибка

См. также:

getOriginalRow()

getTableName

String getTableName()
             throws SQLException

Возвращает идентификатор объекта (таблицы), который использовался для создания этого объекта CachedRowSet. Это имя может быть установлено несколько раз, и спецификация не накладывает ограничений на то, сколько раз это может произойти или должны ли стандартные реализации отслеживать предыдущие имена таблиц.

Возвращает:

объект String, содержащий имя таблицы, являющейся источником данных для этого объекта CachedRowSet, или null, если для таблицы не было установлено имени

Выбрасывает:

SQLException - если при возвращении имени таблицы произошла ошибка

См. также:

ResultSetMetaData.getTableName(int)

setTableName

void setTableName(String tabName)
           throws SQLException

Параметры:

tabName - объект String, идентифицирующий таблицу, из которой был получен этот объект CachedRowSet; не может быть null, но может быть пустой строкой

Выбрасывает:

SQLException - если при присвоении имени таблице произошла ошибка или tabName — null

См. также:

RowSetMetaData.setTableName(int, java.lang.String), RowSetWriter, SyncProvider

getKeyColumns

int[] getKeyColumns()
             throws SQLException

Возвращает массив, содержащий один или несколько номеров столбцов, указывающих на столбцы, образующие ключ, который однозначно идентифицирует строку в этом объекте CachedRowSet.

Возвращает:

массив, содержащий номер или номера столбцов, указывающие на то, какие столбцы составляют первичный ключ для строки в этом объекте CachedRowSet. Этот массив должен быть пустым, если столбцы не представляют первичный ключ.

Выбрасывает:

SQLException - если этот объект CachedRowSet пуст

См. также:

setKeyColumns(int[]), Joinable.getMatchColumnIndexes(), Joinable.getMatchColumnNames()

setKeyColumns

void setKeyColumns(int[] keys)
            throws SQLException

Параметры:

keys - массив int, указывающий на столбцы, которые образуют первичный ключ для этого объекта CachedRowSet; каждый элемент массива должен быть больше 0 и меньше или равен количеству столбцов в этом наборе строк

Выбрасывает:

SQLException - если какие-либо из чисел в заданном массиве не являются допустимыми для этого набора строк

См. также:

getKeyColumns(), Joinable.setMatchColumn(String), Joinable.setMatchColumn(int)

createShared

RowSet createShared()
             throws SQLException

Возвращает:

новый общий объект RowSet , имеющий те же свойства, что и этот объект CachedRowSet , и имеющий указатель на те же данные

Выбрасывает:

SQLException - если произошла ошибка или клонирование не поддерживается в базовой платформе

См. также:

RowSetEvent, RowSetListener

createCopy

CachedRowSet createCopy()
                 throws SQLException

Создаёт объект RowSet , представляющий собой глубокую копию данных в этом объекте CachedRowSet. В отличие от объекта RowSet , созданного вызовом createShared , обновления, внесённые в копию исходного объекта RowSet , не должны быть видны исходному объекту RowSet. Кроме того, любые слушатели событий, зарегистрированные с исходным объектом RowSet , не должны иметь область действия над новыми копиями RowSet. Кроме того, должны сохраняться любые ограничения, установленные ограничениями.

Возвращает:

новый объект RowSet , который является глубокой копией этого объекта CachedRowSet и полностью независим от этого объекта CachedRowSet

Выбрасывает:

SQLException - если при создании копии этого объекта CachedRowSet произошла ошибка

См. также:

createShared(), createCopySchema(), createCopyNoConstraints(), RowSetEvent, RowSetListener

createCopySchema

CachedRowSet createCopySchema()
                       throws SQLException

Возвращает:

пустую копию этого объекта CachedRowSet

Выбрасывает:

SQLException - если произошла ошибка при клонировании структуры этого объекта CachedRowSet

См. также:

createShared(), createCopySchema(), createCopyNoConstraints(), RowSetEvent, RowSetListener

createCopyNoConstraints

CachedRowSet createCopyNoConstraints()
                              throws SQLException

Создаёт объект CachedRowSet , представляющий собой глубокую копию данных этого объекта CachedRowSet , но независимый от него. В отличие от объекта RowSet , созданного вызовом метода createShared , обновления, внесённые в копию этого объекта CachedRowSet , не должны быть видны для него. Кроме того, любые слушатели событий, зарегистрированные с этим объектом CachedRowSet , не должны иметь область действия над новым объектом RowSet. Кроме того, любые ограничения, установленные для этого объекта CachedRowSet , не должны сохраняться в копии.

Возвращает:

новый объект CachedRowSet , который является глубокой копией этого объекта CachedRowSet и полностью независим от этого объекта CachedRowSet

Выбрасывает:

SQLException - если при создании копии этого объекта CachedRowSet произошла ошибка

См. также:

createCopy(), createShared(), createCopySchema(), RowSetEvent, RowSetListener

getRowSetWarnings

RowSetWarning getRowSetWarnings()
                         throws SQLException

Возвращает первое предупреждение, сообщённое вызовами в этом объекте RowSet. Последующие предупреждения в этом объекте RowSet будут присоединены к объекту RowSetWarning , который возвращает этот метод. Цепочка предупреждений автоматически очищается каждый раз при чтении новой строки. Этот метод не может быть вызван в объекте RowSet, который был закрыт; в противном случае будет брошено исключение SQLException.

Возвращает:

объект RowSetWarning, первое RowSetWarning предупреждение или null, если их нет

Выбрасывает:

SQLException - если этот метод вызван в закрытом RowSet

См. также:

RowSetWarning

getShowDeleted

boolean getShowDeleted()
                throws SQLException

Возвращает:

true , если удалённые строки отображаются; false в противном случае

Выбрасывает:

SQLException - если реализация rowset не может определить, отображаются ли строки, помеченные для удаления

См. также:

setShowDeleted(boolean)

setShowDeleted

void setShowDeleted(boolean b)
             throws SQLException

Параметры:

b - true , если удалённые строки должны отображаться; false в противном случае

Выбрасывает:

SQLException - если реализация rowset не может сбросить отображение удалённых строк

См. также:

getShowDeleted()

commit

void commit()
     throws SQLException

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных или объект Connection в этом объекте CachedRowSet находится в режиме автоматического подтверждения

См. также:

Connection.setAutoCommit(boolean)

rollback

void rollback()
       throws SQLException

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных или объект Connection в этом объекте CachedRowSet находится в режиме автоматического подтверждения.

rollback

void rollback(Savepoint s)
       throws SQLException

Параметры:

s - метка транзакции Savepoint

Выбрасывает:

SQLException - если произошла ошибка доступа к базе данных или объект Connection в этом объекте CachedRowSet находится в режиме автоматического подтверждения.

rowSetPopulated

void rowSetPopulated(RowSetEvent event,
                     int numRows)
              throws SQLException

Параметры:

event - объект RowSetEvent, содержащий объект RowSet, являющийся источником событий

numRows - при заполнении, интервал строк, на котором должно срабатывать заполнение CachedRowSet; значение по умолчанию равно нулю; не может быть меньше fetchSize или нуля

Исключения:

SQLException - numRows < 0 or numRows < getFetchSize()

populate

void populate(ResultSet rs,
              int startRow)
       throws SQLException

Параметры:

startRow - позиция в ResultSet, с которой начинать заполнение записей в этом объекте CachedRowSet

rs - объект ResultSet, содержащий данные для чтения в этот объект CachedRowSet

Исключения:

SQLException - если предоставлен нулевой объект ResultSet или этот объект CachedRowSet не может получить связанный объект ResultSetMetaData

См. также:

execute(java.sql.Connection), populate(ResultSet), ResultSet, ResultSetMetaData

setPageSize

void setPageSize(int size)
          throws SQLException

Устанавливает размер страницы объекта CachedRowSet. Объект CachedRowSet может быть настроен на заполнение себя партиями строк размером страницы. Когда вызываются populate() или execute(), CachedRowSet извлекает дополнительную страницу в соответствии с исходным SQL-запросом, используемым для заполнения набора строк.

Параметры:

size - размер страницы объекта CachedRowSet

Исключения:

SQLException - если при установке размера страницы CachedRowSet произошла ошибка, или размер страницы меньше 0.

getPageSize

int getPageSize()

Возвращает размер страницы для объекта CachedRowSet

Возвращает:

размер страницы int

nextPage

boolean nextPage()
          throws SQLException

Увеличивает текущую страницу CachedRowSet. Это заставляет реализацию CachedRowSet извлечь строки следующей страницы размером страницы и заполнить набор строк, если оставшиеся строки остаются в рамках исходного SQL-запроса, используемого для заполнения набора строк.

Возвращает:

true, если существуют другие страницы; false, если это последняя страница

Исключения:

SQLException - если при извлечении следующей страницы произошла ошибка, или если этот метод вызван преждевременно до populate или execute.

previousPage

boolean previousPage()
              throws SQLException

Уменьшает текущую страницу объекта CachedRowSet. Это заставляет реализацию CachedRowSet извлечь строки предыдущей страницы размером страницы и заполнить набор строк. Количество строк, возвращаемых на предыдущей странице, всегда должно оставаться в рамках исходного SQL-запроса, используемого для заполнения набора строк.

Возвращает:

true, если предыдущая страница успешно извлечена; false, если это первая страница

Исключения:

SQLException - если при извлечении предыдущей страницы произошла ошибка, или если этот метод вызван преждевременно до populate или execute.