服务器端的 Derby 数据库应用指南 (derby 在服务器端的使用)

Derby 数据库是一种基于 Java 的关系型数据库管理系统（RDBMS）, 它是 Apache Software Foundation 的一个子项目。由于它的轻量级，易于部署，对简单的 Web 应用程序十分有用，它可以作为一个服务器端数据库使用。本文将探讨 Derby 数据库在服务器端的应用指南，包括如何安装，配置和使用 Derby 数据库。

安装 Derby 数据库

Derby 数据库的安装非常简单，你只需要先下载它的二进制文件。你可以从 Derby 官网中获得二进制文件，它们可以分为两种类型：JDBC 驱动程序和 Derby 引擎。JDBC 驱动程序用于连接到 Derby，而 Derby 引擎用于启动和管理数据库。由于 Derby 是一个基于 Java 的 RDBMS, 你需要先安装 Java 运行环境（JRE）或 Java 开发工具包（JDK）才能运行它。

配置 Derby 数据库

安装 Derby 数据库之后，你需要配置它来满足你的应用程序需求。在 Derby 数据库中，要对数据库进行配置，你需要修改 Derby 配置文件（ derby.properties ）。 Derby 配置文件通常是在 Derby 系统目录（DERBY_HOME）下的一个名为 derby.properties 的文件中。你可以使用任何简单的文本编辑器来编辑 derby.properties 文件。以下是 derby.properties 文件的一些常用配置：

derby.system.home – 指定 Derby 系统目录

derby.stream.error.file – 指定 Derby 错误日志文件

derby.language.logStatementText – 指示 Derby 是否记录 SQL 语句

创建数据库

完成 Derby 数据库的安装和配置之后，你现在可以创建你的之一个 Derby 数据库了。创建 Derby 数据库的最简单方式是使用 Derby 命令行工具。以下是如何使用 Derby 命令行工具创建一个简单的数据库：

1. 打开命令提示符（Windows）或终端窗口（Linux 和 macOS）并输入以下命令来启动 Derby 命令行工具：

$ java -jar $DERBY_HOME/lib/derbyrun.jar ij

2. 输入以下命令来连接到 Derby 引擎：

connect ‘jdbc:derby:testdb;create=true’;

3. 输入以下命令来创建一个新表：

CREATE TABLE users (id INT PRIMARY KEY, name VARCHAR(50));

现在你已经创建了一个简单的 Derby 数据库。

使用 Derby 数据库

现在你已经创建了一个 Derby 数据库，你可以开始使用它了。使用 Derby 数据库非常简单，因为 Derby 数据库支持标准 SQL 语言。以下是如何使用 Derby 数据库的一些示例：

1. 插入数据

INSERT INTO users (id, name) VALUES (1, ‘Alice’);

2. 查询数据

SELECT * FROM users;

3. 更新数据

UPDATE users SET name = ‘Bob’ WHERE id = 1;

4. 删除数据

DELETE FROM users WHERE id = 1;

Derby 数据库还支持更高级的特性，例如事务处理、簇、索引和限制。以下是如何使用这些特性的一些示例：

1. 事务处理

BEGIN TRANSACTION;

INSERT INTO users (id, name) VALUES (1, ‘Alice’);

UPDATE users SET name = ‘Bob’ WHERE id = 1;

COMMIT;

2. 簇

CREATE INDEX users_name_idx ON users (name);

3. 索引

CREATE INDEX users_name_idx ON users (name);

4. 限制

SELECT * FROM users WHERE id = 1 FETCH FIRST 10 ROWS ON;

本文介绍了 Derby 数据库在服务器端的应用指南，包括如何安装、配置和使用 Derby 数据库。 Derby 数据库是一个轻量级、易于部署的 RDBMS，它为简单的 Web 应用程序提供了有效的支持。使用 Derby 数据库非常简单，因为 Derby 数据库支持标准 SQL 语言。 Derby 数据库还支持更高级的特性，例如事务处理、簇、索引和限制，它们可以提高你的应用程序的性能和可靠性。

