H2 数据库使用教程

在Java项目中嵌入H2数据库并启动它,通常有以下几种方式:

1. 使用JDBC URL连接

在你的Java代码中,你可以直接使用JDBC URL来连接到H2数据库。如果你的H2数据库文件已经存在,你可以使用如下代码:

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.SQLException;

public class H2DatabaseStarter {
    public static void main(String[] args) {
        String dbUrl = "jdbc:h2:file:/path/to/your/h2db;DB_CLOSE_DELAY=-1;"; // 替换为你的H2数据库文件路径
        try {
            // 加载H2数据库驱动
            Class.forName("org.h2.Driver");
            // 建立连接
            try (Connection connection = DriverManager.getConnection(dbUrl, "user", "password")) {
                System.out.println("Connected to the H2 database successfully.");
                // 这里可以执行更多的数据库操作
            }
        } catch (ClassNotFoundException e) {
            System.out.println("H2 JDBC Driver not found.");
            e.printStackTrace();
        } catch (SQLException e) {
            System.out.println("Connection to H2 database failed.");
            e.printStackTrace();
        }
    }
}

2. 使用H2的Servlet容器

如果你的项目是一个Web应用,你可以使用H2的Servlet容器来启动H2数据库,并允许通过Web浏览器访问数据库。这通常涉及到在你的web.xml文件中配置一个servletservlet-mapping

<servlet>
    <servlet-name>H2Console</servlet-name>
    <servlet-class>org.h2.server.web.WebServlet</servlet-class>
    <init-param>
        <param-name>webAllowOthers</param-name>
        <param-value>true</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>H2Console</servlet-name>
    <url-pattern>/h2-console/*</url-pattern>
</servlet-mapping>

3. 使用Spring Boot

如果你的项目是基于Spring Boot的,你可以在application.propertiesapplication.yml文件中配置H2数据库:

# application.properties
spring.datasource.url=jdbc:h2:file:./h2db;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=false
spring.datasource.driverClassName=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect

# H2 Console settings
spring.h2.console.enabled=true
spring.h2.console.path=/h2-console
spring.h2.console.settings.web-allow-others=true

这样配置后,Spring Boot会自动配置数据源,并在启动时连接到H2数据库。同时,H2的Web控制台也会被启用,你可以通过访问http://localhost:8080/h2-console来访问数据库。

4. 程序化启动H2服务器

如果你需要更细粒度的控制,或者想要在程序中动态启动和停止H2服务器,你可以使用H2提供的Server类:

import org.h2.tools.Server;

public class H2ServerStarter {
    public static void main(String[] args) throws Exception {
        // 启动H2的Web控制台和TCP服务器
        Server.createTcpServer("-tcp", "-tcpAllowOthers", "-tcpPort", "9092").start();
        Server.createWebServer("-web", "-webAllowOthers", "-webPort", "8082").start();

        System.out.println("H2 Server started. Press Enter to stop...");
        System.in.read();
        Server.shutdown();
    }
}

这段代码会启动H2的TCP服务器和Web服务器,允许其他主机访问。你可以根据需要调整参数。

以上是几种在Java项目中嵌入并启动H2数据库的方法。根据你的项目需求和配置选择合适的方法。

启动方式
启动数据库
1.命令行启动
java -cp h2* jar org.h2. tools.Server
如果在控制台无法创建数据库可以采用如下启动方式
java -cp h2*.jar org.h2.tools.Server -ifNotExists

2.应用程序内启动
用java代码启动
H2数据库启动时支持多种参数,以下是一些常用的参数及其说明:

  1. -tcp:启动H2数据库的TCP服务器模式。

  2. -tcpPort:指定TCP服务器监听的端口。例如,-tcpPort 9092

  3. -tcpPassword:设置TCP服务器的密码。

  4. -tcpAllowOthers:允许其他主机访问H2数据库服务器。

  5. -ifNotExists:如果指定的数据库不存在,则创建一个新的数据库。

  6. -tcpSSL:启用SSL加密的TCP服务器。

  7. -pgPort:启动H2数据库的PostgreSQL兼容模式的服务器,并指定端口。

  8. -baseDir:设置H2数据库文件的存储目录。

  9. -trace:启用SQL日志记录功能。

  10. -web:启动H2的Web控制台。

  11. -webPort:指定Web控制台监听的端口。

  12. -webAllowOthers:允许其他主机访问H2的Web控制台。

  13. -lazy:延迟数据库初始化,直到首次连接。

这些参数可以组合使用,以满足不同的启动需求。例如,如果你想要启动一个允许其他主机访问的TCP服务器,并设置密码和端口,可以使用如下参数组合:-tcp -tcpPort 9092 -tcpPassword yourPassword -tcpAllowOthers

JAVA 项目中使用 H2 数据库
为什么要使用H2数据库
H2数据库是可以嵌入到JAVA项目中的,因为只需要导入一个jar包即可,所以非常的方便。
项目中导入H2
将H2的jar包放到classpath里即可,我是用的maven,maven的配置如下

com.h2database
h2
1.4.192

版本我用的现在的最新版
然后需要修改JDBC的配置,主要是下面两个属性跟其他数据库(如MySQL)不同,其他都一样
org.h2.Driver
jdbc:h2:tcp://localhost/~/test
上面jdbc:h2:tcp://localhost/~/test中的test是数据库的名字,H2默认如果数据库不存在的话,会自动创建一个数据库的。
我用的是hibernate,所以还要修改一下Dialect的配置
org.hibernate.dialect.H2Dialect
到这为止,项目里面就可以使用H2了。
使用WEB控制台管理H2数据库
建表、建数据的话,可以通过H2自带的WEB控制台来做(当然H2也提供命令行的方式)
WEB控制台可以通过命令行来启动,但为了方便,可以从H2官网上下载一个安装包,运行里面的bat文件直接启动。

H2\bin目录

这是H2安装完以后bin目录下的内容,运行h2w.bat打开web控制台

H2 web控制台Login画面
点Connect
之后的玩法就跟其他数据库差不多了,可以点击下面的Sample SQL Script部分来感受一下建表和插入数据等,help命令,可以显示所有的命令。关于命令的详细可以去H2官网里面看。

H2 控制台
关于H2 数据库的连接方式
连接H2数据库有以下方式

  • 服务式 (Server)
  • 嵌入式(Embedded)
  • 内存(Memory)
    还没太仔细研究,到目前的理解:
嵌入式的话,就是这个H2数据库只能给一个应用使用,连接是有排他机制的。当一个应用用嵌入式连接方式连接了以后,其他的应用就不能再连接了。
服务式的话,就跟MySQL、Oracle这种数据库差不多,服务器单独运行,可以多个客户端同时连接。
内存方式,顾名思义,数据仅保持在内存中
    嵌入式和服务式主要体现在JDBC连接的URL方式不同,上面例子中给的是服务式的。
  • 服务式 (Server)
jdbc:h2:tcp://localhost/~/test
  • 嵌入式(Embedded)
jdbc:h2:~/test
  • 内存式(Memory)
jdbc:h2:tcp://localhost/mem:test
    这个不用记,在H2控制台的Login画面选择连接方式,就会生成不同的URL
    采用原生方式连接使用
posted @ 2023-05-09 19:16  ~博客~  阅读(1204)  评论(0)    收藏  举报