SequoiaDBJava开发入门教程

1、背景

近年来，随着社会的进步和信息通信技术的发展，信息、互联网应用在各行业、各领域快速拓展。这些系统采集、处理、积累的数据越来越多，数据量增速越来越快。数据量每年以爆炸性的速度增长。在互联网出现之前，数据主要是人机会话方式产生的，以结构化数据为主。所以大家都需要传统的rdbms来管理这些数据和应用系统。那时候的数据增长缓慢、系统都比较孤立，用传统基本可以满足各类应用开发。但随着大数据时代的到来，数据逐渐地转变为以非结构、半结构化为主，人们对于数据的使用，不在仅仅局限于业务应用的需求。对信息时代所产生的海量数据进行数据挖掘和分析，已经成为了很多企业获取有价值信息常用手段。传统数据库对这类需求和应用无论在技术上还是功能上都几乎束手无策。传统数据库(oldsql)一统天下变成了oldsql+newsql+nosql+其他新技术(流、实时、内存等)共同支撑多类应用的局面。

2、产品介绍

sequoiadb巨杉数据库，专注新一代大数据基础架构研发，是国内领先的新一代分布式数据库厂商。其产品sequoiadb巨杉数据库是一款支持sql、高并发、实时性、分布式、可扩展、灵活存储的newsql数据库。另外sequoiadb支持spark、hive、hadoop、kafka、postgresql等多种大数据工具的对接。在应用开发方面，sequoiadb除了提供原生的api，还提供了c驱动、c++驱动、csharp驱动、java驱动、php驱动、rest接口等。开发者可以方便快速地使用sequoiadb进行应用开发，本文将介绍如何使用javaapi进行应用开发。

3、使用sequoiadb进行应用开发优势

3.1、存储方式灵活

sequoiadb数据库是一款文档型数据库，使用了json这种格式存储数据，可以有效地提高开发效率。总所周知，在开发大型应用时，会涉及到好多的表，表与表之间的关联关系会特别多，特别是在银行，互联网金融等行业中，由于业务复杂繁多，表与表的关系会极其复杂，使用传统数据库进行开发时，首先需要对表进行关联设计，而复杂表的设计需要投入大量的人力，这不但浪费了金钱，还拖慢了开发的进度。另外在后期维护升级中，经过多次的迭代更新后，表中的字段通常会有所变化，如果需要对某些字段的值进行修改或者删除，很难确定改动后的结果会不会对其他业务系统有所影响，这就要求开发的人很懂业务，提高了开发的门槛。如果使用文档型数据库，由于采用的是json结构存储数据。用户可以采用对象的方式，把业务系统设计的字段存储在一个表中，在涉及表关联时，可以在bson中采用嵌套的方式，把数据存储在其中。这就使得开发者不用花费大量的精力在表的设计中，降低了开发的成本。

另外sequoiadb是一款双引擎数据库，支持json格式存储数据的同时，支持分布式对象存储，可以很好支撑非结构化数据管理。

3.2、低成本的部署

sequoiadb可以安装在x86的机器上，相对于安装在高端存储的数据库，这无疑是一个成本的节约。sequoiadb采用了三副本的存储方式，这有效地保证了数据的安全，另外由于使用分布式，数据被保存到多台服务器中，在查询数据时，查询任务会分发到多台机器上同时进行，最后汇总到同一台机器上汇总，这使得可以充分得利用多台服务器的资源，从而实现低成本的部署而又快速效应的效果。

3.3、支持复合索引

在传统的数据库中，很多产品都是只支持单一索引，而sequoiadb还能支持复合索引。在复杂的业务系统中，数据量通常都很大，在查询数据时，通常需要带上多个查询条件，而且还要求快速响应。这就使得单一的索引查询很难满足业务的需求。sequoiadb可以有效地解决这种问题，开发者可以根据业务的查询习惯，把一些经常需要带上的查询条件统计出来，从而把这些每次查询都必须带上的条件进行复合索引的创建。业务系统在查询时，sequoiadb便会通过索引扫描的方式进行快速查询。

3.4、高安全性