相关问题拓展阅读：

• Java SE 6 新特性: Java DB&n

Java SE 6 新特性: Java DB&n

年底 Sun 公司发布了 Java Standard Edition （Java SE ）的最终正式版 代号 Mustang（野马） 跟 Tiger（Java SE ）相备册陆比 Mustang 在性能方面有了不错的提升 与 Tiger 在 API 库方面的大幅度加强相比 虽然 Mustang 在 API 库方面的新特性显得不太多 但是也提供了许多实用和方便的功能 在脚本 WebService XML 编译器 API 数据库 JMX 网络和 Instrumentation 方面都有不错的新特性和功能加强 本系列 文章主要介绍 Java SE 在 API 库方面的部分新特性 通过一些例子和讲解 帮助开发者在编程实践当中更好的运用 Java SE 提高开发效率

　　本文是系列文章的第 篇 介绍了 Java SE 在数据库编程方面的新特性

Java DB Java 里的数据库

　　新安装了 JDK 的程序员们也许会发现 除了传统的 bin jre 等目录 JDK 新增了一个名为 db 的目录 这便是 Java 的新成员 Java DB 这是一个纯 Java 实现 开源的数据库管理系统（DBMS） 源于 Apache 软件基金会（ASF）名下的项目 Derby 它只有 MB 大小 对比动辄上 G 的数据库来说可谓袖珍 但这并不妨碍 Derby 功能齐备 支持几乎大部分的数据库应用所需要的特性 更难能可贵的是 依托于 ASF 强大的社区力量 Derby 得到了包括 IBM 和 Sun 等大公司以及全世界优秀程序员们的支持 这也难怪 Sun 公司会选择其 版本纳入到 JDK 中 作为内嵌的数据库 这就好像为 JDK 注入了一股全新的活力 Java 程序员不再需要耗费大量精力安装和配置数据库 就能进行安全 易用 标准仿顷 并且免费的数据库编程 在这一章中 我们将初窥 Java DB 的世界 来探究如何使用它编写出功能丰富的程序

Hello Java DB 内嵌模式的Derby

　　既然有了内嵌（embedded）的数据库 就让我们从一个简单的范例（代码在 清单 中列出）开始 试着使用它吧 这个程序做了大多数数据库应用都可能会做的操作 在 DBMS 中创建了一个名为 helloDB 的数据姿笑库 创建了一张数据表 取名为 hellotable 向表内插入了两条数据 然后 查询数据并将结果打印在控制台上 最后 删除表和数据库 释放资源

　　清单 HelloJavaDB 的代码

