TAO/tao/Endpoint_Selector_Factory.h

   1 // -*- C++ -*-
   2
   3 //=============================================================================
   4 /**
   5  *  @file   Endpoint_Selector_Factory.h
   6  *
   7  * Strategies for selecting profile/endpoint from an IOR for making an
   8  * invocation.
   9  *
  10  *  @author Marina Spivak <marina@cs.wustl.edu>
  11  *  @author Frank Hunleth <fhunleth@cs.wustl.edu>
  12  */
  13 //=============================================================================
  14
  15 #ifndef TAO_ENDPOINT_SELECTOR_FACTORY_H
  16 #define TAO_ENDPOINT_SELECTOR_FACTORY_H
  17
  18 #include /**/ "ace/pre.h"
  19
  20 #include /**/ "tao/TAO_Export.h"
  21
  22 #if !defined (ACE_LACKS_PRAGMA_ONCE)
  23 # pragma once
  24 #endif /* ACE_LACKS_PRAGMA_ONCE */
  25
  26 #include /**/ "tao/Versioned_Namespace.h"
  27 #include "ace/Service_Object.h"
  28
  29 TAO_BEGIN_VERSIONED_NAMESPACE_DECL
  30
  31 namespace CORBA
  32 {
  33   class Exception;
  34 }
  35
  36 class TAO_Invocation_Endpoint_Selector;
  37
  38
  39 // ****************************************************************
  40
  41 /**
  42  * @class TAO_Endpoint_Selector_Factory
  43  *
  44  * @brief Factory for initializing <Endpoint_Selection_State> and
  45  * obtaining appropriate <Invocation_Endpoint_Selector>.
  46  *
  47  * Used by Invocation classes to initialize its endpoint selection
  48  * strategy and state based on the effective policies.
  49  * Endpoint selection strategies are stateless objects - all the
  50  * state they need is contained by Invocation in
  51  * <Endpoint_Selection_State>.  Thus, rather than allocating an
  52  * endpoint selection strategy object for each Invocation, the
  53  * factory simply returns the appropriate one from the
  54  * set preallocated in the ORB_Core.  One endpoint selection
  55  * strategy object can be used by many invocations concurrently.
  56  */
  57 class TAO_Export TAO_Endpoint_Selector_Factory
  58   : public ACE_Service_Object
  59 {
  60 public:
  61   /// Destructor.
  62   virtual ~TAO_Endpoint_Selector_Factory ();
  63
  64   /// Get an Invocation's endpoint selection strategy and
  65   /// initialize the endpoint selection state instance.
  66   virtual TAO_Invocation_Endpoint_Selector *get_selector () = 0;
  67 };
  68
  69 TAO_END_VERSIONED_NAMESPACE_DECL
  70
  71 #include /**/ "ace/post.h"
  72 #endif  /* TAO_ENDPOINT_SELECTOR_FACTORY_H */