Author: rawson
Date: Wed Apr 21 00:34:40 2010
New Revision: 936124
URL: http://svn.apache.org/viewvc?rev=936124&view=rev
Log:
HBASE-2248 (improve javadoc) Provide new non-copy mechanism to assure atomic
reads in get and scan
Modified:
hadoop/hbase/branches/0.20_pre_durability/src/java/org/apache/hadoop/hbase/client/HTable.java
Modified:
hadoop/hbase/branches/0.20_pre_durability/src/java/org/apache/hadoop/hbase/client/HTable.java
URL:
http://svn.apache.org/viewvc/hadoop/hbase/branches/0.20_pre_durability/src/java/org/apache/hadoop/hbase/client/HTable.java?rev=936124&r1=936123&r2=936124&view=diff
==============================================================================
---
hadoop/hbase/branches/0.20_pre_durability/src/java/org/apache/hadoop/hbase/client/HTable.java
(original)
+++
hadoop/hbase/branches/0.20_pre_durability/src/java/org/apache/hadoop/hbase/client/HTable.java
Wed Apr 21 00:34:40 2010
@@ -55,10 +55,16 @@ import org.apache.hadoop.hbase.util.Writ
/**
* Used to communicate with a single HBase table.
- * This class is not thread safe for writes.
- * Gets, puts, and deletes take out a row lock for the duration
- * of their operation. Scans (currently) do not respect
- * row locking.
+ * This class is not thread safe. Use one instance per thread.
+ *
+ * Puts, deletes, checkAndPut and incrementColumnValue are
+ * done in an exclusive (and thus serial) fashion for each row.
+ * These calls acquire a row lock which is shared with the lockRow
+ * calls.
+ *
+ * Gets and Scans will not return half written data. That is,
+ * all mutation operations are atomic on a row basis with
+ * respect to other concurrent readers and writers.
*/
public class HTable {
private final HConnection connection;
