// $Id$
//
// Copyright (C) 2006
-// Fraunhofer Institut fuer offene Kommunikationssysteme (FOKUS)
-// Kompetenzzentrum fuer Satelitenkommunikation (SatCom)
-// Stefan Bund <stefan.bund@fokus.fraunhofer.de>
+// Fraunhofer Institute for Open Communication Systems (FOKUS)
+// Competence Center NETwork research (NET), St. Augustin, GERMANY
+// Stefan Bund <g0dil@berlios.de>
//
// This program is free software; you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// Custom includes
#include <exception>
#include <string>
+#include <iostream>
+#include <sstream>
#include <boost/preprocessor/repeat.hpp>
#include <boost/preprocessor/cat.hpp>
+#include <boost/utility.hpp>
//#include "Exception.mpp"
///////////////////////////////hh.p////////////////////////////////////////
-namespace senf {
+/** \defgroup exception Exception classes
- /** \brief Exception handling standard UNIX errors (errno)
+ All exceptions in senf are derived from senf::Exception. This class adds the possibility to
+ extend the exception description while it is processed:
- This exception is thrown to signal generic errno failures.
+ \code
+ try {
- \todo make where and err accessors and make the member variables private
+ // Some code which might raise an arbitrary senf exception
- \idea Add a template class derived from SystemException which takes the error number as a
- numeric argument. This allows catching specific errno conditions: ErrnoException<EPIPE> etc.
+ }
+ catch (senf::Exception & e) {
+ e << "\handling user " << user;
+ throw;
+ }
+ \endcode
- \idea Add a generic error thrower which takes the origin string and errno value as an
- argument and will throw a corresponding template class instance. This would just be a big
- switch statement containing all possible errno values, probably created using some macro
- meta-programming.
- */
- class SystemException : public std::exception
+ This will add the user information to any senf exception thrown. The Exception is however not a
+ stream. If you need to do more extensive formating, either use an intermediate string-stream or
+ use <a href="http://www.boost.org/libs/format/doc/format.html">Boost.Format</a>:
+
+ \code
+ try {
+ // ...
+ }
+ catch (senf::Exception & e) {
+ e << boost::format("\ncall id 0x%04x@%s") % id % address;
+ }
+ \endcode
+
+ senf::SystemException is thrown for all operating system errors (failures which result in the
+ operating system setting the errno value). It is also derived from senf::Exception and can
+ therefore be extended as well.
+
+ Defining your own exception classes derived from senf::Exception is very simple:
+
+ \code
+ struct FooException : public senf::Exception
+ { FooException() : senf::Exception("Foo hit the fan") {} };
+ \endcode
+ */
+
+namespace senf {
+
+ /** \brief Generic exception base-class
+
+ Exception is a generic exception base-class which allows the exception to be later extended
+ by catching and re-throwing it (See example in \ref exception).
+
+ \ingroup exception
+ */
+ class Exception
+ : public std::exception
{
public:
- SystemException(); ///< SystemException without error location infor
- /**< The error code is taken from the current value of the
- global 'errno' variable */
+ ///////////////////////////////////////////////////////////////////////////
+ ///\name Structors and default members
+ ///@{
- explicit SystemException(int code); ///< SystemException without error location info
- /**< \param[in] code error number (the errno value) */
+ virtual ~Exception() throw();
- explicit SystemException(char const * where); ///< SystemException with error location info
- /**< The error code is taken from the current value of the
- global 'errno' variable
- \param[in] where description of error origin */
+ ///@}
+ ///////////////////////////////////////////////////////////////////////////
- SystemException(char const * where, int code); ///< SystemException with error location info
- /**< \param[in] where description of error origin
- \param[in] code error number (the errno value) */
+ virtual char const * what() const throw();
- virtual char const * what() const throw(); ///< Return verbose error description
+ template <class Arg>
+ Exception & operator<<(Arg const & arg); ///< Extend exception description
+ /**< Adds \a arg converted to string to the end of the
+ exception description string. This operator allows to
+ use Exception instances like streams. The conversion is
+ performed using <code>boost::lexical_cast</code> and is
+ therefor identical to a streaming operation.
+ \see \ref exception */
- char const * where() const; ///< Error origin
- int code() const; ///< Error code (errno number)
- char const * description() const; ///< Error description (strerror() value)
+ protected:
+ Exception(std::string const & description = ""); ///< Initialize exception with string
+ /**< \a description is the initial error description
+ string. This should probably be a string constant
+ describing the exception for most derived
+ exceptions. */
- bool anyOf(int c0, int c1=0, int c2=0, int c3=0, int c4=0, int c5=0,
- int c6=0, int c7=0, int c8=0, int c9=0);
+ private:
+ std::string message_;
+ };
- virtual ~SystemException() throw();
- private:
- void init();
+ /** \brief Exception handling standard UNIX errors (errno)
- char const * const where_;
- int const code_;
- std::string buffer_;
- };
+ This exception is thrown to signal generic \c errno failures. Normally the \c errno value is
+ automatically taken from the \c errno variable but it may also be specified explicitly:
+
+ \code
+ // Standard usage: Take \c errno from environment
+ throw senf::SystemException("::open()")
+ << " while opening configuration file: " << filename;
+
+ // You may however explicitly specify the errno value
+ throw senf::SystemException("::open()", ENOFILE)
+
+ // Or leave the location information empty
+ throw senf::SystemException(ENOFILE);
+ throw senf::SystemException();
+ \endcode
- template <int Code>
- class ErrnoException : public SystemException
+ \ingroup exception
+ */
+ class SystemException : public Exception
{
public:
- static int const fixed_code = Code;
+ ///////////////////////////////////////////////////////////////////////////
+ ///\name Structors and default members
+ ///@{
- ErrnoException();
- explicit ErrnoException(char const * where);
- };
+ explicit SystemException(std::string const & where = "");
+ explicit SystemException(int code);
+ SystemException(std::string const & where, int code);
+
+ virtual ~SystemException() throw();
- void throwErrno();
- void throwErrno(char const * where);
- void throwErrno(int code);
- void throwErrno(char const * where, int code);
+ ///@}
+ ///////////////////////////////////////////////////////////////////////////
- enum NoThrow_t { nothrow };
+ int errorNumber() const; ///< Error code (\c errno number)
+ char const * description() const; ///< Error description (\c strerror() value)
+
+ bool anyOf(int c0, int c1=0, int c2=0, int c3=0, int c4=0, int c5=0,
+ int c6=0, int c7=0, int c8=0, int c9=0);
+ ///< \c true, if errorNumber() is one of \a c0 ... \a c9
+
+
+
+ private:
+ void init(std::string const & where, int code);
+
+ int code_;
+ };
}