View Javadoc

1   /*
2    * Copyright 2010 The Apache Software Foundation
3    *
4    * Licensed to the Apache Software Foundation (ASF) under one
5    * or more contributor license agreements.  See the NOTICE file
6    * distributed with this work for additional information
7    * regarding copyright ownership.  The ASF licenses this file
8    * to you under the Apache License, Version 2.0 (the
9    * "License"); you may not use this file except in compliance
10   * with the License.  You may obtain a copy of the License at
11   *
12   *     http://www.apache.org/licenses/LICENSE-2.0
13   *
14   * Unless required by applicable law or agreed to in writing, software
15   * distributed under the License is distributed on an "AS IS" BASIS,
16   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
17   * See the License for the specific language governing permissions and
18   * limitations under the License.
19   */
20  
21  package org.apache.hadoop.hbase.filter;
22  
23  import org.apache.hadoop.hbase.KeyValue;
24  import org.apache.hadoop.hbase.util.Bytes;
25  
26  import java.io.DataOutput;
27  import java.io.IOException;
28  import java.io.DataInput;
29  import java.util.List;
30  import java.util.ArrayList;
31  
32  import com.google.common.base.Preconditions;
33  
34  /**
35   * Pass results that have same row prefix.
36   */
37  public class PrefixFilter extends FilterBase {
38    protected byte [] prefix = null;
39    protected boolean passedPrefix = false;
40  
41    public PrefixFilter(final byte [] prefix) {
42      this.prefix = prefix;
43    }
44  
45    public PrefixFilter() {
46      super();
47    }
48  
49    public byte[] getPrefix() {
50      return prefix;
51    }
52  
53    public boolean filterRowKey(byte[] buffer, int offset, int length) {
54      if (buffer == null || this.prefix == null)
55        return true;
56      if (length < prefix.length)
57        return true;
58      // if they are equal, return false => pass row
59      // else return true, filter row
60      // if we are passed the prefix, set flag
61      int cmp = Bytes.compareTo(buffer, offset, this.prefix.length, this.prefix, 0,
62          this.prefix.length);
63      if(cmp > 0) {
64        passedPrefix = true;
65      }
66      return cmp != 0;
67    }
68  
69    public boolean filterAllRemaining() {
70      return passedPrefix;
71    }
72  
73    public static Filter createFilterFromArguments(ArrayList<byte []> filterArguments) {
74      Preconditions.checkArgument(filterArguments.size() == 1,
75                                  "Expected 1 but got: %s", filterArguments.size());
76      byte [] prefix = ParseFilter.removeQuotesFromByteArray(filterArguments.get(0));
77      return new PrefixFilter(prefix);
78    }
79  
80    public void write(DataOutput out) throws IOException {
81      Bytes.writeByteArray(out, this.prefix);
82    }
83  
84    public void readFields(DataInput in) throws IOException {
85      this.prefix = Bytes.readByteArray(in);
86    }
87  
88    @Override
89    public String toString() {
90      return this.getClass().getSimpleName() + " " + Bytes.toStringBinary(this.prefix);
91    }
92  }