访问 UltraLiteJ 数据库存储

Configuration 用于创建并连接到数据库。API 中提供了 Configuration 的多种不同的实现方式。UltraLiteJ 支持的每种类型的数据库存储都存在唯一的实现方式。每种实现方式均提供了一组用于配置数据库存储的方法。

RIM 对象存储 通过 ConfigObjectStore 实现。请参见ConfigObjectStore 接口（仅限 Java ME BlackBerry）。
记录存储 通过 ConfigRecordStore 实现。请参见ConfigRecordStore 接口（仅限 Java ME）。
文件系统存储 通过 ConfigFile 实现。请参见ConfigFile 接口。
非持久性存储 通过 ConfigNonPersistent 实现。请参见ConfigNonPersistent 接口。
内部闪存和 SD 卡存储 通过 ConfigFileME 实现。请参见ConfigFileME 接口（仅限 BlackBerry）。

事务必须使用 Connection 的 commit 方法将事务提交到数据库。这些事务可以使用 rollback 方法回退。
预准备 SQL 语句 PreparedStatement 接口提供了用于处理 SQL 语句的方法。可使用 Connection 的 prepareStatement 方法创建 PreparedStatement。
同步可以通过 Connection 访问用于控制 MobiLink 同步的一组对象。

您不能使用 Sybase Central 或 UltraLite 命令行实用程序直接创建新的 UltraLiteJ 数据库。通过使用 ulunload 和 uljload 实用程序，可将 UltraLite 数据库转换为 UltraLiteJ 数据库。使用 uljload 或 Java SE 应用程序创建的 UltraLiteJ 数据库可以部署到 BlackBerry 设备中，具体方法是：将该数据库复制到 SD 卡，或者使用文件传输机制从 MobiLink 中传输它。

♦ 创建数据库

创建一个新的引用数据库名且适合于您的平台的 Configuration。

在以下示例中，config 为 Configuration 对象的名称，DBname.ulj 为新数据库的名称。

对于 Java ME BlackBerry 设备：

ConfigObjectStore config = 
    DatabaseManager.createConfigurationObjectStore("DBname.ulj");

ConfigFileME config =
DatabaseManager.createConfigFileME( "file:///store/home/user/DBname.ulj" );

ConfigFileME config =
DatabaseManager.createConfigFileME( "file:///SDCard/DBname.ulj" );

对于所有其它 Java ME 设备：

ConfigRecordStore config = 
    DatabaseManager.createConfigurationRecordStore("DBname.ulj");

对于 Java SE 设备：

ConfigFile config = 
    DatabaseManager.createConfigurationFile("DBname.ulj");

或者，您也可以创建所有平台都支持的非持久性数据库 Configuration：

ConfigNonPersistent config = 
    DatabaseManager.createConfigurationNonPersistent("DBname.ulj");

使用 setPassword 方法设置新数据库口令：
config.setPassword("my_password");
创建一个新的 Connection：
Connection conn = DatabaseManager.createDatabase(config);
createDatabase 方法可用于创建数据库，并返回到它的 Connection。调用该方法后，您可以执行 SQL 语句来创建用于应用程序的表和索引，但不能更改数据库的名称、口令和页大小。

UltraLiteJ 数据库必须已存在于客户端设备上，您才能与其连接。

♦ 连接到现有数据库

创建一个新的引用数据库名且适合于您的平台的 Configuration。

在以下示例中，config 为 Configuration 对象的名称，DBname.ulj 为数据库的名称。

对于 Java ME BlackBerry 设备：

ConfigObjectStore config = 
    DatabaseManager.createConfigurationObjectStore("DBname.ulj");

ConfigFileME config =
DatabaseManager.createConfigFileME( "file:///store/home/user/DBname.ulj" );

ConfigFileME config =
DatabaseManager.createConfigFileME( "file:///SDCard/DBname.ulj" );

对于所有其它 Java ME 设备：

ConfigRecordStore config = 
    DatabaseManager.createConfigurationRecordStore("DBname.ulj");

对于 Java SE 设备：

ConfigFile config = 
    DatabaseManager.createConfigurationFile("DBname.ulj");

或者，您也可以连接到所有平台都支持的非持久性数据库 Configuration：

ConfigNonPersistent config = 
    DatabaseManager.createConfigurationNonPersistent("DBname.ulj");

使用 setPassword 方法指定数据库口令：
config.setPassword("my_password");
创建一个新的 Connection：
Connection conn = DatabaseManager.connect(config);
connect 方法会结束数据库连接过程。如果该数据库不存在，则抛出错误。

在调用 release 方法后，Connection 对象会与数据库断开连接。当数据库的所有连接都被释放时，数据库也随之关闭。

请参见release 方法。