11. SyncGuard

使用下述功能需要包含头文件coke/sync_guard.h。

coke::SyncGuard

coke非常不推荐在协程中使用同步阻塞的操作，若必须如此，应采取措施避免将handler线程全部阻塞住。

coke::SyncGuard是对WFGlobal::sync_operation_begin()和WFGlobal::sync_operation_end()的封装。合理使用这些功能，Workflow会动态调整handler线程数，使新任务总会有线程处理，避免完全阻塞。

成员函数

• 构造函数、析构函数

  若auto_sync_begin为true，构造函数会自动调用sync_operation_begin。

  SyncGuard不可拷贝，不可移动。

  若析构时in_guard()返回true，则会自动调用sync_operation_end。

  SyncGuard(bool auto_sync_begin);
  
  SyncGuard(const SyncGuard &) = delete;
  SyncGuard &operator= (const SyncGuard &) = delete;
  
  ~SyncGuard();
  

• 开始同步操作

  调用底层的WFGlobal::sync_operation_begin，但同一个线程内递归地多次使用SyncGuard，实现保证仅调用一次底层接口。

  同一个coke::SyncGuard对象的所有sync_operation_begin和sync_operation_end都必须在同一个线程内调用，包括在构造函数和析构函数中的调用，否则为错误行为。

  void sync_operation_begin();
  

• 结束同步操作

  调用底层的WFGlobal::sync_operation_end，仅在当前线程所有SyncGuard都调用sync_operation_end后才会调用底层接口。

  void sync_operation_end();
  

• 查看是否正在进行同步操作

  若已执行sync_operation_begin但尚未执行sync_operation_end则返回true，否则返回false。

  bool in_guard() const noexcept;