---

lExceptions.h

Go to the documentation of this file.

/******************************************************************************/
/*                                                                            */
/* POLiTe - Persistent Object Library Test                                    */
/*                                        Ph.D. Thesis by Mgr. Michal Kopecky */
/*                                                                            */
/* Charles University Prague                                                  */
/*                                                                            */
/******************************************************************************/
/*                                                                            */
/* File name: ... lExceptions.h                                               */
/* Module: ...... none                                                        */
/*                                                                            */
/******************************************************************************/
/*                                                                            */
/* Declares the class interfaces for the exceptions.                          */
/* It is intended to serve as a starting-point for exception handling.        */
/*                                                                            */
/******************************************************************************/

#ifndef __L_EXCEPTIONS_H__
#define __L_EXCEPTIONS_H__

// Common POLiTe Header(s)
#include <lDefs.h>
#include <lTrace.h>

// During an execution of POLiTe based application, some exceptions may appear
// due to an incorrect work of database server, network layers of software,
// incorrect use of POLiTe services, insufficient amount of resources (memory),
// etc. These exceptions are described below.

class DLL_External ObjLibException {
public:
  ObjLibException();                    // constructor
  virtual ~ObjLibException();           // destructor
  virtual const char *Name() = 0;       // Returns name of exception as a string
};

// GEN.LIB can't communicate with the database server.

class DLL_External ObjLibException_ConnectionError : public ObjLibException {
public:
  ObjLibException_ConnectionError();           // constructor
  virtual ~ObjLibException_ConnectionError();  // destructor
  virtual const char *Name() {return "ConnectionError";};
  // Returns name of exception as a string
};

// Required functionality is not supported on the used database server engine.

class DLL_External ObjLibException_NotSupported : public ObjLibException {
public:
  ObjLibException_NotSupported();            // constructor
  virtual ~ObjLibException_NotSupported();   // destructor
  virtual const char *Name() {return "NotSupported";};
  // Returns name of exception as a string
};

// Database server does not recognise SQL command due either syntax error, or
// semantic error (table not exists, etc.).

class DLL_External ObjLibException_SqlError : public ObjLibException {
public:
  ObjLibException_SqlError();                           // constructor
  virtual ~ObjLibException_SqlError();                  // destructor
  virtual const char *Name() {return "SqlError";};
  // Returns name of exception as a string
};

// The specified object can’t be retrieved from database because table row,
//representing object is locked by another connection.

class DLL_External ObjLibException_DatabaseLock : public ObjLibException {
public:
  ObjLibException_DatabaseLock();            // constructor
  virtual ~ObjLibException_DatabaseLock();   // destructor
  virtual const char *Name() {return "DatabaseLock";};
  // Returns name of exception as a string
};

// The specified object can’t be freed, because it is currently locked on
//a fixed address of memory.

class DLL_External ObjLibException_MemoryLock : public ObjLibException {
public:
  ObjLibException_MemoryLock();                 // constructor
  virtual ~ObjLibException_MemoryLock();        // destructor
  virtual const char *Name() {return "MemoryLock";};
  // Returns name of exception as a string
};

// There is not enough memory to complete operation.

class DLL_External ObjLibException_NoMemory : public ObjLibException {
public:
  ObjLibException_NoMemory();           // constructor
  virtual ~ObjLibException_NoMemory();  // destructor
  virtual const char *Name() {return "NoMemory";};
  // Returns name of exception as a string
};

// Specified data are not found.

class DLL_External ObjLibException_NotFound : public ObjLibException {
public:
  ObjLibException_NotFound();           // constructor
  virtual ~ObjLibException_NotFound();  // destructor
  virtual const char *Name() {return "NotFound";};
  // Returns name of exception as a string
};

#endif  //__L_EXCEPTIONS_H__

---