Интерфейс CachedRowSet

public interface CachedRowSet extends RowSet, Joinable

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

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

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

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

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

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

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

    CachedRowSetImpl crs = new CachedRowSetImpl();

У этого нового объекта CachedRowSet будут заданы свойства по умолчанию объекта BaseRowSet, а также в качестве поставщика синхронизации будет использоваться объект RIOptimisticProvider. RIOptimisticProvider — одна из двух реализаций SyncProvider, включённых в RI, — является поставщиком по умолчанию, который будет предоставлен синглтоном SyncFactory, если поставщик синхронизации не указан.

Объект 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 — объекта CachedRowSet, созданного конструктором по умолчанию.

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

Дополнительные сведения см. в комментариях к SyncFactory и SyncProvider.

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

Данные из объекта CachedRowSet получают с помощью методов получения, унаследованных от интерфейса ResultSet. В следующих примерах, где crs является объектом CachedRowSet, показано, как выполнять перебор строк и получать значения столбцов в каждой строке. В первом примере используется вариант методов получения, принимающий номер столбца; во втором — вариант, принимающий имя столбца. Номера столбцов обычно используются, когда команда объекта RowSet имеет вид SELECT * FROM TABLENAME; имена столбцов чаще всего используются, когда команда задаёт столбцы по именам.

   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

Приложение может получить сведения о столбцах объекта CachedRowSet, вызвав методы ResultSetMetaData и RowSetMetaData для объекта RowSetMetaData. В следующем фрагменте кода, где crs является объектом CachedRowSet, показано, как это сделать. В первой строке создаётся объект RowSetMetaData со сведениями о столбцах объекта crs. Метод getMetaData, унаследованный от интерфейса ResultSet, возвращает объект ResultSetMetaData, который перед присваиванием переменной rsmd приводится к типу объекта RowSetMetaData. Во второй строке определяется количество столбцов в jrs, а в третьей — тип JDBC значений, хранящихся во втором столбце jrs.

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

Интерфейс RowSetMetaData отличается от интерфейса ResultSetMetaData двумя особенностями.

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

ПРИМЕЧАНИЕ. Чтобы возвращать объект RowSetMetaData, реализации должны переопределить метод getMetaData(), определённый в java.sql.ResultSet, и возвращать объект RowSetMetaData.

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

Обновление объекта CachedRowSet похоже на обновление объекта ResultSet, однако, поскольку во время обновления набор строк не подключён к источнику данных, для применения изменений в базовом источнике данных требуется дополнительный шаг. После вызова метода updateRow или insertRow объект CachedRowSet должен также вызвать метод acceptChanges, чтобы записать обновления в источник данных. В следующем примере, где курсор находится на строке объекта CachedRowSet crs, показан код для обновления значений двух столбцов текущей строки и базового источника данных объекта RowSet.

    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 Обновление базового источника данных

При выполнении метода acceptChanges средство записи объекта CachedRowSet — объект RowSetWriterImpl — незаметно для пользователя вызывается для записи изменений, внесённых в набор строк, в базовый источник данных. Средство записи реализовано так, чтобы устанавливать соединение с источником данных и записывать в него обновления.

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

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

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

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

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

Будучи компонентами JavaBeans, все наборы строк участвуют в модели событий JavaBeans и наследуют от класса BaseRowSet методы регистрации слушателей и уведомления их об изменениях. Слушатель объекта CachedRowSet — это компонент, который должен получать уведомления об изменениях в наборе строк. Например, если объект CachedRowSet содержит результаты запроса, отображаемые, скажем, в таблице и на столбчатой диаграмме, таблицу и диаграмму можно зарегистрировать в качестве слушателей набора строк, чтобы они могли обновляться при изменениях. Чтобы стать слушателями, классы таблицы и диаграммы должны реализовать интерфейс RowSetListener. Затем их можно добавить в список слушателей объекта CachedRowSet, как показано в следующих строках кода.

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

