HBase Java API编程实例

本节通过一个具体的编程实例来学习如何使用 HBase Java API 解决实际问题。在本实例中，首先创建一个学生成绩表 scores，用来存储学生各门课程的考试成绩，然后向 scores 添加数据。

表 scores 的概念视图如图 1 所示，用学生的名字 name 作为行键，年级 grade 是一个只有一个列的列族，score 是一个列族，每一门课程都是 score 的一个列，如 english、math、Chinese 等。score 的列可以随时添加。

例如，后续学生又参加了其他课程的考试，如 computing、physics 等，那么就可以添加到 score 列族。因为每个学生参加考试的课程也会不同，所以，并不一定表中的每一个单元都会有值。在该实例中，要向学生成绩表 scores 中添加的数据如图 2 所示。 

图 1  学生成缋表 scores 的概念视图 

图 2  学生成绩表 scores 的数据

本节首先对学生成绩表实例的代码框架进行描述，然后详细介绍每一个功能模块的代码细节。

import java.io.IOException;
import org.apache.hadoop.conf.Configuration;
import org.apache.hadoop.hbase.*;
import org.apache.hadoop.hbase.client.*;
import org.apache.hadoop.hbase.util.Bytes;
public class StudentScores {
    public static Configuration configuration; //HBase 配置信息
    public static Connection connection; //HBase 连接
    public static void main (String [] agrs) thorws IOException{
        init();//建立连接
        createTable();//建表
        insertData();//添加课程成绩
        insertData();//添加课程成绩
        insertData();//添加课程成绩
        getData();//浏览课程成绩
        close();//关闭连接
    }

    public static void init () {......} //建立连接
    public static void close () {......} //关闭连接
    public static void createTable (){......} //创建表
    public static void insertData () {......} //添加课程成绩
    public static getData() {……} //浏览操程成绩
}

下面分别对每一个功能模块的代码进行介绍。

1. 建立连接和关闭连接

在使用 HBase 数据库前，必须首先建立连接，通过连接可以获取 Admin 子类，完成对数据库模型的操作。建立连接的代码如下。

public static void init () {
    configuration = HBaseConfiguration.create();
    configuration.set("hbase.rootdir","hdfs://localhost:9000/hbase");
    try{
        connection = ConnectionFactory.createConnection(configuration);
        admin = connection.getAdmin();
    }catch(IOException e){
        e.printStackTrace();
    }
}

代码中，首先为 configuration 配置对象设置 HBase 数据库的存储路径 hbase.rootdir。本实例使用 HDFS 作为 HBase 的底层存储方式，所以在代码中把 configuration 的第二个参数赋值为 hdfs://localhost:9000/hbase。

对 HBase 数据库操作结束之后，需要关闭数据库的连接，具体代码如下。

public static void close() {
    try{
        if(admin != null) {
            admin.close();
        }
        if (null != connection) {
            Connection.close();
        }
    }catch (IOException e) {
        e.printStackTrace();
    }
}

2. 创建表

创建 HBase 数据库表的时候，首先需要定义表的模型，包括表的名称、行键和列族的名称。具体代码如下。

public static void createTable(String myTableName,String[] colFamily) throws IOException {
    TableName tableName = TableName.valueOf(myTableName);
    If(admin.tableExists(tableName)){
        System.out.printIn("table exists!");
    } else {
        HTableDescriptor hTableDescriptor = new HTableDescriptor(tableName);
        for(String str:colFamily){
            HColumnDescriptor hColumnDescriptor = new HColumnDescriptor(str);
            hTableDescriptor.addFamily(hColumnDescriptor);
        }
        admin.createTable(hTableDescriptor);
    }
}

调用上述代码创建学生成绩表 scores，需要指定参数 myTableName 为“scores”，colFamily 为 “{"grade"，"score"}”，即 createTable("scores",{"grade","score"})。

3. 添加数据

为 HBase 数握库表添加数据，需要指定行键、列族、列限定符、时间戳，其中，时间戳可以在添加数据时由系统自动生成。因此，向表里添加数据时，需要提供行键、列族和列限定符及数据值信息，具体代码如下。

public static void insertData(String tableName, String rowKey, String colFamily, String col, String val) throws IOException {
    Table table = connection.getTable(TableName.valueOf(tableName));
    Put put = new Put(rowKey.getBytes());
    put.addColumn(colFamily.getBytes(),col.getBytes(),val.getBytes());
    table.put(put);
    table.close();
}

使用上述代码添加数据时，需要分别为参数 tableName、rowKey、colFamily、col 和 val赋值。例如，要添加图 2 的第一个学生的数据，就需要使用如下 4 行代码。

insertData("scores","dandan","grade","","6");
insertData("scores","dandan","score","english","95");
insertData("scores","dandan","score"，"math","100");
insertData("scores","dandan","score","Chinese","92");

通过以下代码添加第二个学生的数据。

insertData("scores","sansan","grade","","6");
insertData("scores","sansan","score","english","87");
insertData("scores","sansan","score","math","95");
insertData("scores","sansan","score","Chinese","98");

4. 浏览数据

在向数据库表添加数据以后，就可以查询表中的数据了。

public static void getData (String tableName,String rowKey,String colFamily,String col)throws IOException {
    Table table = connection.getTable(TableName.valueOf(tableName));
    Get get = new Get (rowKey. getBytes()).;
    get.addColumn(colFamily.getBytes(),col.getBytes());
    Result result = table.get(get);
    System.out.printIn(new String(result.getValue(colFamily.getBytes(),
    col.getBytes())));
    table.close();
}

使用上述代码就可以查询学生课程的成绩，例如，为了查询学生“dandan”的“math”课程的成绩，就可以使用下述代码。