Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
使用下载确认时,此脚本会提供用来记录有关下载内容已被成功应用的信息的位置,或触发业务逻辑,该逻辑取决于确认为已应用的下载。
在下表中,说明部分提供 SQL 数据类型。如果您使用 Java 或 .NET 编写脚本,则应该使用相应的数据类型。请参见SQL-Java 数据类型和SQL-.NET 数据类型。
在 SQL 脚本中,可以按名称或使用问号指定事件参数。不建议使用问号,建议您使用命名参数。不能在一个脚本中混合使用名称和问号。如果使用问号,则参数必须按照如下所示的顺序并且仅当没有指定任何后继参数时才是可选的(例如,如果您想使用参数 2,则必须使用参数 1)。如果使用命名参数,则可以按照任何顺序指定任意参数子集。
s.username
VARCHAR(128)。MobiLink 用户名。
1
s.last_download
TIMESTAMP。这是当前同步的上次下载时间。
2
当在远程数据库中成功应用下载时,此事件允许您记录时间。
仅在使用下载确认时才调用此事件。将提交下载事务,且同步会在下载发送后结束。同步客户端确认成功下载时调用此事件。在原始同步的 end_synchronization 脚本之后,于新连接上调用此事件。此事件的操作与 MobiLink 系统表中下载时间的更新一起提交。
由于此脚本的特殊性质,执行此事件时,同步过程中设置的任何连接级变量均不可用。
如果下载不成功或网络连接被删除,则不存在通知且不会调用该脚本。如果及时的下载通知对您的业务需求至关重要,则应使用 prepare_for_download 脚本的 last_download 参数或 begin_publication 脚本的 last_publication_download 参数作为下载通知处理的备份。
以下脚本将记录添加到表 download_pubs_acked 中。该记录包含远程 ID、第一个验证参数和下载时间戳。
INSERT INTO download_pubs_acked( rem_id, auth_parm, last_download ) VALUES( {ml s.remote_id}, {ml a.1}, {ml s.last_download} )
以下对 MobiLink 系统过程的调用在同步脚本版本 ver1 时将名为 confirmDownload 的 Java 方法注册为 nonblocking_download_ack 事件的脚本。
CALL ml_add_java_connection_script( 'ver1', 'nonblocking_download_ack', 'ExamplePackage.ExampleClass.confirmDownload' )
以下是 Java 方法 confirmDownload 示例。它会为给定用户调用 Java 方法来执行基于已确认下载的企业逻辑,直到给定的时间戳。
public String confirmDownload( String user, Timestamp ts ) { actOnConfirmedDownloadTSForUser( _syncConn, user, ts ); return( null ); }
以下对 MobiLink 系统过程的调用在同步脚本版本 ver1 时将名为 ConfirmDownload 的 .NET 方法注册为 nonblocking_download_ack 连接事件的脚本。
CALL ml_add_dnet_connection_script( 'ver1', 'nonblocking_downlolad_ack', 'TestScripts.Test.ConfirmDownload' )
以下是 .NET 方法 ConfirmDownload 示例。它会为给定用户调用 .NET 方法来执行基于已确认下载的企业逻辑,直到给定的时间戳。
public string ConfirmDownload( string user, DateTime ts ) { ActOnConfirmedDownloadTSForUser ( _syncConn, user, ts ); return ( null ); }