From 2da62bc07d8ec56f15adb2c4128bf02fabb3885c Mon Sep 17 00:00:00 2001
From: Nicolas Capponi <nicolas.capponi@forgerock.com>
Date: Tue, 01 Jul 2014 08:57:03 +0000
Subject: [PATCH] Checkpoint commit for OPENDJ-1471 File based changelog : improve cursor behavior CR-3911

---
 opends/src/server/org/opends/server/replication/server/changelog/file/Log.java |   21 +++------------------
 1 files changed, 3 insertions(+), 18 deletions(-)

diff --git a/opends/src/server/org/opends/server/replication/server/changelog/file/Log.java b/opends/src/server/org/opends/server/replication/server/changelog/file/Log.java
index c4dc1ca..16225d9 100644
--- a/opends/src/server/org/opends/server/replication/server/changelog/file/Log.java
+++ b/opends/src/server/org/opends/server/replication/server/changelog/file/Log.java
@@ -423,10 +423,6 @@
   /**
    * Returns a cursor that allows to retrieve the records from this log,
    * starting at the first position.
-   * <p>
-   * The returned cursor initially points to no record, that is
-   * {@code cursor.getRecord()} is equals to {@code null} before any call to
-   * {@code cursor.next()} method.
    *
    * @return a cursor on the log records, which is never {@code null}
    * @throws ChangelogException
@@ -461,10 +457,6 @@
   /**
    * Returns a cursor that allows to retrieve the records from this log,
    * starting at the position defined by the provided key.
-   * <p>
-   * The returned cursor initially points to no record, that is
-   * {@code cursor.getRecord()} is equals to {@code null} before any call to
-   * {@code cursor.next()} method.
    *
    * @param key
    *          Key to use as a start position for the cursor. If key is
@@ -482,11 +474,6 @@
    * Returns a cursor that allows to retrieve the records from this log,
    * starting at the position defined by the smallest key that is higher than
    * the provided key.
-   * <p>
-   * The returned cursor initially points to no record, that is
-   * {@code cursor.getRecord()} is equals to {@code null} before any call to
-   * {@code cursor.next()} method. After the first call to {@code cursor.next()}
-   * the cursor points to the record corresponding to the key found.
    *
    * @param key
    *          Key to use as a start position for the cursor. If key is
@@ -942,7 +929,9 @@
   }
 
   /**
-   * Represents a cursor than can be repositioned on a given key.
+   * Represents a DB Cursor than can be repositioned on a given key.
+   * <p>
+   * Note that as a DBCursor, it provides a java.sql.ResultSet like API.
    */
   static interface RepositionableCursor<K extends Comparable<K>, V> extends DBCursor<Record<K, V>>
   {
@@ -968,10 +957,6 @@
   /**
    * Implements a cursor on the log.
    * <p>
-   * The cursor initially points to a record, that is {@code cursor.getRecord()}
-   * is equals to the first record available from the cursor before any call to
-   * {@code cursor.next()} method.
-   * <p>
    * The cursor uses the log shared lock to ensure reads are not done during a rotation.
    * <p>
    * The cursor can be switched into an empty cursor by calling the {@code actAsEmptyCursor()}

--
Gitblit v1.10.0