sequoiadb采用了多副本的存储方式，开发者通过规划，把数据散落在不同的数据组中，同一数据组的节点散落在不同的机器上，由于同一数据组的数据是一样的，这使得当服务器出现宕机等故障时，数据库可以快速地把主节点切换到其他的节点上，为业务系统提供服务，同时还能有效地防止数据的丢失。

4、环境搭建

4.1、软件配置

操作系统：windows 8

jdk：1.7.0_80 64位，下载地址为：https://www.oracle.com/technetwork/java/javase/downloads/java-archive-downloads-javase7-521261.html#jdk-7u80-oth-jpr

myeclipse：12.0.0

sequoiadb：2.8.1。安装部署参考：

java驱动：2.6.3，下载地址为：

https://download.sequoiadb.com/cn/ index-cat_id-2

4.2、配置eclipse环境

(1)将 sequoiadb 驱动开发包中的 sequoiadb.jar 文件拷贝到工程文件目录下(建议将其放置在其他所有依赖库目录，如 lib 目录);

(2)在 eclipse 主窗口左侧的“package explore”窗口中，选择开发工程，并点击鼠标右键;

(3)在菜单中选择“properties”菜单项;

(4)在弹出的“property for project …”窗口中，选择“java build path”->“libraries”，如下图所示：

(5) 点击“add external jars..”按钮，选择添加 sequoiadb.jar 到工程中;

(6) 点击“ok”完成环境配置。

5、sequoiadb java开发实例

5.1示例一：列举collection

连接数据库，列举出数据库中的所有collection。

package com.sequoiadb.demo;

import com.sequoiadb.base.dbcursor;

import com.sequoiadb.base.sequoiadb;

import com.sequoiadb.exception.baseexception;

public class demo01 {

public static void main(string[] args) {

try{

string connstr = "192.168.43.237";

string username = "";

string password = "";

//本例程连接到本地数据库的11810端口是协调节点的服务端口，使用的是空的用户名和

//密码。用户需要根据自己的实际情况配置参数。

sequoiadb sdb = new sequoiadb(connstr,username,password);

dbcursor cursor = sdb.listcollections();

try{

while(cursor.hasnext()){

system.out.println(cursor.getnext().tostring());

}

}finally{

cursor.close();

}

}catch (baseexception e) {

system.out.println("sequoiadb driver error, error description:" + e.geterrortype());

}

}

}

5.2示例二：增加查找操作

连接数据库，对数据库中的test表的记录进行增加查找的操作。

package com.sequoiadb.demo;

import org.bson.bsonobject;

import org.bson.basicbsonobject;

import com.sequoiadb.base.collectionspace;

import com.sequoiadb.base.dbcollection;

import com.sequoiadb.base.dbcursor;

import com.sequoiadb.base.sequoiadb;

import com.sequoiadb.exception.baseexception;

public class demo02 {

public static void main(string[] args) {

string connstr = "192.168.43.237:11810";

string username = "";

string password = "";

dbcursor cursor = null;

try {

sequoiadb sdb = new sequoiadb(connstr,username,password);

collectionspace db = sdb.createcollectionspace("space");

dbcollection cl = db.createcollection("collection");

//dbcollection cl = sdb.getcollectionspace("space")

.getcollection("collection");

// 创建一个插入的 bson 对象

bsonobject obj = new basicbsonobject();

obj.put("name", "xiaoming");

obj.put("age", 24);

//添加一条记录

cl.insert(obj);

//查询记录

cursor = cl.query();

try{

while (cursor.hasnext()) {

bsonobject record = cursor.getnext();

string name = (string) record.get("name");

system.out.println("name=" + name);

}

}finally{

cursor.close();

}

} catch (baseexception e) {

system.out.println("sequoiadb driver error, error description:" + e.geterrortype());

}

}

}

5.3示例三：数据连接池的使用

数据库连接池的基本原理是在内部对象池中维护一定数量的数据库连接，并对外暴露数据库连接获取和返回方法。如：外部使用者可通过getconnection 方法获取连接，使用完毕后再通过releaseconnection 方法将连接返回，注意此时连接并没有关闭，而是由连接池管理器回收，并为下一次使用做好准备。

