blocxx
|
This class is the base of all exceptions thrown by BloCxx code. More...
#include <Exception.hpp>
Public Member Functions | |
virtual | ~Exception () throw () |
virtual const char * | type () const |
Returns a string representing the concrete type. | |
virtual const char * | getMessage () const |
Returns the message. | |
const char * | getFile () const |
Returns the file. | |
int | getLine () const |
int | getSubClassId () const |
const Exception * | getSubException () const |
Returns the sub exception if available, otherwise 0. | |
int | getErrorCode () const |
Returns the error code representing the error which occurred. | |
virtual const char * | what () const throw () |
Returns getMessage() | |
virtual Exception * | clone () const |
Make a copy of this exception object. | |
virtual void | rethrow () const |
Re-throws the exception. | |
char * | dupString (const char *str) |
Utility function to copy a string. | |
Static Public Attributes | |
static const int | UNKNOWN_SUBCLASS_ID = -1 |
static const int | UNKNOWN_ERROR_CODE = -1 |
Protected Member Functions | |
Exception (const char *file, int line, const char *msg) BLOCXX_DEPRECATED | |
This constructor is deprecated. | |
Exception (const char *file, int line, const char *msg, int errorCode, const Exception *otherException=0, int subClassId=UNKNOWN_SUBCLASS_ID) | |
Exception (int subClassId, const char *file, int line, const char *msg, int errorCode, const Exception *otherException=0) BLOCXX_DEPRECATED | |
Exception (const Exception &e) | |
Exception & | operator= (const Exception &rhs) |
void | swap (Exception &x) |
void | setSubClassId (int subClassId) |
void | setErrorCode (int errorCode) |
Private Attributes | |
char * | m_file |
int | m_line |
char * | m_msg |
int | m_subClassId |
const Exception * | m_subException |
int | m_errorCode |
This class is the base of all exceptions thrown by BloCxx code.
It cannot be constructed directly, only subclasses can be instantiated.
Creating a correct subclass is facilitated by the macros defined in this file.
Exceptions should be thrown by using one of the BLOCXX_THROW_* macros which inserts the file and line number among other helpful things.
Definition at line 65 of file Exception.hpp.
BLOCXX_NAMESPACE::Exception::Exception | ( | const char * | file, |
int | line, | ||
const char * | msg | ||
) | [protected] |
This constructor is deprecated.
Definition at line 87 of file Exception.cpp.
References BLOCXX_NAMESPACE::NonRecursiveMutex::acquire(), m_mutex, and BLOCXX_NAMESPACE::StackTrace::printStackTrace().
Referenced by operator=().
BLOCXX_NAMESPACE::Exception::Exception | ( | const char * | file, |
int | line, | ||
const char * | msg, | ||
int | errorCode, | ||
const Exception * | otherException = 0 , |
||
int | subClassId = UNKNOWN_SUBCLASS_ID |
||
) | [protected] |
file | The filename of the code throwing the exception. |
line | The line of the code throwing the exception. |
msg | A human readable message associated with the exception. |
errorCode | A number identifying the specific error that caused this exception. |
otherException | A pointer to another exception. This allows for exception chaining, presumably otherException is the underlying cause that the current exception is being thrown. If otherException != 0, The new Exception instance will store and delete the result of calling otherException->clone(). otherException will not be saved. |
subClassId | Each subclass of Exception may create an id. getSubClassId() will return this value. You may pass UNKNOWN_SUBCLASS_ID if no id is required. blocxx Ids are be registered in BLOCXX_ExceptionIds.hpp. |
Definition at line 121 of file Exception.cpp.
References BLOCXX_NAMESPACE::NonRecursiveMutex::acquire(), m_mutex, and BLOCXX_NAMESPACE::StackTrace::printStackTrace().
BLOCXX_NAMESPACE::Exception::Exception | ( | int | subClassId, |
const char * | file, | ||
int | line, | ||
const char * | msg, | ||
int | errorCode, | ||
const Exception * | otherException = 0 |
||
) | [protected] |
Definition at line 104 of file Exception.cpp.
References BLOCXX_NAMESPACE::NonRecursiveMutex::acquire(), m_mutex, and BLOCXX_NAMESPACE::StackTrace::printStackTrace().
BLOCXX_NAMESPACE::Exception::Exception | ( | const Exception & | e | ) | [protected] |
Definition at line 138 of file Exception.cpp.
References BLOCXX_NAMESPACE::NonRecursiveMutex::acquire(), and m_mutex.
BLOCXX_NAMESPACE::Exception::~Exception | ( | ) | throw () [virtual] |
Definition at line 152 of file Exception.cpp.
References BLOCXX_NAMESPACE::freeBuf(), m_file, m_msg, m_mutex, m_subException, and BLOCXX_NAMESPACE::NonRecursiveMutex::release().
Exception * BLOCXX_NAMESPACE::Exception::clone | ( | ) | const [virtual] |
Make a copy of this exception object.
If allocation fails, return 0. Subclasses need to override this function. This function must not throw. Here is an example of how to implement this in a derived class:
virtual DerivedException* clone() const { return new(std::nothrow) DerivedException(*this); }
Reimplemented in BLOCXX_NAMESPACE::LoggerException, and BLOCXX_NAMESPACE::StringConversionException.
Definition at line 282 of file Exception.cpp.
char * BLOCXX_NAMESPACE::Exception::dupString | ( | const char * | str | ) |
Utility function to copy a string.
This function will not throw--if allocation fails, 0 is returned. The result must be free[]'d. if str == 0, 0 is returned. TODO: This function doesn't really belong on this class, but so far only this class and subclasses have a use for it.
Definition at line 72 of file Exception.cpp.
int BLOCXX_NAMESPACE::Exception::getErrorCode | ( | ) | const |
Returns the error code representing the error which occurred.
Code are unique only in the scope of the derived exception class. May return UNKNONWN_ERROR_CODE if the error is unavailable.
Definition at line 302 of file Exception.cpp.
Referenced by BLOCXX_NAMESPACE::operator<<().
const char * BLOCXX_NAMESPACE::Exception::getFile | ( | ) | const |
Returns the file.
May return 0.
Definition at line 210 of file Exception.cpp.
References m_file.
Referenced by BLOCXX_NAMESPACE::operator<<().
int BLOCXX_NAMESPACE::Exception::getLine | ( | ) | const |
Definition at line 197 of file Exception.cpp.
References m_line.
Referenced by BLOCXX_NAMESPACE::operator<<().
const char * BLOCXX_NAMESPACE::Exception::getMessage | ( | ) | const [virtual] |
Returns the message.
May return 0. This function will not throw. Derived class implementations must not throw.
Definition at line 204 of file Exception.cpp.
References m_msg.
Referenced by BLOCXX_NAMESPACE::LogAppender::createLogAppender(), and BLOCXX_NAMESPACE::operator<<().
int BLOCXX_NAMESPACE::Exception::getSubClassId | ( | ) | const |
Definition at line 268 of file Exception.cpp.
const Exception * BLOCXX_NAMESPACE::Exception::getSubException | ( | ) | const |
Returns the sub exception if available, otherwise 0.
Definition at line 295 of file Exception.cpp.
Referenced by BLOCXX_NAMESPACE::operator<<().
Definition at line 170 of file Exception.cpp.
References Exception().
void BLOCXX_NAMESPACE::Exception::rethrow | ( | ) | const [virtual] |
Re-throws the exception.
All derived classes should override this which makes it possible to catch a base class Exception and still re-thrown the derived class.
Reimplemented in BLOCXX_NAMESPACE::LoggerException, and BLOCXX_NAMESPACE::StringConversionException.
Definition at line 288 of file Exception.cpp.
void BLOCXX_NAMESPACE::Exception::setErrorCode | ( | int | errorCode | ) | [protected] |
Definition at line 309 of file Exception.cpp.
void BLOCXX_NAMESPACE::Exception::setSubClassId | ( | int | subClassId | ) | [protected] |
Definition at line 275 of file Exception.cpp.
void BLOCXX_NAMESPACE::Exception::swap | ( | Exception & | x | ) | [protected] |
Definition at line 177 of file Exception.cpp.
References m_errorCode, m_file, m_line, m_msg, m_subClassId, and m_subException.
const char * BLOCXX_NAMESPACE::Exception::type | ( | ) | const [virtual] |
Returns a string representing the concrete type.
e.g. "SocketException". Will not return 0. This function will not throw. Derived class implementations must not throw.
Reimplemented in BLOCXX_NAMESPACE::LoggerException, and BLOCXX_NAMESPACE::StringConversionException.
Definition at line 190 of file Exception.cpp.
Referenced by BLOCXX_NAMESPACE::operator<<(), and BLOCXX_NAMESPACE::Thread::threadRunner().
const char * BLOCXX_NAMESPACE::Exception::what | ( | ) | const throw () [virtual] |
Returns getMessage()
Definition at line 261 of file Exception.cpp.
int BLOCXX_NAMESPACE::Exception::m_errorCode [private] |
Definition at line 180 of file Exception.hpp.
Referenced by swap().
char* BLOCXX_NAMESPACE::Exception::m_file [private] |
Definition at line 175 of file Exception.hpp.
Referenced by getFile(), swap(), and ~Exception().
int BLOCXX_NAMESPACE::Exception::m_line [private] |
Definition at line 176 of file Exception.hpp.
char* BLOCXX_NAMESPACE::Exception::m_msg [private] |
Definition at line 177 of file Exception.hpp.
Referenced by getMessage(), swap(), and ~Exception().
int BLOCXX_NAMESPACE::Exception::m_subClassId [private] |
Definition at line 178 of file Exception.hpp.
Referenced by swap().
const Exception* BLOCXX_NAMESPACE::Exception::m_subException [private] |
Definition at line 179 of file Exception.hpp.
Referenced by swap(), and ~Exception().
const int BLOCXX_NAMESPACE::Exception::UNKNOWN_ERROR_CODE = -1 [static] |
Definition at line 113 of file Exception.hpp.
Referenced by BLOCXX_NAMESPACE::operator<<().
const int BLOCXX_NAMESPACE::Exception::UNKNOWN_SUBCLASS_ID = -1 [static] |
Definition at line 112 of file Exception.hpp.