异步接口使用指南

头文件:wmpf/operation.h

微信小程序 SDK 的接口存在大量异步操作。如果看到一个函数的返回值类型为wx_operation_t,则说明此函数是一个异步函数,需要在合适的时机调用如下任一函数以等待异步执行的结果:

  • wx_operation_wait():同步阻塞式等待。支持设置超时时间。
  • wx_operation_await():异步等待,不会阻塞当前线程。支持设置回调函数。

如果不关心异步操作的结果,可以调用如下函数释放wx_operation_t对象。

  • wx_operation_destroy():主动销毁wx_operation_t对象。异步操作会继续执行。

如果想取消一个异步操作,可以调用如下函数:

  • wx_operation_cancel():取消异步操作。

请特别注意wx_operation_t对象的生命周期,以免造成内存泄漏:

  • 调用 wx_operation_waitwx_operation_await 函数直至异步调用结束,那么wx_operation_t对象会被自动回收。
  • 如果调用 wx_operation_wait 超时,可以重新调用 wx_operation_wait函数以继续等待,或者调用wx_operation_cancel()主动结束此次异步调用。cancel 后wx_operation_t对象亦会被自动回收。
  • 也可以手动调用wx_operation_destroy()销毁 operation 对象,这种情况下异步操作还会继续进行,但是将不会收到异步调用的结果。

1. 同步等待

同步阻塞当前线程,直到操作完成或超时。

  • 如果操作完成(包括正常返回和接口异常的情况),wx_operation_t 将被自动释放。
  • 如果异步操作没有在指定时间内完成,返回 WXERROR_TIMEOUT。可以有以下选择:
    • 重新调用 wx_operation_wait() 继续等待;
    • 调用 wx_operation_cancel() 取消异步调用;
    • 调用 wx_operation_destroy() 销毁 operation 对象。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注