简而言之:
- 当
spawn()
被调用时,Boost.Asio 执行一些设置工作,然后将使用一个内部处理程序strand
,dispatch()
该处理程序使用用户提供的函数作为入口点创建一个协程。在某些情况下,内部处理程序可以在对 的调用中被调用spawn()
,而其他时候它会被发布到io_service
延迟调用。
- 协程被挂起,直到操作完成并调用完成处理程序,
io_service
被销毁,或者 Boost.Asio 检测到协程已被挂起而无法恢复它,此时 Boost.Asio 将销毁协程。
如上所述,当spawn()
被调用时,Boost.Asio 会执行一些设置工作,然后将使用一个内部处理程序strand
,dispatch()
该处理程序使用用户提供的函数作为入口点创建一个协程。当yield_context
对象作为处理程序传递给异步操作时,Boost.Asio 将在使用完成处理程序启动异步操作后立即产生,该完成处理程序将复制结果并恢复协程。前面提到的链归协程所有,用于保证yield发生在resume之前。让我们考虑一个简单的示例来演示 spawn()
:
#include <iostream>
#include <boost/asio.hpp>
#include <boost/asio/spawn.hpp>
boost::asio::io_service io_service;
void other_work()
{
std::cout << "Other work" << std::endl;
}
void my_work(boost::asio::yield_context yield_context)
{
// Add more work to the io_service.
io_service.post(&other_work);
// Wait on a timer within the coroutine.
boost::asio::deadline_timer timer(io_service);
timer.expires_from_now(boost::posix_time::seconds(1));
std::cout << "Start wait" << std::endl;
timer.async_wait(yield_context);
std::cout << "Woke up" << std::endl;
}
int main ()
{
boost::asio::spawn(io_service, &my_work);
io_service.run();
}
上面的示例输出:
Start wait
Other work
Woke up
这里试图说明示例的执行。中的路径|
表示活动堆栈,:
表示挂起的堆栈,箭头用于表示控制权的转移:
boost::asio::io_service io_service;
boost::asio::spawn(io_service, &my_work);
`-- dispatch a coroutine creator
into the io_service.
io_service.run();
|-- invoke the coroutine creator
| handler.
| |-- create and jump into
| | into coroutine ----> my_work()
: : |-- post &other_work onto
: : | the io_service
: : |-- create timer
: : |-- set timer expiration
: : |-- cout << "Start wait" << endl;
: : |-- timer.async_wait(yield)
: : | |-- create error_code on stack
: : | |-- initiate async_wait operation,
: : | | passing in completion handler that
: : | | will resume the coroutine
| `-- return <---- | |-- yield
|-- io_service has work (the : :
| &other_work and async_wait) : :
|-- invoke other_work() : :
| `-- cout << "Other work" : :
| << endl; : :
|-- io_service still has work : :
| (the async_wait operation) : :
| ...async wait completes... : :
|-- invoke completion handler : :
| |-- copies error_code : :
| | provided by service : :
| | into the one on the : :
| | coroutine stack : :
| |-- resume ----> | `-- return error code
: : |-- cout << "Woke up." << endl;
: : |-- exiting my_work block, timer is
: : | destroyed.
| `-- return <---- `-- coroutine done, yielding
`-- no outstanding work in
io_service, return.