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文件中配置一个servlet和servlet-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.properties或application.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数据库启动时支持多种参数,以下是一些常用的参数及其说明:
-
-tcp:启动H2数据库的TCP服务器模式。 -
-tcpPort:指定TCP服务器监听的端口。例如,-tcpPort 9092。 -
-tcpPassword:设置TCP服务器的密码。 -
-tcpAllowOthers:允许其他主机访问H2数据库服务器。 -
-ifNotExists:如果指定的数据库不存在,则创建一个新的数据库。 -
-tcpSSL:启用SSL加密的TCP服务器。 -
-pgPort:启动H2数据库的PostgreSQL兼容模式的服务器,并指定端口。 -
-baseDir:设置H2数据库文件的存储目录。 -
-trace:启用SQL日志记录功能。 -
-web:启动H2的Web控制台。 -
-webPort:指定Web控制台监听的端口。 -
-webAllowOthers:允许其他主机访问H2的Web控制台。 -
-lazy:延迟数据库初始化,直到首次连接。
这些参数可以组合使用,以满足不同的启动需求。例如,如果你想要启动一个允许其他主机访问的TCP服务器,并设置密码和端口,可以使用如下参数组合:-tcp -tcpPort 9092 -tcpPassword yourPassword -tcpAllowOthers。
JAVA 项目中使用 H2 数据库
为什么要使用H2数据库
H2数据库是可以嵌入到JAVA项目中的,因为只需要导入一个jar包即可,所以非常的方便。
项目中导入H2
将H2的jar包放到classpath里即可,我是用的maven,maven的配置如下
版本我用的现在的最新版
然后需要修改JDBC的配置,主要是下面两个属性跟其他数据库(如MySQL)不同,其他都一样
上面jdbc:h2:tcp://localhost/~/test中的test是数据库的名字,H2默认如果数据库不存在的话,会自动创建一个数据库的。
我用的是hibernate,所以还要修改一下Dialect的配置
到这为止,项目里面就可以使用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
采用原生方式连接使用

浙公网安备 33010602011771号