From 1934510d8081103997953f80150dd43b61356434 Mon Sep 17 00:00:00 2001 From: zhangduo Date: Thu, 7 Sep 2017 16:18:58 +0800 Subject: [PATCH] HBASE-18446 Mark StoreFileScanner/StoreFileReader as IA.LimitedPrivate(Phoenix) --- .../org/apache/hadoop/hbase/coprocessor/RegionObserver.java | 13 +++++++------ .../apache/hadoop/hbase/regionserver/StoreFileReader.java | 5 ++++- .../apache/hadoop/hbase/regionserver/StoreFileScanner.java | 5 ++++- 3 files changed, 15 insertions(+), 8 deletions(-) diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionObserver.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionObserver.java index 4f997c2..afff51a 100644 --- a/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionObserver.java +++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/coprocessor/RegionObserver.java @@ -342,8 +342,7 @@ public interface RegionObserver extends Coprocessor { * effect in this hook. * @param c the environment provided by the region server * @param store the store being compacted - * @param scanners the list {@link org.apache.hadoop.hbase.regionserver.StoreFileScanner}s - * to be read from + * @param scanners the list of store file scanners to be read from * @param scanType the {@link ScanType} indicating whether this is a major or minor compaction * @param earliestPutTs timestamp of the earliest put that was found in any of the involved store * files @@ -372,8 +371,7 @@ public interface RegionObserver extends Coprocessor { * effect in this hook. * @param c the environment provided by the region server * @param store the store being compacted - * @param scanners the list {@link org.apache.hadoop.hbase.regionserver.StoreFileScanner}s - * to be read from + * @param scanners the list of store file scanners to be read from * @param scanType the {@link ScanType} indicating whether this is a major or minor compaction * @param earliestPutTs timestamp of the earliest put that was found in any of the involved store * files @@ -400,8 +398,7 @@ public interface RegionObserver extends Coprocessor { * effect in this hook. * @param c the environment provided by the region server * @param store the store being compacted - * @param scanners the list {@link org.apache.hadoop.hbase.regionserver.StoreFileScanner}s - * to be read from + * @param scanners the list of store file scanners to be read from * @param scanType the {@link ScanType} indicating whether this is a major or minor compaction * @param earliestPutTs timestamp of the earliest put that was found in any of the involved store * files @@ -1462,7 +1459,9 @@ public interface RegionObserver extends Coprocessor { * @param reader the base reader, if not {@code null}, from previous RegionObserver in the chain * @return a Reader instance to use instead of the base reader if overriding * default behavior, null otherwise + * @deprecated For Phoenix only, StoreFileReader is not a stable interface. */ + @Deprecated default StoreFileReader preStoreFileReaderOpen( final ObserverContext ctx, final FileSystem fs, final Path p, final FSDataInputStreamWrapper in, long size, @@ -1482,7 +1481,9 @@ public interface RegionObserver extends Coprocessor { * @param r original reference file. This will be not null only when reading a split file. * @param reader the base reader instance * @return The reader to use + * @deprecated For Phoenix only, StoreFileReader is not a stable interface. */ + @Deprecated default StoreFileReader postStoreFileReaderOpen( final ObserverContext ctx, final FileSystem fs, final Path p, final FSDataInputStreamWrapper in, long size, diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileReader.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileReader.java index 15bf121..3ab56ed 100644 --- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileReader.java +++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileReader.java @@ -34,9 +34,11 @@ import org.apache.hadoop.fs.Path; import org.apache.hadoop.hbase.Cell; import org.apache.hadoop.hbase.CellComparator; import org.apache.hadoop.hbase.CellUtil; +import org.apache.hadoop.hbase.HBaseInterfaceAudience; import org.apache.hadoop.hbase.HConstants; import org.apache.hadoop.hbase.KeyValue; import org.apache.hadoop.hbase.classification.InterfaceAudience; +import org.apache.hadoop.hbase.classification.InterfaceStability; import org.apache.hadoop.hbase.client.Scan; import org.apache.hadoop.hbase.io.FSDataInputStreamWrapper; import org.apache.hadoop.hbase.io.TimeRange; @@ -53,7 +55,8 @@ import org.apache.hadoop.hbase.util.Bytes; /** * Reader for a StoreFile. */ -@InterfaceAudience.Private +@InterfaceAudience.LimitedPrivate(HBaseInterfaceAudience.PHOENIX) +@InterfaceStability.Evolving public class StoreFileReader { private static final Log LOG = LogFactory.getLog(StoreFileReader.class.getName()); diff --git a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileScanner.java b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileScanner.java index 603ff0a..d9f517f 100644 --- a/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileScanner.java +++ b/hbase-server/src/main/java/org/apache/hadoop/hbase/regionserver/StoreFileScanner.java @@ -32,8 +32,10 @@ import org.apache.hadoop.fs.Path; import org.apache.hadoop.hbase.Cell; import org.apache.hadoop.hbase.CellComparator; import org.apache.hadoop.hbase.CellUtil; +import org.apache.hadoop.hbase.HBaseInterfaceAudience; import org.apache.hadoop.hbase.HConstants; import org.apache.hadoop.hbase.classification.InterfaceAudience; +import org.apache.hadoop.hbase.classification.InterfaceStability; import org.apache.hadoop.hbase.client.Scan; import org.apache.hadoop.hbase.io.TimeRange; import org.apache.hadoop.hbase.io.hfile.HFileScanner; @@ -43,7 +45,8 @@ import org.apache.hadoop.hbase.regionserver.querymatcher.ScanQueryMatcher; * KeyValueScanner adaptor over the Reader. It also provides hooks into * bloom filter things. */ -@InterfaceAudience.LimitedPrivate("Coprocessor") +@InterfaceAudience.LimitedPrivate(HBaseInterfaceAudience.PHOENIX) +@InterfaceStability.Evolving public class StoreFileScanner implements KeyValueScanner { // the reader it comes from: private final StoreFileReader reader; -- 2.7.4