TAO/tao/Object_Loader.h

   1 // -*- C++ -*-
   2
   3 // ================================================================
   4 /**
   5  *  @file   Object_Loader.h
   6  *
   7  *  @author Carlos O'Ryan (coryan@cs.wustl.edu)
   8  */
   9 // ================================================================
  10
  11 #ifndef TAO_OBJECT_LOADER_H
  12 #define TAO_OBJECT_LOADER_H
  13
  14 #include /**/ "ace/pre.h"
  15 #include "ace/Service_Object.h"
  16
  17 #if !defined (ACE_LACKS_PRAGMA_ONCE)
  18 # pragma once
  19 #endif /* ACE_LACKS_PRAGMA_ONCE */
  20
  21 #include "tao/orbconf.h"
  22 #include "tao/TAO_Export.h"
  23
  24 TAO_BEGIN_VERSIONED_NAMESPACE_DECL
  25
  26 namespace CORBA
  27 {
  28   class Object;
  29   typedef Object *Object_ptr;
  30
  31   class ORB;
  32   typedef ORB *ORB_ptr;
  33 }
  34
  35 /**
  36  * @class TAO_Object_Loader
  37  *
  38  * @brief A class to dynamically load object implementations into an
  39  * ORB.
  40  *
  41  * Many services and components of the ORB can be dynamically
  42  * loaded, often these components are returned to the application via
  43  * an object reference (CORBA::Object_ptr).  This class is used to
  44  * dynamically load such components, and encapsulate the creation of
  45  * the object reference.
  46  */
  47 class TAO_Export TAO_Object_Loader : public ACE_Service_Object
  48 {
  49 public:
  50   /// The destructor
  51   virtual ~TAO_Object_Loader ();
  52
  53   /**
  54    * Create and activate a new object into the orb.
  55    * This method cannot throw any exception, but it can return a nil
  56    * object to indicate an error condition.
  57    */
  58   virtual CORBA::Object_ptr create_object (CORBA::ORB_ptr orb,
  59                                            int argc,
  60                                            ACE_TCHAR* argv []) = 0;
  61 };
  62
  63 TAO_END_VERSIONED_NAMESPACE_DECL
  64
  65 #include /**/ "ace/post.h"
  66
  67 #endif /* TAO_OBJECT_LOADER_H */