Exception.h

/* 
   EyeDB Object Database Management System
   Copyright (C) 1994-2008 SYSRA
   
   EyeDB is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.
   
   EyeDB is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.
   
   You should have received a copy of the GNU Lesser General Public
   License along with this library; if not, write to the Free Software
   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA 
*/

/*
   Author: Eric Viara <viara@sysra.com>
*/


#ifndef _EYEDB_EXCEPTION_H
#define _EYEDB_EXCEPTION_H

#include <stdarg.h>

namespace eyedb {

  enum SeverityStatus {
    _Warning=1,
    _Error,
    _FatalError
  };

  class Exception;

  typedef const Exception *Status;

  class Exception {

    // ----------------------------------------------------------------------
    // Exception Interface
    // ----------------------------------------------------------------------
  public:

    Exception(int status = 0, SeverityStatus severity = _Error);

    Exception(Status parent, int status = 0,
              SeverityStatus severity = _Error);

    Exception(const Exception &e);

    Exception& operator=(const Exception &e);

    Status setSeverity(SeverityStatus severity);

    SeverityStatus getSeverity() const;

    Status getParent() const;

    void setStatus( int status);

    int getStatus() const;

    Status setString(const char *fmt, ...);

    Status setString(SeverityStatus severity, const char *fmt, ...);

    Status setString(int status, SeverityStatus severity, const char *fmt, ...);

    const char *getString() const;

    const char *getDesc() const;

    Status setUserData(Any ud);

    Any getUserData() const;

    static void setHandler(void (*handler)(Status, void *), void *hud = NULL);

    static void (*getHandler())(Status, void *);

    static void *getHandlerUserData();

    void applyHandler() const;

    enum Mode {
      ExceptionMode = 32,
      StatusMode    = 64
    };

    static Exception::Mode setMode(Exception::Mode mode);

    static Exception::Mode getMode();

    Status print(FILE *fd = stderr, bool newline = true) const;

    static Status make(int err, const char *fmt, ...);

    static Status make(int err, const std::string &s);

    static Status make(const char *fmt, ...);

    static Status make(const std::string &s);

    static Status make(int err);


    static Status make(Status status);

    ~Exception();

    // ----------------------------------------------------------------------
    // Exception Private Part
    // ----------------------------------------------------------------------
  private:
    Exception *parent;
    int status; // will be _Error
    SeverityStatus severity;
    char *string;
    Any user_data;
    static void* handler_user_data;
    static void (*handler)(Status, void *);
    static Exception::Mode mode;

    static struct _desc {
      const char *status_string;
      const char *desc;
    } statusDesc[IDB_N_ERROR];

    static void (*print_method)(Status, FILE*);
    void setPrintMethod(void (*)(Status, FILE*));
    void (*getPrintMethod(void))(Status, FILE*);
  
    void statusMake(Status, int, SeverityStatus);
    void print_realize(FILE*, bool newline) const;

    // ----------------------------------------------------------------------
    // Exception Restricted Access (conceptually private)
    // ----------------------------------------------------------------------
  public:
    static void init(void);
    static void _release(void);
  };

  std::ostream& operator<<(std::ostream&, const Exception &);
  std::ostream& operator<<(std::ostream&, Status);

  // ----------------------------------------------------------------------
  // Status CPP Macros
  // ----------------------------------------------------------------------

  static const Status Success = (Status)0;

  extern Status _status_;

#define eyedb_CHECK(e) \
        ((_status_ = (e)) ? \
        (void)fprintf(stderr, "file %s, line %d : %s\n<<\n  %s\n>>\n", \
                      __FILE__, __LINE__, _status_->getDesc(), #e), \
        _status_ : _status_)

#define eyedb_ASSERT(e) \
        if (eyedb_CHECK(e)) \
                abort()

#define eyedb_CHECK_RETURN(e) \
        if ((_status_ = (e))) return _status_

}

#endif

---