HSQLDB安装与使用

HSQLDB是一个轻量级的纯Java开发的开放源代码的关系数据库系统，其体积小，占用空间小，使用简单，支持内存运行方式等特点。可以在

http://sourceforge.net/projects/hsqldb/files/

下载最新的HSQLDB版本。我这里下载的是HSQLDB 2.2.7版本。下载完之后，把它解压到任一目录下，如E:\hsqldb下，完成安装工作。

Hsqldb有四种运行模式：

一、内存（Memory-Only）模式：所有的数据都将在内存中完成，如果程序退出，则相应的数据也将同时被销毁。连接JDBC的实例为：jdbc:hsqldb:mem:dbname

二、进行（In-Process）模式：此模式从应用程序启动数据库，由于所有的数据都将写到文件中，所以，即使程序退出，数据也不会被销毁。In-Process不需要另外启动，可以通过

DriverManager.getConnection("jdbcUriName","username","password");

方式即可启动数据库。连接JDBC的实例为：

jdbc:hsqldb:file:/E:/hsqldb/data/dbname
jdbc:hsqldb:file:/opt/db/dbname
jdbc:hsqldb:file:dbname

三、服务器模式：此模式下HSQLDB跟其它数据库服务器一样，需要通过服务器的形式来进行启动，可以通过

java -classpath ../lib/hsqldb.jar org.hsqldb.server.WebServer –database.0 testdb –dbname.0 testdbName

的命令启动一个守护进程。连接JDBC的实例为：

jdbc:hsqldb:hsql://localhost:port/dbname

四、Web服务器模式：此模式以WEB服务器的形式启动，并通过HTTP协议接受客户端命令。从1.7.2版本开始，Web服务器模式的HSQLDB开始支持事务处理。可以通过

java -classpath ../lib/hsqldb.jar org.hsqldb.WebServer –database.0 testdb –dbname.0 testdbname

的命令来启动。

重点讨论hsqldb服务器模式的启动方法和连接和实际java程序的JDBC连接情况。假设JDK已经安装到机器上，环境变量等都正确设置。

首先在E:\hsqldbTest目录下建立两个子目录，data和lib目录，data用来存放数据，lib用来管理jar包。将解压之后的hsqldb中的lib目录下的hsqldb.jar文件拷贝到E:\hsqldbTest\lib目录下。

1．在hsqldbTest目录下创建runServer.bat文件，其内容为：

cd ..\data
@java -classpath ../lib/hsqldb.jar org.hsqldb.server.Server

2．保存runServer.bat文件，并双击运行该文件，此时回弹出命令行窗口，如下图，表示已启动HSQLDB数据库。

此时，在data目录下产生了三个文件，如：

test.lck——标识数据库锁状态。

test.log——运行数据库产生的log信息，它将记录每一个运行和用户操作环节。

test.properties——数据库的配置信息，包括分配的内存大小等，可更具需要修改。

注：如果在命令行窗口中按下[Ctrl] + [C]组合键，数据库将退出并关闭。

在做第三步时，千万不能关闭runServer.bat

3．再创建runManager.bat文件，用来启动图形界面管理工具，其内容为：

cd ..\data
@java -classpath ..\lib\hsqldb.jar org.hsqldb.util.DatabaseManager

4．保存runManager.bat文件，并双击文件，此时回弹出图形界面（注意，在进行这一不之前，必须确保第二步已执行），如下图。

Recent：将会列出最近的数据库配置

Setting Name:设置名称，这里不需要填写

Type：选择服务器模式（HSQL Database Engine Server）

Driver：驱动名称，不需要修改

URL：JDBC连接，无需修改

User：用户名,根据需要设置

Password：密码，根据需要设置

5．点击【OK】按钮，即可连接到test数据库。如下图所示。

此时，我们可以在窗口中创建表等操作，例如，我们创建一个TBL_USERS的表。在菜单栏中选择COMMAND->CREATE TABLE命令，此时在右下文本框中显示创建表的命令，包括各式，支持的类型等。我们创建的TBL_USERS表结构如下图所示：

