DownloadTableData 接口

为一个同步封装一个下载表的信息。

语法

public interface DownloadTableData

成员

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

名称	说明
getDeletePreparedStatement 方法	返回允许用户向下载中添加删除操作的 [java.sql.PreparedStatement] 实例。
getLastDownloadTime 方法	返回此表的上次下载时间。
getMetaData 方法	获取 [DownloadTableData] 实例的元数据。
getName 方法	返回 DownloadTableData 实例的表名。
getUpsertPreparedStatement 方法	返回允许用户向同步下载中添加 upsert（插入或更新）操作的 [java.sql.PreparedStatement] 实例。

注释

使用此接口可设置将下载到客户端的数据操作。

可使用 [DownloadData] 接口获取当前同步的 [DownloadTableData] 实例。可以分别使用 [getUpsertPreparedStatement] 和 [getDeletePreparedStatement] 方法来获取用于插入和更新操作以及删除操作的 Java 预准备语句。

执行删除语句时可将所有主键设置为空值，以便远程客户端截断表。

[java.sql.PreparedStatement.executeUpdate] 方法可注册要下载的操作。有关 [java.sql.PreparedStatement] 的详细信息，请查阅 Java 软件开发工具包文档。

注释

对于插入和更新预准备语句，必须设置所有列值。对于删除操作，则需设置主键值。delete 和 upsert 预准备语句不能同时打开。

有关直接行处理的详细信息，请参见直接行处理。

示例

本示例假设 MobiLink 客户端数据库中有名为 [remoteOrders] 的表，是使用以下 SQL 语句创建的：

CREATE TABLE remoteOrders (
    pk INT NOT NULL,
    col1 VARCHAR(200),
    PRIMARY KEY (pk)
);

以下示例使用 [DownloadData.getDownloadTableByName] 方法返回表示 [remoteOrders] 表的 [DownloadTableData] 实例。本示例假设您已有称为 [_cc] 的 [DBConnectionContext] 实例。

// The method used for the handle_DownloadData event.
public void handleDownload() throws SQLException {

    // Get the DownloadData for the current synchronization.
    DownloadData my_dd = _cc.getDownloadData();

    // Get the DownloadTableData for the remoteOrders table.
    DownloadTableData td = my_dd.getDownloadTableByName("remoteOrders");

    // User defined-methods to set download operations.
    setDownloadInserts(td);
    setDownloadDeletes(td);
    // ...
}

在本示例中，[SetDownloadInserts] 方法使用 [GetUpsertCommand] 为您想要插入或更新的行获取命令。[IDbCommand] 将会保存一些参数，这些参数将会被设置为您要插入到远程数据库中的值。

void setDownloadInserts(DownloadTableData td) {
    java.sql.PreparedStatement insert_ps = td.getUpsertPreparedStatement();

    // The following method calls are the same as the following SQL statement:
    // INSERT INTO remoteOrders(pk, col1) values(2300, "truck");
    insert_ps.setInt(1, 2300);
    insert_ps.setString(2, "truck");

    int update_result = insert_ps.executeUpdate();
    if (update_result == 0) {
        // Insert was filtered because it was uploaded
        // in the same synchronization.
    }
    else {
        // Insert was not filtered.
    }
}

[setDownloadDeletes] 方法使用 [DownloadTableData.getDeletePreparedStatement] 来为想要删除的行获取准备好的语句。[java.sql.PreparedStatement.setInt] 方法设置要在远程数据库中删除的行的主键值，[java.sql.PreparedStatement.executeUpdate] 方法注册要下载的行值。

void setDownloadDeletes(DownloadTableData td) {
    java.sql.PreparedStatement delete_ps = td.getDeletePreparedStatement();

    // The following method calls are the same as the following SQL statement:
    // DELETE FROM remoteOrders  where pk=2300;
    delete_ps.setInt(1, 2300);
    delete_ps.executeUpdate();
}

getDeletePreparedStatement 方法
 getLastDownloadTime 方法
 getMetaData 方法
 getName 方法
 getUpsertPreparedStatement 方法

使用DocCommentXchange讨论此页。

DownloadTableData 接口

语法

成员

注释

注释

另请参见

示例