　　public class HelloJavaDB { public static void main(String args) { try { // load the driver Class forName( apache derby jdbc EmbeddedDriver ) newInstance(); System out println( Load the embedded driver ); Connection conn = null; Properties props = new Properties(); props put( user user ); props put( password user ); //create and connect the database named helloDB conn=DriverManager getConnection( jdbc:derby:helloDB;create=true props); System out println( create and connect to helloDB ); conn setAutoCommit(false); // create a table and insert o records Statement s = conn createStatement(); s execute( create table hellotable(name varchar( ) score int) ); System out println( Created table hellotable ); s execute( insert into hellotable values( Ruth Cao ) ); s execute( insert into hellotable values ( Flora Shi ) ); // list the o records ResultSet rs = s executeQuery( SELECT name score FROM hellotable ORDER BY score ); System out println( name\t\tscore ); while(rs next()) { StringBuilder builder = new StringBuilder(rs getString( )); builder append( \t ); builder append(rs getInt( )); System out println(builder toString()); } // delete the table s execute( drop table hellotable ); System out println( Dropped table hellotable ); rs close(); s close(); System out println( Closed result set and statement ); mit(); conn close(); System out println( Committed transaction and closed connection ); try { // perform a clean shutdown DriverManager getConnection( jdbc:derby:;shutdown=true ); } catch (SQLException se) { System out println( Database shut down normally ); } } catch (Throwable e) { // handle the exception } System out println( SimpleApp finished ); }}

　　随后 我们在命令行（本例为 Windows 平台 当然 其它系统下稍作改动即可）下键入以下命令

　　清单 运行 HelloJavaDB 命令

　　java –cp ;%JAVA_HOME%\db\lib\derby jar HelloJavaDB

　　程序将会按照我们预想的那样执行 图 是执行结果的一部分截屏

　　图 HelloJavaDB 程序的执行结果

　　上述的程序和以往没什么区别 不同的是我们不需要再为 DBMS 的配置而劳神 因为 Derby 已经自动地在当前目录下新建了一个名为 helloDB 的目录 来物理地存储数据和日志 需要做的只是注意命名问题 在内嵌模式下驱动的名字应为 apache derby jdbc EmbeddedDriver 创建一个新数据库时需要在协议后加入 create=true 另外 关闭所有数据库以及 Derby 的引擎可以使用以下代码

　　清单 关闭所有数据库及 Derby 引擎

　　DriverManager getConnection( jdbc:derby:;shutdown=true );

　　如果只想关闭一个数据库 那么则可以调用

　　清单 关闭一个数据库

　　DriverManager getConnection( jdbc:derby:helloDB;shutdown=true );

　　这样 使用嵌入模式的 Derby 维护和管理数据库的成本接近于 这对于希望专心写代码的人来说不失为一个好消息 然而有人不禁要问 既然有了内嵌模式 为什么大多数的 DBMS 都没有采取这样的模式呢？不妨做一个小实验 当我们同时在两个命令行窗口下运行 HelloJavaDB 程序 结果一个的结果与刚才一致 而另一个却出现了错误 如 图 所示

　　图 内嵌模式的局限

　　错误的原因其实很简单 在使用内嵌模式时 Derby 本身并不会在一个独立的进程中 而是和应用程序一起在同一个 Java 虚拟机（JVM）里运行 因此 Derby 如同应用所使用的其它 jar 文件一样变成了应用的一部分 这就不难理解为什么在 classpath 中加入 derby 的 jar 文件 我们的示例程序就能够顺利运行了 这也说明了只有一个 JVM 能够启动数据库 而两个跑在不同 JVM 实例里的应用自然就不能够访问同一个数据库了

　　鉴于上述的局限性 和来自不同 JVM 的多个连接想访问一个数据库的需求 下一节将介绍 Derby 的另一种模式 网络服务器（Neork Server）

网络服务器模式

　　如上所述 网络服务器模式是一种更为传统的客户端/服务器模式 我们需要启动一个 Derby 的网络服务器用于处理客户端的请求 不论这些请求是来自同一个 JVM 实例 还是来自于网络上的另一台机器 同时 客户端使用 DRDA（Distributed Relational Database Architecture）协议连接到服务器端 这是一个由 The Open Group 倡导的数据库交互标准 图 说明了该模式的大体结构

　　由于 Derby 的开发者们努力使得网络服务器模式与内嵌模式之间的差异变小 使得我们只需简单地修改 清单 中的程序就可以实现 如 清单 所示 我们在 HelloJavaDB 中增添了一个新的函数和一些字符串变量 不难看出 新的代码只是将一些在 上一节中特别指出的字符串进行了更改 驱动类为 apache derby jdbc ClientDriver 而连接数据库的协议则变成了 jdbc: / 这是一个类似 URL 的字符串 而事实上 Derby 网络的客户端的连接格式为 jdbc: 在这个例子中 我们使用了最简单的本地机器作为服务器 而端口则是 Derby 默认的 端口

　　图 Derby 网络服务器模式架构

　　清单 网络服务器模式下的 HelloJavaDB

　　public class HelloJavaDB { public static String driver = apache derby jdbc EmbeddedDriver ; public static String protocol = jdbc:derby: ; public static void main(String args) { // same as before } private static void parseArguments(String args) { if (args length == || args length > ) { return; } if (args equalsIgnoreCase( derbyclient )) { framework = derbyclient ; driver = apache derby jdbc ClientDriver ; protocol = jdbc: / ; } }}

　　当然 仅仅有客户端是不够的 我们还需要启动网络服务器 Derby 中控制网络服务器的类是 apache derby drda NeorkServerControl 因此键入以下命令即可 如果想了解 NeorkServerControl 更多的选项 只要把 start 参数去掉就可以看到帮助信息了 关于网络服务器端的实现 都被 Derby 包含在 derbynet jar 里

　　清单 启动网络服务器

　　java cp ; C:\Program Files\Java\jdk \db\lib\derby jar ; C:\Program Files\Java\jdk \db\lib\derbynet jar apache derby drda NeorkServerControl start

　　相对应的 网络客户端的实现被包含在 derbyclient jar 中 所以 只需要在 classpath 中加入该 jar 文件 修改后的客户端就可以顺利地读取数据了 再一次尝试着使用两个命令行窗口去连接数据库 就能够得到正确的结果了 如果不再需要服务器 那么使用 NeorkServerControl 的 shutdown 参数就能够关闭服务器

　　更多

　　至此 文章介绍了 Java SE 中的新成员 Java DB（Derby） 也介绍了如何在内嵌模式以及网络服务器模式下使用 Java DB 当然这只是浅尝辄止 更多高级的选项还需要在 Sun 和 Derby 的文档中寻找 在这一章的最后 我们将简单介绍几个 Java DB 的小工具来加快开发速度 它们都位于 apache derby tools 包内 在开发过程中需要获取信息或者测试可以用到

ij 一个用来运行 SQL 脚本的工具 dblook 为 Derby 数据库作模式提取（Schema extraction） 生成 DDL 的工具 sysinfo 显示系统以及 Derby 信息的工具类

JDBC 新功能 新 API

　　如果说上一章介绍了 Java 中的一个新成员 它本来就存在 但是没有被加入进 JDK 那么这一章 我们将关注在 JDBC 中又增加了哪些新功能以及与之相对应的新 API

　　自动加载驱动

　　在 JDBC 之前 编写 JDBC 程序都需要加上以下这句有点丑陋的代码

　　清单 注册 JDBC 驱动

　　Class forName( apache derby jdbc EmbeddedDriver ) newInstance();

　　Java sql DriverManager 的内部实现机制决定了这样代码的出现 只有先通过 Class forName 找到特定驱动的 class 文件 DriverManager getConnection 方法才能顺利地获得 Java 应用和数据库的连接 这样的代码为编写程序增加了不必要的负担 JDK 的开发者也意识到了这一点 从 Java 开始 应用程序不再需要显式地加载驱动程序了 DriverManager 开始能够自动地承担这项任务 作为试验 我们可以将 清单 中的相关代码删除 重新编译后在 JRE 下运行 结果和原先的程序一样

　　好奇的读者也许会问 DriverManager 为什么能够做到自动加载呢？这就要归功于一种被称为 Service Provider 的新机制 熟悉 Java 安全编程的程序员可能对其已经是司空见惯 而它现在又出现在 JDBC 模块中 JDBC 的规范规定 所有 JDBC 的驱动 jar 文件必须包含一个 java sql Driver 它位于 jar 文件的 META INF/services 目录下 这个文件里每一行便描述了一个对应的驱动类 其实 编写这个文件的方式和编写一个只有关键字（key）而没有值（value）的 properties 文件类似 同样地 # 之后的文字被认为是注释 有了这样的描述 DriverManager 就可以从当前在 CLASSPATH 中的驱动文件中找到 它应该去加载哪些类 而如果我们在 CLASSPATH 里没有任何 JDBC 的驱动文件的情况下 调用 清单 中的代码会输出一个 sun jdbc odbc JdbcOdbcDriver 类型的对象 而仔细浏览 JDK 的目录 这个类型正是在 %JAVA_HOME%/jre/lib/resources jar 的 META INF/services 目录下的 java sql Driver 文件中描述的 也就是说 这是 JDK 中默认的驱动 而如果开发人员想使得自己的驱动也能够被 DriverManager 找到 只需要将对应的 jar 文件加入到 CLASSPATH 中就可以了 当然 对于那些 JDBC 之前的驱动文件 我们还是只能显式地去加载了

　　清单 罗列本地机器上的 JDBC 驱动

　　Enumeration drivers = DriverManager getDrivers();while(drivers hasMoreElements()) { System out println(drivers nextElement());}

　　RowId

　　熟悉 DB Oracle 等大型 DBMS 的人一定不会对 ROWID 这个概念陌生 它是数据表中一个 隐藏 的列 是每一行独一无二的标识 表明这一行的物理或者逻辑位置 由于 ROWID 类型的广泛使用 Java SE 中新增了 java sql RowId 的数据类型 允许 JDBC 程序能够访问 SQL 中的 ROWID 类型 诚然 不是所有的 DBMS 都支持 ROWID 类型 即使支持 不同的 ROWID 也会有不同的生命周期 因此使用 DatabaseMetaData getRowIdLifetime 来判断类型的生命周期不失为一项良好的实践经验 我们在 清单 的程序获得连接之后增加以下代码 便可以了解 ROWID 类型的支持情况

清单 了解 ROWID 类型的支持情况

　　DatabaseMetaData meta = conn getMetaData();System out println(meta getRowIdLifetime());

　　Java SE 的 API 规范中 java sql RowIdLifetime 规定了 种不同的生命周期 ROWID_UNSUPPORTED ROWID_VALID_FOREVER ROWID_VALID_OTHER ROWID_VALID_SESSION 和 ROWID_VALID_TRANSACTION 从字面上不难理解它们表示了不支持 ROWID ROWID 永远有效等等 具体的信息 还可以参看相关的 JavaDoc 读者可以尝试着连接 Derby 进行试验 会发现运行结果是 ROWID_UNSUPPORTED 即 Derby 并不支持 ROWID

　　既然提供了新的数据类型 那么一些相应的获取 更新数据表内容的新 API 也在 Java 中被添加进来 和其它已有的类型一样 在得到 ResultSet 或者 CallableStatement 之后 调用 get/set/update 方法得到/设置/更新 RowId 对象 示例的代码如 清单 所示

　　清单 获得/设置 RowId 对象

　　// Initialize a PreparedStatementPreparedStatement pstmt = connection prepareStatement( SELECT rowid name score FROM hellotable WHERE rowid = ? );// Bind rowid into prepared statement pstmt setRowId( rowid);// Execute the statementResultSet rset = pstmt executeQuery(); // List the recordswhile(rs next()) { RowId id = rs getRowId( ); // get the immutable rowid object String name = rs getString( ); int score = rs getInt( );}

　　鉴于不同 DBMS 的不同实现 RowID 对象通常在不同的数据源（datasource）之间并不是可移植的 因此 JDBC 的 API 规范并不建议从连接 A 取出一个 RowID 对象 将它用在连接 B 中 以避免不同系统的差异而带来的难以解释的错误 而至于像 Derby 这样不支持 RowId 的 DBMS 程序将直接在 setRowId 方法处抛出 SQLFeatureNotSupportedException

SQLXML

　　SQL 标准引入了 SQL/XML 作为 SQL 标准的扩展 SQL/XML 定义了 SQL 语言怎样和 XML 交互 如何创建 XML 数据 如何在 SQL 语句中嵌入 XQuery 表达式等等 作为 JDBC 的一部分 Java 增加了 java sql SQLXML 的类型 JDBC 应用程序可以利用该类型初始化 读取 存储 XML 数据 java sql Connection createSQLXML 方法就可以创建一个空白的 SQLXML 对象 当获得这个对象之后 便可以利用 setString setBinaryStream setCharacterStream 或者 setResult 等方法来初始化所表示的 XML 数据 以 setCharacterStream 为例 清单 表示了一个 SQLXML 对象如何获取 java io Writer 对象 从外部的 XML 文件中逐行读取内容 从而完成初始化

　　清单 利用 setCharacterStream 方法来初始化 SQLXML 对象

　　SQLXML xml = con createSQLXML();Writer writer = xml setCharacterStream();BufferedReader reader = new BufferedReader(new FileReader( test xml ));String line= null;while((line = reader readLine() != null) { writer write(line);}

　　由于 SQLXML 对象有可能与各种外部的资源有联系 并且在一个事务中一直持有这些资源 为了防止应用程序耗尽资源 Java 提供了 free 方法来释放其资源 类似的设计在 java sql Array Clob 中都有出现

　　至于如何使用 SQLXML 与数据库进行交互 其方法与其它的类型都十分相似 可以参照 RowId 一节 中的例子在 Java SE 的 API 规范中找到 SQLXML 中对应的 get/set/update 方法构建类似的程序 此处不再赘述

SQLExcpetion 的增强

　　在 Java SE 之前 有关 JDBC 的异常类型不超过 个 这似乎已经不足以描述日渐复杂的数据库异常情况 因此 Java SE 的设计人员对以 java sql SQLException 为根的异常体系作了大幅度的改进 首先 SQLException 新实现了 Iterable 接口 清单 实现了 清单 程序的异常处理机制 这样简洁地遍历了每一个 SQLException 和它潜在的原因（cause）

　　清单 SQLException 的 for each loop

　　// Java codecatch (Throwable e) { if (e instanceof SQLException) { for(Throwable ex : (SQLException)e ){ System err println(ex toString()); } }}

　　此外 图 表示了全部的 SQLException 异常体系 除去原有的 SQLException 的子类 Java 中新增的异常类被分为 种 SQLReoverableException SQLNonTransientException SQLTransientException 在 SQLNonTransientException 和 SQLTransientException 之下还有若干子类 详细地区分了 JDBC 程序中可能出现的各种错误情况 大多数子类都会有对应的标准 SQLState 值 很好地将 SQL 标准和 Java 类库结合在一起

　　图 SQLException 异常体系

　　在众多的异常类中 比较常见的有 SQLFeatureNotSupportedException 用来表示 JDBC 驱动不支持某项 JDBC 的特性 例如在 Derby 下运行 清单 中的程序 就可以发现 Derby 的驱动并不支持 RowId 的特性 另外值得一提的是 SQLClientInfoException 直接继承自 SQLException 表示当一些客户端的属性不能被设置在一个数据库连接时所发生的异常

小结 更多新特性与展望

　　在本文中 我们已经向读者介绍了 Java SE 中 JDBC 最重要的一些新特性 它们包括嵌在 JDK 中的 Java DB （Derby）和 JDBC 的一部分 当然 还有很多本文还没有覆盖到的新特性 比如增加了对 SQL 语言中 NCHAR NVARCHAR LONGNVARCHAR 和 NCLOB 类型的支持 在数据库连接池的环境下为管理 Statement 对象提供更多灵活 便利的方法等

lishixinzhi/Article/program/Java/P/202311/19343

derby 在服务器端的使用的介绍就聊到这里吧，感谢你花时间阅读本站内容，更多关于derby 在服务器端的使用,服务器端的 Derby 数据库应用指南,Java SE 6 新特性: Java DB&n的信息别忘了在本站进行查找喔。