理解Derby数据库的定位机制
当我们在Java应用程序中使用DriverManager.getConnection("jdbc:derby:myDerbyDB;create=true");这样的代码连接并创建Derby数据库时，数据库文件（通常是一个名为myDerbyDB的文件夹）会被创建在Java应用程序的执行根目录下。这意味着如果你的Java项目在C:\Users\me\Documents\JavaDerbyDemo下运行，那么myDerbyDB文件夹就会出现在C:\Users\me\Documents\JavaDerbyDemo中。
然而，当我们在命令行中通过java -jar derbyrun.jar ij启动Derby的ij工具，并尝试使用connect 'jdbc:derby:myDerbyDB';连接数据库时，ij默认会在其启动目录下寻找myDerbyDB文件夹。如果derbyrun.jar是从Derby安装目录的lib文件夹中启动的，那么ij就会在lib文件夹中寻找数据库，而这通常与Java应用程序创建数据库的位置不同，从而导致“数据库未找到”的错误（ERROR XJ004: Database 'myDerbyDB' not found.）。
方法一：从正确的目录连接现有数据库
要解决上述问题，关键在于确保ij工具在正确的上下文（即数据库文件所在的父目录）中运行。
-
确认数据库位置： 首先，找到你的Java应用程序创建的myDerbyDB数据库文件夹的实际位置。例如，如果你的Java项目根目录是C:\Projects\MyDerbyApp，并且你的Java代码在此处执行，那么myDerbyDB文件夹应该在C:\Projects\MyDerbyApp下。
立即学习“Java免费学习笔记（深入）”；
-
在数据库父目录中启动ij： 导航到包含myDerbyDB文件夹的父目录（例如，C:\Projects\MyDerbyApp）。 然后，使用完整的路径来执行derbyrun.jar，启动ij工具。假设Derby安装在C:\derbydb\db-derby-10.16.1.1-bin，则命令如下：
C:\Projects\MyDerbyApp> java -jar C:\derbydb\db-derby-10.16.1.1-bin\lib\derbyrun.jar ij
或者，如果你已经设置了DERBY_HOME环境变量指向Derby的安装目录，你可以使用：
C:\Projects\MyDerbyApp> java -jar %DERBY_HOME%\lib\derbyrun.jar ij
-
连接数据库：ij启动后，你就可以在ij>提示符下成功连接到数据库了：
ij> connect 'jdbc:derby:myDerbyDB';
此时，ij会在其启动目录（即C:\Projects\MyDerbyApp）中找到myDerbyDB文件夹并成功建立连接。
示例 Java 代码 (用于创建数据库):
import java.sql.DriverManager;
import java.sql.SQLException;
public class DerbyDatabaseCreator {
public static void main(String[] args) {
try {
// 这将在当前Java程序执行的目录下创建或连接myDerbyDB
DriverManager.getConnection("jdbc:derby:myDerbyDB;create=true");
System.out.println("Derby database 'myDerbyDB' created or connected successfully.");
} catch (SQLException e){
e.printStackTrace();
}
}
}方法二：使用ij工具直接创建并连接数据库
如果你希望通过ij工具直接创建数据库，而不是依赖Java应用程序，可以在连接字符串中加入create=true参数。
-
启动ij工具： 在任何你希望创建数据库的目录中启动ij。例如，如果你想在C:\DerbyDatabases目录下创建数据库，则先进入该目录，然后启动ij：
C:\DerbyDatabases> java -jar C:\derbydb\db-derby-10.16.1.1-bin\lib\derbyrun.jar ij
-
创建并连接数据库： 在ij>提示符下，使用以下命令：
ij> connect 'jdbc:derby:myNewDerbyDB;create=true';
执行此命令后，ij将在其启动目录（C:\DerbyDatabases）下创建一个名为myNewDerbyDB的数据库文件夹，并立即建立连接。
最佳实践与注意事项
- 理解工作目录： 始终清楚你的Java应用程序和ij工具是在哪个目录下执行的，因为Derby数据库的创建和查找都依赖于这个工作目录。
- 避免移动数据库文件： 不建议将Derby数据库文件夹手动复制到Derby安装目录的lib文件夹或其他系统目录中。这可能会导致管理混乱，并且不是Derby推荐的使用方式。保持lib文件夹的纯净，只存放库文件。
- 使用DERBY_HOME环境变量： 为了方便管理和执行Derby命令，建议设置DERBY_HOME环境变量，指向Derby的安装根目录。这样在任何目录下都可以通过%DERBY_HOME%\lib\derbyrun.jar来引用derbyrun.jar。
- 管理多个数据库： 如果你需要管理多个Derby数据库，可以为每个数据库创建一个独立的父目录，并在需要连接时，从相应的父目录启动ij，或者在connect字符串中指定数据库的绝对路径（例如：connect 'jdbc:derby:/path/to/myDerbyDB';，但这通常不如在正确的工作目录下操作方便）。
通过理解Derby数据库的定位机制并遵循上述方法，你可以有效地解决“数据库未找到”的问题，并更灵活地管理你的Derby数据库。
