begin_synchronization 连接事件

在应用程序连接到 MobiLink 服务器以便进行同步过程准备时处理任何语句。

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

SQL 脚本的参数名称	说明	顺序
s.remote_id	VARCHAR(128)。MobiLink 远程 ID。只有在使用命名参数时才能引用远程 ID。	不适用
s.username	VARCHAR(128)。MobiLink 用户名。	1

无。

在准备进行同步的应用程序与 MobiLink 服务器建立连接后，MobiLink 服务器立即执行此事件。该事件在上载事务之前的一个单独事务中执行。

begin_synchronization 脚本对于维护统计信息很有用。这是因为即使存在错误或冲突，也会调用 end_synchronization 脚本，从而使回退上载事务时，统计信息之类的内容可得到维护。

如果要在后面的脚本中多次引用用户名值，则您最好将该值存储在临时表或变量中。

CALL ml_add_connection_script ( 
  'version1', 
  'begin_synchronization', 
  'set @EmployeeID = {ml s.username}' );

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

CALL ml_add_java_connection_script( 
 'ver1',
 'begin_synchronization',
 'ExamplePackage.ExampleClass.beginSynchronizationConnection'
)

以下是 Java 方法 beginSynchronizationConnection 示例。它保存同步用户的名称供以后使用。

public String beginSynchronizationConnection(
  String user ) {  
  _curUser = user;
  return ( null );
}

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

CALL ml_add_dnet_connection_script( 'ver1',
  'begin_synchronization',
  'TestScripts.Test.BeginSync'
)

以下是 .NET 方法 BeginSync 示例。它保存同步用户的名称供以后使用。

public string BeginSync( 
  string user ) { 
  _curUser = user;
  return ( null );
}