TAO/docs/tutorials/Quoter/RTCORBA/Broker.idl

   1 /**
   2  * @file Broker.idl
   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  * Contains IDL definitions for the Stock Broker in the Publish/Subscribe Real-time CORBA
   8  * Stock Quoter Service.
   9  */
  10
  11 #ifndef QUOTER_BROKER_IDL
  12 #define QUOTER_BROKER_IDL
  13
  14 #include "Common.idl"
  15 #include "Distributor.idl"
  16
  17 module Stock
  18 {
  19   /**
  20    * @class StockBroker
  21    * @brief Provides interfaces for stock broker clients.
  22    */
  23   interface StockBroker
  24   {
  25     /// Factory operation to return StockNameConsumer object reference.
  26     StockNameConsumer get_consumer_notifier ();
  27
  28     /// Connects the broker to a supplied Quoter object reference.
  29     void connect_quoter_info  (in StockQuoter c);
  30
  31     /// Disconnects a the quoter connection.
  32     StockQuoter disconnect_quoter_info ();
  33
  34     /// Gets the current quoter connection.
  35     StockQuoter get_connection_quoter_info ();
  36
  37     /// Shutdown the object and terminate the application
  38     oneway void shutdown ();
  39   };
  40
  41   /**
  42    * @class StockBrokerHome
  43    * @brief Interface that aids in managing StockBroker lifecycles.
  44    */
  45   interface StockBrokerHome
  46   {
  47     /// Create a StockBroker object.
  48     StockBroker create (in StockDistributor dist,
  49                         in string stock_name);
  50   };
  51 };
  52
  53 #endif