数据库连接池技术带来的优势：

1、资源复用：由于数据库连接得到重用，避免了频繁创建、释放连接引起的大量性能开销。在减少系统　　消耗的基础上，另一方面也增进了系统运行环境的平稳性(减少内存碎片以及数据库临时进程/线程的数量)。

2、更快的系统响应速度：数据库连接池在初始化过程中，往往已经创建了若干数据库连接至于池中备用。此时连接的初始化工作均已完成。对于业务请求处理而言，直接利用现有可用连接，避免了数据库连接　　初始化和释放过程的时间，从而缩减了系统整体响应时间。

3、统一的连接管理，避免数据库连接泄漏：在较为完备的数据库连接池实现中，可根据预先的连接占用超时设定，强制收回被占用连接。从而避免了常规数据库连接操作中可能出现的资源泄漏。

package com.sequoiadb.demo;

import java.util.arraylist;

import org.bson.bsonobject;

import org.bson.basicbsonobject;

import com.sequoiadb.base.collectionspace;

import com.sequoiadb.base.dbcollection;

import com.sequoiadb.base.dbcursor;

import com.sequoiadb.base.sequoiadb;

import com.sequoiadb.base.sequoiadbdatasource;

import com.sequoiadb.datasource.connectstrategy;

import com.sequoiadb.datasource.datasourceoptions;

import com.sequoiadb.exception.baseexception;

import com.sequoiadb.net.configoptions;

public class datasource {

public static void main(string[] args) throws interruptedexception {

arraylist addrs = new arraylist();

string user = "";

string password = "";

configoptions nwopt = new configoptions();

datasourceoptions dsopt = new datasourceoptions();

sequoiadbdatasource ds = null;

// 提供coord节点地址

addrs.add("192.168.43.237:11810");

addrs.add("zxq3:11810");

// 设置网络参数

nwopt.setconnecttimeout(500); // 建连超时时间为500ms。

nwopt.setmaxautoconnectretrytime(0); // 建连失败后重试时间为0ms。

// 设置连接池参数

dsopt.setmaxcount(500); // 连接池最多能提供500个连接。

dsopt.setdeltainccount(20); // 每次增加20个连接。

dsopt.setmaxidlecount(20); // 连接池空闲时，保留20个连接。

dsopt.setkeepalivetimeout(0); // 池中空闲连接存活时间。单位:毫秒。

// 0表示不关心连接隔多长时间没有收发消息。

dsopt.setcheckinterval(60 * 1000); // 每隔60秒将连接池中多于

// maxidlecount限定的空闲连接关闭，

// 并将存活时间过长(连接已停止收发

// 超过keepalivetimeout时间)的连接关闭。

// 向catalog同步coord地址的周期。单位:毫秒。

// 0表示不同步。

dsopt.setsynccoordinterval(0);

// 连接出池时，是否检测连接的可用性，默认不检测。

dsopt.setvalidateconnection(false);

// 默认使用coord地址负载均衡的策略获取连接。

dsopt.setconnectstrategy(connectstrategy.balance);

// 建立连接池

ds = new sequoiadbdatasource(addrs, user, password, nwopt, dsopt);

// 使用连接池运行任务

runtask(ds);

// 任务结束后，关闭连接池

ds.close();

}

static void runtask(sequoiadbdatasource ds) throws interruptedexception {

string clfullname = "mycs.mycl";

// 准备任务

thread createcltask = new thread(new createcltask(ds, clfullname));

thread inserttask = new thread(new inserttask(ds, clfullname));

thread querytask = new thread(new querytask(ds, clfullname));

// 创建集合

createcltask.start();

createcltask.join();

// 往集合插记录

inserttask.start();

thread.sleep(3000);

// 从集合中查记录

querytask.start();

// 等待任务结束

inserttask.join();

querytask.join();

}

}

