Apache
/
hbase
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

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

Signed-off-by: Chia-Ping Tsai <chia7712@gmail.com>
This commit is contained in:
cuijianwei 2016-04-10 14:31:31 +08:00 committed by Chia-Ping Tsai
parent a5131a0491
commit 6e3ffd03e7
3 changed files with 12 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
hbase-client/src/main/java/org/apache/hadoop/hbase/client/Append.java
View File

@ -34,10 +34,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

7
hbase-client/src/main/java/org/apache/hadoop/hbase/client/Increment.java
View File

@ -38,10 +38,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

14
hbase-client/src/main/java/org/apache/hadoop/hbase/client/Table.java
View File

@ -326,10 +326,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
@ -341,10 +340,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