Return-Path: X-Original-To: archive-asf-public-internal@cust-asf2.ponee.io Delivered-To: archive-asf-public-internal@cust-asf2.ponee.io Received: from cust-asf.ponee.io (cust-asf.ponee.io [163.172.22.183]) by cust-asf2.ponee.io (Postfix) with ESMTP id 8397F200BAD for ; Tue, 25 Oct 2016 18:19:41 +0200 (CEST) Received: by cust-asf.ponee.io (Postfix) id 825BA160AF3; Tue, 25 Oct 2016 16:19:41 +0000 (UTC) Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id D25A3160AD8 for ; Tue, 25 Oct 2016 18:19:40 +0200 (CEST) Received: (qmail 71512 invoked by uid 500); 25 Oct 2016 16:19:40 -0000 Mailing-List: contact commits-help@hbase.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@hbase.apache.org Delivered-To: mailing list commits@hbase.apache.org Received: (qmail 71501 invoked by uid 99); 25 Oct 2016 16:19:40 -0000 Received: from git1-us-west.apache.org (HELO git1-us-west.apache.org) (140.211.11.23) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 25 Oct 2016 16:19:40 +0000 Received: by git1-us-west.apache.org (ASF Mail Server at git1-us-west.apache.org, from userid 33) id E198EE056F; Tue, 25 Oct 2016 16:19:39 +0000 (UTC) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: stack@apache.org To: commits@hbase.apache.org Message-Id: X-Mailer: ASF-Git Admin Mailer Subject: hbase git commit: HBASE-1600 Table#checkAndPut() docs are too vague (Csaba Skrabak) Date: Tue, 25 Oct 2016 16:19:39 +0000 (UTC) archived-at: Tue, 25 Oct 2016 16:19:41 -0000 Repository: hbase Updated Branches: refs/heads/master caa1a8494 -> 36aa41685 HBASE-1600 Table#checkAndPut() docs are too vague (Csaba Skrabak) Project: http://git-wip-us.apache.org/repos/asf/hbase/repo Commit: http://git-wip-us.apache.org/repos/asf/hbase/commit/36aa4168 Tree: http://git-wip-us.apache.org/repos/asf/hbase/tree/36aa4168 Diff: http://git-wip-us.apache.org/repos/asf/hbase/diff/36aa4168 Branch: refs/heads/master Commit: 36aa41685685f6b7d10fea63787cb8adacecc2e7 Parents: caa1a84 Author: Michael Stack Authored: Tue Oct 25 09:19:32 2016 -0700 Committer: Michael Stack Committed: Tue Oct 25 09:19:32 2016 -0700 ---------------------------------------------------------------------- .../org/apache/hadoop/hbase/client/Table.java | 19 +++++++++++++++++-- 1 file changed, 17 insertions(+), 2 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/hbase/blob/36aa4168/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 4d93442..016894b 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 @@ -231,7 +231,12 @@ public interface Table extends Closeable { /** * Atomically checks if a row/family/qualifier value matches the expected * value. If it does, it adds the put. If the passed value is null, the check - * is for the lack of column (ie: non-existance) + * is for the lack of column (ie: non-existence) + * + * The expected value argument of this call is on the left and the current + * value of the cell is on the right side of the comparison operator. + * + * Ie. eg. GREATER operator means expected value > existing <=> add the put. * * @param row to check * @param family column family to check @@ -286,7 +291,12 @@ public interface Table extends Closeable { /** * Atomically checks if a row/family/qualifier value matches the expected * value. If it does, it adds the delete. If the passed value is null, the - * check is for the lack of column (ie: non-existance) + * check is for the lack of column (ie: non-existence) + * + * The expected value argument of this call is on the left and the current + * value of the cell is on the right side of the comparison operator. + * + * Ie. eg. GREATER operator means expected value > existing <=> add the delete. * * @param row to check * @param family column family to check @@ -555,6 +565,11 @@ public interface Table extends Closeable { * If it does, it performs the row mutations. If the passed value is null, the check * is for the lack of column (ie: non-existence) * + * The expected value argument of this call is on the left and the current + * value of the cell is on the right side of the comparison operator. + * + * Ie. eg. GREATER operator means expected value > existing <=> perform row mutations. + * * @param row to check * @param family column family to check * @param qualifier column qualifier to check