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 的概念视图

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

1. 建立连接和关闭连接

在使用 HBase 数据库前，必须首先建立连接，通过连接可以获取 Admin 子类，完成对数据库模型的操作。建立连接的代码如下。
代码中，首先为 configuration 配置对象设置 HBase 数据库的存储路径 hbase.rootdir。本实例使用 HDFS 作为 HBase 的底层存储方式，所以在代码中把 configuration 的第二个参数赋值为 hdfs://localhost:9000/hbase。

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

创建 HBase 数据库表的时候，首先需要定义表的模型，包括表的名称、行键和列族的名称。具体代码如下。调用上述代码创建学生成绩表 scores，需要指定参数 myTableName 为“scores”，colFamily 为 “{“grade”，”score”}”，即 createTable(“scores”,{“grade”,”score”})。

3. 添加数据

为 HBase 数握库表添加数据，需要指定行键、列族、列限定符、时间戳，其中，时间戳可以在添加数据时由系统自动生成。因此，向表里添加数据时，需要提供行键、列族和列限定符及数据值信息，具体代码如下。使用上述代码添加数据时，需要分别为参数 tableName、rowKey、colFamily、col 和 val赋值。例如，要添加图 2 的第一个学生的数据，就需要使用如下 4 行代码。
通过以下代码添加第二个学生的数据。4. 浏览数据

在向数据库表添加数据以后，就可以查询表中的数据了。使用上述代码就可以查询学生课程的成绩，例如，为了查询学生“dandan”的“math”课程的成绩，就可以使用下述代码。

图 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() {……} //浏览操程成绩
}
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();
}
}
public static void close() {
try{
if(admin != null) {
admin.close();
}
if (null != connection) {
Connection.close();
}
}catch (IOException e) {
e.printStackTrace();
}
}
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);
}
}
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();
}
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”);
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();
}
getData(“scores”,”dandan”,”score”,”math”);