CREATE TABLE TBL_USERS(
         ID INTEGER NOT NULL PRIMARY KEY,
         FIRST_NAME VARCHAR(20),
         LAST_NAME VARCHAR (30),
         LOGIN_DATE DATE
 )

6．点击【Execute】按钮，如果无语法错误，SQL语句将正常执行，此时，选择菜单栏中的View-> Refresh Tree命令，左侧栏中将显示创建的TBL_USERS。如下图所示。并且查看test.log文件，创建表的过程都将全部记录。

7．另外还可以用DatabaseManagerSwing工具启动图形界面。创建runManagerSwing.bat文件，内容为：

cd ..\data
@java -classpath ..\lib\hsqldb.jar org.hsqldb.util.DatabaseManagerSwing

保存文件，双击该文件，将启动Swing图形界面，如下图所示，具体的操作过程和DatabaseManager工具类似，不再重复。

以上就是启动hsqldb数据库和创建表的整个过程，其它的功能可以通过多次联系即可掌握。按照以上操作方式，hsqldb将自动产生一个test的数据库。但是有时候我们需要自己指定数据库，数据库访问名，数据库访问端口等，该如何实现呢，很简单。只要在相对根目录下创建一个server.properties文件即可。

创建自己制定的数据库：

1.首先在E:\hsqldbTest目录下创建一个server.properties文件，文件内容为（注：在实际文件中，删除后面的注释内容）：

server.port = 9001 　　　　　　　　　　#指定端口号为9001
server.database.0 = file:data/mydb  #将在data目录下创建mydb数据库
server.dbname.0 = mydb           　 #指定数据库名，jdbc连接时就是用此名称
server.silent = true

2.在E:\hsqldbTest目录下创建runServer2.bat文件，文件内容为

cd ..\data
@java -classpath ../lib/hsqldb.jar org.hsqldb.server.Server -port 9001 -database.0 file:../data/mydb -dbname.0 mydb

3.双击运行runServer2.bat文件，将会在data目录下创建mydb数据库，并启动数据库。

4.双击运行已创建好的runManagerSwing.bat文件，打开图形管理界面，并设置连接到mydb数据库中，如下图所示：

5.配置好选项，点击OK按钮，即可连接到mydb数据库，在窗口中可以按照以前的步骤创建表，添加记录等操作。

好了，以上就是整个hsqldb的安装、启动、创建表等的全过程，在这里特别说明的是，hsqldb.2.2.7 是用JDK.1.5以上的版本的编译的，所以，如果你使用的是低于jdk1.5的版本时，可能出现异常情况，不能正常使用。另外，即使你安装的jdk版本是1.5以上的，可能还会出现异常，该如何办呢，此时，确保你的hsqldb是在官方网站下载的，需要检查你的java的环境变量，由于你的机器可能安装有oracle，很有可能出现问题，此时只需将%JAVA_HOME%\bin路径放置在path路径的最开头，这样，就不会出现异常情况了。

接下来，我们通过一个具体的java程序来连接建立好的mydb数据库，并且在mydb数据库中创建一个TBL_USERS的表。并插入一条记录。

1. 在E:\hsqldbTest目录下创建一个HsqlDemo.java文件，内容如下：

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.Statement;
import org.hsqldb.jdbcDriver;
public class HsqlDemo {
public static void main(String[] args) {
try {
            Class.forName("org.hsqldb.jdbcDriver");
            Connection c = DriverManager.getConnection("jdbc:hsqldb:hsql://localhost:9001/mydb", "sa", "");
if (c != null) {
                System.out.println("Connected db success!");
                String sql = "CREATE TABLE TBL_USERS(ID INTEGER, NAME VARCHAR, BIRTHDAY DATE);";
                Statement st = c.createStatement();
                st.execute(sql);
                sql = "INSERT INTO TBL_USERS(ID, NAME, BIRTHDAY) VALUES ('1', 'ADMIN', SYSDATE);";
                st.executeUpdate(sql);
if (st != null) {
                    st.close();
                }
                c.close();
            }
        } catch(Exception e) {
            System.out.println("ERROR:failed to load HSQLDB JDBC driver.");
            e.printStackTrace();
return;
        }
    }   
}

