hbase-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From chia7...@apache.org
Subject hbase git commit: HBASE-15497 Incorrect javadoc for atomicity guarantee of Increment and Append
Date Mon, 04 Sep 2017 08:24:48 GMT
Repository: hbase
Updated Branches:
  refs/heads/branch-1.4 fd9a29a23 -> ccaef7c02


HBASE-15497 Incorrect javadoc for atomicity guarantee of Increment and Append

Signed-off-by: Chia-Ping Tsai <chia7712@gmail.com>


Project: http://git-wip-us.apache.org/repos/asf/hbase/repo
Commit: http://git-wip-us.apache.org/repos/asf/hbase/commit/ccaef7c0
Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/ccaef7c0
Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/ccaef7c0

Branch: refs/heads/branch-1.4
Commit: ccaef7c029fb210cf1dfeb992c9d3b4e4427111b
Parents: fd9a29a
Author: cuijianwei <cuijianwei@xiaomi.com>
Authored: Sun Apr 10 14:31:31 2016 +0800
Committer: Chia-Ping Tsai <chia7712@gmail.com>
Committed: Mon Sep 4 16:23:18 2017 +0800

----------------------------------------------------------------------
 .../java/org/apache/hadoop/hbase/client/Append.java   |  7 +++----
 .../org/apache/hadoop/hbase/client/Increment.java     |  7 +++----
 .../java/org/apache/hadoop/hbase/client/Table.java    | 14 ++++++--------
 3 files changed, 12 insertions(+), 16 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/hbase/blob/ccaef7c0/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Append.java
----------------------------------------------------------------------
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Append.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Append.java
index efc958d..6144570 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Append.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Append.java
@@ -35,10 +35,9 @@ import org.apache.hadoop.hbase.util.Bytes;
 /**
  * Performs Append operations on a single row.
  * <p>
- * Note that this operation does not appear atomic to readers. Appends are done
- * under a single row lock, so write operations to a row are synchronized, but
- * readers do not take row locks so get and scan operations can see this
- * operation partially completed.
+ * This operation ensures atomicty to readers. Appends are done
+ * under a single row lock, so write operations to a row are synchronized, and
+ * readers are guaranteed to see this operation fully completed.
  * <p>
  * To append to a set of columns of a row, instantiate an Append object with the
  * row to append to. At least one column to append must be specified using the

http://git-wip-us.apache.org/repos/asf/hbase/blob/ccaef7c0/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Increment.java
----------------------------------------------------------------------
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Increment.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Increment.java
index 88c7bc1..48f2fd6 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Increment.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Increment.java
@@ -39,10 +39,9 @@ import org.apache.hadoop.hbase.util.ClassSize;
 /**
  * Used to perform Increment operations on a single row.
  * <p>
- * This operation does not appear atomic to readers.  Increments are done
- * under a single row lock, so write operations to a row are synchronized, but
- * readers do not take row locks so get and scan operations can see this
- * operation partially completed.
+ * This operation ensures atomicity to readers. Increments are done
+ * under a single row lock, so write operations to a row are synchronized, and
+ * readers are guaranteed to see this operation fully completed.
  * <p>
  * To increment columns of a row, instantiate an Increment object with the row
  * to increment.  At least one column to increment must be specified using the

http://git-wip-us.apache.org/repos/asf/hbase/blob/ccaef7c0/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Table.java
----------------------------------------------------------------------
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Table.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Table.java
index ac9cfbd..28b3f87 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Table.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/Table.java
@@ -341,10 +341,9 @@ public interface Table extends Closeable {
   /**
    * Appends values to one or more columns within a single row.
    * <p>
-   * This operation does not appear atomic to readers.  Appends are done
-   * under a single row lock, so write operations to a row are synchronized, but
-   * readers do not take row locks so get and scan operations can see this
-   * operation partially completed.
+   * This operation guaranteed atomicity to readers. Appends are done
+   * under a single row lock, so write operations to a row are synchronized, and
+   * readers are guaranteed to see this operation fully completed.
    *
    * @param append object that specifies the columns and amounts to be used
    *                  for the increment operations
@@ -356,10 +355,9 @@ public interface Table extends Closeable {
   /**
    * Increments one or more columns within a single row.
    * <p>
-   * This operation does not appear atomic to readers.  Increments are done
-   * under a single row lock, so write operations to a row are synchronized, but
-   * readers do not take row locks so get and scan operations can see this
-   * operation partially completed.
+   * This operation ensures atomicity to readers. Increments are done
+   * under a single row lock, so write operations to a row are synchronized, and
+   * readers are guaranteed to see this operation fully completed.
    *
    * @param increment object that specifies the columns and amounts to be used
    *                  for the increment operations


Mime
View raw message