[/
    Copyright (c) 2016-2019 Vinnie Falco (vinnie dot falco at gmail dot com)

    Distributed under the Boost Software License, Version 1.0. (See accompanying
    file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)

    Official repository: https://github.com/boostorg/beast
]

[section 自定义解析器]

虽然库自带的解析器能覆盖大部分常见场景，但通过继承 __basic_parser__ 接口，也可以实现自定义的解析结果存储策略。基本解析器负责按 HTTP/1 协议规范将输入缓冲区解析为各个元素，而派生类则决定如何处理这些元素。由于所有 HTTP 流读取算法都只依赖基本解析器接口，因此自定义解析器可以与它们协同工作。以下是一些可能需要实现自定义解析器的场景：

* 检查传入的头部字段，并决定保留或丢弃。

* 使用外部接口提供的容器。

基本解析器使用虚函数。要声明自定义解析器，需要从 __basic_parser__ 派生并实现所有必需的虚函数。派生类的声明大致如下：

[code_http_10_custom_parser]

[endsect]