View Javadoc

1   /**
2    * Licensed to the Apache Software Foundation (ASF) under one
3    * or more contributor license agreements.  See the NOTICE file
4    * distributed with this work for additional information
5    * regarding copyright ownership.  The ASF licenses this file
6    * to you under the Apache License, Version 2.0 (the
7    * "License"); you may not use this file except in compliance
8    * with the License.  You may obtain a copy of the License at
9    *
10   *     http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing, software
13   * distributed under the License is distributed on an "AS IS" BASIS,
14   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15   * See the License for the specific language governing permissions and
16   * limitations under the License.
17   */
18  package org.apache.hadoop.hbase;
19  
20  import static org.junit.Assert.assertEquals;
21  import static org.junit.Assert.assertTrue;
22  
23  import org.apache.hadoop.hbase.exceptions.DeserializationException;
24  import org.apache.hadoop.hbase.io.compress.Compression;
25  import org.apache.hadoop.hbase.io.compress.Compression.Algorithm;
26  import org.apache.hadoop.hbase.io.encoding.DataBlockEncoding;
27  import org.apache.hadoop.hbase.regionserver.BloomType;
28  import org.apache.hadoop.hbase.testclassification.SmallTests;
29  import org.apache.hadoop.hbase.util.BuilderStyleTest;
30  import org.junit.experimental.categories.Category;
31  import org.junit.Test;
32  
33  /** Tests the HColumnDescriptor with appropriate arguments */
34  @Category(SmallTests.class)
35  public class TestHColumnDescriptor {
36    @Test
37    public void testPb() throws DeserializationException {
38      HColumnDescriptor hcd = new HColumnDescriptor(
39        HTableDescriptor.META_TABLEDESC.getColumnFamilies()[0]);
40      final int v = 123;
41      hcd.setBlocksize(v);
42      hcd.setTimeToLive(v);
43      hcd.setBlockCacheEnabled(!HColumnDescriptor.DEFAULT_BLOCKCACHE);
44      hcd.setValue("a", "b");
45      hcd.setMaxVersions(v);
46      assertEquals(v, hcd.getMaxVersions());
47      hcd.setMinVersions(v);
48      assertEquals(v, hcd.getMinVersions());
49      hcd.setKeepDeletedCells(KeepDeletedCells.TRUE);
50      hcd.setInMemory(!HColumnDescriptor.DEFAULT_IN_MEMORY);
51      boolean inmemory = hcd.isInMemory();
52      hcd.setScope(v);
53      hcd.setDataBlockEncoding(DataBlockEncoding.FAST_DIFF);
54      hcd.setBloomFilterType(BloomType.ROW);
55      hcd.setCompressionType(Algorithm.SNAPPY);
56      hcd.setDFSReplication((short) v);
57  
58      byte [] bytes = hcd.toByteArray();
59      HColumnDescriptor deserializedHcd = HColumnDescriptor.parseFrom(bytes);
60      assertTrue(hcd.equals(deserializedHcd));
61      assertEquals(v, hcd.getBlocksize());
62      assertEquals(v, hcd.getTimeToLive());
63      assertEquals(hcd.getValue("a"), deserializedHcd.getValue("a"));
64      assertEquals(hcd.getMaxVersions(), deserializedHcd.getMaxVersions());
65      assertEquals(hcd.getMinVersions(), deserializedHcd.getMinVersions());
66      assertEquals(hcd.getKeepDeletedCells(), deserializedHcd.getKeepDeletedCells());
67      assertEquals(inmemory, deserializedHcd.isInMemory());
68      assertEquals(hcd.getScope(), deserializedHcd.getScope());
69      assertTrue(deserializedHcd.getCompressionType().equals(Compression.Algorithm.SNAPPY));
70      assertTrue(deserializedHcd.getDataBlockEncoding().equals(DataBlockEncoding.FAST_DIFF));
71      assertTrue(deserializedHcd.getBloomFilterType().equals(BloomType.ROW));
72      assertEquals(v, deserializedHcd.getDFSReplication());
73    }
74  
75    @Test
76    /** Tests HColumnDescriptor with empty familyName*/
77    public void testHColumnDescriptorShouldThrowIAEWhenFamiliyNameEmpty()
78        throws Exception {
79      try {
80        new HColumnDescriptor("".getBytes());
81      } catch (IllegalArgumentException e) {
82        assertEquals("Family name can not be empty", e.getLocalizedMessage());
83      }
84    }
85  
86    /**
87     * Test that we add and remove strings from configuration properly.
88     */
89    @Test
90    public void testAddGetRemoveConfiguration() throws Exception {
91      HColumnDescriptor desc = new HColumnDescriptor("foo");
92      String key = "Some";
93      String value = "value";
94      desc.setConfiguration(key, value);
95      assertEquals(value, desc.getConfigurationValue(key));
96      desc.removeConfiguration(key);
97      assertEquals(null, desc.getConfigurationValue(key));
98    }
99  
100   @Test
101   public void testClassMethodsAreBuilderStyle() {
102     /* HColumnDescriptor should have a builder style setup where setXXX/addXXX methods
103      * can be chainable together:
104      * . For example:
105      * HColumnDescriptor hcd
106      *   = new HColumnDescriptor()
107      *     .setFoo(foo)
108      *     .setBar(bar)
109      *     .setBuz(buz)
110      *
111      * This test ensures that all methods starting with "set" returns the declaring object
112      */
113 
114     BuilderStyleTest.assertClassesAreBuilderStyle(HColumnDescriptor.class);
115   }
116 }