C++ 开发 Web 服务框架 - HTTP Web 框架的设计与实现(二)

C++ 开发 Web 服务框架 - HTTP Web 框架的设计与实现

一、概述

项目介绍

服务器开发中 Web 服务是一个基本的代码单元,将服务端的请求和响应部分的逻辑抽象出来形成框架,能够做到最高级别的框架级代码复用。本次项目将综合使用 C++11 及 Boost 中的 Asio 实现 HTTP 和 HTTPS 的服务器框架。

项目涉及的知识点

  • C++基本知识
    • 面向对象
    • 模板
    • 命名空间
    • 常用 IO 库
  • C++11 相关
    • lambda expression
    • std::shared_ptr
    • std::make_shared
    • std::unordered_map
    • std::regex
    • std::smatch
    • std::regex_match
    • std::function
    • std::thread
  • Boost Asio 相关
    • boost::asio::io_service
    • boost::asio::ip::tcp::socket
    • boost::asio::ip::tcp::v4()
    • boost::asio::ip::tcp::endpoint
    • boost::asio::ip::tcp::acceptor
    • boost::asio::streambuf
    • boost::asio::async_read
    • boost::asio::async_read_until
    • boost::asio::async_write
    • boost::asio::transfer_exactly
    • boost::asio::ssl::stream
    • boost::asio::ssl::stream_base::server
    • boost::asio::ssl::context
    • boost::asio::ssl::context::sslv23
    • boost::asio::ssl::context::pem
    • boost::system::error_code

编译环境提示

在 g++ 4.9 之前,regex 库并不支持 ECMAScript 的正则语法,换句话说,在 g++4.9 之前,g++ 对 C++11 标准库的支持并不完善,为保证本次项目的顺利进行,请确保将 g++ 版本升级至 4.9 以上。

 
  1. // 下面的这段代码可以测试你的编译器对正则表达式的支持情况

  2. #include <iostream>

  3. #include <regex>

  4.  
  5. int main()

  6. {

  7. std::regex r1("S");

  8. printf("S works.\n");

  9. std::regex r2(".");

  10. printf(". works.\n");

  11. std::regex r3(".+");

  12. printf(".+ works.\n");

  13. std::regex r4("[0-9]");

  14. printf("[0-9] works.\n");

  15. return 0;

  16. }

如果你的运行结果遇到了下图所示的错误,说明你确实需要升级你的 g++ 了:

此处输入图片的描述

使用 g++ -v 可以查看到当前编译器版本:

此处输入图片的描述

如果你最后一行中的 gcc version 显示的是 4.8.x,那么你需要手动将编译器版本升级至 4.9 以上,方法如下:

 
  1. # 安装 add-apt-repository 工具

  2. sudo apt-get install software-properties-common

  3. # 增加源

  4. sudo add-apt-repository ppa:ubuntu-toolchain-r/test

  5. # 更新源

  6. sudo apt-get update

  7. # 更新安装

  8. sudo apt-get upgrade

  9. # 安装 gcc/g++ 4.9

  10. sudo apt-get install gcc-4.9 g++-4.9

  11. # 更新链接

  12. sudo updatedb

  13. sudo ldconfig

  14. sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.8 48 \

  15. --slave /usr/bin/g++ g++ /usr/bin/g++-4.8 \

  16. --slave /usr/bin/gcc-ar gcc-ar /usr/bin/gcc-ar-4.8 \

  17. --slave /usr/bin/gcc-nm gcc-nm /usr/bin/gcc-nm-4.8 \

  18. --slave /usr/bin/gcc-ranlib gcc-ranlib /usr/bin/gcc-ranlib-4.8

  19. sudo update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-4.9 49 \

  20. --slave /usr/bin/g++ g++ /usr/bin/g++-4.9 \

  21. --slave /usr/bin/gcc-ar gcc-ar /usr/bin/gcc-ar-4.9 \

  22. --slave /usr/bin/gcc-nm gcc-nm /usr/bin/gcc-nm-4.9 \

  23. --slave /usr/bin/gcc-ranlib gcc-ranlib /usr/bin/gcc-ranlib-4.9

