如何设计一个C++ API

我的建议是查看Boost::ASIO的文档和教程(您可以将其用作Boost的一部分或独立的部分 阿西奥 项目,但我猜需求不是外部libs,而不仅仅是没有提升)。

通常,阻塞调用定义起来很简单,而非阻塞操作需要一些回调机制,以便在操作完成时通知用户操作结果。同样,请看一下教程和文档,了解一个干净的界面,这样浏览起来比浏览标题容易得多。

编辑:ASIO支持不同的协议,因此它可能比您需要的更复杂,请阅读其中一个示例并了解如何使用回调机制。

关于异步调用的使用,我建议阅读 future 对于C++ 0x。

基本上,这个想法是将代理交给用户,而不是简单的类型。此代理了解线程,可用于:

• 关于完成情况的投票
• 得到结果

您还可以添加一些聪明的机制,例如尝试在固定的持续时间内获得结果,或者在某个固定的时间点之前获得结果,如果任务没有及时完成,则放弃(暂时)(例如,做其他事情,稍后再试,或者简单地继续并忘记这一点)。

C++0x的新线程API已经非常巧妙地设计(主要是在Booost。线程之后),它将给您提供关于如何设计多线程的深刻见解。