source_block 类

source_block 是仅限于源的块的抽象基类。 该类提供了基本的链接管理功能，还提供了常见的错误检查。

template<
   class _TargetLinkRegistry,
   class _MessageProcessorType = ordered_message_processor<typename _TargetLinkRegistry::type::type>
>
class source_block : public ISource<typename _TargetLinkRegistry::type::type>;

参数

• _TargetLinkRegistry
  要用于保存目标链接的链接注册表。

• _MessageProcessorType
  用于消息处理的处理器类型。

成员

公共 Typedefs

Name	说明
target_iterator	要遍历已连接的目标的迭代器。

公共构造函数

Name	说明
source_block::source_block 构造函数	构造 source_block 对象。
source_block::~source_block 析构函数	销毁 source_block 对象。

公共方法

Name	说明
source_block::accept 方法	接受由此 source_block 对象提供的消息，将所有权转移给调用方。
source_block::acquire_ref 方法	获取此 source_block 对象上的引用计数，以防止删除。
source_block::consume 方法	使用先前由 source_block 对象提供并由目标成功保留的消息，将所有权转移给调用方。
source_block::link_target 方法	将目标块链接到此 source_block 对象。
source_block::release 方法	释放以前成功的消息保留。
source_block::release_ref 方法	释放此 source_block 对象上的引用数。
source_block::reserve 方法	保留此 source_block 对象之前提供的消息。
source_block::unlink_target 方法	从此 source_block 对象取消目标块的链接。
source_block::unlink_targets 方法	从该 source_block 对象断开所有目标块的链接。 （重写 ISource::unlink_targets。）

受保护的方法

Name	说明
source_block::accept_message 方法	当在派生类中重写时，接受源提供的消息。 消息块应重写此方法以验证 _MsgId 并返回一条消息。
source_block::async_send 方法	如果尚未异步对消息进行排队和开始传播任务，则完成此操作。
source_block::consume_message 方法	当在派生类中重写时，使用之前保留的消息。
source_block::initialize_source 方法	初始化此 source_block 内的 message_propagator。
source_block::link_target_notification 方法	通知新的目标已链接至此 source_block 对象的回调。
source_block::propagate_to_any_targets 方法	当在派生类中重写，将给定消息传播至任何或所有链接的目标。 这是消息块的主传播例程。
source_block::release_message 方法	当在派生类中被重写时，释放之前的消息保留。
source_block::remove_targets 方法	移除此源块的所有目标链接。 这应从析构函数调用。
source_block::reserve_message 方法	当在派生类中重写时，保留之前由该 source_block 对象提供的消息。
source_block::resume_propagation 方法	在派生类中重写时，在释放保留后恢复传播。
source_block::sync_send 方法	如果尚未同步对消息进行排队和开始传播任务，那么完成此操作。
source_block::unlink_target_notification 方法	通知目标已在此 source_block 对象中取消链接的回调。
source_block::wait_for_outstanding_async_sends 方法	等待所有异常传播完成。 该特定于传播函数的自旋等待，在消息块的析构函数中使用以确保在销毁块之前有时间完成所有异步传播。

备注

消息块应从此块派生，以利用此类提供的链接管理和同步。

继承层次结构

ISource

source_block

要求

**标头：**agents.h

命名空间： 并发

请参见

参考

Concurrency 命名空间

ISource 类