HSQLDB 操作说明

HSQLDB

 

import java.sql.Connection;

import java.sql.DriverManager;

import java.sql.Statement;

import javax.servlet.ServletContext;

import javax.servlet.ServletContextEvent;

import javax.servlet.ServletContextListener;

/**

* @author zhoudong

* @Created on 2005-2-1

* @email:eclipse@sina100.com

*/

public class HSQLDBServletContextListener implements ServletContextListener {

    /*

     * (non-Javadoc)

     *

     * @see javax.servlet.ServletContextListener#contextInitialized(javax.servlet.ServletContextEvent)

     */

    public void contextInitialized(ServletContextEvent evt) {

        try {

            ServletContext context = evt.getServletContext();

            String params = "port=9001;silent=true;trace=false;database.0="

                    + context.getRealPath("/") + "/WEB-INF/tm/hsqldb/tmdb";

            org.hsqldb.Server server = new org.hsqldb.Server();

            server.putPropertiesFromString(params);

            server.setLogWriter(null);

            server.setErrWriter(null);

            server.start();

        } catch (Exception e) {

            System.err.println(e);

        }

    }

    /*

     * (non-Javadoc)

     *

     * @see javax.servlet.ServletContextListener#contextDestroyed(javax.servlet.ServletContextEvent)

     */

    public void contextDestroyed(ServletContextEvent arg0) {

        Connection conn = null;

        try {

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

            conn = DriverManager.getConnection("jdbc:hsqldb:hsql://localhost:9001",

                    "sa", "");

            Statement stmt = conn.createStatement();

            stmt.executeUpdate("SHUTDOWN;");

            stmt.close();

        } catch (Exception e) {

            //

        } finally {

            try {

                conn.close();

            } catch (Exception e) {

                //

            }

        }

    }

    public static void main(String[] args) {

    }

}

工程的web.xml加上这个listener就可以了。

 

一、简介：

hsql数据库是一款纯Java编写的免费数据库，许可是BSD-style的协议，如果你是使用Java编程的话，不凡考虑一下使用它，相对其他数据库 来说，其体积小，才563kb。仅一个hsqldb.jar文件就包括了数据库引擎，数据库驱动，还有其他用户界面操作等内容。在Java开源世界里， hsql是极为受欢迎的（就Java本身来说），JBoss应用程序服务器默认也提供了这个数据库引擎。由于其体积小的原因，又是纯Java设计，又支持 SQL99，SQL2003大部分的标准，所以也是作为商业应用程序展示的一种选择。请到以下地址下载hsql： http://prdownloads.sourceforge.net/hsqldb/hsqldb_1_7_3_3.zip?download

二、使用hsql数据库：

1、hsql数据库引擎有几种服务器模式：常用的Server模式、WebServer模式、Servlet模式、Standlone模式、Memory-Only数据库。

2、最为常用的Server模式：

1)首先却换到lib文件夹下，运行java -cp hsqldb.jar org.hsqldb.Server -database.0 db/mydb -dbname.0 xdb

执行命令后，将会在db文件夹下创建一个数据库mydb，别名（用于访问数据库）是xdb，如果存在mydb数据库，将会打开它。

2)运行数据库界面操作工具：java -cp hsqldb.jar org.hsqldb.util.DatabaseManager

在Type选项里选上相应的服务器模式，这里选择HSQL Database Engine Server模式；Driver不用修改；URL修改为jdbc:hsqldb:hsql://localhost/xdb （主要这里xdb就是上面我们设置的别名）;user里设置用户名，第一次登录时，设置的是管理员的用户名，password设置密码。然后点击Ok。

3)第一次运行数据库引擎，创建数据库完毕。好了，你可以打开db文件夹，会发现里面多了几个文件。

mydb.properties文件：是关于数据库的属性文件。

mydb.script：hsql主要保存的表（这里按hsql的说法是Memory表，就是最为常用的），里面的格式都是文本格式，可以用文本查看，里面的语句都是sql语句，熟悉sql语句的话，你也可以手动修改它。每次运行数据库引擎的话都是从这里加载进内存的。

mydb.lck表示数据库处于打开状态。

