// This may look like C, but it's really -*- C++ -*-

//=============================================================================
/**
 *  @file   Unknown_User_Exception.h
 *
 *  $Id$
 *
 *  Defines the way an exception is reported by a DII request.
 *
 *
 *  @author  Copyright 1994-1995 by Sun Microsystems Inc.
 */
//=============================================================================


#ifndef TAO_UNKNOWN_USER_EXCEPTION_H
#define TAO_UNKNOWN_USER_EXCEPTION_H
#include "ace/pre.h"

#include "dynamicinterface_export.h"

#if !defined (ACE_LACKS_PRAGMA_ONCE)
#  pragma once
#endif /* ACE_LACKS_PRAGMA_ONCE */

#include "tao/Exception.h"

#if defined (TAO_EXPORT_MACRO)
#undef TAO_EXPORT_MACRO
#endif
#define TAO_EXPORT_MACRO TAO_DynamicInterface_Export

#if defined (TAO_EXPORT_NESTED_CLASSES)
#  if defined (TAO_EXPORT_NESTED_MACRO)
#    undef TAO_EXPORT_NESTED_MACRO
#  endif /* defined (TAO_EXPORT_NESTED_MACRO) */
#  define TAO_EXPORT_NESTED_MACRO TAO_DynamicInterface_Export
#endif /* TAO_EXPORT_NESTED_CLASSES */

/**
 * @class CORBA_UnknownUserException
 *
 * @brief CORBA_UnknownUserException
 *
 * When user exceptions are received by a DII invocation the ORB
 * is unable to create the exception with the right dynamic type;
 * to workaround this problem it throws a
 * <CORBA::UnknownUserException> that contains the exception inside
 * an Any.
 */
class TAO_DynamicInterface_Export CORBA_UnknownUserException 
  : public CORBA_UserException
{
public:
  // = Initialization and termination methods.

  /// Constructor.
  CORBA_UnknownUserException (void);

  /// Constructor.
  CORBA_UnknownUserException (CORBA_Any& exception);

  /// Copy constructor.
  CORBA_UnknownUserException (const CORBA_UnknownUserException& e);

  /// Destructor.
  virtual ~CORBA_UnknownUserException (void);

  /// Return the any containing the user exception.
  CORBA_Any& exception (void);

  /// To throw an UnknownUserException of this type.
  virtual void _raise (void);

  virtual void _tao_encode (TAO_OutputCDR &cdr,
                            CORBA::Environment &) const;
  virtual void _tao_decode (TAO_InputCDR &cdr,
                            CORBA::Environment &);

  /// Narrow to an UnknowUserException.
  static CORBA_UnknownUserException *_downcast (CORBA_Exception *ex);

  // = TAO specific extension.

  /// Helper method to implement _downcast.
  virtual int _is_a (const char *type_id) const;

  /// This class has a specific typecode.
  virtual CORBA::TypeCode_ptr _type (void) const;

private:
  /// Holder for the actual exception.
  CORBA_Any *exception_;
};

#include "ace/post.h"
#endif /* TAO_UNKNOWN_USER_EXCEPTION_H */