Boost.Asio 提供了多个 I/O 对象以开发网络应用。 以下例子使用了 类来建立与中另一台PC的连接,并下载 'Highscore' 主页;就象一个浏览器在指向 时所要做的。
这个程序最明显的部分是三个句柄的使用:connect_handler()
和 read_handler()
函数会分别在连接被建立后以及接收到数据后被调用。 那么为什么需要 resolve_handler()
函数呢?
互联网使用了所谓的IP地址来标识每台PC。 IP地址实际上只是一长串数字,难以记住。 而记住象 www.highscore.de 这样的名字就容易得多。 为了在互联网上使用类似的名字,需要通过一个叫作域名解析的过程将它们翻译成相应的IP地址。 这个过程由所谓的域名解析器来完成,对应的 I/O 对象是:boost::asio::ip::tcp::resolver
。
域名解析也是一个需要连接到互联网的过程。 有些专门的PC,被称为DNS服务器,其作用就象是电话本,它知晓哪个IP地址被赋给了哪台PC。 由于这个过程本身的透明的,只要明白其背后的概念以及为何需要 boost::asio::ip::tcp::resolver
I/O 对象就可以了。 由于域名解析不是发生在本地的,所以它也被实现为一个异步操作。 一旦域名解析成功或被某个错误中断,resolve_handler()
函数就会被调用。
开始执行后,该应用将创建一个类型为 boost::asio::ip::tcp::resolver::query
的对象 query,表示一个查询,其中含有名字 www.highscore.de 以及互联网常用的端口80。 这个查询被传递给 async_resolve()
方法以解析该名字。 最后,main()
只要调用 I/O 服务的 run()
方法,将控制交给操作系统进行异步操作即可。
当域名解析的过程完成后, 被调用,检查域名是否能被解析。 如果解析成功,则存有错误条件的对象 _ec 被设为0。 只有在这种情况下,才会相应地访问 socket 以创建连接。 服务器的地址是通过类型为 boost::asio::ip::tcp::resolver::iterator
的第二个参数来提供的。
调用了 asyncconnect()
方法之后,connect_handler()
会被自动调用。 在该句柄的内部,会访问 _ec 对象以检查连接是否已建立。 如果连接是有效的,则对相应的 socket 调用 async_read_some()
方法,启动读数据操作。 为了保存接收到的数据,要提供一个缓冲区作为第一个参数。 在以上例子中,缓冲区的类型是 boost::array
,它来自 Boost C++ 库 Array,定义于 boost/array.hpp
.
每当有一个或多个字节被接收并保存至缓冲区时,readhandler()
函数就会被调用。 准确的字节数通过 std::size_t
类型的参数 _bytes_transferred 给出。 同样的规则,该句柄应该首先看看参数 ec 以检查有没有接收错误。 如果是成功接收,则将数据写出至标准输出流。
上个例子是用来取出 www.highscore.de 的网页的,而下一个例子则示范了一个简单的 web 服务器。 其主要差别在于,这个应用不会连接至其它PC,而是等待连接。
- #include <boost/asio.hpp>
- #include <string>
- boost::asio::io_service io_service;
- boost::asio::ip::tcp::endpoint endpoint(boost::asio::ip::tcp::v4(), 80);
- boost::asio::ip::tcp::acceptor acceptor(io_service, endpoint);
- boost::asio::ip::tcp::socket sock(io_service);
- std::string data = "HTTP/1.1 200 OK\r\nContent-Length: 13\r\n\r\nHello, world!";
- void write_handler(const boost::system::error_code &ec, std::size_t bytes_transferred)
- {
- }
- void accept_handler(const boost::system::error_code &ec)
- {
- if (!ec)
- {
- boost::asio::async_write(sock, boost::asio::buffer(data), write_handler);
- }
- int main()
- {
- acceptor.listen();
- acceptor.async_accept(sock, accept_handler);
- io_service.run();
- }
类型为 boost::asio::ip::tcp::acceptor
的 I/O 对象 acceptor - 被初始化为指定的协议和端口号 - 用于等待从其它PC传入的连接。 初始化工作是通过 endpoint 对象完成的,该对象的类型为 boost::asio::ip::tcp::endpoint
,将本例子中的接收器配置为使用端口80来等待 IP v4 的传入连接,这是 WWW 通常所使用的端口和协议。
接收器初始化完成后,main()
首先调用 listen()
方法将接收器置于接收状态,然后再用 async_accept()
方法等待初始连接。 用于发送和接收数据的 socket 被作为第一个参数传递。
当一个PC试图建立一个连接时,accepthandler()
被自动调用。 如果该连接请求成功,就执行自由函数 boost::asio::async_write()
来通过 socket 发送保存在 _data 中的信息。 boost::asio::ip::tcp::socket
还有一个名为 async_write_some()
的方法也可以发送数据;不过它会在发送了至少一个字节之后调用相关联的句柄。 该句柄需要计算还剩余多少字节,并反复调用 async_write_some()
直至所有字节发送完毕。 而使用 boost::asio::async_write()
可以避免这些,因为这个异步操作仅在缓冲区的所有字节都被发送后才结束。