其他的请参看hsqldb包里的手册。

3、WebServer模式和Server运行模式基本一样，只是支持了Http等协议，主要用于防火墙，默认端口是9001。启动Server，java -cp hsqldb.jar org.hsqldb.WebServer ...剩余的和上面的一致。

4、Servlet模式可以允许你通过Servlet容器来访问数据库，请查看hsqlServlet.java的源代码，和WebServer类似。

5、另一个值得思考的模式是Standalone模式：不能通过网络来访问数据库，主要是在一个JVM中使用，那样的话，访问的速度会更加快。虽然 文档里面提到主要是用于开发时使用，但是我们可以假设一下，该方法不需要一个引擎类的东西，而类似于打开文件的方式，返回一个Connection对象：

Connection c = DriverManager.getConnection("jdbc:hsqldb:file:mydb", "sa", "");

将会在当前目录找到mydb数据库相关文件，打开并返回一个Connection对象。该方式有点好处就是可以不使用引擎，在需要的时候操作数据。所以那 些对数据库不是特别有要求的，但又需要一个操作数据库的方式的话，可以使用这种方法。对于那些不想额外在数据库引擎花费金钱的话，可以使用这种方法。但是 不推荐使用该方法。记得Hibernate里SessionFactory可以使用openSession(Connecttion c)来获得一个Session对象的，因此，在测试或者实际应用的话都可以这样使用。

6、Memory-Only 数据库：顾名思义，主要是内存中使用，不用于保存数据。可以用于在内存中交换数据。

三、具体的链接与操作的话，和一般的JDBC操作一样。而相应的Server模式的话，连接地址主要你运行数据库界面操作工具时，在URL一栏时默认已经设好了，自己实习一下，对比其中参数。

这篇文章介绍大致内容很详细，不过也大都是从Hsql的帮助上翻译的，我有必要加入点新鲜的血液。

这篇文章美中不足的是缺少实战性，往往初学者第一步都走不出来，比如我。

我在实践中遇到的问题是打开数据库管理器怎么也连接不上数据库，总是说

java.sql.sqlException Socket create error

搞了一个晚上，到第二天早上清醒一下，想起来这个数据库应该在创建库之后，保持那个cmd窗口，在此过程中连接。

 

=================================================================================================

===============

/**
 * 方便单机程序使用HSQL的工具类，包括启动，关闭，连接。数据库默认不加密，用户为sa，密码空
 * @author 郑高强
 */
public class HSQL_Util {

    public static final int PORT = 9002;
    public static final String DB_NAME = "kenko";       //数据库文件名，同时也是本类中的数据库名
    public static final String DB_PATH = "./db/";
    public static final String USER_NAME = "sa";
    public static final String PASSWORD = "";
    public static final int SERVER_MODE = 0;
    public static final int STAND_ALONE_MODE = 1;   //In-Process
    public static int mode = SERVER_MODE;          //记录当前用什么模式，开发时用Server，发布时用standalone

    /**
     * 启动数据库服务
     */
    public static boolean startHSQL() {
        if (mode == SERVER_MODE) {
            Server server = new Server();//它可是hsqldb.jar里面的类啊。
            server.setDatabaseName(0, DB_NAME);
            server.setDatabasePath(0, DB_PATH + DB_NAME);
            server.setPort(PORT);
            server.setSilent(true);
            server.start();         //自动多线程运行
            System.out.println("hsqldb started...");
        } else if (mode == STAND_ALONE_MODE) {
            //standalone模式，打开连接就同时启动数据库，所以这里可以什么都不做
        }

        try {
            Thread.sleep(800);        // 等待Server启动
        } catch (InterruptedException e) {
        }
        return true;
    }

    /**
     * 关闭数据库服务
     */
    public static boolean stopHSQL() {
        try {
            Statement statement = getConnection().createStatement();
            statement.executeUpdate("SHUTDOWN;");
            return true;
        } catch (SQLException ex) {
            Logger.getLogger(HSQL_Util.class.getName()).log(Level.SEVERE, null, ex);
            return false;
        }
    }

