HBase Java客户端编程

本文以HBase 0.90.2为例，介绍如何在Windows系统，Eclipse IDE集成环境下，使用Java语言，进行HBase客户端编程，包含建立表、删除表、插入记录、删除记录、各种方式下的查询操作等。

1. 准备工作

1、下载后安装jdk包（这里使用的是jdk-6u10-rc2-bin-b32-windows-i586-p-12_sep_2008）；

2、下载eclipse，解压到本地（这里使用的是eclipse-java-helios-SR2-win32）；

3、下载HBase包，解压安装包到本地（这里使用的是hbase-0.90.2）。

2. 搭建开发环境

1、运行Eclipse，创建一个新的Java工程“HBaseClient”，右键项目根目录，选择 “Properties”->“Java Build Path”->“Library”->“Add External JARs”，将HBase解压后根目录下的hbase-0.90.2.jar、hbase-0.90.2-tests.jar和lib子目录下所有jar 包添加到本工程的Classpath下。

2、按照步骤1中的操作，将自己所连接的HBase的配置文件hbase-site.xml添加到本工程的Classpath中，如下所示为配置文件的一个示例：

<configuration>
<property>
<name>hbase.rootdir</name>
<value>hdfs://hostname:9000/hbase</value>
</property>
<property>
<name>hbase.cluster.distributed</name>
<value>true</value>
</property>
<property>
<name>hbase.zookeeper.quorum</name>
<value>*.*.*.*, *.*.*.*, *.*.*.*</value>
</property>
<property skipInDoc="true">
<name>hbase.defaults.for.version</name>
<value>0.90.2</value>
</property>
</configuration>

3、下面可以在Eclipse环境下进行HBase编程了。

3. HBase基本操作代码示例

3.1 初始化配置

privatestatic Configuration conf =null;
/**
* 初始化配置
*/
static {
conf = HBaseConfiguration.create();
}

3.2 创建表

/**
* 创建表操作
* @throws IOException
*/
publicvoid createTable(String tablename, String[] cfs) throws IOException {
HBaseAdmin admin =new HBaseAdmin(conf);
if (admin.tableExists(tablename)) {
System.out.println("表已经存在！");
}
else {
HTableDescriptor tableDesc =new HTableDescriptor(tablename);
for (int i =0; i < cfs.length; i++) {
tableDesc.addFamily(new HColumnDescriptor(cfs[i]));
}
admin.createTable(tableDesc);
System.out.println("表创建成功！");
}
}

3.3 删除表

/**
* 删除表操作
* @param tablename
* @throws IOException
*/
publicvoid deleteTable(String tablename) throws IOException {
try {
HBaseAdmin admin =new HBaseAdmin(conf);
admin.disableTable(tablename);
admin.deleteTable(tablename);
System.out.println("表删除成功！");
} catch (MasterNotRunningException e) {
e.printStackTrace();
} catch (ZooKeeperConnectionException e) {
e.printStackTrace();
}
}

3.4 插入一行记录

/**
* 插入一行记录
* @param tablename
* @param cfs
*/
publicvoid writeRow(String tablename, String[] cfs) {
try {
HTable table =new HTable(conf, tablename);
Put put =new Put(Bytes.toBytes("rows1"));
for (int j =0; j < cfs.length; j++) {
put.add(Bytes.toBytes(cfs[j]),
Bytes.toBytes(String.valueOf(1)),
Bytes.toBytes("value_1"));
table.put(put);
}
} catch (IOException e) {
e.printStackTrace();
}
}

3.5 删除一行记录

/**
* 删除一行记录
* @param tablename
* @param rowkey
* @throws IOException
*/
publicvoid deleteRow(String tablename, String rowkey) throws IOException {
HTable table =new HTable(conf, tablename);
List list =new ArrayList();
Delete d1 =new Delete(rowkey.getBytes());
list.add(d1);
table.delete(list);
System.out.println("删除行成功！");
}

3.6 查找一行记录

/**
* 查找一行记录
* @param tablename
* @param rowkey
*/
publicstaticvoid selectRow(String tablename, String rowKey)
throws IOException {
HTable table =new HTable(conf, tablename);
Get g =new Get(rowKey.getBytes());
Result rs = table.get(g);
for (KeyValue kv : rs.raw()) {
System.out.print(new String(kv.getRow()) +"");
System.out.print(new String(kv.getFamily()) +":");
System.out.print(new String(kv.getQualifier()) +"");
System.out.print(kv.getTimestamp() +"");
System.out.println(new String(kv.getValue()));
}
}

3.7 查询表中所有行

/**
* 查询表中所有行
* @param tablename
*/
publicvoid scaner(String tablename) {
try {
HTable table =new HTable(conf, tablename);
Scan s =new Scan();
ResultScanner rs = table.getScanner(s);
for (Result r : rs) {
KeyValue[] kv = r.raw();
for (int i =0; i < kv.length; i++) {
System.out.print(new String(kv[i].getRow()) +"");
System.out.print(new String(kv[i].getFamily()) +":");
System.out.print(new String(kv[i].getQualifier()) +"");
System.out.print(kv[i].getTimestamp() +"");
System.out.println(new String(kv[i].getValue()));
}
}
} catch (IOException e) {
e.printStackTrace();
}
}