HSQLDB

HSQLDB

 

前几天做个一个演示的程序，为了方便移植，选择使用 HSQL 作为数据库。HSQL使用 java 语言编写的免费数据库，相对其他数据库，体积很小，是一个非常轻量级的数据库。不需要安装，而且支持嵌套查询和Indentity主键。

下面结合在程序中使用，对 HSQL 作个简要的介绍和使用。

一 简介

HSQL 主要分为 Server，Standlone，Memory-On ，web服务模式四种方式。

(1) Memory-Only Databases  不做持久化，无密码，不允许远程访问。

url = jdbc:hsqldb:em:dataname  

该模式不保存数据到硬盘上，只是在内存中作数据交换，应用程序退出后则数据被销毁，启动方式：

Connection c = DriverManager.getConnection("jdbc:hsqldb:mem:myDbName", "sa", "")。

(2) Hsqldb Server  支持持久化 ，可以设置密码（设置密码修改test.script文件的user表中的值即可），允许远程访问。  该模式和其他数据库服务器一样，以服务器的形式被启动。

url = jdbc:hsqldb:hsql://server:9001/dataname  

启动方式：

java -cp ../lib/hsqldb.jar org.hsqldb.Server -database.0 mydb -dbname.0 myDbName

(3) In-Process (Standalone) Mode   进程模式支持持久化 ，可将数据存储在本地文件中，可以设置密码（设置密码修改test.script文件的user表中的值即可），不允许远程访问。

该模式因为不用网络连接，在 JVM 中使用，所以可以获得更高的速度。而且不需要用户手工启动数据库。缺点是不可以用DB 工具 察看数据库的当前情况。因此开发时还是推荐使用Server模式。

 In-Process使用的时候不用起服务，直接用JDBC Driver连接URL：

启动方式：

jdbc:hsqldb:file: dataname

 如果db file不在当前目录，可以写为

jdbc:hsqldb:file:path/dataname

(4) Web服务器模式 该模式以WEB服务器的形式启动，并通过HTTP协议接受客户端命令。从1.7.2开始，WEB服务器模式开始支持事务。

java -cp ../lib/hsqldb.jar org.hsqldb.WebServer -database.0 mydb -dbname.0 myDbName

 

二 使用

(1) 可以到 http://hsqldb.org/ 上下载到其最新的稳定版本。截至笔者写稿的日期，The latest stable version 为 1.8.0.8。

       一个hsqldb.jar文件包括了数据库引擎，数据库驱动，还有其他用户界面操作等内容。

(2) 笔者所使用的是 Memory-Only Databases  用户名为 sa，密码为空。

由于笔者做的是 Web 程序演示，所以可以把数据库引擎和web 容器绑定，在启动Web 服务时启动数据库。

测试是否连接：

Class.forName("org.hsqldb.jdbcDriver");

Connection conn = DriverManager.getConnection("jdbc:hsqldb:mem:.",  "sa", "");

conn.close();

写一个 HSQL 的监听器扩展类。

import java.sql.Connection;

import java.sql.DriverManager;

import java.sql.Statement;

import java.util.ResourceBundle;

 

import javax.servlet.ServletContext;

import javax.servlet.ServletContextEvent;

import javax.servlet.ServletContextListener;

 

import org.hsqldb.Server;

 

public class RunHSQLListener implements ServletContextListener {

    private String driver = "";

    private String url = "";

    private String username ="";

    private String password = "";

    private String hsqlUrl = "";

 

    public void contextInitialized(ServletContextEvent event) {

       ServletContext context = event.getServletContext();

       context.log("开始启动HSQL数据库..");

       try {

           ResourceBundle resourceBundle = ResourceBundle

                  .getBundle ("properties.data");

           driver = resourceBundle.getString("driver");

           username = resourceBundle.getString("username");

           password = resourceBundle.getString("password");

           hsqlUrl = resourceBundle.getString("hsqlUrl");

           String databaseName = resourceBundle.getString("databaseName");

           int port = Integer.parseInt (resourceBundle.getString("port"));

           url = hsqlUrl + port + "/" + databaseName;

           Server server = new Server();

           server.setDatabaseName(0, databaseName);

           server.setPort(port);

           server.setSilent(true );

           server.start();

           context.log("成功启动HSQL数据库");

       } catch (Exception ex) {

           System.out .println("启动错误=" + ex);

       }

    }

 

    public void contextDestroyed(ServletContextEvent event) {

       ServletContext context = event.getServletContext();

       Connection conn = null ;

       try {

           Class.forName (driver);

           conn = DriverManager.getConnection (url, username, password);

           Statement stmt = conn.createStatement();

           stmt.executeUpdate("SHUTDOWN;");

           stmt.close ();

       } catch (Exception e) {

       } finally {

           try {

              conn.close();

              context.log("关毕 HSQL 数据库..");

           } catch (Exception e) {

           }

       }

    }

}

同时在web.xml中配置
<listener>
<listener-class>com.iplan.portal.framework.web.HsqlListener</listener-class>
</listener>
这样在启动web容器的时候，同时启动了hsqldb，关闭容器的时候同时也关掉hsqldb。

（3）其它的操作，和一般的JDBC操作相同,将 hsqldb.jar 添加到 classpath 中即可。

 

三 和 Hibernage 集成使用

在hibernate.cfg.xml 中

<hibernate-configuration>
    <session-factory>
        <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>

    </session-factory>
</hibernate-configuration>

也可以将相应值放在属性文件里，在加载到配置文件中。

 

四 HSQLDB 服务器模式的启动方法

服务器模式的启动方法。假设我们需要创建/启动一个名为mydb的数据库。
操作方法：

(1) 在c:\hsqldb目录下创建mydb目录，用于存放数据。

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

java -cp ..\lib\hsqldb.jar org.hsqldb.Server -database mydb

或

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

启动runMydb.bat命令即可
(2) 通过图形界面管理，创建manageMydb.bat文件，内容：

java -cp ..\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

参考文档 ：http://hsqldb.sourceforge.net/web/hsqlDocsFrame.html