翻译:Boost.Asio基础剖析 收藏
Basic Boost.Asio Anatomy
Boost.Asio基础剖析
Boost.Asio may be used to perform both synchronous and asynchronous operations on I/O objects such as sockets. Before using Boost.Asio it may be useful to get a conceptual picture of the various parts of Boost.Asio, your program, and how they work together.
Boost.Asio可用于在诸如socket对象上执行同步和异步操作。在使用Boost.Asio之前,了解一下Boost.Asio和你的程序的各个部分的概念图,以及它们如何一起工作,是非常有用的,
As an introductory example, let's consider what happens when you perform a connect operation on a socket. We shall start by examining synchronous operations.
作为一个入门例子,让我们了解一下,当你在执行一个socket连接时,发生了什么情况。这里我们将开始研究同步操作。
Your programwill have at least oneio_serviceobject. Theio_servicerepresentsyour program's link to theoperating system's I/O services.
你的程序将至少有一个io_service对象,这个io_service代表了你的程序到操作系统的
I/O服务的连接。
boost::asio::io_service io_service;
To perform I/O operationsyour programwill need anI/O objectsuch as a TCP socket:
为了执行I/O操作,你的程序需要一个I/O对象,如TCP socket:。
boost::asio::ip::tcp::socket socket(io_service);
When a synchronous connect operation is performed, the following sequence of events occurs:
当异步连接操作执行时,下列事件顺次发生:
1. Your programinitiates the connect operation by calling theI/O object:
你的程序通过调用I/O对象初始化连接操作,
socket.connect(server_endpoint);
2. TheI/O objectforwards the request to theio_service.
I/O转发请求到io_service.
3. Theio_servicecalls on theoperating systemto perform the connect operation.
io_service调用操作系统执行连接操作
4. Theoperating systemreturns the result of the operation to theio_service.
操作系统返回操作结果给io_service
5. Theio_servicetranslates any error resulting from the operation into a boost::system::error_code. Anerror_codemay be compared with specific values, or tested as a boolean (where afalseresult means that no error occurred). The result is then forwarded back up to theI/O object.
io_service将任何错误代码转换为boost::system::error_code,这个error_code可以和特定值比较,也可作为boolean测试(false表示没有错误发生)。结果然后转发回I/O对象
6. TheI/O objectthrows an exception of typeboost::system::system_errorif the operation failed. If the code to initiate the operation had instead been written as:
如果操作失败,I/O对象抛出boost::system::system_error类型的异常。如果初始化操作的代码按下面的方式书写:
boost::system::error_code ec;
socket.connect(server_endpoint, ec);
then theerror_codevariableecwould be set to the result of the operation, and no exception would be thrown.
那么error_code变量ec将被设置为操作的结果,并且没有异常抛出。
When an asynchronous operation is used, a different sequence of events occurs.
当使用异步操作时,将是不同的事件产生顺序
1. Your programinitiates the connect operation by calling theI/O object:
你的程序通过调用I/O对象初始化连接操作
socket.async_connect(server_endpoint, your_completion_handler);
whereyour_completion_handleris a function or function object with the signature:
这里your_completion_handler是一个带有signature (目标识别特征)的函数或函数对象:
void your_completion_handler(const boost::system::error_code& ec);
The exact signature required depends on the asynchronous operation being performed. The reference documentation indicates the appropriate form for each operation.
确切的signature (目标识别特征)根据执行的异步操作的不同而不同,参考文档为每个操作列出了正确的形式。
2. TheI/O objectforwards the request to theio_service.
I/O对象将请求转发给io_service
3. Theio_servicesignals to theoperating systemthat it should start an asynchronous connect.
io_service通知操作系统,告诉操作系统启动一个异步连接
Time passes. (In the synchronous case this wait would have been contained entirely within the duration of the connect operation.)
过一段时间。(在同步操作的情况下,这个等待是整个连接操作的时间)
4. Theoperating systemindicates that the connect operation has completed by placing the result on a queue, ready to be picked up by theio_service.
操作系统通过在队列里放置一个结果来指示连接操作已经完成,这个结果等待io_service来取。
5.Your programmust make a call toio_service::run()(or to one of the similario_servicemember functions) in order for the result to be retrieved. A call toio_service::run()blocks while there are unfinished asynchronous operations, so you would typically call it as soon as you have started your first asynchronous operation.
为了确保结果能够被收到,你的程序必须调用io_service::run()(或相似的io_service成员函数)。当有未完成的操作时,io_service::run()的调用被阻塞,所以你要在第一次启动异步操作后尽快调用io_service::run()。
6. While inside the call toio_service::run(), theio_servicedequeues the result of the operation, translates it into anerror_code, and then passes it toyour completion handler.
在io_service::run()内部,io_service从队列移除操作结果,转换为error_code,并传递给your completion handler
源文档 <http://blog.csdn.net/asmc51/archive/2009/09/09/4536287.aspx>