设计前的思考

我们知道,HTTP 和 HTTPS 都是应用层的一种协议,他们的底层实际上是通过 TCP 进行传输的。因此,要实现一个 Web 框架,就必须要对浏览器访问 Web 服务器的过程做一个了解。

首先,服务端已经运行起了服务,因此在服务器启动后便开始通过 Socket 监听端口上的请求。这时,客户端浏览器想要访问服务器资源时,就会发送相应的 HTTP 或者 HTTPS 请求。当服务端收到请求后,就会处理这部分请求,返回客户端所需的资源。

仔细思考后不难发现,HTTP 和 HTTPS 两种方式的服务器之间在处理请求、返回请求唯一区别就在于他们究竟如何处理与客户端建立连接的方式上,也就是常说的 accept() 方法。

因此,我们在设计基类的时候,就可以将 accept() 方法设计成一个虚函数,留给具体的子类来实现这个方法,而真正对于服务器内部的相关逻辑,全部由基类 ServerBase 来实现。

对此,我们先确定好基类的基本设计,在ServerBase模板类中,我们只需预留一个接口start()用于启动服务器给外部调用。

由于子类需要实现虚函数 accept() 的具体方式,因此需要保留为 protected,由于我们需要对请求进行解析和应答,而这部分逻辑其实是与协议类型无关的,因此我们可以将这部分逻辑直接放到 ServerBase 中进行实现,到目前为止,我们有:

 
  1. #ifndef SERVER_BASE_HPP

  2. #define SERVER_BASE_HPP

  3.  
  4. #include <unordered_map>

  5. #include <thread>

  6.  
  7. namespace ShiyanlouWeb {

  8.  
  9. // socket_type 为 HTTP or HTTPS

  10. template <typename socket_type>

  11. class ServerBase {

  12. public:

  13. // 启动服务器

  14. void start();

  15. protected:

  16. // 需要不同类型的服务器实现这个方法

  17. virtual void accept() {}

  18. // 处理请求和应答

  19. void process_request_and_respond(std::shared_ptr<socket_type> socket) const;

  20. };

  21.  
  22. template<typename socket_type>

  23. class Server : public ServerBase<socket_type> {};

  24. }

  25. #endif /* SERVER_BASE_HPP */

二、设计 ServerBase

实现一个 Web 服务器,最重要的就是对来自客户端的请求信息进行解析,为此,我们需要在 ShiyanlouWeb 命名空间中定义一个 Request 结构体:

 
  1. struct Request {

  2. // 请求方法, POST, GET; 请求路径; HTTP 版本

  3. std::string method, path, http_version;

  4. // 对 content 使用智能指针进行引用计数

  5. std::shared_ptr<std::istream> content;

  6. // 哈希容器, key-value 字典

  7. std::unordered_map<std::string, std::string> header;

  8. // 用正则表达式处理路径匹配

  9. std::smatch path_match;

  10. };

这个结构体用于解析请求,如请求方法,请求路径,HTTP 版本等信息。同时,并定义一个 std::istream 指针来保存请求体中包含的内容,由于我们并不关心 header 中信息的顺序,所以可以考虑使用 std::unordered_map 来指定一个无序容器,保存 header。此外,由于还需要对请求路径进行解析,我们不妨用正则表达式来处理这部分的解析。

在定义好请求后,我们还需要考虑服务器资源的类型。这个资源类型,决定了我们如何让别人使用我们的库,首先我们定义资源类型:

 
  1. typedef std::map<std::string, std::unordered_map<std::string,

  2. std::function<void(std::ostream&, Request&)>>> resource_type;

