TAO/docs/tutorials/Quoter/RTCORBA/Broker_i.h

   1 /**
   2  * @file Broker_i.h
   3  * @author Shanshan Jiang <shanshan.jiang@vanderbilt.edu>
   4  * @author William R. Otte <wotte@dre.vanderbilt.edu>
   5  * @author Douglas C. Schmidt <schmidt@dre.vanderbilt.edu>
   6  */
   7
   8 #ifndef BROKERI_H_
   9 #define BROKERI_H_
  10
  11 // local headers
  12 #include "StockNameConsumer_i.h"
  13 #include "BrokerS.h"
  14 #include "DistributorC.h"
  15
  16 #if !defined (ACE_LACKS_PRAGMA_ONCE)
  17 #pragma once
  18 #endif /* ACE_LACKS_PRAGMA_ONCE */
  19
  20 /**
  21  * @class Stock_StockBroker_i
  22  * @brief This class defined the Stock Broker client.
  23  */
  24 class  Stock_StockBroker_i
  25   : public virtual POA_Stock::StockBroker
  26 {
  27 public:
  28   /**
  29    * Constructor.
  30    *
  31    * @param orb
  32    * @param stock_name The name of the stock that the Stock Broker client is interested in.
  33    * @param priority The CORBA priority of this Stock Broker client.
  34    */
  35   Stock_StockBroker_i (CORBA::ORB_ptr orb,
  36                        Stock::StockDistributor_ptr dist,
  37                        const char *stock_name);
  38
  39   /// Destructor
  40   virtual ~Stock_StockBroker_i (void);
  41
  42   /**
  43    * Return the StockNameConsumer object created by the Constructor.
  44    *
  45    * @return Returns a StockNameConsumer object reference.
  46    */
  47   virtual ::Stock::StockNameConsumer_ptr get_consumer_notifier ();
  48
  49   /**
  50    * Duplicate a StockQuoter object using the StockQuoter object reference "c" in the argument.
  51    *
  52    * @param c A StockQuoter object reference.
  53    */
  54   virtual void connect_quoter_info (::Stock::StockQuoter_ptr c);
  55
  56   /**
  57    * Destroy the StockQuoter object and return it.
  58    *
  59    * @return Returns the destroyed StockQuoter object reference.
  60    */
  61   virtual ::Stock::StockQuoter_ptr disconnect_quoter_info ();
  62
  63   /**
  64    * Return the StockQuoter object.
  65    *
  66    * @return Returns the StockQuoter object reference that has been
  67    *         created by connect_quoter_info ().
  68    */
  69   virtual ::Stock::StockQuoter_ptr get_connection_quoter_info ();
  70
  71   /**
  72    * Shutdown the object and destroy the application.
  73    */
  74   virtual void shutdown ();
  75
  76 private:
  77   // Cached ORB pointer
  78   CORBA::ORB_var orb_;
  79
  80   /// A StockQuoter object reference that is used to get detailed
  81   /// stock information.
  82   Stock::StockQuoter_var quoter_;
  83
  84   /// A StockNameConsumer servant that is used to get notification of
  85   /// updates.
  86   Stock_StockNameConsumer_i *consumer_;
  87
  88   /// The distributor that we are registered with, useful for shutdown.
  89   Stock::StockDistributor_var distributor_;
  90 };
  91
  92 /**
  93  * @class Stock_StockBrokerHome_i
  94  * @brief This class defined the Stock Broker home.
  95  */
  96 class  Stock_StockBrokerHome_i
  97   : public virtual POA_Stock::StockBrokerHome,
  98     public ACE_Event_Handler
  99 {
 100 public:
 101   /**
 102    * Constructor.
 103    * Register the necessary factories and mappings with the specified orb and
 104    * Create a new instance of the StockBroker object.
 105    *
 106    * @param orb
 107    */
 108   Stock_StockBrokerHome_i (CORBA::ORB_ptr orb);
 109
 110   /// Destructor
 111   virtual ~Stock_StockBrokerHome_i (void);
 112
 113   /**
 114    * Return the StockBroker object created by the Constructor.
 115    *
 116    * @return The StockBroker object created by the Constructor.
 117    */
 118   virtual ::Stock::StockBroker_ptr create (Stock::StockDistributor_ptr dist,
 119                                            const char *stock_name);
 120
 121   virtual int handle_signal (int signum,
 122                              siginfo_t * = 0,
 123                              ucontext_t * = 0);
 124
 125 private:
 126   /// The StockDistributor object created by its home.
 127   Stock::StockBroker_var broker_;
 128
 129   /// Cache a reference to the ORB.
 130   CORBA::ORB_var orb_;
 131 };
 132
 133 #endif /* BROKERI_H_  */