hbase-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From st...@apache.org
Subject hbase git commit: HBASE-13983 Doc how the oddball HTable methods getStartKey, getEndKey, etc. will be removed in 2.0.0
Date Wed, 01 Jul 2015 20:13:03 GMT
Repository: hbase
Updated Branches:
  refs/heads/branch-1.0 ac6a1c1d9 -> 708293487


HBASE-13983 Doc how the oddball HTable methods getStartKey, getEndKey, etc. will be removed
in 2.0.0


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

Branch: refs/heads/branch-1.0
Commit: 708293487a63b2c0313aaae1fa15222af805ad33
Parents: ac6a1c1
Author: stack <stack@apache.org>
Authored: Wed Jul 1 13:12:47 2015 -0700
Committer: stack <stack@apache.org>
Committed: Wed Jul 1 13:12:47 2015 -0700

----------------------------------------------------------------------
 .../org/apache/hadoop/hbase/client/HTable.java  | 23 +++++++++++++++++---
 1 file changed, 20 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/hbase/blob/70829348/hbase-client/src/main/java/org/apache/hadoop/hbase/client/HTable.java
----------------------------------------------------------------------
diff --git a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/HTable.java b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/HTable.java
index d64af7a..5cb49a9 100644
--- a/hbase-client/src/main/java/org/apache/hadoop/hbase/client/HTable.java
+++ b/hbase-client/src/main/java/org/apache/hadoop/hbase/client/HTable.java
@@ -97,11 +97,19 @@ import com.google.protobuf.ServiceException;
  * In the case of reads, some fields used by a Scan are shared among all threads.
  *
  * <p>HTable is no longer a client API. Use {@link Table} instead. It is marked
- * InterfaceAudience.Private indicating that this is an HBase-internal class as defined in
+ * InterfaceAudience.Private as of hbase-1.0.0 indicating that this is an
+ * HBase-internal class as defined in
  * <a href="https://hadoop.apache.org/docs/current/hadoop-project-dist/hadoop-common/InterfaceClassification.html">Hadoop
- * Interface Classification</a>
- * There are no guarantees for backwards source / binary compatibility and methods or class
can
+ * Interface Classification</a>. There are no guarantees for backwards
+ * source / binary compatibility and methods or the class can
  * change or go away without deprecation.
+ * <p>Near all methods of this * class made it out to the new {@link Table}
+ * Interface or were * instantiations of methods defined in {@link HTableInterface}.
+ * A few did not. Namely, the {@link #getStartEndKeys}, {@link #getEndKeys},
+ * and {@link #getStartKeys} methods. These three methods are available
+ * in {@link RegionLocator} as of 1.0.0 but were NOT marked as
+ * deprecated when we released 1.0.0. In spite of this oversight on our
+ * part, these methods will be removed in 2.0.0.
  *
  * @see Table
  * @see Admin
@@ -600,24 +608,33 @@ public class HTable implements HTableInterface, RegionLocator {
 
   /**
    * {@inheritDoc}
+   * To be removed in 2.0.0.
+   * @deprecated Use {@link RegionLocator#getStartKeys()} instead
    */
   @Override
+  @Deprecated
   public byte [][] getStartKeys() throws IOException {
     return getStartEndKeys().getFirst();
   }
 
   /**
    * {@inheritDoc}
+   * To be removed in 2.0.0.
+   * @deprecated Use {@link RegionLocator#getEndKeys()} instead
    */
   @Override
+  @Deprecated
   public byte[][] getEndKeys() throws IOException {
     return getStartEndKeys().getSecond();
   }
 
   /**
    * {@inheritDoc}
+   * To be removed in 2.0.0.
+   * @deprecated Use {@link RegionLocator#getStartEndKeys()} instead
    */
   @Override
+  @Deprecated
   public Pair<byte[][],byte[][]> getStartEndKeys() throws IOException {
 
     List<RegionLocations> regions = listRegionLocations();


Mime
View raw message