| /** |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you under the Apache License, Version 2.0 (the |
| * "License"); you may not use this file except in compliance |
| * with the License. You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| package org.apache.hadoop.hbase.filter; |
| |
| import static org.junit.Assert.*; |
| |
| import java.io.IOException; |
| import java.util.ArrayList; |
| import java.util.HashMap; |
| import java.util.HashSet; |
| import java.util.List; |
| import java.util.Map; |
| import java.util.Objects; |
| import java.util.Set; |
| |
| import org.apache.hadoop.hbase.Cell; |
| import org.apache.hadoop.hbase.HBaseClassTestRule; |
| import org.apache.hadoop.hbase.HBaseTestingUtility; |
| import org.apache.hadoop.hbase.KeyValue; |
| import org.apache.hadoop.hbase.KeyValueTestUtil; |
| import org.apache.hadoop.hbase.TableName; |
| import org.apache.hadoop.hbase.client.Durability; |
| import org.apache.hadoop.hbase.client.Put; |
| import org.apache.hadoop.hbase.client.Result; |
| import org.apache.hadoop.hbase.client.ResultScanner; |
| import org.apache.hadoop.hbase.client.Scan; |
| import org.apache.hadoop.hbase.client.Table; |
| import org.apache.hadoop.hbase.filter.FilterList.Operator; |
| import org.apache.hadoop.hbase.testclassification.FilterTests; |
| import org.apache.hadoop.hbase.testclassification.MediumTests; |
| import org.apache.hadoop.hbase.util.Bytes; |
| import org.junit.After; |
| import org.junit.AfterClass; |
| import org.junit.Before; |
| import org.junit.BeforeClass; |
| import org.junit.ClassRule; |
| import org.junit.Rule; |
| import org.junit.Test; |
| import org.junit.experimental.categories.Category; |
| import org.junit.rules.TestName; |
| import org.slf4j.Logger; |
| import org.slf4j.LoggerFactory; |
| |
| class StringRange { |
| private String start = null; |
| private String end = null; |
| private boolean startInclusive = true; |
| private boolean endInclusive = false; |
| |
| public StringRange(String start, boolean startInclusive, String end, |
| boolean endInclusive) { |
| this.start = start; |
| this.startInclusive = startInclusive; |
| this.end = end; |
| this.endInclusive = endInclusive; |
| } |
| |
| public String getStart() { |
| return this.start; |
| } |
| |
| public String getEnd() { |
| return this.end; |
| } |
| |
| public boolean isStartInclusive() { |
| return this.startInclusive; |
| } |
| |
| public boolean isEndInclusive() { |
| return this.endInclusive; |
| } |
| |
| @Override |
| public int hashCode() { |
| int hashCode = 0; |
| if (this.start != null) { |
| hashCode ^= this.start.hashCode(); |
| } |
| |
| if (this.end != null) { |
| hashCode ^= this.end.hashCode(); |
| } |
| return hashCode; |
| } |
| |
| @Override |
| public boolean equals(Object obj) { |
| if (this == obj) { |
| return true; |
| } |
| if (obj == null) { |
| return false; |
| } |
| if (!(obj instanceof StringRange)) { |
| return false; |
| } |
| StringRange oth = (StringRange) obj; |
| return this.startInclusive == oth.startInclusive && |
| this.endInclusive == oth.endInclusive && |
| Objects.equals(this.start, oth.start) && |
| Objects.equals(this.end, oth.end); |
| } |
| |
| @Override |
| public String toString() { |
| String result = (this.startInclusive ? "[" : "(") |
| + (this.start == null ? null : this.start) + ", " |
| + (this.end == null ? null : this.end) |
| + (this.endInclusive ? "]" : ")"); |
| return result; |
| } |
| |
| public boolean inRange(String value) { |
| boolean afterStart = true; |
| if (this.start != null) { |
| int startCmp = value.compareTo(this.start); |
| afterStart = this.startInclusive ? startCmp >= 0 : startCmp > 0; |
| } |
| |
| boolean beforeEnd = true; |
| if (this.end != null) { |
| int endCmp = value.compareTo(this.end); |
| beforeEnd = this.endInclusive ? endCmp <= 0 : endCmp < 0; |
| } |
| |
| return afterStart && beforeEnd; |
| } |
| |
| } |
| |
| |
| @Category({FilterTests.class, MediumTests.class}) |
| public class TestColumnRangeFilter { |
| |
| @ClassRule |
| public static final HBaseClassTestRule CLASS_RULE = |
| HBaseClassTestRule.forClass(TestColumnRangeFilter.class); |
| |
| private final static HBaseTestingUtility TEST_UTIL = new HBaseTestingUtility(); |
| |
| private static final Logger LOG = LoggerFactory.getLogger(TestColumnRangeFilter.class); |
| |
| @Rule |
| public TestName name = new TestName(); |
| |
| @BeforeClass |
| public static void setUpBeforeClass() throws Exception { |
| TEST_UTIL.startMiniCluster(); |
| } |
| |
| @AfterClass |
| public static void tearDownAfterClass() throws Exception { |
| TEST_UTIL.shutdownMiniCluster(); |
| } |
| |
| @Before |
| public void setUp() throws Exception { |
| // Nothing to do. |
| } |
| |
| @After |
| public void tearDown() throws Exception { |
| // Nothing to do. |
| } |
| |
| @Test |
| public void TestColumnRangeFilterClient() throws Exception { |
| String family = "Family"; |
| Table ht = TEST_UTIL.createTable(TableName.valueOf(name.getMethodName()), |
| Bytes.toBytes(family), Integer.MAX_VALUE); |
| |
| List<String> rows = generateRandomWords(10, 8); |
| long maxTimestamp = 2; |
| List<String> columns = generateRandomWords(20000, 8); |
| |
| List<KeyValue> kvList = new ArrayList<>(); |
| |
| Map<StringRange, List<KeyValue>> rangeMap = new HashMap<>(); |
| |
| rangeMap.put(new StringRange(null, true, "b", false), |
| new ArrayList<>()); |
| rangeMap.put(new StringRange("p", true, "q", false), |
| new ArrayList<>()); |
| rangeMap.put(new StringRange("r", false, "s", true), |
| new ArrayList<>()); |
| rangeMap.put(new StringRange("z", false, null, false), |
| new ArrayList<>()); |
| String valueString = "ValueString"; |
| |
| for (String row : rows) { |
| Put p = new Put(Bytes.toBytes(row)); |
| p.setDurability(Durability.SKIP_WAL); |
| for (String column : columns) { |
| for (long timestamp = 1; timestamp <= maxTimestamp; timestamp++) { |
| KeyValue kv = KeyValueTestUtil.create(row, family, column, timestamp, |
| valueString); |
| p.add(kv); |
| kvList.add(kv); |
| for (StringRange s : rangeMap.keySet()) { |
| if (s.inRange(column)) { |
| rangeMap.get(s).add(kv); |
| } |
| } |
| } |
| } |
| ht.put(p); |
| } |
| |
| TEST_UTIL.flush(); |
| |
| ColumnRangeFilter filter; |
| Scan scan = new Scan(); |
| scan.readAllVersions(); |
| for (StringRange s : rangeMap.keySet()) { |
| filter = new ColumnRangeFilter(s.getStart() == null ? null : Bytes.toBytes(s.getStart()), |
| s.isStartInclusive(), s.getEnd() == null ? null : Bytes.toBytes(s.getEnd()), |
| s.isEndInclusive()); |
| assertEquals(rangeMap.get(s).size(), cellsCount(ht, filter)); |
| } |
| ht.close(); |
| } |
| |
| @Test |
| public void TestColumnRangeFilterWithColumnPaginationFilter() throws Exception { |
| String family = "Family"; |
| String table = "TestColumnRangeFilterWithColumnPaginationFilter"; |
| try (Table ht = |
| TEST_UTIL.createTable(TableName.valueOf(table), Bytes.toBytes(family), Integer.MAX_VALUE)) { |
| // one row. |
| String row = "row"; |
| // One version |
| long timestamp = 100; |
| // 10 columns |
| int[] columns = { 0, 1, 2, 3, 4, 5, 6, 7, 8, 9 }; |
| String valueString = "ValueString"; |
| |
| Put p = new Put(Bytes.toBytes(row)); |
| p.setDurability(Durability.SKIP_WAL); |
| for (int column : columns) { |
| KeyValue kv = |
| KeyValueTestUtil.create(row, family, Integer.toString(column), timestamp, valueString); |
| p.add(kv); |
| } |
| ht.put(p); |
| |
| TEST_UTIL.flush(); |
| |
| // Column range from 1 to 9. |
| StringRange stringRange = new StringRange("1", true, "9", false); |
| ColumnRangeFilter filter1 = new ColumnRangeFilter(Bytes.toBytes(stringRange.getStart()), |
| stringRange.isStartInclusive(), Bytes.toBytes(stringRange.getEnd()), |
| stringRange.isEndInclusive()); |
| |
| ColumnPaginationFilter filter2 = new ColumnPaginationFilter(5, 0); |
| ColumnPaginationFilter filter3 = new ColumnPaginationFilter(5, 1); |
| ColumnPaginationFilter filter4 = new ColumnPaginationFilter(5, 2); |
| ColumnPaginationFilter filter5 = new ColumnPaginationFilter(5, 6); |
| ColumnPaginationFilter filter6 = new ColumnPaginationFilter(5, 9); |
| assertEquals(5, cellsCount(ht, new FilterList(Operator.MUST_PASS_ALL, filter1, filter2))); |
| assertEquals(5, cellsCount(ht, new FilterList(Operator.MUST_PASS_ALL, filter1, filter3))); |
| assertEquals(5, cellsCount(ht, new FilterList(Operator.MUST_PASS_ALL, filter1, filter4))); |
| assertEquals(2, cellsCount(ht, new FilterList(Operator.MUST_PASS_ALL, filter1, filter5))); |
| assertEquals(0, cellsCount(ht, new FilterList(Operator.MUST_PASS_ALL, filter1, filter6))); |
| } |
| } |
| |
| private int cellsCount(Table table, Filter filter) throws IOException { |
| Scan scan = new Scan().setFilter(filter).readAllVersions(); |
| try (ResultScanner scanner = table.getScanner(scan)) { |
| List<Cell> results = new ArrayList<>(); |
| Result result; |
| while ((result = scanner.next()) != null) { |
| result.listCells().forEach(results::add); |
| } |
| return results.size(); |
| } |
| } |
| |
| List<String> generateRandomWords(int numberOfWords, int maxLengthOfWords) { |
| Set<String> wordSet = new HashSet<>(); |
| for (int i = 0; i < numberOfWords; i++) { |
| int lengthOfWords = (int) (Math.random() * maxLengthOfWords) + 1; |
| char[] wordChar = new char[lengthOfWords]; |
| for (int j = 0; j < wordChar.length; j++) { |
| wordChar[j] = (char) (Math.random() * 26 + 97); |
| } |
| String word = new String(wordChar); |
| wordSet.add(word); |
| } |
| List<String> wordList = new ArrayList<>(wordSet); |
| return wordList; |
| } |
| |
| } |
| |