5. 引用

5.1 异步操作的要求

在Asio中,异步操作由一个以前缀async_命名的函数启动。 这些功能将被称为启动功能。
Asio中的所有启动函数都将满足处理程序需求的函数对象作为最终参数。 这些处理程序接受第一个参数为类型const error_code的左值。
Asio中异步操作的实现可以调用操作系统提供的应用程序编程接口(API)。 如果这样的操作系统API调用导致错误,则会使用const error_code左值调用该处理程序,其值为true。 否则,处理程序将被调用一个const error_code左值,其值为false。
除非另有说明,否则当异步操作的行为被定义为“仿佛”由POSIX函数实现时,处理程序将被调用一个类型为error_code的值,该值与POSIX为该函数描述的失败条件(如果有)相对应。 否则,将使用实现定义的error_code值调用处理程序,该值反映操作系统错误。
异步操作不会因错误条件而失败,表明信号中断(POSIX EINTR)。 异步操作不会因任何与非阻塞操作(POSIX EWOULDBLOCK,EAGAIN或EINPROGRESS; Windows WSAEWOULDBLOCK或WSAEINPROGRESS)相关的错误条件而失败。
所有异步操作都有一个关联的io_service对象。 如果启动函数是成员函数,则相关的io_service是由同一对象上的get_io_service()成员函数返回的。 在初始化函数不是成员函数的情况下,关联的io_service是由启动函数的第一个参数的get_io_service()成员函数返回的。

启动函数的参数将被视为如下:

  • 如果参数声明为const引用或by-value,则在启动函数完成后,程序不需要保证参数的有效性。 该实现可以创建参数副本,并且所有副本将在调用处理程序后立即销毁。
  • 如果参数被声明为非const引用,const指针或非const指针,那么程序必须保证参数的有效性,直到调用处理程序。

只允许库实现从一个满足以下条件之一的线程调用启动函数参数的拷贝构造函数或析构函数:

  • 线程正在执行关联的io_service对象的任何成员函数。
  • 线程正在执行关联的io_service对象的析构函数。
  • 线程正在执行io_service服务访问函数use_service,add_service或has_service之一,其中第一个参数是关联的io_service对象。
  • 线程正在执行本子句中定义的类的对象的任何成员函数,构造函数或析构函数,其中对象的get_io_service()成员函数返回关联的io_service对象。
  • 线程正在执行本节中定义的任何函数,其中该函数的任何参数都有一个返回关联的io_service对象的get_io_service()成员函数。
    与异步操作关联的io_service对象将有未完成的工作,就像通过维护一个或多个使用io_service构造的io_service :: work对象的存在一样,直到调用异步操作的处理程序之后。

当异步操作完成时,操作的处理程序将按如下方式调用:

  1. 如下所述构造处理程序的绑定完成处理程序bch
  2. 调用ios.post(bch)来为延迟调用安排处理程序,其中ios是关联的io_service。

这意味着即使异步操作立即完成,也不能从启动函数内直接调用处理函数。

绑定完成处理程序是一个处理程序对象,它包含用户提供的处理程序的副本,其中用户提供的处理程序接受一个或多个参数。 绑定完成处理程序不接受任何参数,并且包含要作为参数传递给用户提供的处理程序的值。 绑定完成处理程序将asio_handler_allocate(),asio_handler_deallocate()和asio_handler_invoke()调用转发给用户提供的处理函数的相应函数。 绑定完成处理程序符合完成处理程序的要求。

例如,一个ReadHandler的绑定完成处理程序可能被实现如下:

template<class ReadHandler>
struct bound_read_handler
{
  bound_read_handler(ReadHandler handler, const error_code& ec, size_t s)
    : handler_(handler), ec_(ec), s_(s)
    { }
  void operator()()
  {
    handler_(ec_, s_);
  }
  ReadHandler handler_;
  const error_code ec_;
  const size_t s_;
};
template<class ReadHandler>
void* asio_handler_allocate(size_t size,
  bound_read_handler<ReadHandler>* this_handler)
{
  using asio::asio_handler_allocate;
  return asio_handler_allocate(size, &this_handler->handler_);
}

Asio可能会使用一个或多个隐藏线程来模拟异步功能。 上述要求旨在防止这些隐藏的线程调用程序代码。 这意味着,例如,程序可以在处理程序对象中使用线程不安全的引用计数,前提是该程序确保所有对io_service和相关对象的调用都来自一个线程。

template<class ReadHandler>
void asio_handler_deallocate(void* pointer, std::size_t size,
  bound_read_handler<ReadHandler>* this_handler)
{
  using asio::asio_handler_deallocate;
  asio_handler_deallocate(pointer, size, &this_handler->handler_);
}
template<class F, class ReadHandler>
void asio_handler_invoke(const F& f,
  bound_read_handler<ReadHandler>* this_handler)
{
  using asio::asio_handler_invoke;
  asio_handler_invoke(f, &this_handler->handler_);
}

如果启动异步操作的线程在调用关联的处理程序之前终止,则行为是已定义的。 特别是,在Vista之前的Windows版本中,当启动线程退出时,未完成的操作将被取消。

初始化函数的处理程序参数定义处理程序标识。 也就是说,原始处理程序参数和处理程序参数的任何副本将被视为等同。 如果实现需要为异步操作分配存储空间,则实现将执行asio_handler_allocate(size,&h),其中size是所需的大小(以字节为单位),以及他的处理程序。 该实现将执行asio_handler_deallocate(p,size,&h),其中p是指向存储的指针,以便在通过asio_handler_invoke调用处理程序之前释放存储空间。 可以为单个异步操作分配多个存储块。

启动函数的返回类型

默认情况下,启动函数返回void。 当处理程序是函数指针,C ++ 11 lambda或由boost :: bind或std :: bind产生的函数对象时,情况总是如此。
对于其他类型,返回类型可以通过两个步骤来定制:

  1. handler_type模板的专门化,用于根据异步操作的处理程序签名来确定真正的处理程序类型。
  2. async_result模板的专门化,用于确定返回类型并从处理程序中提取返回值。

这两个模板专门为堆栈协程和C ++ 11 std :: future类提供支持。
例如,考虑使用asio :: use_future特殊值启用std :: future支持时会发生的情况,如下所示:

std::future<std::size_t> length =
  my_socket.async_read_some(my_buffer, asio::use_future);

当处理程序签名的格式如下:

void handler(error_code ec, result_type result);

启动函数返回一个在result_type上模板化的std :: future。 在上面的async_read_some例子中,这是std :: size_t。 如果异步操作失败,则error_code将转换为system_error异常,并在未来传回给调用者。

处理器签名的形式如下:

void handler(error_code ec);

启动函数返回std :: future <void>.

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,636评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,890评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,680评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,766评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,665评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,045评论 1 276
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,515评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,182评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,334评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,274评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,319评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,002评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,599评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,675评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,917评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,309评论 2 345
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,885评论 2 341

推荐阅读更多精彩内容