TAO/tao/DynamicInterface/Unknown_User_Exception.h

   1 // -*- C++ -*-
   2
   3 //=============================================================================
   4 /**
   5  *  @file   Unknown_User_Exception.h
   6  *
   7  *  Defines the way an exception is reported by a DII request.
   8  *
   9  *  @author  Portions Copyright 1994-1995 by Sun Microsystems Inc.
  10  *  @author  Portions Copyright 1997-2003 by Washington University
  11  */
  12 //=============================================================================
  13
  14
  15 #ifndef TAO_UNKNOWN_USER_EXCEPTION_H
  16 #define TAO_UNKNOWN_USER_EXCEPTION_H
  17
  18 #include /**/ "ace/pre.h"
  19
  20 #include "tao/DynamicInterface/dynamicinterface_export.h"
  21
  22 #if !defined (ACE_LACKS_PRAGMA_ONCE)
  23 #  pragma once
  24 #endif /* ACE_LACKS_PRAGMA_ONCE */
  25
  26 #include "tao/UserException.h"
  27
  28 TAO_BEGIN_VERSIONED_NAMESPACE_DECL
  29
  30 namespace CORBA
  31 {
  32   /**
  33    * @class UnknownUserException
  34    *
  35    * @brief UnknownUserException
  36    *
  37    * When user exceptions are received by a DII invocation the ORB
  38    * is unable to create the exception with the right dynamic type;
  39    * to workaround this problem it throws a
  40    * @c CORBA::UnknownUserException that contains the exception inside
  41    * an Any.
  42    */
  43   class TAO_DynamicInterface_Export UnknownUserException
  44     : public CORBA::UserException
  45   {
  46   public:
  47     /// Constructor.
  48     UnknownUserException ();
  49
  50     /// Constructor.
  51     UnknownUserException (CORBA::Any& exception);
  52
  53     /// Copy constructor.
  54     UnknownUserException (const UnknownUserException& e);
  55
  56     /// Destructor.
  57     virtual ~UnknownUserException ();
  58
  59     /// Return the any containing the user exception.
  60     CORBA::Any& exception ();
  61
  62     /// To throw an UnknownUserException of this type.
  63     virtual void _raise () const;
  64
  65     virtual CORBA::Exception *_tao_duplicate () const;
  66     virtual void _tao_encode (TAO_OutputCDR &cdr) const;
  67     virtual void _tao_decode (TAO_InputCDR &cdr);
  68
  69     /// Narrow to an UnknowUserException.
  70     static UnknownUserException * _downcast (CORBA::Exception *ex);
  71     static UnknownUserException const * _downcast (CORBA::Exception const * ex);
  72
  73     /// Return the repository ID of the Exception.
  74     virtual const char * _rep_id () const;
  75
  76     // = TAO specific extension.
  77
  78     /// This class has a specific typecode.
  79     virtual CORBA::TypeCode_ptr _tao_type () const;
  80
  81   private:
  82     /// Holder for the actual exception.
  83     CORBA::Any *exception_;
  84   };
  85
  86   // The CORBA::UnknownUserException TypeCode.
  87   extern TAO_DynamicInterface_Export TypeCode_ptr const _tc_UnknownUserException;
  88 } // End CORBA namespace.
  89
  90 TAO_END_VERSIONED_NAMESPACE_DECL
  91
  92 #include /**/ "ace/post.h"
  93
  94 #endif /* TAO_UNKNOWN_USER_EXCEPTION_H */