Status.h

#ifndef XRPL_RPC_STATUS_H_INCLUDED
#define XRPL_RPC_STATUS_H_INCLUDED
 
#include <xrpl/beast/utility/instrumentation.h>
#include <xrpl/protocol/ErrorCodes.h>
#include <xrpl/protocol/TER.h>
 
namespace xrpl {
namespace RPC {
 
struct Status : public std::exception
{
public:
    enum class Type { none, TER, error_code_i };
    using Code = int;
    using Strings = std::vector<std::string>;
 
    static constexpr Code OK = 0;
 
    Status() = default;
 
    // The enable_if allows only integers (not enums).  Prevents enum narrowing.
    template <
        typename T,
        typename = std::enable_if_t<std::is_integral<T>::value>>
    Status(T code, Strings d = {})
        : type_(Type::none), code_(code), messages_(std::move(d))
    {
    }
 
    Status(TER ter, Strings d = {})
        : type_(Type::TER), code_(TERtoInt(ter)), messages_(std::move(d))
    {
    }
 
    Status(error_code_i e, Strings d = {})
        : type_(Type::error_code_i), code_(e), messages_(std::move(d))
    {
    }
 
    Status(error_code_i e, std::string const& s)
        : type_(Type::error_code_i), code_(e), messages_({s})
    {
    }
 
    /* Returns a representation of the integer status Code as a string.
       If the Status is OK, the result is an empty string.
    */
    std::string
    codeString() const;
 
    operator bool() const
    {
        return code_ != OK;
    }
 
    bool
    operator!() const
    {
        return !bool(*this);
    }
 
    TER
    toTER() const
    {
        XRPL_ASSERT(
            type_ == Type::TER, "xrpl::RPC::Status::toTER : type is TER");
        return TER::fromInt(code_);
    }
 
    error_code_i
    toErrorCode() const
    {
        XRPL_ASSERT(
            type_ == Type::error_code_i,
            "xrpl::RPC::Status::toTER : type is error code");
        return error_code_i(code_);
    }
 
    void
    inject(Json::Value& object) const
    {
        if (auto ec = toErrorCode())
        {
            if (messages_.empty())
                inject_error(ec, object);
            else
                inject_error(ec, message(), object);
        }
    }
 
    Strings const&
    messages() const
    {
        return messages_;
    }
 
    std::string
    message() const;
 
    Type
    type() const
    {
        return type_;
    }
 
    std::string
    toString() const;
 
    void
    fillJson(Json::Value&);
 
private:
    Type type_ = Type::none;
    Code code_ = OK;
    Strings messages_;
};
 
}  // namespace RPC
}  // namespace xrpl
 
#endif