Каждый метод CachedRowSet, перемещающий курсор или изменяющий данные, также уведомляет зарегистрированных слушателей об изменениях, поэтому table и barGraph получат уведомление при изменении crs.

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

Одна из основных причин использовать объект CachedRowSet — передача данных между различными компонентами приложения. Поскольку объект CachedRowSet поддерживает сериализацию, его можно использовать, например, для отправки результата запроса, выполненного компонентом Enterprise JavaBeans на сервере, по сети клиенту, работающему в веб-браузере.

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

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

Второе важное применение объектов CachedRowSet — обеспечение прокрутки и обновления объектов ResultSet, которые сами не поддерживают эти возможности. Иными словами, объект CachedRowSet можно использовать для расширения возможностей драйвера с поддержкой технологии JDBC (далее — «драйвер JDBC»), если СУБД не обеспечивает полную поддержку прокрутки и обновления. Чтобы сделать непрокручиваемый и доступный только для чтения объект ResultSet прокручиваемым и обновляемым, программисту достаточно создать объект CachedRowSet, заполненный данными этого объекта ResultSet. Это показано в следующем фрагменте кода, где stmt — объект Statement.

   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 Универсальный доступ к данным

Ещё одно преимущество класса CachedRowSet состоит в том, что он позволяет получать и хранить данные из источников, отличных от реляционной базы данных. Читатель набора строк можно реализовать так, чтобы он считывал данные из любого табличного источника данных и заполнял ими набор строк, в том числе данными из электронной таблицы или текстового файла. Поскольку объект CachedRowSet и его метаданные можно создать с нуля, компонент, выполняющий роль фабрики наборов строк, может использовать эту возможность для создания набора строк с данными из источников, не использующих SQL. Тем не менее предполагается, что большую часть времени объекты CachedRowSet будут содержать данные, полученные из базы данных SQL с помощью API JDBC.

9.0 Настройка свойств

Все наборы строк поддерживают набор свойств, которые обычно задаются с помощью инструмента. Количество и виды свойств набора строк зависят от его назначения и способа получения данных. Например, наборы строк, получающие данные из объекта ResultSet, должны задать свойства, необходимые для подключения к базе данных. Если набор строк использует для подключения средство DriverManager, ему нужно задать свойство для URL-адреса JDBC, указывающего соответствующий драйвер, а также свойства, содержащие имя пользователя и пароль. Если же набор строк использует для подключения объект DataSource, что является предпочтительным способом, задавать свойство для URL-адреса JDBC не требуется. Вместо этого необходимо задать свойства для логического имени источника данных, имени пользователя и пароля.

ПРИМЕЧАНИЕ. Чтобы использовать объект 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 = ?");
 

Значения, которые будут использоваться для задания параметров-заполнителей команды, содержатся в поле params объекта RowSet, представляющем собой объект 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 хранит данные в памяти, объём данных, который он может одновременно содержать, зависит от доступного объёма памяти. Чтобы обойти это ограничение, объект CachedRowSet может получать данные из объекта ResultSet фрагментами, называемыми страницами. Чтобы воспользоваться этим механизмом, приложение задаёт количество строк на странице с помощью метода setPageSize. Иными словами, если размер страницы установлен равным пяти, за один раз из источника данных будет извлекаться фрагмент из пяти строк. Приложение также может задать максимальное количество строк, извлекаемых за один раз. Если максимальное количество строк равно нулю или оно не задано, число строк, извлекаемых за один раз, не ограничено.

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

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

После выполнения этого кода crs будет содержать четыре строки из rsHandle, начиная с десятой строки.

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

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

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

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

Чтобы получить следующую страницу (фрагмент данных), приложение вызывает метод 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
        }
    }

После выполнения этого фрагмента кода приложение пройдёт все 1000 строк, но одновременно в памяти будет находиться не более 100 строк.

Интерфейс 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
        }
    }