From aa5e98f98d15857138d7e0c6015c6481c2a955ed Mon Sep 17 00:00:00 2001
From: Michael Stack <stack@apache.org>
Date: Tue, 11 Dec 2007 17:17:29 +0000
Subject: [PATCH] HADOOP-2243 getRow returns empty Map if no-such row.. should
 return null Intentionally not added to the CHANGES.txt because way hbase
 currently works is correct; this commit just adds a bit of clarifying
 javadoc.

git-svn-id: https://svn.apache.org/repos/asf/lucene/hadoop/trunk/src/contrib/hbase@603307 13f79535-47bb-0310-9956-ffa450edef68
---
 src/java/org/apache/hadoop/hbase/HTable.java | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/java/org/apache/hadoop/hbase/HTable.java b/src/java/org/apache/hadoop/hbase/HTable.java
index 7c03ec57602..427e3169c33 100644
--- a/src/java/org/apache/hadoop/hbase/HTable.java
+++ b/src/java/org/apache/hadoop/hbase/HTable.java
@@ -352,7 +352,7 @@ public class HTable implements HConstants {
    * Get all the data for the specified row at the latest timestamp
    * 
    * @param row row key
-   * @return map of colums to values
+   * @return Map of columns to values.  Map is empty if row does not exist.
    * @throws IOException
    */
   public SortedMap<Text, byte[]> getRow(Text row) throws IOException {
@@ -364,7 +364,7 @@ public class HTable implements HConstants {
    * 
    * @param row row key
    * @param ts timestamp
-   * @return map of colums to values
+   * @return Map of columns to values.  Map is empty if row does not exist.
    * @throws IOException
    */
   public SortedMap<Text, byte[]> getRow(Text row, long ts) throws IOException {
@@ -650,12 +650,12 @@ public class HTable implements HConstants {
   }
   
   /** 
-   * Change a value for the specified column.
+   * Update a value for the specified column.
    * Runs {@link #abort(long)} if exception thrown.
    *
    * @param lockid lock id returned from startUpdate
    * @param column column whose value is being set
-   * @param val new value for column
+   * @param val new value for column.  Cannot be null.
    */
   public void put(long lockid, Text column, byte val[]) {
     checkClosed();
@@ -667,12 +667,12 @@ public class HTable implements HConstants {
   }
   
   /** 
-   * Change a value for the specified column.
+   * Update a value for the specified column.
    * Runs {@link #abort(long)} if exception thrown.
    *
    * @param lockid lock id returned from startUpdate
    * @param column column whose value is being set
-   * @param val new value for column
+   * @param val new value for column.  Cannot be null.
    * @throws IOException throws this if the writable can't be
    * converted into a byte array 
    */