Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » MobiLink - 服务器管理 » MobiLink 事件 » 同步事件

 

end_publication 连接事件

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

参数

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

在 SQL 脚本中,可以使用名称或问号指定事件参数,但不能在一个脚本中混合使用名称和问号。如果使用问号,则参数必须按照如下所示的顺序并且仅当没有指定任何后继参数时才是可选的(例如,如果您想使用参数 2,则必须使用参数 1)。如果使用命名参数,则可以按照任何顺序指定任意参数子集。

SQL 脚本的参数名称

说明

顺序

s.generation_number

INTEGER。如果部署不使用基于文件的下载,则可以忽略此参数。缺省值是 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

缺省操作

无。

注释

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

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

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

世代号

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

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

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

另请参见
SQL 示例

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

CALL ml_add_connection_script(
   'version1',
   'end_publication',
   'CALL RecordPubEndSync( 
    {ml s.generation_number}, 
    {ml s.username}, 
    {ml s.publication_name}, 
    {ml s.last_publication_upload}, 
    {ml s.last_publication_download} )' );
Java 示例

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

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

以下是 Java 方法 endPublication 示例。它将向 MobiLink 消息日志输出一条消息。(请注意:将消息输出到 MobiLink 消息日志在开发时可能会有帮助,但会降低生产服务器的性能。)

public String endPublication(
  ianywhere.ml.script.InOutInteger generation_number,
  String user,
  String pub_name,
  Timestamp last_publication_upload,
  Timestamp last_publication_download ) {
  java.lang.System.out.println(
   "Finished synchronizing publication " + pub_name );
  return ( null );
}
.NET 示例

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

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

以下是 .NET 方法 endPub 示例。它将向 MobiLink 消息日志输出一条消息。(请注意:将消息输出到 MobiLink 消息日志在开发时可能会有帮助,但会降低生产服务器的性能。)

public string EndPub(
  ref int generation_number,
  string user,
  string pub_name,
  DateTime last_publication_upload,
  DateTime last_publication_download ) {
  System.Console.Write(
   "Finished synchronizing publication " + pub_name );
  return ( null );
}