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>

其余就跟其他數據庫的用法一樣了，這里不再詳述。