    /**
     * 获取连接
     */
    public static Connection getConnection() {
        Connection conn = null;
        try {
            Class.forName("org.hsqldb.jdbcDriver");
            if (mode == SERVER_MODE) {
                conn = DriverManager.getConnection("jdbc:hsqldb:hsql://localhost:" + PORT + "/" + DB_NAME, USER_NAME, PASSWORD);
            } else if (mode == STAND_ALONE_MODE) {
                conn = DriverManager.getConnection("jdbc:hsqldb:file:" + DB_PATH + DB_NAME, USER_NAME, PASSWORD);
            }
        } catch (ClassNotFoundException ex) {
            Logger.getLogger(HSQL_Util.class.getName()).log(Level.SEVERE, null, ex);
        } catch (SQLException ex) {
            Logger.getLogger(HSQL_Util.class.getName()).log(Level.SEVERE, null, ex);
        }
        return conn;
    }

    /**
     * 测试
     */
    public static void main(String[] args) {
        HSQL_Util.mode = HSQL_Util.STAND_ALONE_MODE;
        HSQL_Util.startHSQL();
        Connection conn = HSQL_Util.getConnection();
        try {
            Statement statement = getConnection().createStatement();
            statement.executeUpdate("create table customer(id integer not null primary key,firstname varchar,lastname varchar)");
            for (int i = 10; i < 20; i++) {
                statement.executeUpdate("insert into customer values(" + i + ",'liu','zhaoyang')");
            }
            statement.close();
        } catch (SQLException ex) {
            Logger.getLogger(HSQL_Util.class.getName()).log(Level.SEVERE, null, ex);
        }
        HSQL_Util.stopHSQL();
    }
}

运行上述的类，在项目目录，会生成一个db文件夹，里边有数据库的一些基本文件：

速度测试：

String note = "XXXX";     //这里省略，实际是800个中文字
        System.out.println(note.length());
        HSQL_Util.mode = HSQL_Util.STAND_ALONE_MODE;
        HSQL_Util.startHSQL();
        Connection conn = HSQL_Util.getConnection();
        try {
            Statement statement = getConnection().createStatement();
            statement.executeUpdate("create cached table customer(id integer not null primary key,firstname varchar,lastname varchar)");
            for (int i = 1; i < 60000; i++) {                                 //插入6万条数据用了43秒，生成262M的文件
                statement.executeUpdate("insert into customer values(" + i + ",'" + note + "','zhaoyang')");
            }
            statement.executeQuery("select * from customer where id = 40");     //6万条数据用了9秒
            statement.close();
        } catch (SQLException ex) {
            Logger.getLogger(HSQL_Util.class.getName()).log(Level.SEVERE, null, ex);
        }
        HSQL_Util.stopHSQL();
    }

 

===================================================================

==============================

Hsqldb是一个开放源代码的JAVA数据库，其具有标准的SQL语法和JAVA接口，它可以自由使用和分发，非常简洁和快速的。具有Server模式，进程内模式(In-Process)和内存模式(Memory-Only)三种。运行Hsqldb需要hsqldb.jar包, 它包含了一些组件和程序。每个程序需要不同的命令来运行。它位于项目的lib目录下，目前的版本是1.8.0.5。官方的下载地址是：http://prdownloads.sourceforge.net/hsqldb/hsqldb_1_8_0_5.zip?download

        在介绍这些模式之前我们需要了解一些Hsqldb所涉及的一些文件。每个Hsqld数据库包含了2到5个命名相同但扩展名不同的文件，这些文件位于同一个目录下。例如，名位"test"的数据库包含了以下几个文件：

• test.properties

• test.script

• test.log

• test.data

• test.backup

   

 

  properties文件描述了数据库的基本配置。 script文件记录了表和其它数据库对象的定义。log文件记录了数据库最近所做的更新。data文件包含了cached（缓冲）表的数据，而backup文件是将data文件压缩备份，它包含了data文件上次的最终状态数据。所有这些文件都是必不可少的，千万不可擅自删除。但如果你的数据库没有缓冲表(cached table),test.data和test.backup文件是不会存在。

　　接下来我们对Hsqldb的三种模式进行简单介绍，同时包括部分工具的启动的方式。

一、 Server模式

