http_UrlRouter.hpp

浏览该文件的文档.

#pragma once

namespace http
{
template < class _ReqClass, class _RspClass >
using CrossRouteHandlerFunctionT = std::function< bool ( winux::SharedPointer<_ReqClass> requestPtr, _RspClass & rsp, winux::StringArray const & urlPathPartArr, size_t i ) >;

template < class _ReqClass, class _RspClass >
using RouteHandlerFunctionT = std::function< void ( winux::SharedPointer<_ReqClass> requestPtr, _RspClass & rsp ) >;

class HTTPWRAPPER_DLL UrlRouter
{
public:
    using CrossRouteHandlerFunction = CrossRouteHandlerFunctionT<http::Request, http::Response>;
    using RouteHandlerFunction = RouteHandlerFunctionT<http::Request, http::Response>;

    UrlRouter( http::HttpServerConfig * httpConfig = nullptr );

    virtual ~UrlRouter();

    bool init( http::HttpServerConfig * httpConfig );

    void crossRoute( winux::String const & method, winux::String const & path, CrossRouteHandlerFunction handler );

    void route( winux::String const & method, winux::String const & path, RouteHandlerFunction handler );

protected:
    virtual void routing( winux::SharedPointer<http::Request> requestPtr, http::UrlPathPartData const & urlData, http::Response & rsp );

    http::StaticFileMemoryCache _staticFileCache;
    // 路由处理器
    std::vector< std::unordered_map< winux::String, std::unordered_map< winux::String, CrossRouteHandlerFunction > > > _crossRouter;
    std::unordered_map< winux::String, std::unordered_map< winux::String, RouteHandlerFunction > > _router;

    // 处理一个WebMain逻辑
    DEFINE_CUSTOM_EVENT_RETURN_EX(
        void,
        WebMain,
        ( winux::SharedPointer<http::Request> requestPtr, http::Response & rsp )
    );

    // 文件扩展名处理，返回true表示成功处理，返回false表示没有处理
    DEFINE_CUSTOM_EVENT_RETURN_EX(
        bool,
        ExtensionHandling,
        ( winux::String const & extName, winux::String const & fullPath, winux::SharedPointer<http::Request> requestPtr, http::Response & rsp )
    );

private:
    http::HttpServerConfig * _httpConfig;

};


} // namespace http