optional.hpp

Go to the documentation of this file.

#pragma once
 
/// @file userver/storages/postgres/io/optional.hpp
/// @brief Optional values I/O support
/// @ingroup userver_postgres_parse_and_format
 
#include <optional>
 
#include <userver/utils/assert.hpp>
#include <userver/utils/optional_ref.hpp>
 
#include <userver/storages/postgres/io/buffer_io.hpp>
#include <userver/storages/postgres/io/buffer_io_base.hpp>
#include <userver/storages/postgres/io/nullable_traits.hpp>
#include <userver/storages/postgres/io/traits.hpp>
 
#include <boost/optional/optional_fwd.hpp>
 
USERVER_NAMESPACE_BEGIN
 
namespace storages::postgres::io {
 
namespace detail {
 
template <template <typename> class Optional, typename T, bool Categories = false>
struct OptionalValueParser : BufferParserBase<Optional<T>> {
    using BaseType = BufferParserBase<Optional<T>>;
    using ValueParser = typename traits::IO<T>::ParserType;
 
    using BaseType::BaseType;
 
    void operator()(const FieldBuffer& buffer) {
        T val;
        ValueParser{val}(buffer);
        this->value = std::move(val);
    }
};
 
template <template <typename> class Optional, typename T>
struct OptionalValueParser<Optional, T, true> : BufferParserBase<Optional<T>> {
    using BaseType = BufferParserBase<Optional<T>>;
    using ValueParser = typename traits::IO<T>::ParserType;
 
    using BaseType::BaseType;
 
    void operator()(const FieldBuffer& buffer, const TypeBufferCategory& categories) {
        T val;
        ValueParser{val}(buffer, categories);
        this->value = std::move(val);
    }
};
 
template <template <typename> class Optional, typename T>
struct OptionalValueFormatter : BufferFormatterBase<Optional<T>> {
    using BaseType = BufferFormatterBase<Optional<T>>;
    using ValueFormatter = typename traits::IO<T>::FormatterType;
 
    using BaseType::BaseType;
 
