iAnywhere.com - end_publication 连接事件

end_publication 连接事件

功能

提供有关正被同步的发布的有用信息。

参数

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

项	参数	说明
1	generation_number	INTEGER。如果部署不使用基于文件的下载，则可以忽略此参数。缺省值为 1。
2	ml_username	VARCHAR(128)。如果一个 UltraLite 远程在使用 UL_SYNC_ALL 数据库进行同步，则将使用 'unknown' 这一名称调用此事件一次。
3	publication_name	VARCHAR(128)
4	last_upload	TIMESTAMP。上次成功上载。
5	last_download	TIMESTAMP。上次成功下载。

缺省操作

无。

说明

此事件使您可以根据当前正在同步的发布来设计同步逻辑。此事件与 end_synchronization 事件在相同的事务中并在 end_synchronization 事件之前被调用。对于当前正在同步的每个发布，将调用此事件一次。

如果当前同步成功应用了上载，则 last_upload 参数将包含应用此最新上载的时间。如果当前同步获得成功下载确认，last_download 时间将包含生成此最新下载的时间。该值与作为上次下载时间戳传递给下载脚本的值相同。

世代号

generation_number 参数专用于基于文件的下载。

世代号的输出值从 begin_publication 脚本传递到 end_publication 脚本。generation_number 的意义取决于是否在使用当前同步来创建一个下载文件，或者当前同步是否具有上载。

在基于文件的下载中，世代号用于强制在下载之前进行上载。该编号存储在下载文件中。

另请参见

SQL 示例

您可能要为每个正被同步的发布记录该信息。下面的示例调用 ml_add_connection_script，将事件指派给名为 RecordPubEndSync 的存储过程。

call ml_add_connection_script(
   'version1',
   'end_publication',
   'call RecordPubEndSync( ?, ?, ?, ?, ? )' );

Java 示例

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

call ml_add_java_connection_script(
   'ver1',
   'end_publication',
   'ExamplePackage.ExampleClass.endPublication' )

以下是示例 Java 方法 endPublication。它将向 MobiLink 日志输出一条消息。（这在开发时可能会有帮助，但会降低生产服务器的性能。）

public String endPublication(
    ianywhere.ml.script.InOutInteger generation_number,
    String user,
    String pub_name,
    Timestamp last_upload,
    Timestamp last_download )
{  System.out.println(
     "Finished synchronizing publication " + pub_name );
   return( null ); }

.NET 示例

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

call ml_add_dnet_connection_script( 'ver1',
  'end_publication',
  'TestScripts.Test.EndPub'
)

以下是示例 Java 方法 endPublication。它将向 MobiLink 日志输出一条消息。（这在开发时可能会有帮助，但会降低生产服务器的性能。）

public void EndPub(
    ref int generation_number,
    string user,
    string pub_name,
    DateTime last_upload,
    DateTime last_download )
{
    Console.Write(
      "Finished synchronizing publication " + pub_name );
}