Connection 接口

描述数据库连接，启动数据库操作需要此连接。

语法

public interface Connection

成员

Connection 接口的所有成员，包括所有继承的成员。

名称	说明
checkpoint 方法	对数据库更改执行检查点操作。
commit 方法	提交数据库更改。
createDecimalNumber 方法	创建一个新的 DecimalNumber 对象。
createSyncParms 方法	创建同步参数集。
createUUIDValue 方法	创建 UUID 值。
dropDatabase 方法	删除数据库。
emergencyShutdown 方法 [BlackBerry]	紧急关闭连接的数据库。
getDatabaseId 方法 [BlackBerry]	返回数据库 ID 值。
getDatabaseInfo 方法	返回一个包含有关数据库属性信息的 DataInfo 对象。
getDatabaseProperty 方法	返回数据库属性。
getLastDownloadTime 方法	返回指定发布的最近一次下载的时间。
getLastIdentity 方法	检索插入到 DEFAULT AUTOINCREMENT 或 DEFAULT GLOBAL AUTOINCREMENT 列中的最新值；如果在不包含此类列的表中执行最新 INSERT 事务，则返回 0。
getOption 方法 [BlackBerry]	返回数据库选项。
getState 方法 [BlackBerry]	返回连接的状态。
getSyncObserver 方法	返回当前为此 Connection 对象注册的 SyncObserver 对象。
getSyncResult 方法	返回上一个 SYNCHRONIZE SQL 语句的结果。
isSynchronizationDeleteDisabled 方法 [BlackBerry]	确定是否已禁用对删除操作的同步。
prepareStatement 方法	准备将要执行的语句。
release 方法	释放此连接。
resetLastDownloadTime 方法	重置指定发布的下载时间。
rollback 方法	提交回退操作，以撤消对数据库的更改。
setDatabaseId 方法	设置全局自动增量的数据库 ID。
setOption 方法	设置数据库选项。
setSyncObserver 方法	设置一个 SyncObserver 对象来监控此连接上的同步进度。
synchronize 方法	将数据库与 MobiLink 服务器同步。
CONNECTED 变量	表示已连接状态。
NOT_CONNECTED 变量	表示未连接状态。
OPTION_BLOB_FILE_BASE_DIR 变量 [BlackBerry]	数据库选项：blob 文件基本目录。
OPTION_DATABASE_ID 变量 [BlackBerry]	数据库选项：数据库 ID。
OPTION_DATE_FORMAT 变量 [BlackBerry]	数据库选项：日期格式。
OPTION_DATE_ORDER 变量 [BlackBerry]	数据库选项：日期顺序。
OPTION_ML_REMOTE_ID 变量 [BlackBerry]	数据库选项：ML 远程 ID。
OPTION_NEAREST_CENTURY 变量 [BlackBerry]	数据库选项：最接近的世纪值。
OPTION_PRECISION 变量 [BlackBerry]	数据库选项：精度。
OPTION_SCALE 变量 [BlackBerry]	数据库选项：小数位数。
OPTION_TIME_FORMAT 变量 [BlackBerry]	数据库选项：时间格式。
OPTION_TIMESTAMP_FORMAT 变量 [BlackBerry]	数据库选项：时间戳格式。
OPTION_TIMESTAMP_INCREMENT 变量 [BlackBerry]	数据库选项：时间戳增量。
OPTION_TIMESTAMP_WITH_TIME_ZONE_FORMAT 变量 [BlackBerry]	数据库选项：带时区格式的时间戳。
PROPERTY_DATABASE_NAME 变量 [BlackBerry]	数据库属性：数据库名称。
PROPERTY_PAGE_SIZE 变量 [BlackBerry]	数据库属性：页面大小。
SYNC_ALL 变量	用于请求同步数据库中所有表（包括不在任何发布中的表）的发布列表。
SYNC_ALL_DB_PUB_NAME 变量	SYNC_ALL_DB 发布的保留名称。
SYNC_ALL_PUBS 变量	用于请求同步数据库中所有发布的发布列表。

注释

使用 DatabaseManager 类的 connect 或 createDatabase 方法可获得连接。如果不再需要连接，可使用 release 方法来释放连接。当数据库的所有连接都被释放时，数据库也随之关闭。

Connection 对象提供以下功能：

创建新模式（表、索引和发布）
创建新值和域对象
将更改永久提交到数据库
准备要执行的 SQL 语句
回退对数据库进行的未提交更改

以下示例演示了如何为已创建了 Connection 对象、conn 的简单数据库创建模式。数据库包含两个表，分别为表 T1（仅具有名为 num 的整数主键列）和表 T2（具有名为 num 的整数主键列和名为 quantity 的整数列）。T2 在 quantity 列上具有额外索引。T1 包含在名为 PubA 的发布之中。

// Assumes a valid connection object, conn, for the current database.

PreparedStatement ps;

ps = conn.prepareStatement( "CREATE TABLE T1 ( num INT NOT NULL PRIMARY KEY )" );
ps.execute();
ps.close();

ps = conn.prepareStatement( "CREATE TABLE T2 ( num INT NOT NULL PRIMARY KEY, quantity INT)" );
ps.execute();
ps.close();

ps = conn.prepareStatement( "CREATE INDEX index1 ON T2( quantity )" );
ps.execute();
ps.close();

ps = conn.prepareStatement( "CREATE Publication PubA ( Table T1 )" );
ps.execute();
ps.close();

另请参见

使用DocCommentXchange讨论此页。