　Server模式提供了最大的可访问性。应用程序（客户端）通过Hsqldb的JDBC驱动连接服务器。在服务器模式中，服务器在运行的时候可以被指定为最多10个数据库。根据客户端和服务器之间通信协议的不同，Server模式可以分为以下三种：

1、 Hsqldb Serve

　　这种模式是首选的也是最快的。它采用HSQLDB专有的通信协议。启动服务器需要编写批处理命令。Hsqldb提供的所有工具都能以java class归档文件(也就是jar)的标准方式运行。假如hsqldb.jar位于相对于当前路径的../lib下面。我们的命令将这样写：

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

　　现在你可能会疑惑，[-database.0 ]、 [dbname.0]为什么在后面加[0]。_... ...我们不是在前面说服务模式运行的时候可以指定10个数据库吗，如有多个数据库，则继续写命令行参数-database.1 aa -dbname.1 aa -database.2 bb-dbname.2 bb ... ...

　　新建文本文件保存上面命令，文件名可以随意，将后缀名改成bat，然后直接执行批处理文件即可。在以后介绍的执行启动工具的命令采用同样方法。

　　上面启动服务器的命令启动了带有一个（默认为一个数据库）数据库的服务器，这个数据库是一个名为"mydb.*"文件，这些文件就是mydb.Properties、mydb.script、mydb.log等文件。其中demoDB是mydb的别名，可在连接数据库时使用。

2、 Hsqldb Web Server

  　这种模式只能用在通过HTTP协议访问数据库服务器主机，采用这种模式唯一的原因是客户端或服务器端的防火墙对数据库对网络连接强加了限制。其他情况下，这种模式不推荐被使用。

　运行web服务器的时候，只要将刚才命令行中的主类（main class）替换成：org.hsqldb.WebServer

3、 Hsqldb Servlet

    这种模式和Web Server一样都采用HTTP协议，当如Tomcat或Resin等servlet引擎（或应用服务器）提供数据库的访问时，可以使用这种模式。但是Servlet模式不能脱离servlet引擎独立启动。为了提供数据库的连接，必须将HSQLDB.jar中的hsqlServlet类放置在应用服务器的相应位置。

　　Web Server和Servlet模式都只能在客户端通过JDBC驱动来访问。Servlet模式只能启动一个单独的数据库。请注意做为应用程序服务器的数据库引擎通常不使用这种模式。

连接到以Server模式运行的数据库

  当HSQLDB服务器运行时，客户端程序就可以通过hsqldb.jar中带有的HSQLDB JDBC Driver连接数据库。

java 代码

 

1. try{   
2.   
3.          Class.forName("org.hsqldb.jdbcDriver") ;   
4.   
5. }catch(ClassNotFoundException e){   
6.   
7.          e.printStackTrace();     
8.   
9. }   
10.   
11.      Connection c = DriverManager.getConnection("jdbc:hsqldb:hsql://localhost/xdb", "sa", "");   
12.   

 

   注：hsqldb的默认用户是sa密码为空。修改默认密码的方法我们将在工具使用部分做出介绍。

二、 In-Process模式

  In-Process模式又称Standalone模式。这种模式下，数据库引擎作为应用程序的一部分在同一个JVM中运行。对于一些应用程序来说， 这种模式因为数据不用转换和通过网络的传送而使得速度更快一些。其主要的缺点就是默认的不能从应用程序外连接到数据库。所以当应用程序正在运行的时候，你不能使用类似于Database Manager的外部工具来查看数据库的内容。在1.8.0版本中，你可以从同一个JVM的一个线程里面来运行一个服务器实例，从而可以提供外部连接来访问你的In-Process数据库。

　　推荐的使用In-Process模式方式是：开发的时候为数据库使用一个HSQLDB 服务器实例，然后在部属的时候转换到In-Process内模式。

　　一个In-Process模式数据库是从JDBC语句开始启动的，在连接URL中带有指定的数据库文件路径作为JDBC的一部分。例如，假如数据库名称为testdb，它的数据库文件位于与确定的运行应用程序命令相同的目录下，下面的代码可以用来连接数据库：

