neforce::http::http_filter类 参考

HTTP过滤器基类 更多...

#include <http_filter.hpp>

类 neforce::http::http_filter 继承关系图:

Public 成员函数
virtual void	do_filter (http_request &request, http_response &response)=0
	核心过滤方法
virtual bool	pre_filter (http_request &request, http_response &response)
	预处理方法
virtual void	post_filter (http_request &request, http_response &response)
	后处理方法
virtual string	name () const
	获取过滤器名称

详细描述

HTTP过滤器基类

所有HTTP过滤器的抽象基类，定义了过滤器的生命周期方法。

过滤器生命周期：

1. pre_filter：请求处理前调用
2. do_filter：实际处理
3. post_filter：响应发送前调用

在文件 http_filter.hpp 第 48 行定义.

成员函数说明

do_filter()

virtual void neforce::http::http_filter::do_filter ( http_request & request, http_response & response )

pure virtual

核心过滤方法

参数

request	HTTP请求
response	HTTP响应

执行实际的过滤逻辑。通常由具体处理器实现， 中间件过滤器可能不实现此方法。

在 neforce::http::authentication_filter, neforce::http::cache_filter, neforce::http::compress_filter, neforce::http::cors_filter, neforce::http::csrf_filter, neforce::http::health_check_filter, neforce::http::logging_filter, neforce::http::reverse_proxy_filter, neforce::http::security_headers_filter, neforce::http::static_file_filter , 以及 neforce::http::token_bucket_filter 内被实现.

name()

virtual string neforce::http::http_filter::name ( ) const

inlinenodiscardvirtual

获取过滤器名称

返回

过滤器名称

被 neforce::http::authentication_filter, neforce::http::cache_filter, neforce::http::compress_filter, neforce::http::cors_filter, neforce::http::csrf_filter, neforce::http::health_check_filter, neforce::http::logging_filter, neforce::http::reverse_proxy_filter, neforce::http::security_headers_filter, neforce::http::static_file_filter , 以及 neforce::http::token_bucket_filter 重载.

在文件 http_filter.hpp 第 85 行定义.

post_filter()

virtual void neforce::http::http_filter::post_filter ( http_request & request, http_response & response )

inlinevirtual

后处理方法

参数

request	HTTP请求
response	HTTP响应

在响应发送前调用，可以修改响应头或正文。

被 neforce::http::cache_filter, neforce::http::compress_filter, neforce::http::logging_filter , 以及 neforce::http::security_headers_filter 重载.

在文件 http_filter.hpp 第 79 行定义.

被这些函数引用 neforce::http::async_filter::post_filter_async().

pre_filter()

virtual bool neforce::http::http_filter::pre_filter ( http_request & request, http_response & response )

inlinevirtual

预处理方法

参数

request	HTTP请求
response	HTTP响应

返回

返回false表示中断后续处理

在请求处理前调用，可以检查请求、修改请求或提前返回响应。

被 neforce::http::authentication_filter, neforce::http::cache_filter, neforce::http::cors_filter, neforce::http::csrf_filter, neforce::http::health_check_filter, neforce::http::logging_filter, neforce::http::reverse_proxy_filter, neforce::http::security_headers_filter, neforce::http::static_file_filter , 以及 neforce::http::token_bucket_filter 重载.

在文件 http_filter.hpp 第 70 行定义.

被这些函数引用 neforce::http::async_filter::pre_filter_async().

---

该类的文档由以下文件生成:

• http_filter.hpp