iAnywhere.com - begin_download 连接事件

begin_download 连接事件

功能

紧接在 MobiLink 同步服务器开始对下载数据流进行准备之前处理任何语句。

参数

在下表中，[说明] 部分提供 SQL 数据类型。如果您使用 Java 或 .NET 编写脚本，则应该使用相应的数据类型。请参见 SQL-Java 数据类型和 SQL-.NET 数据类型。

只有当未指定任何后续参数时，事件参数才是可选的。如果要使用参数 2，您必须使用参数 1。

项	参数	说明
1	last_download	TIMESTAMP
2	ml_username	VARCHAR(128)

缺省操作

无。

说明

MobiLink 同步服务器执行该事件是对下载的信息进行处理的第一步。下载信息是在单独的一个事务中进行处理的。执行该事件是该事务中的第一步操作。

在下载阶段紧前面的最后一次成功的同步过程中，从统一数据库中获取的时间值即为 last_download 时间戳。如果当前用户从未成功地进行过同步，则该值将被设置为 1900-01-01。

另请参见

end_download 连接事件

SQL 示例

下面的示例调用 ml_add_connection_script，将事件指派给名为 SetDownloadParameters 的存储过程。

call ml_add_connection_script (
   'Lab',
   'begin_download',
   'CALL SetDownloadParameters( ?, ? )' )

Java 示例

下面的存储过程调用在同步脚本版本 ver1 时将名为 beginDownloadConnection 的 Java 方法注册为 begin_download 连接事件的脚本。

call ml_add_java_connection_script(
   'example_ver',
   'begin_download',
   'ExamplePackage.ExampleClass.beginDownloadConnection' )

下面是示例 Java 方法 beginDownloadConnection。它调用一个 Java 函数 (prepDeleteTables)，该函数将使用先前设置的 JDBC 同步准备删除表。

public String beginDownloadConnection(
    Timestamp ts, String user )
  throws java.sql.SQLException
{  prepDeleteTables ( _syncConn, ts, user );
   return ( null ); }

.NET 示例

下面的存储过程调用在同步脚本版本 ver1 时将名为 BeginDownload 的 .NET 方法注册为 begin_download 连接事件的脚本。

call ml_add_dnet_connection_script(
  'ver1',
  'begin_download',
  'TestScripts.Test.BeginDownload'
)

下面是示例 .NET 方法 BeginDownload。它调用一个 .NET 函数 (prepDeleteTables)，该函数将使用先前设置的 JDBC 同步准备删除表。

public void BeginDownload(
  DateTime timestamp,
  string user )
{  prepDeleteTables ( _syncConn, ts, user );
   return ( null ); }