　　Connection c = DriverManager.getConnection("jdbc:hsqldb:file:testdb ", "sa", "");

    数据库文件的路径格式在Linux主机和Windows主机上都被指定采用前斜线("/"）。所以相对路径或者是相对于相同分区下相同目录路径的表达方式是一致的。使用相对路径的时候，这些路径表示的是相对于用于启动JVM的shell命令的执行路径。

三、Memry-Only数据库

 

　　Memory-Only数据库不是持久化的而是全部在随机访问的内存中。因为没有任何信息写在磁盘上。这种模式通过mem:协议的方式来指定：

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

　　你也可以在server.properties中指定相同的URL来运行一个Memory-Only（仅处于内存中）服务器实例。

　　注意事项：当一个服务器实例启动或者建立一个in-process数据库连接的时候，如果指定的路径没有数据库存在，那么就会创建一个新的空的数据库。这个特点的副作用就是让那些新用户产生疑惑。在指定连接已存在的数据库路径的时候，如果出现了什么错误的话，就会建立一个指向新数据库的连接。为了解决这个问题，你可以指定一个连接属性ifexists=true只允许和已存在的数据库建立连接而避免创建新的数据库，如果数据库不存在的话，getConnection()方法将会抛出异常。

四、 工具的使用

 

　Hsqldb提供的主要的工具类：

• org.hsqldb.util.DatabaseManager

• org.hsqldb.util.DatabaseManagerSwing

• org.hsqldb.util.Transfer

• org.hsqldb.util.QueryTool

• org.hsqldb.util.SqlTool

　　其中DatabaseManage和Sql Tool，只能用命令行参数来运行。你可以在命令行后面加上参数-?来查看这些工具可用的参数列表。其他工具可以通过DatabaseManager的主界面启动，便于交互式操作。

　　为了便于操作，我们同样把这些工具启动的命令做成批处理文件。方法和前面我们所介绍的创建启动服务模式命令的方法一样。在这里我们再强调一次hsqldb.jar的位置，因为所有启动命令都是参照hsqldb.jar的位置编写的

　　如果您觉得麻烦你也可以采用绝对路径编写命令。

　　现在我们一起运行AWT版本的DatabaseManager工具，hsqldb.jar位于相对于当前路径的../lib下面，命令如下:

　　Java -cp ../lib/hsqldb.jar org.hsqldb.util.DatabaseManager

　　将命令保存为后缀名为bat的批处理文件，保存为DatabaseManager.bat，也可根据个人习惯命名。执行DatabaseManager.bat你将看到如下画面：。

 

        现在对这个简洁的登录界面做个简单的介绍*_*

• Recent：选择你最近的登录方案，[可选]

• Setting Name：本次登录方案名称，如果本次登录成功，那么等你下次登录的时候在Recent下拉列表中将看到你的成功登录方案[可选]

• Type：登录模式，其中包括In-Memory模式、Standalone(In-process)模式、Server模式、WebServer模式... ...[必选]

• Driver：连接数据库的驱动程序[必选]

• URL：连接数据库的URL[必选]

• User：用户名[必选]

• Password：密码[ 除非密码为空]

　　注：如果Type项选择Server模式或者WebServer模式需要你事先启动与之对应的服务模式。而Standalone(In-process)默认是不支持DatabaseManager连接的，具体原因我们已经在前面解释过。至于In-Memory可以随意登录，所有的操作数据都不会记录在本地磁盘。而Type还有很多其他选项，具体的用法可以参考官方文档，位置在hsqldb目录\doc\guide\ guide.pdf。

　　如果你想运行DatabaseManagerSwing也很简单，相信你已经想到了。我们只需要把启动DatabaseManager命令修改成：

　　Java -cp ../lib/hsqldb.jar org.hsqldb.util. DatabaseManagerSwing

　　两种工具的操作方法类似，这里就不再赘述。

        差点忘记，前面我说过要给出修改sa用户密码的方法。最后再占用大家一点点时间。当你用SA通过DatabaseManager登录成功后会出现如下界面：

      在右上方的空白区域输入set password "newpassword" 点击执行即可。

　 到这里我们对Hsqldb的简单介绍就结束了。