2.在E:\hsqldbTest目录下建立一个runJava.bat文件，用来运行HsqlDemo.java内容如下：

@echo off
set path = C:\Program Files\Java\jdk1.6.0_05\bin     #jdk的路径
javac -classpath ../lib/hsqldb.jar HsqlDemo.java
java  -classpath ../lib/hsqldb.jar;./ HsqlDemo    # 注意./ 后面的空格，./[空格] HsqlDemo

3.确定mydb数据库已经启动，如果没有，运行runServer2.bat，启动数据库。

4.运行runJava.bat文件，运行程序，如果无异常产生，说明已正确执行，此时，可以在mydb.log文件中看到创建的TBL_USERS，插入的记录，当然，可以用图形工具查看表。

OK，以上就是所有的hsqldb启动过程和连接jdbc的过程。假设我们需要创建/启动一个名为mydb的数据库。为了操作方便等，我们在c:/hsqldb目录下创建mydb目录。

1，创建runMydb.bat文件，文件内容为：

java -classpath ../lib/hsqldb.jar org.hsqldb.server.Server -database mydb

或

java -classpath ../lib/hsqldb.jar org.hsqldb.server.Server -database.0 mydb -dbname.0 mydb 

启动runMydb.bat命令即可

2，创建manageMydb.bat文件，内容：

java -classpath ../lib/hsqldb.jar org.hsqldb.util.DatabaseManager -url jdbc:hsqldb:hsql://localhost/mydb 

启动manageMydb.bat，即可启动HSQLDB的图形界面管理工具

Hsqldb 的主要工具类：

org.hsqldb.util.DatabaseManager 
org.hsqldb.util.DatabaseManagerSwing 
org.hsqldb.util.Transfer 
org.hsqldb.util.QueryTool 
org.hsqldb.util.SqlTool 

使用JDBC连接HSQLDB数据库

Java语言通过JDBC使用HSQLDB数据库非常简单：
1，将 hsqldb.jar 加入到classpath
2，通过 Class.forName("org.hsqldb.jdbcDriver"); 初始化hsqldb的jdbc驱动
3，通过 DriverManager.getConnection(hsqldb-url, user, password); 取得HSQLDB数据库的连接

使用例：

        try {
            Class.forName("org.hsqldb.jdbcDriver");
        } catch (Exception e) {
            System.out.println("ERROR:failed to load jdbc driver");
            e.printStackTrace();
return;
        }
        Connection conn = DriverManager.getConnection("jdbc:hsqldb:hsql://localhost/mydb");

其中，jdbc:hsqldb:hsql://localhost/xdb需要替换为合适的jdbc-url。
有关JDBC-URL的详细描述请参考HSQLDB的四种运行模式

在Hibernate里使用HSQLDB
著名的ORM工具Hibernate也提供了对HSQLDB数据库的支持。需要在Hibernage里使用HSQLDB，只需在hibernate.cfg.xml里加入类似如下设置：

<hibernate-configuration>
<session-factory>
<property name="show_sql">true</property>
<property name="connection.driver_class">org.hsqldb.jdbcDriver</property>
<property name="connection.url">jdbc:hsqldb:hsql://localhost/mydb</property>
<property name="connection.username">SA</property>
<property name="connection.password"></property>
<property name="dialect">org.hibernate.dialect.HSQLDialect</property>
<mapping resource="Customer.hbm.xml" />
</session-factory>
</hibernate-cofiguration>

其余就跟其他数据库的用法一样了，这里不再详述。