并在ServerBase中定义好资源成员:

 
  1. template <typename socket_type>

  2. class ServerBase {

  3. public:

  4. // 用于服务器访问资源处理方式

  5. resource_type resource;

  6. // 用于保存默认资源的处理方式

  7. resource_type default_resource;

  8. protected:

  9. // 用于内部实现对所有资源的处理

  10. std::vector<resource_type::iterator> all_resources;

  11. ……

首先,resource_type 是一个 std::map,其键为一个字符串,值则为一个无序容器std::unordered_map,这个无序容器的键依然是一个字符串,其值接受一个返回类型为空、参数为 ostream 和 Request 的函数。

因此,我们在使用这套框架的时候,当我们有了一个 Server 的对象,定义资源可以是如下的形式:

 
  1. // 处理访问 /info 的 GET 请求, 返回请求的信息

  2. server.resource["^/info/?$"]["GET"] = [](ostream& response, Request& request) {

  3. // 处理请求及资源

  4. // ...

  5. };

其中,std::map 用于存储请求路径的正则表达式,而 std::unordered_map 用于存储请求方法,而最后通过一个匿名 Lambda 函数来保存处理方法。有了资源类型,我们仅仅只是定义了当他人使用这套框架时的接口。

为此,我们还需要考虑实现其他接口需要的成员及方法。

首先,Boost Asio 库要求每一个应用都具有一个 io_service 对象的调度器,而实现 TCP socket 连接,就需要一个 acceptor 对象,而初始化一个 acceptor 还需要有一个 endpoint 对象,因此,我们需要在 ServerBase 类中的 protected 作用域内定义:

 
  1. boost::asio::io_service m_io_service;

  2. boost::asio::ip::tcp::endpoint endpoint;

  3. boost::asio::ip::tcp::acceptor acceptor;

单个线程的服务器注定是鸡肋的,所以我们不妨在内部实现一个线程池,所以我们可以继续定义:

 
  1. size_t num_threads;

  2. std::vector<std::thread> threads;

整个 ServerBase 应该在被构造时完成一些关键成员的初始化,对于 endpoint 我们可以将其通过tcp::v4()及申明的端口号进行初始化,完成后,在将 io_service 对象和 endpoint 共同交给 acceptor 进行初始化,因此我们有构造函数:

 
  1. ServerBase(unsigned short port, size_t num_threads=1) :

  2. endpoint(boost::asio::ip::tcp::v4(), port),

  3. acceptor(m_io_service, endpoint),

  4. num_threads(num_threads) {}

至此,我们整个 ServerBase 中的设计就变成了:

 
  1. //

  2. // server_base.hpp

  3. // web_server

  4. // created by changkun at shiyanlou.com

  5. //

  6.  
  7. #ifndef SERVER_BASE_HPP

  8. #define SERVER_BASE_HPP

  9.  
  10. #include <boost/asio.hpp>

  11.  
  12. #include <regex>

  13. #include <unordered_map>

  14. #include <thread>

  15.  
  16. namespace ShiyanlouWeb {

  17. struct Request {

  18. // 请求方法, POST, GET; 请求路径; HTTP 版本

  19. std::string method, path, http_version;

  20. // 对 content 使用智能指针进行引用计数

  21. std::shared_ptr<std::istream> content;

  22. // 哈希容器, key-value 字典

  23. std::unordered_map<std::string, std::string> header;

  24. // 用正则表达式处理路径匹配

  25. std::smatch path_match;

  26. };

  27.  
  28. // 使用 typedef 简化资源类型的表示方式

  29. typedef std::map<std::string, std::unordered_map<std::string,

  30. std::function<void(std::ostream&, Request&)>>> resource_type;

  31.  
  32. // socket_type 为 HTTP or HTTPS

  33. template <typename socket_type>

  34. class ServerBase {

  35. public:

  36. resource_type resource;

  37. resource_type default_resource;

  38.  
  39. // 构造服务器, 初始化端口, 默认使用一个线程

  40. ServerBase(unsigned short port, size_t num_threads=1) :

  41. endpoint(boost::asio::ip::tcp::v4(), port),

  42. acceptor(m_io_service, endpoint),

  43. num_threads(num_threads) {}

  44.  
  45. void start();

  46. protected:

  47. // asio 库中的 io_service 是调度器,所有的异步 IO 事件都要通过它来分发处理

  48. // 换句话说, 需要 IO 的对象的构造函数,都需要传入一个 io_service 对象

  49. boost::asio::io_service m_io_service;

  50. // IP 地址、端口号、协议版本构成一个 endpoint,并通过这个 endpoint 在服务端生成

  51. // tcp::acceptor 对象,并在指定端口上等待连接

  52. boost::asio::ip::tcp::endpoint endpoint;

  53. // 所以,一个 acceptor 对象的构造都需要 io_service 和 endpoint 两个参数

  54. boost::asio::ip::tcp::acceptor acceptor;

  55.  
  56. // 服务器线程

  57. size_t num_threads;

  58. std::vector<std::thread> threads;

  59.  
  60. // 所有的资源及默认资源都会在 vector 尾部添加, 并在 start() 中创建

  61. std::vector<resource_type::iterator> all_resources;

  62.  
  63. // 需要不同类型的服务器实现这个方法

  64. virtual void accept() {}

  65.  
  66. // 处理请求和应答

  67. void process_request_and_respond(std::shared_ptr<socket_type> socket) const;

  68. };

  69.  
  70. template<typename socket_type>

  71. class Server : public ServerBase<socket_type> {};

  72. }

  73. #endif /* SERVER_BASE_HPP */

三、实现 ServerBase

真正要实现的只有两个方法:

  1. void ServerBase::start()
  2. void ServerBase::process_request_and_respond()

首先来实现 start()。实现 start() 时,我们要将考虑下面几个问题:

  1. 默认资源应该在最后被添加到 all_resources 中,当我们处理请求路径时,应该先处理好所有的非特殊路径,当找不到匹配请求路径时,再使用默认的请求资源。
  2. 当指定启用多个线程时,线程启动后需要让线程各自等待,直到整个请求应答过程结束
 
  1. void start() {

  2. // 默认资源放在 vector 的末尾, 用作默认应答

  3. // 默认的请求会在找不到匹配请求路径时,进行访问,故在最后添加

  4. for(auto it=resource.begin(); it!=resource.end();it++) {

  5. all_resources.push_back(it);

  6. }

  7. for(auto it=default_resource.begin(); it!=default_resource.end();it++) {

  8. all_resources.push_back(it);

  9. }

  10.  
  11. // 调用 socket 的连接方式,还需要子类来实现 accept() 逻辑

  12. accept();

  13.  
  14. // 如果 num_threads>1, 那么 m_io_service.run()

  15. // 将运行 (num_threads-1) 线程成为线程池

  16. for(size_t c=1;c<num_threads;c++) {

  17. threads.emplace_back([this](){

  18. m_io_service.run();

  19. });

  20. }

  21.  
  22. // 主线程

  23. m_io_service.run();

  24.  
  25. // 等待其他线程,如果有的话, 就等待这些线程的结束

  26. for(auto& t: threads)

  27. t.join();

  28. }

再来实现 process_request_and_respond()

 
  1. // 处理请求和应答

  2. void process_request_and_respond(std::shared_ptr<socket_type> socket) const {

  3. // 为 async_read_untile() 创建新的读缓存

  4. // shared_ptr 用于传递临时对象给匿名函数

  5. // 会被推导为 std::shared_ptr<boost::asio::streambuf>

  6. auto read_buffer = std::make_shared<boost::asio::streambuf>();

  7.  
  8. boost::asio::async_read_until(*socket, *read_buffer, "\r\n\r\n",

  9. [this, socket, read_buffer](const boost::system::error_code& ec, size_t bytes_transferred) {

  10. if(!ec) {

  11. // 注意:read_buffer->size() 的大小并一定和 bytes_transferred 相等, Boost 的文档中指出:

  12. // 在 async_read_until 操作成功后, streambuf 在界定符之外可能包含一些额外的的数据

  13. // 所以较好的做法是直接从流中提取并解析当前 read_buffer 左边的报头, 再拼接 async_read 后面的内容

  14. size_t total = read_buffer->size();

  15.  
  16. // 转换到 istream

  17. std::istream stream(read_buffer.get());

  18.  
  19. // 被推导为 std::shared_ptr<Request> 类型

  20. auto request = std::make_shared<Request>();

  21.  
  22. // 接下来要将 stream 中的请求信息进行解析,然后保存到 request 对象中

  23. ……

  24. });

  25. }

当我们通过 read_buffer 拿到 istream 对象后,就需要对这个这些信息进行解析,然后保存到 request 中,为此,我们不妨增加一个 parse_request() 方法:

 
  1. // 解析请求

  2. Request parse_request(std::istream& stream) const {

  3. Request request;

  4.  
  5. // 使用正则表达式对请求报头进行解析,通过下面的正则表达式

  6. // 可以解析出请求方法(GET/POST)、请求路径以及 HTTP 版本

  7. std::regex e("^([^ ]*) ([^ ]*) HTTP/([^ ]*)$");

  8.  
  9. std::smatch sub_match;

  10.  
  11. //从第一行中解析请求方法、路径和 HTTP 版本

  12. std::string line;

  13. getline(stream, line);

  14. line.pop_back();

  15. if(std::regex_match(line, sub_match, e)) {

  16. request.method = sub_match[1];

  17. request.path = sub_match[2];

  18. request.http_version = sub_match[3];

  19.  
  20. // 解析头部的其他信息

  21. bool matched;

  22. e="^([^:]*): ?(.*)$";

  23. do {

  24. getline(stream, line);

  25. line.pop_back();

  26. matched=std::regex_match(line, sub_match, e);

  27. if(matched) {

  28. request.header[sub_match[1]] = sub_match[2];

  29. }

  30. } while(matched==true);

  31. }

  32. return request;

  33. }

然后我们来继续实现 process_request_and_respond() 方法:

 
  1. // 处理请求和应答

  2. void process_request_and_respond(std::shared_ptr<socket_type> socket) const {

  3. auto read_buffer = std::make_shared<boost::asio::streambuf>();

  4. boost::asio::async_read_until(*socket, *read_buffer, "\r\n\r\n",

  5. [this, socket, read_buffer](const boost::system::error_code& ec, size_t bytes_transferred) {

  6. if(!ec) {

  7. ……

  8.  
  9. // 被推导为 std::shared_ptr<Request> 类型

  10. auto request = std::make_shared<Request>();

  11. *request = parse_request(stream);

  12.  
  13. size_t num_additional_bytes = total-bytes_transferred;

  14.  
  15. // 如果满足,同样读取

  16. if(request->header.count("Content-Length")>0) {

  17. boost::asio::async_read(*socket, *read_buffer,

  18. boost::asio::transfer_exactly(stoull(request->header["Content-Length"]) - num_additional_bytes),

  19. [this, socket, read_buffer, request](const boost::system::error_code& ec, size_t bytes_transferred) {

  20. if(!ec) {

  21. // 将指针作为 istream 对象存储到 read_buffer 中

  22. request->content = std::shared_ptr<std::istream>(new std::istream(read_buffer.get()));

  23. respond(socket, request);

  24. }

  25. });

  26. } else {

  27. respond(socket, request);

  28. }

  29. }

  30. });

  31. }

最后,在代码的最后,我们需要将请求的内容和 socket 一同传递给 respond() 来处理应答,因此,还需要增加一个 respond() 方法:

 
  1. // 应答

  2. void respond(std::shared_ptr<socket_type> socket, std::shared_ptr<Request> request) const {

  3. // 对请求路径和方法进行匹配查找,并生成响应

  4. for(auto res_it: all_resources) {

  5. std::regex e(res_it->first);

  6. std::smatch sm_res;

  7. if(std::regex_match(request->path, sm_res, e)) {

  8. if(res_it->second.count(request->method)>0) {

  9. request->path_match = move(sm_res);

  10.  
  11. // 会被推导为 std::shared_ptr<boost::asio::streambuf>

  12. auto write_buffer = std::make_shared<boost::asio::streambuf>();

  13. std::ostream response(write_buffer.get());

  14. res_it->second[request->method](response, *request);

  15.  
  16. // 在 lambda 中捕获 write_buffer 使其不会再 async_write 完成前被销毁

  17. boost::asio::async_write(*socket, *write_buffer,

  18. [this, socket, request, write_buffer](const boost::system::error_code& ec, size_t bytes_transferred) {

  19. // HTTP 持久连接(HTTP 1.1), 递归调用

  20. if(!ec && stof(request->http_version)>1.05)

  21. process_request_and_respond(socket);

  22. });

  23. return;

  24. }

  25. }

  26. }

  27. }

四、实现 HTTP Server

当我们实现完报头解析、请求应答这两个重要的逻辑之后,剩下的,就是对针对不同类型的服务器实现不同的 accept() 方法了。

在 Boost 中,HTTP 类型就是普通的 socket 类型(boost::asio::ip::tcp::socket)。为此,我们可以通过以下不到四十行代码简单实现 HTTP 服务器:

 
  1. //

  2. // server_http.hpp

  3. // web_server

  4. // created by changkun at shiyanlou.com

  5. //

  6.  
  7. #ifndef SERVER_HTTP_HPP

  8. #define SERVER_HTTP_HPP

  9.  
  10. #include "server_base.hpp"

  11.  
  12. namespace ShiyanlouWeb {

  13. typedef boost::asio::ip::tcp::socket HTTP;

  14. template<>

  15. class Server<HTTP> : public ServerBase<HTTP> {

  16. public:

  17. // 通过端口号、线程数来构造 Web 服务器, HTTP 服务器比较简单,不需要做相关配置文件的初始化

  18. Server(unsigned short port, size_t num_threads=1) :

  19. ServerBase<HTTP>::ServerBase(port, num_threads) {};

  20. private:

  21. // 实现 accept() 方法

  22. void accept() {

  23. // 为当前连接创建一个新的 socket

  24. // Shared_ptr 用于传递临时对象给匿名函数

  25. // socket 会被推导为 std::shared_ptr<HTTP> 类型

  26. auto socket = std::make_shared<HTTP>(m_io_service);

  27.  
  28. acceptor.async_accept(*socket, [this, socket](const boost::system::error_code& ec) {

  29. // 立即启动并接受一个连接

  30. accept();

  31. // 如果出现错误

  32. if(!ec) process_request_and_respond(socket);

  33. });

  34. }

  35. };

  36. }

  37. #endif /* SERVER_HTTP_HPP */

五、编写测试

现在我们可以来正式使用我们的框架了。到目前为止,我们一共创建了下面的这些文件:

 
  1. src

  2. ├── server_base.hpp

  3. └── server_http.hpp

我们的 HTTP Web 框架就只有这两个核心文件。

下面我们可以基于我们的 Web 框架开发一个 Web 服务器了:

首先,我们创建好 main 逻辑:

 
  1. //

  2. // main_http.cpp

  3. // web_server

  4. // created by changkun at shiyanlou.com

  5. //

  6.  
  7. #include "server_http.hpp"

  8. #include "handler.hpp"

  9.  
  10. using namespace ShiyanlouWeb;

  11.  
  12. int main() {

  13. // HTTP 服务运行在 12345 端口,并启用四个线程

  14. Server<HTTP> server(12345, 4);

  15. start_server<Server<HTTP>>(server);

  16. return 0;

  17. }

在这个逻辑中,有 start_server<T>() 这个方法,传递了一个 Server<HTTP> 对象。 而 handler.hpp 则负责实现我们整个 HTTP Web 服务器实例的逻辑。

在开发这个处理逻辑的时候,我们之前提到的框架资源类型定义了我们向外提供的接口,使用形式如下所示:

 
  1. // 处理访问 /info 的 GET 请求, 返回请求的信息

  2. server.resource["^/info/?$"]["GET"] = [](ostream& response, Request& request) {

  3. // 处理请求及资源

  4. // ...

  5. };

为了测试 GET 请求和 POST 请求,我们先创建一个 www 目录来存放我们的 Web 资源,随便编写一些 HTML 代码:

 
  1. <!-- www/index.html -->

  2. <html>

  3. <head>

  4. <title>Shiyanlou Web Server Test</title>

  5. </head>

  6. <body>

  7. Hello world in index.html.

  8. </body>

  9. </html>

我们可以编写下面的服务器测试代码:

 
  1. //

  2. // handler.hpp

  3. // web_server

  4. // created by changkun at shiyanlou.com

  5. //

  6.  
  7. #include "server_base.hpp"

  8. #include <fstream>

  9.  
  10. using namespace std;

  11. using namespace ShiyanlouWeb;

  12.  
  13. template<typename SERVER_TYPE>

  14. void start_server(SERVER_TYPE &server) {

  15. // 向服务器增加请求资源的处理方法

  16.  
  17. // 处理访问 /string 的 POST 请求,返回 POST 的字符串

  18. server.resource["^/string/?$"]["POST"] = [](ostream& response, Request& request) {

  19. // 从 istream 中获取字符串 (*request.content)

  20. stringstream ss;

  21. *request.content >> ss.rdbuf(); // 将请求内容读取到 stringstream

  22. string content=ss.str();

  23.  
  24. // 直接返回请求结果

  25. response << "HTTP/1.1 200 OK\r\nContent-Length: " << content.length() << "\r\n\r\n" << content;

  26. };

  27.  
  28. // 处理访问 /info 的 GET 请求, 返回请求的信息

  29. server.resource["^/info/?$"]["GET"] = [](ostream& response, Request& request) {

  30. stringstream content_stream;

  31. content_stream << "<h1>Request:</h1>";

  32. content_stream << request.method << " " << request.path << " HTTP/" << request.http_version << "<br>";

  33. for(auto& header: request.header) {

  34. content_stream << header.first << ": " << header.second << "<br>";

  35. }

  36.  
  37. // 获得 content_stream 的长度(使用 content.tellp() 获得)

  38. content_stream.seekp(0, ios::end);

  39.  
  40. response << "HTTP/1.1 200 OK\r\nContent-Length: " << content_stream.tellp() << "\r\n\r\n" << content_stream.rdbuf();

  41. };

  42.  
  43. // 处理访问 /match/[字母+数字组成的字符串] 的 GET 请求, 例如执行请求 GET /match/abc123, 将返回 abc123

  44. server.resource["^/match/([0-9a-zA-Z]+)/?$"]["GET"] = [](ostream& response, Request& request) {

  45. string number=request.path_match[1];

  46. response << "HTTP/1.1 200 OK\r\nContent-Length: " << number.length() << "\r\n\r\n" << number;

  47. };

  48.  
  49. // 处理默认 GET 请求, 如果没有其他匹配成功,则这个匿名函数会被调用

  50. // 将应答 web/ 目录及其子目录中的文件

  51. // 默认文件: index.html

  52. server.default_resource["^/?(.*)$"]["GET"] = [](ostream& response, Request& request) {

  53. string filename = "web/";

  54.  
  55. string path = request.path_match[1];

  56.  
  57. // 防止使用 `..` 来访问 web/ 目录外的内容

  58. size_t last_pos = path.rfind(".");

  59. size_t current_pos = 0;

  60. size_t pos;

  61. while((pos=path.find('.', current_pos)) != string::npos && pos != last_pos) {

  62. current_pos = pos;

  63. path.erase(pos, 1);

  64. last_pos--;

  65. }

  66.  
  67. filename += path;

  68. ifstream ifs;

  69. // 简单的平台无关的文件或目录检查

  70. if(filename.find('.') == string::npos) {

  71. if(filename[filename.length()-1]!='/')

  72. filename+='/';

  73. filename += "index.html";

  74. }

  75. ifs.open(filename, ifstream::in);

  76.  
  77. if(ifs) {

  78. ifs.seekg(0, ios::end);

  79. size_t length=ifs.tellg();

  80.  
  81. ifs.seekg(0, ios::beg);

  82.  
  83. // 文件内容拷贝到 response-stream 中,不应该用于大型文件

  84. response << "HTTP/1.1 200 OK\r\nContent-Length: " << length << "\r\n\r\n" << ifs.rdbuf();

  85.  
  86. ifs.close();

  87. } else {

  88. // 文件不存在时,返回无法打开文件

  89. string content="Could not open file "+filename;

  90. response << "HTTP/1.1 400 Bad Request\r\nContent-Length: " << content.length() << "\r\n\r\n" << content;

  91. }

  92. };

  93.  
  94. // 运行 HTTP 服务器

  95. server.start();

  96. }

六、结果测试

到目前为止,我们整个目录树应该是这个样子:

 
  1. ├── handler.hpp

  2. ├── main_http.cpp

  3. ├── server_base.hpp

  4. ├── server_http.hpp

  5. └── web

  6. └── index.html

由于我们使用了 boost 库,因此需要在编译时告诉编译器去索引 boost 的位置,如果直接使用编译命令编译,会出现指令过长的情况,我们不妨编写一个 Makefile:

 
  1. #

  2. # Makefile

  3. # web_server

  4. #

  5. # created by changkun at shiyanlou.com

  6. #

  7.  
  8. CXX = g++

  9. EXEC_HTTP = server_http

  10.  
  11. SOURCE_HTTP = main_http.cpp

  12.  
  13. OBJECTS_HTTP = main_http.o

  14.  
  15. # 开启编译器 O3 优化, pthread 启用多线程支持

  16. LDFLAGS_COMMON = -std=c++11 -O3 -pthread -lboost_system

  17. LDFLAGS_HTTP =

  18.  
  19. LPATH_COMMON = -I/usr/include/boost

  20. LPATH_HTTP =

  21.  
  22. LLIB_COMMON = -L/usr/lib

  23. LLIB_HTTP =

  24.  
  25. http:

  26. $(CXX) $(SOURCE_HTTP) $(LDFLAGS_COMMON) $(LDFLAGS_HTTP) $(LPATH_COMMON) $(LPATH_HTTP) $(LLIB_COMMON) $(LLIB_HTTP) -o $(EXEC_HTTP)

  27.  
  28. clean:

  29. rm -f $(EXEC_HTTP) *.o

最终,我们能够使用 make http 来编译我们的代码,并通过 ./server_http 来运行我们的服务器,并在浏览器中测试我们的服务器运行情况:

对于 GET 请求,我们可以直接在浏览器中访问:

 
  1. localhost:12345/ # 会访问到 index.html

  2. localhost:12345/match/123abc # 会获得到一个 123abc 的字符串

  3. localhost:12345/info/ # 会获得整个请求体的信息

而对于 POST 请求,我们可以使用 curl 命令进行测试:

curl -d "test string" "http://localhost:12345/string/"

这时候能看到服务器返回测试结果,就是我们 POST 发送的字符串。

此处输入图片的描述

总结

本节实验我们实现了服务器除开建立 TCP 连接具体实现外的 ServerBase 基类,并从此类继承出了 Server<HTTP> 子类,实现了 HTTP 服务器框架,同时,基于我们编写的框架,我们开发出了一个简易的 HTTP Web 服务器。在整个过程中,我们用到了大量 C++11 和 Boost Asio 的相关知识。在下一节实验中,我们将据此进一步实现 HTTPS 服务器框架,并编写启用 HTTPS 服务器。

 

 

原文地址:https://www.shiyanlou.com/courses/568/labs/1984/document

  • 1
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值