class createcltask implements runnable {

private sequoiadbdatasource ds;

private string csname;

private string clname;

public createcltask(sequoiadbdatasource ds, string clfullname) {

this.ds = ds;

this.csname = clfullname.split("\\.")[0];

this.clname = clfullname.split("\\.")[1];

}

@override

public void run() {

sequoiadb db = null;

collectionspace cs = null;

dbcollection cl = null;

// 从连接池获取连接池

try {

db = ds.getconnection();

} catch (baseexception e) {

e.printstacktrace();

system.exit(1);

} catch (interruptedexception e) {

e.printstacktrace();

system.exit(1);

}

// 使用连接创建集合

if (db.iscollectionspaceexist(csname))

db.dropcollectionspace(csname);

cs = db.createcollectionspace(csname);

cl = cs.createcollection(clname);

// 将连接归还连接池

ds.releaseconnection(db);

system.out.println("suceess to create collection " + csname + "." + clname);

}

}

class inserttask implements runnable {

private sequoiadbdatasource ds;

private string csname;

private string clname;

public inserttask(sequoiadbdatasource ds, string clfullname) {

this.ds = ds;

this.csname = clfullname.split("\\.")[0];

this.clname = clfullname.split("\\.")[1];

}

@override

public void run() {

sequoiadb db = null;

collectionspace cs = null;

dbcollection cl = null;

bsonobject record = null;

// 从连接池获取连接

try {

db = ds.getconnection();

} catch (baseexception e) {

e.printstacktrace();

system.exit(1);

} catch (interruptedexception e) {

e.printstacktrace();

system.exit(1);

}

// 使用连接获取集合对象

cs = db.getcollectionspace(csname);

cl = cs.getcollection(clname);

// 使用集合对象插入记录

record = genrecord();

cl.insert(record);

// 将连接归还连接池

ds.releaseconnection(db);

system.out.println("suceess to insert record: " + record.tostring());

}

private bsonobject genrecord() {

bsonobject obj = new basicbsonobject();

obj.put("name", "james");

obj.put("age", 30);

return obj;

}

}

class querytask implements runnable {

private sequoiadbdatasource ds;

private string csname;

private string clname;

public querytask(sequoiadbdatasource ds, string clfullname) {

this.ds = ds;

this.csname = clfullname.split("\\.")[0];

this.clname = clfullname.split("\\.")[1];

}

@override

public void run() {

sequoiadb db = null;

collectionspace cs = null;

dbcollection cl = null;

dbcursor cursor = null;

// 从连接池获取连接

try {

db = ds.getconnection();

} catch (baseexception e) {

e.printstacktrace();

system.exit(1);

} catch (interruptedexception e) {

e.printstacktrace();

system.exit(1);

}

// 使用连接获取集合对象

cs = db.getcollectionspace(csname);

cl = cs.getcollection(clname);

// 使用集合对象查询

cursor = cl.query();

try {

while(cursor.hasnext()) {

system.out.println("the inserted record is: " + cursor.getnext());

}

} finally {

cursor.close();

}

// 将连接对象归还连接池

ds.releaseconnection(db);

}

}

由于sequoiadb的javaapi涉及操作众多，在此不一一举例，其他的操作使用大同小异，具体可参考：

https://doc.sequoiadb.com/cn/index/public/home/document/208/api/java/html/index.html

6、sequoiadb对持久层框架的支持

在软件开发中，基本所有的大型应用使用到了框架来进行开发，框架具有复用性，这使得一个应用开发速度得到了大大的提高。类似于mybatis、hibernate等等这些框架对jdbc操作数据库的过程进行封装，使得开发者只需要关注sql本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。sequoiadb数据库的套件sequoiasql是postgresql功能的扩展。通过sequoiasql，用户可以使用sql语句访问sequoiadb数据库，完成对数据库的增删改查等操作。sequoiasql集成持久层框架时，只需要使用到postgresql的jdbc连接驱动即可，其集成过程与其它框架集成postgresql的过程是一样的。

7、小结

随着数据以爆炸性的速度增长，集中式数据库越来越表现出了不足，分布式数据库越来越受到了开发者的青睐。sequoiadb是一款支持sql、高并发、实时性、分布式、可扩展、灵活存储的newsql数据库，支持spark、hadoop、hive、等大数据产品的连接同时提供了多种语言的驱动方便开发者的使用。在选择使用分布式数据库时，sequoiadb无疑是一个很好的选择。