`
han_zw
  • 浏览: 174201 次
  • 性别: Icon_minigender_1
  • 来自: 天津
社区版块
存档分类
最新评论

Derby 学习笔记

阅读更多

    其实本人对 derby 并不是特别喜欢,跟 H2 Database 相比,同样都是文件数据库无论是性能上还是程序简洁程度上都略逊一筹。不过现在的项目要用到 derby ,只有把 derby 下载学习一把。

 

1.  安装

其实从本质上来说 derby 根本就没有真正的安装过程,下载下来直接解压就可以了。以我下载的 db-derby-10.6.2.1-bin.zip 为例。解压后包含以下目录结构 :

bin: 包含 derby 相关的各个运行脚本,有 windows unix 两种版本。

Demo :顾名思义,包含着 derby 自带的各个实例。

Docs: 包括 derby 的所有官网上的文档,分为 pdf html 两种。开始时我还在官网上单独下载文档,原来这个压缩包里已经都自带了。

Javadoc :因为 derby 是完全用 java 语言开发的,这个目录下存放的就是 java API 文档了。

lib: 存放 derby jar 文件。

test: derby 的测试的 jar 包,没用过。

解压完成之后还需要设置一些环境变量。

设置 DERBY_HOME 值为 derby 的安装根目录,另外将 derby bin 目录加入到系统的 PATH 中(均以 windows 为例加以介绍的)。

或者启动脚本中进行临时性设置,例如:

set DERBY_HOME=D:\Program Files\db-derby-10.6.2.1-bin

set PATH=%DERBY_HOME%\bin;%PATH%

 

   这样 derby 就算是安装完成了。

 

2.   工具的使用

2.1    sysinfo

该命令主要是查看 derby 的版本信息和系统的 Java 信息。启动方式很多,可以直接通过 java 命令启动,因为 derby 本身是 java 编写,所以很多命令都可以通过 java 命令来启动运行,官方文档中有相关介绍。不过我还是习惯上以 derby 自带的脚本的方式运行。以下是我本地运行 sysinfo 的输出结果 :

F:\studio\derby\DERBYTUTOR>sysinfo
------------------ Java 信息 ------------------
Java 版本:        1.5.0_16
Java 供应商:      Sun Microsystems Inc.
Java 主目录:      D:\Program Files\Java\jdk1.5.0_16\jre
Java 类路径:      D:\Program Files\db-derby-10.6.2.1-bin\lib\derby.
-derby-10.6.2.1-bin\lib\derbyLocale_zh_CN.jar;D:\Program Files\db-de
run.jar;D:\Program Files\db-derby-10.6.2.1-bin\lib\derbytools.jar;D:
-bin/lib/derby.jar;D:\Program Files\db-derby-10.6.2.1-bin/lib/derbyn
\db-derby-10.6.2.1-bin/lib/derbytools.jar
OS 名:            Windows XP
OS 体系结构:      x86
OS 版本:          5.1
Java 用户名:      han
Java 用户主目录:C:\Documents and Settings\User
Java 用户目录:    F:\studio\derby\DERBYTUTOR
java.specification.name: Java Platform API Specification
java.specification.version: 1.5
java.runtime.version: 1.5.0_16-b02
--------- Derby 信息 --------
JRE - JDBC: J2SE 5.0 - JDBC 3.0
[D:\Program Files\db-derby-10.6.2.1-bin\lib\derby.jar] 10.6.2.1 - (9
[D:\Program Files\db-derby-10.6.2.1-bin\lib\derbytools.jar] 10.6.2.1
[D:\Program Files\db-derby-10.6.2.1-bin\lib\derbynet.jar] 10.6.2.1 -
[D:\Program Files\db-derby-10.6.2.1-bin\lib\derbyclient.jar] 10.6.2.
------------------------------------------------------
----------------- 语言环境信息 -----------------
当前语言环境:  [中文/中国 [zh_CN]]
找到支持的语言环境:[cs]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[de_DE]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[es]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[fr]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[hu]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[it]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[ja_JP]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[ko_KR]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[pl]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[pt_BR]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[ru]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[zh_CN]
         版本:10.6.2.1 - (999685)
找到支持的语言环境:[zh_TW]
         版本:10.6.2.1 - (999685)
------------------------------------------------------
F:\studio\derby\DERBYTUTOR>

 

注:上图内容在选取时有部门文字没有选中

我觉得当你在一个陌生环境下,首先执行一下这个 sysinfo 命令还是挺有用处的。

2.2   dblook

用于查看数据库中所有部分的结构,包括建表语句等等。

这个命令开始时本人用的脚本的调用方式,一直报错说是 java.sql.SQLException: No suitable driver 。后来才发现系统自带的 dblook 的脚本有些问题,例如调用脚本为:

dblook -d 'jdbc:derby://127.0.0.1:9527/firstdb;user=sa;password=derby' –verbose

其中 dblook 在调用 dblook 的类之前会先调用 derby_common.bat derby_common.bat 中会对参数进行处理,参数变为:

-d 'jdbc:derby://127.0.0.1:9527/firstdb user petl password petl' -verbose

因为可能其他脚本也会用到 derby_common.bat 就没敢修改这段脚本,只能改成用 java 语法来调用(前提是已经将 derby 的几个 jar 添加到 classpath 下面)。

java dblook -d 'jdbc:derby://127.0.0.1:9527/firstdb;user=sa;password=derby' –verbose

dblook 的相关参数介绍:

-d   <sourceDBUrl>: 指定数据库连接的完整 URL

-z   <schemaName> :指定 schema

-t <tableOne> <tableTwo> ...: 表名 , 可以列出多个,中间以空格分隔

-append: 以防止覆盖输出文件,生成的 dblook 的日志为追加模式。

-verbose 除了将错误消息打印到日志文件外,

  还将其打印到控制台。如果没有指定此选项,错误将只打印到

  日志文件。
           -o <filename>
指定将生成的 DDL 写入其中的文件名。

  如果没有指定,缺省值是控制台。

 

2.3   ij

感觉 ij 就是 derby 的一个控制台,很强大,也很重要。文档中关于 ij 的内容最多,用到时可以查阅。在这里只说一下我暂时用的到 ij

连接数据库:

$>ij
ij 版本 10.6
ij> connect ‘jdbc:derby://localhost:9527/firstdb/firstdb;user=sa;password=derby’;
ij>

连接之后的操作就相当于一般的数据库控制台一样了。

3.  derby 的启动与停止

derby 的启动模式可以分为 Embedded Network 两种模式。 Embedded 模式是 derby 服务与使用 derby Application 位于同一个 JVM 中,而 Network 模式为以往比较常见的 client/server 形式, derby 位于服务器上,对外提供 derby 的服务。

3.1    Embeded 模式的启动

3.1.1  通过控制台启停

可以直接通过 ij 命令来启动。例如:

$>ij
ij 版本 10.6
ij> connect ‘jdbc:derby://localhost:9527/firstdb/firstdb;user=sa;password=derby’;
ij>create table mytab(
>ID int,
>Name varchar2(32)
>);
已插入/更新/删除0行
Ij>

想要停止时只需键入 exit; 直接退出 ij 即可。

3.1.2  程序中启停

启动方式与平时的 jdbc 的连接方式类似,只是需要指定 driver 为:

org.apache.derby.jdbc.EmbeddedDriver

具体启动方式为:

String driver = "org.apache.derby.jdbc.EmbeddedDriver";

String connectionURL = "jdbc:derby:firstdb;user=sa;password=derby";

Class.forName(driver);

Connection conn = DriverManager.getConnection(connectionURL);

      

停止的话,可以停止整个 derby 服务,也可以指定要停止的数据库。

 

Try{                 

    DriverManager.getConnection("jdbc:derby:;shutdown=true;user=sa;password=derby");
               } catch (SQLException se)  {  
                  if ( se.getSQLState().equals("XJ015") ) {    
                     System.out.println(“shutdown normal”);
                  }

       } 

整个 Derby 服务在关闭时会抛出 XJ015 的错误,关闭 derby 服务中某个库时会抛出 08006 的错误。这两个需要特殊处理一下。

  

3.2   Network 模式的启停

3.2.1 通过控制台启停

直接运行 bin 目录下的 NetworkServerControl.bat ,但前提是已经设置了 derby jar classpath NetworkServerControl 命令的具体用法可以参照命令本身的提示。举例如下:

NetworkServerControl start -h 0.0.0.0  -p 9527

注:其中 -h 指定主机名,一般情况下位主机 IP ,或者主机名。本例中指定为 0.0.0.0, 表示监听本机所有可用的 IP 或者主机名。

此时就可以网络的形式连接该服务了。以 ij 连接方式举例:

Connect ‘jdbc:derby://127.0.0.1:9527/firstdb;user=sa;password=derby’;
 

若要停止 derby 服务同样可以通过 NetworkServerControl 完成。如:

NetworkServerControl shutdown -h 127.0.0.1 -p 9527 -user sa -password derby 

3.2.2  程序中连接和停止

在应用程序中通过 jdbc Network 模式的 derby 服务进行连接于 Embedded 模式的类似,所不同的是驱动要改为 : org.apache.derby.jdbc.ClientDriver

连接的 URL 与通过控制台连接时一致。

因为是 Network 模式,所以在程序中一般不用停 derby 服务。

 

4.  常用操作

         接下来介绍一下 derby 数据中的常用操作

4.1   GET/SET 数据库属性

         可以通过 Derby 内置的两个存储过程设置和获取数据的相关属性值:

         如:

         -- 设置数据库的用户 sa ,密码为 derby

 

CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(‘derby.user.sa’,’derby’)

       -- 获取用户 sa 的密码

 Values SYSCS_UTIL.SYSCS_GET_DATABASE_PROPERTY(‘derby.user.sa’)

 

4.2 查看数据库中的所有表

       可以通过 SYS. SYSTABLES 查看数据库中的表信息。

4.3 查看约束

         对应的是 SYS. SYSCONSTRAINTS 表。

 

5.  权限控制

Derby 的权限控制可以分为系统域、数据库域。系统域是针对 derby 引擎全局的用户信息设置。数据库域是针对某个数据库实例的用户信息的设置,存储在该数据库内。系统域和数据库域有相同的用户的话,数据库域的设置会覆盖掉系统域的设置。

5.1   系统域

在系统设置的 derby.system.home 的目录下添加 derby.properties 文件。

注: derby.system.home 需要设置在 java 的启动参数中,用来设置系统的根目录,如果未设置的话则为当前的启动目录。

在其中类似如下内容:

##启用用户认证
derby.connection.requireAuthentication=true
##derby的认证模式方式有好几种,BUILTIN,LDAP,或者直接采用自定义的类。
derby.authentication.provider=BUILTIN
derby.user.sa=derby

         这样就设置了 derby 的启动和访问需要用户认证,并且成功添加了用户 sa ,密码为 derby 。想要在添加别的用户只需要在后面继续追加用户配置。例如增加用户 gest ,则追加

derby.user.gest=123456

启动或者 derby 数据库时需要在参数中加入用户名和密码,例如通过 ij 连接数据库:

Connect  ‘jdbc:derby://127.0.0.1:9527/firstdb;user=sa;password=derby’
 

5.2   数据库域

Derby 还支持针对数据库级别的用户设置,并且数据库级的用户会覆盖系统级的用户设置。数据库级的用户设置参数与系统级是一样的,所不同的是数据库级设置时采用自带的存储过程 SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY 进行属性的设置。例如同样添加上面的用户可以通过如下步骤。

1. 连接数据库 firstdb

2.  执行

CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(‘derby.connection.requireAuthentication’,’true’);
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(‘derby.authentication.provider’,’ BUILTIN’);
CALL SYSCS_UTIL.SYSCS_SET_DATABASE_PROPERTY(‘derby.user.sa’,’derby’); 

    这样一个只对数据库实例 firstdb 有效的用户 sa 就设置成功了。如果想删除用户只需设置对应用户的密码为 null 即可。

5.3   自定义类

不论是系统级还是数据库的用户设置都可采用三种 PROVIDER ,除了上面咱们用的 BUILTIN 之外还有 LDAP 和自定义类。

其中 LDAP 好像是用一种什么服务,这个感兴趣的可以自己 Google 一下。在这里说一下自定义类。自定义类使用时只需设置 derby.authentication.provider 属性值为自定义的完整类名。该类必须实现 derby UserAuthenticator 接口。

在这里把官网上的一个简单实现贴一下。因为即使本人在这写一个自己的例子也没有意义,反正具体用的话大家都会根据需求自己开发的。

import org.apache.derby.authentication.UserAuthenticator;
import java.io.FileInputStream;
import java.util.Properties;
import java.sql.SQLException;

public class MyAuthenticationSchemeImpl implements
UserAuthenticator {
private static final String USERS_CONFIG_FILE = "myUsers.cfg";
private static Properties usersConfig;

public MyAuthenticationSchemeImpl() {
}

/* static block where we load the users definition from a
users configuration file.*/
static {
FileInputStream in = null;
usersConfig = new Properties();
try {
in = new FileInputStream(USERS_CONFIG_FILE);
usersConfig.load(in);
in.close();
} catch (java.io.IOException ie) {
// No Config file. Raise error message
System.err.println(
"WARNING: Error during Users Config file
retrieval");
System.err.println("Exception: " + ie);
}
}

public boolean authenticateUser(String userName,
String userPassword,
String databaseName,
Properties info)
throws SQLException
{
if (userName == null)
// We do not tolerate 'guest' user for now.
return false;
String actualUserPassword;
actualUserPassword = usersConfig.getProperty(userName);
if (actualUserPassword == null)
actualUserPassword = System.getProperty(userName);
if (actualUserPassword == null)
// no such passed-in user found
return false;
// check if the password matches
if (!actualUserPassword.equals(userPassword))
return false;
// Now, check if the user is a valid user of the database
if (databaseName != null)
{
if (databaseName.equals("DarkSide")) {
// check if user is a valid one.
if (!userName.equals("DarthVader"))
// This user is not a valid one of the passed-in
return false;
}
}
// The user is a valid one in this database
return true;
}
}

 

6.     Derby hibernate+spring3 整合开发

Derby 与其他数据库在操作上没有什么区别,在这里只是把涉及到的配置文件简单贴出来看一下。

建表语句为

 

Create table TEST_USER(

ID INT GENERATED ALWAYS AS IDENTITY (START WITH 1, INCREMENT BY 1) ,

NAME VARCHAR(32)

);

   

         Spring 配置文件

    <?xml version="1.0" encoding="UTF-8"?>

<beans xmlns="http://www.springframework.org/schema/beans"

    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

    xmlns:jee="http://www.springframework.org/schema/jee"

    xmlns:tx="http://www.springframework.org/schema/tx"

    xmlns:aop="http://www.springframework.org/schema/aop"

    xmlns:jdbc="http://www.springframework.org/schema/jdbc"

    xmlns:context="http://www.springframework.org/schema/context"

    xsi:schemaLocation="http://www.springframework.org/schema/beans

    http://www.springframework.org/schema/beans/spring-beans-3.0.xsd

    http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd

    http://www.springframework.org/schema/jee http://www.springframework.org/schema/jee/spring-jee-3.0.xsd

    http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd

    http://www.springframework.org/schema/jdbc http://www.springframework.org/schema/jdbc/spring-jdbc-3.0.xsd

    http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-3.0.xsd"

    default-lazy-init="true">

   

    <bean class="org.springframework.beans.factory.config.PropertyPlaceholderConfigurer">

        <property name="systemPropertiesModeName" value="SYSTEM_PROPERTIES_MODE_OVERRIDE" />

        <property name="ignoreResourceNotFound" value="true" />

        <property name="locations">

            <list>

                <value>classpath*:/application.properties</value>

            </list>

        </property>

    </bean>

 

    <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">

        <property name="driverClassName" value=" org.apache.derby.jdbc.ClientDriver" />

        <property name="url" value="jdbc:derby://127.0.0.1:9527/firstdb" />

        <property name="username" value="sa" />

        <property name="password" value="derby" />

        <property name="initialSize" value="5" />

        <property name="maxActive" value="20" />

        <property name="maxIdle" value="10" />

        <property name="defaultAutoCommit" value="true" />

    </bean>

<bean id="sessionFactory" org.springframework.orm.hibernate3.LocalSessionFactoryBean">

        <property name="dataSource" ref="dataSource" />

        <property name="hibernateProperties">

            <props>

                <prop key="hibernate.dialect"> org.hibernate.dialect.DerbyDialect </prop>

                <prop key="hibernate.show_sql">true</prop>

                <prop key="hibernate.format_sql">true</prop>

            </props>

        </property>

    </bean>

    <bean id="txManager" class="org.springframework.orm.hibernate3.HibernateTransactionManager"> 

    <property name="sessionFactory" ref="sessionFactory" /> 

   </bean>

  

</beans>

 

Hibernate 映射文件:

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE hibernate-mapping PUBLIC

    "-//Hibernate/Hibernate Mapping DTD 3.0//EN"

    "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">

 

<hibernate-mapping default-lazy="false">

    <class name="com.harvey.derby.bean.User" table="TEST_USER">

 

        <id name="id"

            column="ID"

            type="java.lang.Integer"

        >

            <generator class="native"></generator>

        </id>

 

        <property

            name="name"

            type="java.lang.String"

            update="true"

            insert="true"

            column="name"

        />

    </class>

</hibernate-mapping>

 

关于 derby 的介绍就到这里,说的比较粗枝大叶,具体的还得倒实际用的时候再说吧。

分享到:
评论
2 楼 han_zw 2012-02-20  
还真是没贴完啊,可能是文章容量有限制吧,今晚回去再贴下。
1 楼 w359405949 2012-02-16  
博主大大,貌似你的文章没有贴完呢

相关推荐

    我的derby学习笔记之一:derby开始准备

    derby的eclipse插件 博文链接:https://hugebait.iteye.com/blog/47188

    derby数据库笔记

    Derby数据库是一款轻量级的关系型数据库管理系统,由Apache软件基金会开发并维护,它属于Java数据库(JDBC)的一部分。...通过学习这些笔记,开发者可以深化对Derby数据库的理解,提高其在实际项目中的应用能力。

    良葛格Java学习笔记

    【良葛格Java学习笔记】是一份全面且深入的Java编程学习资料,旨在帮助初学者和进阶者掌握Java这门强大的编程语言。这个压缩包包含了一本名为"良葛格Java学习笔记"的HTML文档,它很可能包含了从基础到高级的Java知识...

    入门必备Java学习笔记

    总之,"入门必备Java学习笔记"是一份全面的资源,涵盖了Java初学者需要掌握的所有基础知识,包括JavaSE API的使用,Javalang的基本概念,以及数据库连接技术JDBC和Apache Derby的应用。通过深入阅读和实践,学习者...

    Hive学习笔记(更新版)

    ### Hive学习笔记(更新版) #### 一、Hive简介 Hive 是一款构建于 Hadoop 之上的数据仓库工具,旨在提供一种简单易用的方法处理存储在 Hadoop 文件系统 (HDFS) 中的大量数据集。它允许用户使用类似于 SQL 的语言...

    完整图文版 阿里巴巴数据产品平台 大数据与云计算技术系列教程 Hadoop之Hive学习笔记(共63页).pdf

    **Hive学习笔记** Hive是由阿里巴巴数据产品平台推出的一款基于Hadoop的大数据处理工具,主要服务于大数据与云计算技术领域。Hive的核心是提供了一种类SQL(HQL)的查询语言,使得熟悉SQL的开发者能够方便地进行大...

    hive学习笔记精华版

    【Hive学习笔记精华版】 Hive是大数据处理领域中的一款重要工具,它基于Hadoop构建,主要用于数据仓库和数据分析。作为一个离线处理系统,Hive可以将结构化的数据文件映射成数据库表,允许用户使用类似SQL的查询...

    Hive学习笔记整理.pdf

    Hive学习笔记整理.pdf 本文档是关于Hive学习笔记的整理,涵盖了Hive的架构、Hive和Hadoop的关系、Hive和普通关系数据库的异同、Hive的元数据库、Hive数据存储、Hive的基本操作等知识点。 1. HIVE结构 Hive的架构...

    阿里巴巴Hive学习笔记.docx

    《阿里巴巴Hive学习笔记》是基于阿里巴巴内部分享的资料,主要涵盖了Hive的基本结构、与Hadoop的关系、元数据库管理以及基本操作等方面,为初学者提供了深入理解Hive的全面指南。 1. **Hive结构** - **Hive架构**...

    java学习笔记JDK6课件之二

    【Java学习笔记JDK6课件之二】深入解析 Java是世界上最流行的编程语言之一,尤其对于新手开发者来说,理解并掌握JDK6是至关重要的第一步。本篇笔记将详细介绍如何下载、安装JDK,设置Path和Classpath,以及编写并...

    hive学习笔记-比较全的知识

    标题中提到的"Hive学习笔记-比较全的知识"和描述中所述"相当不错的,适合初学者,下载绝对不亏"意味着本篇文档旨在为初学者提供一个全面的学习指南,覆盖Hive的主要概念和操作。而标签"hive"确定了文档的中心主题是...

Global site tag (gtag.js) - Google Analytics