diff options
Diffstat (limited to 'TAO/tao/except.h')
| -rw-r--r-- | TAO/tao/except.h | 208 |
1 files changed, 208 insertions, 0 deletions
diff --git a/TAO/tao/except.h b/TAO/tao/except.h new file mode 100644 index 00000000000..ea62bfbadfa --- /dev/null +++ b/TAO/tao/except.h @@ -0,0 +1,208 @@ +// This may look like C, but it's really -*- C++ -*- + +// ============================================================================ +// +// = LIBRARY +// TAO +// +// = FILENAME +// except.h +// +// = DESCRIPTION +// This file defines way in which CORBA exceptions are reported. +// +// = AUTHOR +// Copyright 1994-1995 by Sun Microsystems Inc. +// +// ============================================================================ + +#if !defined (TAO_EXCEPT_H) +# define TAO_EXCEPT_H + +# include "ace/OS.h" +# include "ace/Synch.h" + +extern const IID IID_CORBA_Exception; +extern const IID IID_CORBA_UserException; +extern const IID IID_CORBA_SystemException; + +class ACE_Svc_Export CORBA_Exception : public IUnknown + // = TITLE + // CORBA2-specified exception hierarchy. + // + // All exceptions have a type (represented by a TypeCode) and a widely + // scoped type ID (in the TypeCode) that generated by any OMG-IDL compiler + // and available through the Interface Repositories. Think of it as a + // "globally scoped" name distinguishing each exception. +{ +public: + CORBA_Exception (const CORBA_Exception &src); + CORBA_Exception &operator = (const CORBA_Exception &src); + + void *operator new (size_t, const void *p) + { return (void *) p; } + void *operator new (size_t s) + { return ::operator new (s); } + void operator delete (void *p) + { ::operator delete (p); } + + const CORBA_String id (void) const; + const CORBA_TypeCode_ptr type (void) const; + + // = Methods required for COM IUnknown support + + ULONG __stdcall AddRef (void); + ULONG __stdcall Release (void); + HRESULT __stdcall QueryInterface (REFIID riid, + void **ppv); + + CORBA_Exception (CORBA_TypeCode_ptr type); + virtual ~CORBA_Exception (void); + +private: + CORBA_TypeCode_ptr _type; + // Type of the Exception. + + u_int _refcnt; + // Reference count to avoid copying overhead. + + ACE_Thread_Mutex lock_; + // Serialize access to reference count. +}; + +class ACE_Svc_Export CORBA_UserException : public CORBA_Exception + // = TITLE + // User exceptions are those defined by application developers + // using OMG-IDL. +{ +public: + CORBA_UserException (CORBA_TypeCode_ptr tc); + ~CORBA_UserException (void); + +protected: + // Copy and assignment operators. +}; + +enum CORBA_CompletionStatus +{ + COMPLETED_YES, // successful or exceptional completion + COMPLETED_NO, // didn't change any state; retry is OK + COMPLETED_MAYBE // can't say what happened; retry unsafe +}; + +class ACE_Svc_Export CORBA_SystemException : public CORBA_Exception + // = TITLE + // System exceptions are those defined in the CORBA spec; OMG-IDL + // defines these. +{ +public: + // 94-9-14 also sez: public copy constructor + // and assignment operator. + + CORBA_SystemException (CORBA_TypeCode_ptr tc, + CORBA_ULong code, + CORBA_CompletionStatus completed); + + ~CORBA_SystemException (void); + + CORBA_ULong minor (void) const { return _minor; } + void minor (CORBA_ULong m) { _minor = m; } + + CORBA_CompletionStatus completion (void) const { return _completed; } + + void completion (CORBA_CompletionStatus c) + { _completed = c; } + +private: + CORBA_ULong _minor; + CORBA_CompletionStatus _completed; +}; + +// Declarations for all of the CORBA standard exceptions. +// +// XXX shouldn't have a default minor code, at least for code that's +// inside the ORB. All minor codes should be symbolically catalogued. + +#define SYSEX(name) \ +extern CORBA_TypeCode_ptr _tc_CORBA_ ## name ; \ +class ACE_Svc_Export CORBA_ ## name : public CORBA_SystemException { \ +public: \ + CORBA_ ## name (CORBA_CompletionStatus completed, \ + CORBA_ULong code = 0xffff0000L) \ + : CORBA_SystemException (_tc_CORBA_ ## name, code, completed) \ + { } \ +} + +SYSEX(UNKNOWN); +SYSEX(BAD_PARAM); +SYSEX(NO_MEMORY); +SYSEX(IMP_LIMIT); +SYSEX(COMM_FAILURE); +SYSEX(INV_OBJREF); +SYSEX(OBJECT_NOT_EXIST); +SYSEX(NO_PERMISSION); +SYSEX(INTERNAL); +SYSEX(MARSHAL); +SYSEX(INITIALIZE); +SYSEX(NO_IMPLEMENT); +SYSEX(BAD_TYPECODE); +SYSEX(BAD_OPERATION); +SYSEX(NO_RESOURCES); +SYSEX(NO_RESPONSE); +SYSEX(PERSIST_STORE); +SYSEX(BAD_INV_ORDER); +SYSEX(TRANSIENT); +SYSEX(FREE_MEM); +SYSEX(INV_IDENT); +SYSEX(INV_FLAG); +SYSEX(INTF_REPOS); +SYSEX(BAD_CONTEXT); +SYSEX(OBJ_ADAPTER); +SYSEX(DATA_CONVERSION); + +#undef SYSEX + +enum CORBA_ExceptionType +{ + NO_EXCEPTION, + SYSTEM_EXCEPTION, + USER_EXCEPTION +}; + +class CORBA_Environment + // = TITLE + // A CORBA_Environment is a way to automagically ensure that + // exception data is freed -- the "var" class for Exceptions. It + // adds just a bit of convenience function support, helping classify + // exceptions as well as reducing memory leakage. +{ +public: + CORBA_Environment (void) : _exception (0) { } + ~CORBA_Environment (void) { clear (); } + + CORBA_Exception_ptr exception (void) const { return _exception; } + + void exception (CORBA_Exception *ex) + { clear (); _exception = ex; } + + CORBA_ExceptionType exception_type (void) const; + const CORBA_String exception_id (void) const; + + void clear (void) + { + if (_exception) + { + _exception->Release (); + _exception = 0; // XXX + } + } + +private: + CORBA_Exception_ptr _exception; + + // = These are not provided. + CORBA_Environment (const CORBA_Environment &src); + CORBA_Environment &operator = (const CORBA_Environment &src); +}; + +#endif /* TAO_EXCEPT_H */ |