Uri.h

浏览该文件的文档.

#pragma once
 
#include "common/Export.h"
#include "common/Result.h"
 
#include <cstdint>
#include <functional>
#include <string>
#include <string_view>
#include <utility>
 
namespace eve {
 
enum class UriScheme : std::uint8_t {
    Asset,
    Project,
    Builtin,
    Generated,
    Memory,
};
 
[[nodiscard]] EVENGINE_API_FOUNDATION const char* uriSchemeName(UriScheme scheme) noexcept;
 
class EVENGINE_API_FOUNDATION Uri {
public:
    [[nodiscard]] static Result<Uri> parse(std::string_view text);
 
    [[nodiscard]] static Result<Uri> fromParts(UriScheme scheme, std::string_view path, std::string_view query = {},
                                               std::string_view fragment = {});
 
    [[nodiscard]] UriScheme scheme() const noexcept { return scheme_; }
 
    [[nodiscard]] std::string_view path() const noexcept { return path_; }
 
    [[nodiscard]] std::string_view query() const noexcept { return query_; }
 
    [[nodiscard]] std::string_view fragment() const noexcept { return fragment_; }
 
    [[nodiscard]] const std::string& format() const noexcept { return formatted_; }
 
    friend bool operator==(const Uri&, const Uri&) noexcept = default;
 
private:
    Uri(UriScheme scheme, std::string path, std::string query, std::string fragment);
 
    UriScheme   scheme_;
    std::string path_;
    std::string query_;
    std::string fragment_;
    std::string formatted_;
};
 
class EVENGINE_API_FOUNDATION ResourceUri {
public:
    [[nodiscard]] static Result<ResourceUri> parse(std::string_view text);
 
    [[nodiscard]] static Result<ResourceUri> fromParts(UriScheme scheme, std::string_view path,
                                                       std::string_view query = {}, std::string_view fragment = {});
 
    [[nodiscard]] static Result<ResourceUri> fromLegacyProjectPath(std::string_view path);
 
    [[nodiscard]] UriScheme scheme() const noexcept { return uri_.scheme(); }
 
    [[nodiscard]] std::string_view path() const noexcept { return uri_.path(); }
 
    [[nodiscard]] std::string_view query() const noexcept { return uri_.query(); }
 
    [[nodiscard]] std::string_view fragment() const noexcept { return uri_.fragment(); }
 
    [[nodiscard]] const std::string& format() const noexcept { return uri_.format(); }
 
    [[nodiscard]] const Uri& uri() const noexcept { return uri_; }
 
    friend bool operator==(const ResourceUri&, const ResourceUri&) noexcept = default;
 
private:
    explicit ResourceUri(Uri uri) : uri_(std::move(uri)) {}
 
    Uri uri_;
};
 
}  // namespace eve
 
namespace std {
 
template <>
struct hash<eve::Uri> {
    std::size_t operator()(const eve::Uri& value) const noexcept {
        return std::hash<std::string_view>{}(value.format());
    }
};
 
template <>
struct hash<eve::ResourceUri> {
    std::size_t operator()(const eve::ResourceUri& value) const noexcept {
        return std::hash<std::string_view>{}(value.format());
    }
};
 
}  // namespace std