文章摘要
本文介绍了在调用服务器方法时,服务器会返回一个调用对象,该对象包含方法的返回值和状态信息。调用对象的主要属性包括唯一标识号(id)、返回值(return_value)、粗数据(data)、状态(status)、错误信息(message)、回调函数(callback和error_callback)以及上下文(context)。文章还列出了与调用对象相关的常见方法,如`wait`(等待特定异步调用完成)和`cancel`(停止当前异步调用),并简要说明了这些方法的用途。
文档: 调用对象属性和方法
当您调用一个服务器方法时,该方法不返回单个值。而是创建一个调用对象,该对象包含被调用过程的返回值和状态信息。下表列出了调用对象的属性。
属性 描述
id
调用的唯一标识号,它是首次调用时产生的。
return_value
方法的返回值──如果有的话。
data
产生 remote scripting 调用时,服务器返回的粗数据,是以 XML 标记封装的。有关详细信息,请参阅检查错误。
status
指示方法调用当前状态的值。可能值包括:
-1 失败
0 完成
1 挂起
有关详细信息,请参阅异步调用 Remote Scripting 方法。
message
和调用有关的文本信息。如果调用成功,那么 message 包含值“完成”。如果失败,那么 message 可能包含服务器返回的错误文本或者一条标准错误消息。有关详细信息,请参阅检查错误。
callback
调用中指定的可选回调函数文本。
error_callback
调用中指定的可选错误回调函数文本。
context
随调用传递的上下文值。有关详细信息,请参阅异步调用 Remote Scripting 方法。
下表列出了您能为调用对象调用的方法。
方法 描述
wait 停止当前正执行的客户脚本,直到指定调用对象的一个异步 remote scripting 调用完成。
cancel 停止某个正异步执行的 remote scripting 调用。
关于调用对象的详细信息,请参阅同步调用 Remote Scripting 方法和异步调用 Remote Scripting 方法。
© 版权声明
文章版权归作者所有,未经允许请勿转载。