begin_publication 连接事件

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

参数

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

SQL 脚本的参数名称	说明	顺序
s.generation_number	INTEGER。这是一个 INOUT 参数。如果部署不使用基于文件的下载，则可以忽略此参数。缺省值为 1。	1
s.remote_id	VARCHAR(128)。MobiLink 远程 ID。只有在使用命名参数时才能引用远程 ID。	不适用
s.username	VARCHAR(128)。MobiLink 用户名。	2
s.publication_name	VARCHAR(128)。发布的名称。	3
s.last_publication_upload	TIMESTAMP。此发布上次成功上载的时间。	4
s.last_publication_download	TIMESTAMP。发布的上一次下载时间。	5
s.subscription_id	VARCHAR(128)。预订 ID。	6

缺省操作

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

注释

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

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

如果一个 UltraLite 远程数据库在与 UL_SYNC_ALL 进行同步，则将使用 'unknown' 这一名称调用此事件一次。

世代号

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

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

另请参见

SQL 示例

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

CALL ml_add_connection_script(
 'version1',
 'begin_publication',
 '{CALL RecordPubSync( 
    {ml s.generation_number}, 
    {ml s.username}, 
    {ml s.publication_name}, 
    {ml s.last_publication_upload}, 
    {ml s.last_publication_download}, 
    {ml s.subscription_id} )}' );

Java 示例

以下对 MobiLink 系统过程的调用在同步脚本版本 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_publication_upload,
  Timestamp last_download ) {  
  _publicationNames[ _numPublications++ ] = pub_name;
  return ( null );
}

.NET 示例

以下对 MobiLink 系统过程的调用在同步脚本版本 ver1 时将名为 BeginPub 的 .NET 方法注册为 begin_publication 连接事件的脚本。

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

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

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