Kylin/HttpProxy/router.hpp

91 lines
2.1 KiB
C++
Raw Normal View History

2023-12-30 22:09:18 +08:00
//
// Copyright (c) 2022 Alan de Freitas (alandefreitas@gmail.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/url
//
#ifndef BOOST_URL_ROUTER_HPP
#define BOOST_URL_ROUTER_HPP
#include <boost/url/detail/config.hpp>
#include <boost/url/parse_path.hpp>
#include "detail/router.hpp"
#include "matches.hpp"
namespace boost {
namespace urls {
/** A URL router.
This container matches static and dynamic
URL requests to an object which represents
how the it should be handled. These
values are usually callback functions.
@tparam T type of resource associated with
each path template
@tparam N maximum number of replacement fields
in a path template
@par Exception Safety
@li Functions marked `noexcept` provide the
no-throw guarantee, otherwise:
@li Functions which throw offer the strong
exception safety guarantee.
@see
@ref parse_absolute_uri,
@ref parse_relative_ref,
@ref parse_uri,
@ref parse_uri_reference,
@ref resolve.
*/
template <class T>
class router
: private detail::router_base
{
public:
/// Constructor
router() = default;
/** Route the specified URL path to a resource
@param path A url path with dynamic segments
@param resource A resource the path corresponds to
@see
https://fmt.dev/latest/syntax.html
*/
template <class U>
void
insert(core::string_view pattern, U&& v);
/** Match URL path to corresponding resource
@param request Request path
@return The match results
*/
T const*
find(segments_encoded_view path, matches_base& m) const noexcept;
#ifdef BOOST_URL_DOCS
/// @copydoc find
T const*
find(segments_encoded_view path, matches& m) const noexcept;
#endif
};
} // urls
} // boost
#include "impl/router.hpp"
#endif