iAnywhere.com - begin_publication 连接事件

begin_publication 连接事件

功能

提供有关正被同步的发布的有用信息。还可以使用此脚本来管理基于文件的下载的世代号。

参数

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

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

缺省操作

缺省世代号是 1。如果未为此事件定义脚本，则发送到远程的世代号将始终为 1。

说明

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

此事件的一个潜在用途是根据所用的发布控制下载内容。例如，假设有一个表，它同时属于优先级发布 (PriorityPub) 和所有表的发布 (AllTablesPub)。begin_publication 事件的脚本可将这些发布名存储在 Java 类或 SQL 变量或包中。然后，根据正在同步的发布是 PriorityPub 还是 AllTablesPub，下载脚本可以具有不同的行为方式。

世代号

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

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

在基于文件的下载中，世代号用于强制在下载之前进行上载。该编号存储在下载文件中。在包含上载的同步过程中，将为每个发布预订输出一个世代号。这些世代号在上载确认中被发送给远程数据库，并存储于 SYSSYNC.generation_number 中。

另请参见

SQL 示例

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

call ml_add_connection_script(
'version1',
'begin_publication',
'{call RecordPubSync( ?, ?, ?, ?, ? )}' );

Java 示例

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

call ml_add_java_connection_script( 'ver1',
   'begin_publication',
   'ExamplePackage.ExampleClass.beginPublication' )

下面是示例 Java 方法 beginPublication。它保存每个发布的名称供以后使用。

public String beginPublication(
    ianywhere.ml.script.InOutInteger generation_number,
    String user,
    String pub_name,
    Timestamp last_upload,
    Timestamp last_download )
{  _publicationNames[ _numPublications++ ] = pub_name;
   return( null ); }

.NET 示例

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

call ml_add_dnet_connection_script( 'ver1',
  'begin_publication',
  'TestScripts.Test.BeginPub'
)

下面是示例 .NET 方法 BeginPub。它保存每个发布的名称供以后使用。

public void BeginPub(
    ref int generation_number,
    string user,
    string pub_name,
    DateTime last_upload,
    DateTime last_download )
{
    _publicationNames[ _numPublications++ ] = pub_name;
}