    template <typename Buffer>
    void operator()(const UserTypes& types, Buffer& buffer) const {
        if (this->value) {
            ValueFormatter{*this->value}(types, buffer);
        }
    }
};
 
}  // namespace detail
 
/// Parser specialization for boost::optional
template <typename T>
struct BufferParser<boost::optional<T>, std::enable_if_t<traits::kHasParser<T>>>
    : detail::OptionalValueParser<boost::optional, T, detail::kParserRequiresTypeCategories<T>> {
    using BaseType = detail::OptionalValueParser<boost::optional, T, detail::kParserRequiresTypeCategories<T>>;
    using BaseType::BaseType;
};
 
/// Formatter specialization for boost::optional
template <typename T>
struct BufferFormatter<boost::optional<T>, std::enable_if_t<traits::kHasFormatter<T>>>
    : detail::OptionalValueFormatter<boost::optional, T> {
    using BaseType = detail::OptionalValueFormatter<boost::optional, T>;
    using BaseType::BaseType;
};
 
/// Parser specialization for std::optional
template <typename T>
struct BufferParser<std::optional<T>, std::enable_if_t<traits::kHasParser<T>>>
    : detail::OptionalValueParser<std::optional, T, detail::kParserRequiresTypeCategories<T>> {
    using BaseType = detail::OptionalValueParser<std::optional, T, detail::kParserRequiresTypeCategories<T>>;
    using BaseType::BaseType;
};
 
/// Formatter specialization for std::optional
template <typename T>
struct BufferFormatter<std::optional<T>, std::enable_if_t<traits::kHasFormatter<T>>>
    : detail::OptionalValueFormatter<std::optional, T> {
    using BaseType = detail::OptionalValueFormatter<std::optional, T>;
    using BaseType::BaseType;
};
 
/// Formatter specialization for utils::OptionalRef
template <typename T>
struct BufferFormatter<USERVER_NAMESPACE::utils::OptionalRef<T>, std::enable_if_t<traits::kHasFormatter<T>>>
    : detail::OptionalValueFormatter<USERVER_NAMESPACE::utils::OptionalRef, T> {
    using BaseType = detail::OptionalValueFormatter<USERVER_NAMESPACE::utils::OptionalRef, T>;
    using BaseType::BaseType;
};
 
/// Pg mapping specialization for boost::optional
template <typename T>
struct CppToPg<boost::optional<T>, std::enable_if_t<traits::kIsMappedToPg<T>>> : CppToPg<T> {};
 
/// Pg mapping specialization for std::optional
template <typename T>
struct CppToPg<std::optional<T>, std::enable_if_t<traits::kIsMappedToPg<T>>> : CppToPg<T> {};
 
/// Pg mapping specialization for USERVER_NAMESPACE::utils::OptionalRef
template <typename T>
struct CppToPg<USERVER_NAMESPACE::utils::OptionalRef<T>, std::enable_if_t<traits::kIsMappedToPg<T>>> : CppToPg<T> {};
 
namespace traits {
 
/// Nullability traits for boost::optional
template <typename T>
struct IsNullable<boost::optional<T>> : std::true_type {};
 
template <typename T>
struct GetSetNull<boost::optional<T>> {
    using ValueType = boost::optional<T>;
    inline static bool IsNull(const ValueType& v) { return !v; }
    inline static void SetNull(ValueType& v) { v = ValueType{}; }
    inline static void SetDefault(ValueType& v) { v.emplace(); }
};
 
template <typename T>
struct IsMappedToPg<boost::optional<T>> : IsMappedToPg<T> {};
template <typename T>
struct IsSpecialMapping<boost::optional<T>> : IsMappedToPg<T> {};
 
template <typename T>
struct ParserBufferCategory<BufferParser<boost::optional<T>>>
    : ParserBufferCategory<typename traits::IO<T>::ParserType> {};
 
/// Nullability traits for std::optional
template <typename T>
struct IsNullable<std::optional<T>> : std::true_type {};
 
template <typename T>
struct GetSetNull<std::optional<T>> {
    using ValueType = std::optional<T>;
    inline static bool IsNull(const ValueType& v) { return !v; }
    inline static void SetNull(ValueType& v) { v = std::nullopt; }
    inline static void SetDefault(ValueType& v) { v.emplace(); }
};
 
template <typename T>
struct IsMappedToPg<std::optional<T>> : IsMappedToPg<T> {};
template <typename T>
struct IsSpecialMapping<std::optional<T>> : IsMappedToPg<T> {};
 
template <typename T>
struct ParserBufferCategory<BufferParser<std::optional<T>>> : ParserBufferCategory<typename traits::IO<T>::ParserType> {
};
 
/// Nullability traits for USERVER_NAMESPACE::utils::OptionalRef
template <typename T>
struct IsNullable<USERVER_NAMESPACE::utils::OptionalRef<T>> : std::true_type {};
 
template <typename T>
struct GetSetNull<USERVER_NAMESPACE::utils::OptionalRef<T>> {
    using ValueType = USERVER_NAMESPACE::utils::OptionalRef<T>;
    inline static bool IsNull(const ValueType& v) { return !v; }
    inline static void SetNull(ValueType&) { static_assert(!sizeof(T), "SetNull not enabled for utils::OptionalRef"); }
    inline static void SetDefault(ValueType&) {
        static_assert(!sizeof(T), "SetDefault not enabled for utils::OptionalRef");
    }
};
 
template <typename T>
struct IsMappedToPg<USERVER_NAMESPACE::utils::OptionalRef<T>> : IsMappedToPg<T> {};
template <typename T>
struct IsSpecialMapping<USERVER_NAMESPACE::utils::OptionalRef<T>> : IsMappedToPg<T> {};
 
}  // namespace traits
 
}  // namespace storages::postgres::io
 
USERVER_NAMESPACE_END