BadInputError Class Reference

Bad input error, thrown when the input to an SDK API is invalid. More...

#include <src/api/mip/error.h>

Inheritance diagram for BadInputError:

Collaboration diagram for BadInputError:

Public Types
enum class	ErrorCode {   General = 0 ,   FileIsTooLargeForProtection = 1 ,   ParameterParsing = 2 ,   LicenseNotTrusted = 3 ,   DoubleKey = 4 ,   FileFormatNotSupported = 5 }
	ErrorCode of bad input error. More...

Public Member Functions
void	AddDebugInfo (const std::string &key, const std::string &value, bool sensitive=false)
	Add debug info entry.
virtual std::shared_ptr< Error >	Clone () const =0
	Clone the error.
const std::map< std::string, std::string > &	GetDebugInfo () const
	Get debug info.
ErrorCode	GetErrorCode () const
	Gets the errorCode of bad input.
const std::string &	GetErrorName () const
	Get the error name.
virtual ErrorType	GetErrorType () const
	Get the error type.
const std::string &	GetMessage (bool maskPII=false) const
	Get the error message.
void	SetMessage (const std::string &msg)
	Set the error message.
char const *	what () const noexcept override
	Get the error message.

Public Attributes
std::map< std::string, std::string >	mDebugInfo
std::string	mMessage
std::string	mName
ErrorType	mType

Detailed Description

Bad input error, thrown when the input to an SDK API is invalid.

Definition at line 247 of file error.h.

Member Enumeration Documentation

ErrorCode

enum class BadInputError::ErrorCode

strong

ErrorCode of bad input error.

Enumerator
General	General bad input error.
FileIsTooLargeForProtection	File is too large for protection.
ParameterParsing	Parameter cannot be parsed correctly.
LicenseNotTrusted	Publishing license not issued by trusted source.
DoubleKey	A paremeter for double key encryption is needed and missing.
FileFormatNotSupported	The input file's format is not supported.

Definition at line 253 of file error.h.

                       {
    General = 0, /**< General bad input error */
    FileIsTooLargeForProtection = 1, /**< File is too large for protection */
    ParameterParsing = 2, /**< Parameter cannot be parsed correctly */
    LicenseNotTrusted = 3, /**< Publishing license not issued by trusted source */
    DoubleKey = 4, /**< A paremeter for double key encryption is needed and missing */
    FileFormatNotSupported = 5, /**<The input file's format is not supported */
  };

Member Function Documentation

AddDebugInfo()

void Error::AddDebugInfo ( const std::string & key, const std::string & value, bool sensitive = false )

inlineinherited

Add debug info entry.

Parameters

key	Debug info key
value	Debug info value

Definition at line 179 of file error.h.

                                                                                          {
    if (!key.empty() && !value.empty()) {
      mDebugInfo[key] = value;
      mFormattedMessage = mFormattedMessage + ", " + key + "=" + value;
      mMaskedMessage = mMaskedMessage + ", " + key + "=" + (sensitive ? "***" : value);
    }
  }

References Error::mDebugInfo.

Referenced by DelegateResponseError::DelegateResponseError(), DelegateResponseError::DelegateResponseError(), and DelegateResponseError::DelegateResponseError().

Clone()

virtual std::shared_ptr< Error > Error::Clone ( ) const

pure virtualinherited

Clone the error.

Returns

a clone of the error.

Implemented in JustificationRequiredError.

GetDebugInfo()

const std::map< std::string, std::string > & Error::GetDebugInfo ( ) const

inlineinherited

Get debug info.

Returns

Debug info (keys/values)

Definition at line 192 of file error.h.

{ return mDebugInfo; }

References Error::mDebugInfo.

GetErrorCode()

ErrorCode BadInputError::GetErrorCode ( ) const

inline

Gets the errorCode of bad input.

Returns

ErrorCode of bad input error

Definition at line 293 of file error.h.

{ return mErrorCode; }

GetErrorName()

const std::string & Error::GetErrorName ( ) const

inlineinherited

Get the error name.

Returns

the error name.

Definition at line 144 of file error.h.

{ return mName; }

References Error::mName.

GetErrorType()

virtual ErrorType Error::GetErrorType ( ) const

inlinevirtualinherited

Get the error type.

Returns

the error type.

Definition at line 137 of file error.h.

{ return mType; }

References Error::mType.

GetMessage()

const std::string & Error::GetMessage ( bool maskPII = false ) const

inlineinherited

Get the error message.

Returns

the error message.

Definition at line 151 of file error.h.

                                                          {
    return maskPII ? mMaskedMessage : mFormattedMessage;
  }

SetMessage()

void Error::SetMessage ( const std::string & msg )

inlineinherited

Set the error message.

Parameters

msg	the error message.

Definition at line 160 of file error.h.

                                        {
    std::string* targetStrings[] = { &mFormattedMessage, &mMaskedMessage };
    for (auto* targetString : targetStrings) {
      size_t pos = targetString->find(mMessage);
      if (pos != std::string::npos) {
        targetString->replace(pos, mMessage.length(), msg);
      } else {
        targetString->replace(0, 0, msg);
      }
    }
    mMessage = msg;
  }

References Error::mMessage.

what()

char const * Error::what ( ) const

inlineoverridenoexceptinherited

Get the error message.

Returns

the error message

Definition at line 121 of file error.h.

                                             {
    return mFormattedMessage.c_str();
  }

Member Data Documentation

mDebugInfo

std::map<std::string, std::string> Error::mDebugInfo

inherited

Definition at line 225 of file error.h.

Referenced by Error::AddDebugInfo(), and Error::GetDebugInfo().

mMessage

std::string Error::mMessage

inherited

Definition at line 224 of file error.h.

Referenced by DelegateResponseError::DelegateResponseError(), and Error::SetMessage().

mName

std::string Error::mName

inherited

Definition at line 226 of file error.h.

Referenced by Error::GetErrorName().

mType

ErrorType Error::mType

inherited

Definition at line 227 of file error.h.

Referenced by Error::GetErrorType().

---

The documentation for this class was generated from the following file:

• src/api/mip/error.h