java.sql.PreparedStatement DownloadTableData.getUpsertPreparedStatement()
    throws java.sql.SQLException

用于将插入和更新操作添加到下载中的 [java.sql.PreparedStatement] 实例。

此预准备语句将应用于 DownloadTableData 实例，表中每列在语句中对应一个参数。

要在下载中包括插入或更新操作，请在 [java.sql.PreparedStatement] 中设置所有列值，然后调用 [java.sql.PreparedStatement.executeUpdate] 方法。如果插入或更新操作被过滤，则对准备好的语句调用 [java.sql.PreparedStatement.executeUpdate] 将返回 0；如果插入或更新操作未被过滤，则将返回 1。操作如果是在同一同步中上载的，则会被过滤。

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

• DownloadTableData 接口 [MobiLink 服务器 Java]

在以下示例中，[setDownloadInserts] 方法使用 [getUpsertPreparedStatement] 来为要插入或更新的行获取准备好的语句。[java.sql.PreparedStatement.setInt] 和 [PreparedStatement.setString] 方法设置下载中的列值，[PreparedStatement.executeUpdate] 方法设置下载中的行值。

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

    // This is the same as executing 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.
    }
    insert_ps.close();
}