Apache Derby 教程

Apache Derby 教程

derbyMirror of Apache Derby项目地址:https://gitcode.com/gh_mirrors/derby/derby

Apache Derby是一款轻量级、嵌入式的关系型数据库管理系统，它是Java开发的并且完全符合JDBC 4.2规范。以下是基于其GitHub仓库的教程，涵盖了项目的目录结构、启动文件和配置文件介绍。

1. 项目目录结构及介绍

当你克隆或下载Apache Derby源码后，你会看到以下主要目录结构：

apache-derby/
|-- build/
|   |-- classes/
|   |-- jars/
|   |-- ...
|-- derby/
|   |-- src/
|   |   |-- java/
|   |   |   |-- org.apache.derby/
|   |   |   |   |-- engine/
|   |   |   |   |-- impl/
|   |   |   |   |-- internal/
|   |   |   |   |-- ...
|   |   |   |-- test/
|   |   |   |-- tools/
|   |   |-- native/
|   |   |-- resources/
|   |   |-- scripts/
|   |-- samples/
|-- lib/
|-- tools/
|-- ...

• build/ 包含构建过程中产生的类文件和jar包。
• derby/ 是项目的主要源代码目录，包含Java源码、测试用例、资源和脚本。
  • src/java 存放所有Java源代码。
  • src/native 用于存放本地（非Java）代码，如C/C++。
  • src/resources 包含数据库相关的资源文件。
  • src/scripts 有各种命令行脚本，用于管理数据库。
• lib/ 存放项目依赖的库文件。
• tools/ 提供一些工具程序，例如Derby控制台工具等。

2. 项目的启动文件介绍

Apache Derby的启动通常涉及运行Java应用程序，使用ij工具作为交互式SQL客户端。你可以通过以下命令来启动ij：

java -jar derbyrun.jar ij

ij是Derby提供的一个简单的命令行接口，允许你连接到任何Derby数据库并执行SQL语句。

此外，为了启动数据库服务器，可以使用NetworkServerControl类的start方法，但通常在生产环境中，我们会创建一个Java应用来管理和监控数据库服务。

3. 项目的配置文件介绍

Derby的配置主要通过系统属性或环境变量进行，而不是传统意义上的配置文件。例如，设置Derby服务器监听的端口号可以通过以下Java系统属性完成：

java -Dderby.system.home=/path/to/derby/home -Dderby.network.serverPort=1527 -jar derbyrun.jar NetworkServerControl start

• derby.system.home 指定Derby数据存储的主目录。
• derby.network.serverPort 设置网络服务器监听的端口。

另外，你还可以通过derby.properties文件提供特定的配置，但默认情况下Derby并不期望存在这样一个文件。如果你希望自定义配置，可以在derby.system.home指定的目录下创建这个文件，然后添加相应的属性。例如：

derby.infolog.append=true
derby.language.logQueryPlan=true

这些配置将在启动时加载，并影响数据库的行为。

请注意，上述内容是基于对Apache Derby源码树的一般性理解，实际操作可能会因版本差异而有所不同。建议查阅最新的官方文档以获取详细的安装和配置步骤。

derbyMirror of Apache Derby项目地址:https://gitcode.com/gh_mirrors/derby/derby