首先说一下hsqldb几个优点
- 轻巧,只有600多K,运行速度非常快。结合Hibernate数据库无关的特性,非常适合在项目开发的时候使用。
- 作为单元测试数据库。单元测试的时候,启动HSQLDB的file模式,数据不存盘,可以保证测试原子性。
- 来回复制,随身携带。
- 不需要安装,使用非常方便。
- 稳定,而且支持的数据量足够大。
- 小型项目作为现场数据库使用,不需要安装Oracle之类的大型DB,减轻了维护成本,并且,HSQLDB非常容易备份。
Hsqldb的各种好处就不再多说了,今天我们谈谈如何让它在我们日常开发中给我们带来更多的便捷。就像标题所说的,让Hsqldb随WebAPP一起启动。比平时用的DB2、Oracle、SQLServer... ...都要简洁方便许多,更重要从开发角度考虑Hsqldb的性能已经足够了。springside也是这么做的。
废话不多说了,现在开始:
我们借助Listener来实现此功能。
先给出一段该Listener的配置信息吧,*^_^*是存在web.xml里的。
xml 代码
- <context-param>
- <param-name>hsql.dbPath</param-name>
- <param-value>D:/db</param-value>
- </context-param>
- <context-param>
- <param-name>hsql.dbName</param-name>
- <param-value>mydb</param-value>
- </context-param>
- <context-param>
- <param-name>hsql.port</param-name>
- <param-value>9002</param-value>
- </context-param>
- <listener>
- <listener-class>
- systop.com.systopbase.common.HsqlStartListener
- </listener-class>
- </listener>
简单解释一下:
- hsql.dbPath: 采用绝对路径,且是固定的[D:/db]。而在实际应用中在这里我们更需要的是变量[或者说是相对路径],嘻嘻*^_^*不要着急,写这篇文章是为了让大家了解一下。在我们的systop-base项目中就采用了相对路径的方法,在那里你会有惊喜发现。
- hsql.dbName:需要说明的是在D:/db目录下确认有mydb.script和mydb.properties两个文件.
- hsql.port:设置hsqldb的端口,默认是9001,防止冲出使用9002。
接下来我们看看Listener是如何实现的:
java 代码
- package systop.com.systopbase.common;
- import org.hsqldb.Server;
- import org.springframework.util.FileCopyUtils;
- import javax.servlet.ServletContextEvent;
- import javax.servlet.ServletContextListener;
- import java.io.File;
- import java.io.FileOutputStream;
- import java.io.IOException;
- import java.sql.Connection;
- import java.sql.DriverManager;
- import java.sql.Statement;
- /**
- * 该类的职责是在WebApp启动时自动开启HSQL服务. 依然使用Server方式,不受AppServer的影响.
- */
- public class HsqlListener implements ServletContextListener {
- /**
- * Listener 初始化方法.
- */
- public void contextInitialized(ServletContextEvent sce) {
- String dbName = sce.getServletContext().getInitParameter("hsql.dbName");
- String path = sce.getServletContext().getInitParameter("hsql.dbPath");
- int port = -1;
- try {
- port = Integer.parseInt(sce.getServletContext().getInitParameter("hsql.port"));
- }catch(Exception e){
- port = 9001;
- }
- if (dbName == null || dbName.equals("")){
- System.out.println("Cant' get hsqldb.dbName from web.xml Context Param");
- return;
- }
- File dbDir = new File(path);
- if (!dbDir.exists()) {//判断目录是否存在
- if (!dbDir.mkdirs()) {//如果不存在创建,如果创建失败直接返回
- System.out.println("Can not create DB Dir for Hsql:" + dbDir);
- return;
- }
- }
- //以下代码是做数据库恢复的。我们把原始的数据库放在classpath下,当启动web的时候,检查目标
- //数据库是否存在,如果不存在,就把原始数据库复制为指定的数据库
- if (!path.endsWith("/")){
- path = path + "/";
- }
- File scriptFile = new File(path + dbName + ".script");
- File propertiesFile = new File(path + dbName + ".properties");
- if (scriptFile.exists() && propertiesFile.exists()){//判断数据文件是否存在
- this.startServer(path, dbName, port);
- } else{
- System.out.println("Connect failed:Connect Hsqldb error or database files not exits!");
- }
- }
- /**
- * 启动Hsqldb服务的方法。
- * @param dbPath 数据库路径
- * @param dbName 数据库名称
- * @param port 所使用的端口号
- */
- private void startServer(String dbPath, String dbName, int port) {
- Server server = new Server();//它可是hsqldb.jar里面的类啊。
- server.setDatabaseName(0, dbName);
- server.setDatabasePath(0, dbPath + dbName);
- if (port != -1){
- server.setPort(port);
- }
- server.setSilent(true);
- server.start();
- System.out.println("hsqldb started...");
- // 等待Server启动
- try {
- Thread.sleep(800);
- } catch (InterruptedException e){
- // do nothing
- }
- }
- /**
- * Listener销毁方法,在Web应用终止的时候执行"shutdown"命令关闭数据库.
- */
- public void contextDestroyed(ServletContextEvent arg0) {
- //这里就不用说了,自然是关闭数据库操作
- Connection conn = null;
- try {
- Class.forName("org.hsqldb.jdbcDriver");
- conn = DriverManager.getConnection("jdbc:hsqldb:hsql://localhost:9002/bookstore", "sa", "");
- Statement stmt = conn.createStatement();
- stmt.executeUpdate("SHUTDOWN;");
- } catch (Exception e){
- // do nothing
- }
- }
- }
现在就部署到Web应用中去尝试一下吧。:)