H2數據庫攻略之三-結合Maven

上一節我們介紹了H2database是什麼以及簡單的應用，本文將進一步深入，將H2應用到以Maven管理的項目中。

一、引入Maven依賴
在maven中定義H2數據庫的版本屬性

<properties>
    <h2.version>1.3.172</h2.version>
</properties>

添加H2依賴

<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <version>${h2.version}</version>
    <scope>test</scope>
</dependency>

二、運行方式

1、在內存中運行
數據庫只在內存中運行，關閉連接後數據庫將被清空，適合測試環境

連接字符串：

jdbc:h2:mem:DBName;DB_CLOSE_DELAY=-1

如果不指定DBName，則以私有方式啓動，只允許一個連接

2、嵌入式
數據庫持久化存儲爲單個文件

連接字符串：

jdbc:h2:file:~/.h2/DBName;AUTO_SERVER=TRUE

~/.h2/DBName表示數據庫文件的存儲位置，如果第一次連接則會自動創建數據庫

3、服務模式
H2支持三種服務模式：

web server：此種運行方式支持使用瀏覽器訪問H2 Console
TCP server：支持客戶端/服務器端的連接方式
PG server：支持PostgreSQL客戶端
啓動tcp服務連接字符串示例：

jdbc:h2:tcp://localhost/~/test 使用用戶主目錄

jdbc:h2:tcp://localhost//data/test 使用絕對路徑

4、連接字符串參數
DB_CLOSE_DELAY：要求最後一個正在連接的連接斷開後，不要關閉數據庫
MODE=MySQL：兼容模式，H2兼容多種數據庫，該值可以爲：DB2、Derby、HSQLDB、MSSQLServer、MySQL、Oracle、PostgreSQL
AUTO_RECONNECT=TRUE：連接丟失後自動重新連接
AUTO_SERVER=TRUE：啓動自動混合模式，允許開啓多個連接，該參數不支持在內存中運行模式
TRACE_LEVEL_SYSTEM_OUT、TRACE_LEVEL_FILE：輸出跟蹤日誌到控制檯或文件， 取值0爲OFF，1爲ERROR（默認值），2爲INFO，3爲DEBUG
SET TRACE_MAX_FILE_SIZE mb：設置跟蹤日誌文件的大小，默認爲16M
5、啓動服務模式，打開H2 Console web頁面
啓動服務，在命令行中執行

java -cp h2*.jar org.h2.tools.Server

執行如下命令，獲取選項列表及默認值

java -cp h2*.jar org.h2.tools.Server -?

常見的選項如下：

-web：啓動支持H2 Console的服務
-webPort ：服務啓動端口，默認爲8082
-browser：啓動H2 Console web管理頁面
-tcp：使用TCP server模式啓動
-pg：使用PG server模式啓動
此外，使用maven也可以啓動H2服務

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>1.0.0</modelVersion>
    <version>1.0.0</version>
    <groupId>groupid</groupId>
    <artifactId>h2-console</artifactId>
    <name>H2 Console</name>
    <packaging>pom</packaging>

    <properties>
        <h2.version>1.3.172</h2.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>com.h2database</groupId>
            <artifactId>h2</artifactId>
            <version>${h2.version}</version>
            <scope>runtime</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.codehaus.mojo</groupId>
                <artifactId>exec-maven-plugin</artifactId>
                <executions>
                    <execution>
                        <goals>
                            <goal>java</goal>
                            </goals>
                    </execution>
                </executions>
                <configuration>
                    <mainClass>org.h2.tools.Server</mainClass>
                    <arguments>
                        <argument>-web</argument>
                        <argument>-webPort</argument>
                        <argument>8090</argument>
                        <argument>-browser</argument>
                    </arguments>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

在命令行中執行如下命令啓動H2 Console

mvn exec:java

或者建立一個bat文件

@echo off
call mvn exec:java
pause

此操作相當於執行了如下命令：

java -jar h2-1.3.168.jar -web -webPort 8090 -browser

三、應用程序配置

1、Properties配置
java應用程序關於數據庫的Properties配置文件示例如下：

#h2 database settings
jdbc.driver=org.h2.Driver
jdbc.url=jdbc:h2:file:~/.h2/quickstart;AUTO_SERVER=TRUE;DB_CLOSE_DELAY=-1
jdbc.username=sa
jdbc.password=sa

#connection pool settings
jdbc.pool.maxIdle=5
jdbc.pool.maxActive=40

2、初始化數據庫
（1）、在Maven中初始化數據庫

可以創建一個Profile，專門用於初始化數據庫。在maven中可以通過maven-antrun-plugin執行ant任務，在ant任務中使用sql標籤可以執行sql腳本文件，配置示例如下：

    <profile>
        <id>refresh-db</id>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-antrun-plugin</artifactId>
                    <configuration>
                        <target>
                            <property file="src/main/resources/application.properties" />
                            <sql driver="${jdbc.driver}" url="${jdbc.url}" userid="${jdbc.username}" password="${jdbc.password}" onerror="continue" encoding="${project.build.sourceEncoding}">
                                <classpath refid="maven.test.classpath" />
                                <transaction src="src/main/resources/sql/h2/schema.sql"/>
                                <transaction src="src/test/resources/data/h2/import-data.sql"/>
                            </sql>
                        </target>
                    </configuration>
                </plugin>
            </plugins>
        </build>
    </profile>

執行如下命令調用該Profile，初始化數據庫

mvn antrun:run -Prefresh-db

（2）、在Spring中初始化數據庫

Spring Profile和maven profile一樣，也可以模擬不同的開發環境。在Spirng中可以通過jdbc:initialize-database初始化數據庫，配置示例如下

<beans profile="test">
    <context:property-placeholder ignore-resource-not-found="true"
        location="classpath*:/application.properties,
                  classpath*:/application.test.properties" />    

    <!-- Spring Simple連接池 -->
    <bean id="dataSource" class="org.springframework.jdbc.datasource.SimpleDriverDataSource">
        <property name="driverClass" value="${jdbc.driver}" />
        <property name="url" value="${jdbc.url}" />
        <property name="username" value="${jdbc.username}" />
        <property name="password" value="${jdbc.password}" />
    </bean>

    <!-- 初始化數據表結構 -->
    <jdbc:initialize-database data-source="dataSource" ignore-failures="ALL">
        <jdbc:script location="classpath:sql/h2/schema.sql" />
        <jdbc:script location="classpath:data/h2/import-data.sql" encoding="UTF-8"/>
    </jdbc:initialize-database>
</beans>