ServiceApplication.hxx
上传用户:sy_wanhua
上传日期:2013-07-25
资源大小:3048k
文件大小:6k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #if !defined(VOCAL_SERVICE_APPLICATION_HXX)
  2. #define VOCAL_SERVICE_APPLICATION_HXX
  3. /* ====================================================================
  4.  * The Vovida Software License, Version 1.0 
  5.  * 
  6.  * Copyright (c) 2000 Vovida Networks, Inc.  All rights reserved.
  7.  * 
  8.  * Redistribution and use in source and binary forms, with or without
  9.  * modification, are permitted provided that the following conditions
  10.  * are met:
  11.  * 
  12.  * 1. Redistributions of source code must retain the above copyright
  13.  *    notice, this list of conditions and the following disclaimer.
  14.  * 
  15.  * 2. Redistributions in binary form must reproduce the above copyright
  16.  *    notice, this list of conditions and the following disclaimer in
  17.  *    the documentation and/or other materials provided with the
  18.  *    distribution.
  19.  * 
  20.  * 3. The names "VOCAL", "Vovida Open Communication Application Library",
  21.  *    and "Vovida Open Communication Application Library (VOCAL)" must
  22.  *    not be used to endorse or promote products derived from this
  23.  *    software without prior written permission. For written
  24.  *    permission, please contact vocal@vovida.org.
  25.  *
  26.  * 4. Products derived from this software may not be called "VOCAL", nor
  27.  *    may "VOCAL" appear in their name, without prior written
  28.  *    permission of Vovida Networks, Inc.
  29.  * 
  30.  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
  31.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  32.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
  33.  * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
  34.  * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
  35.  * IN EXCESS OF ,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
  36.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  37.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  38.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  39.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  40.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  41.  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  42.  * DAMAGE.
  43.  * 
  44.  * ====================================================================
  45.  * 
  46.  * This software consists of voluntary contributions made by Vovida
  47.  * Networks, Inc. and many individuals on behalf of Vovida Networks,
  48.  * Inc.  For more information on Vovida Networks, Inc., please see
  49.  * <http://www.vovida.org/>.
  50.  *
  51.  */
  52. static const char* const ServiceApplication_hxx_Version = 
  53.     "$Id: ServiceApplication.hxx,v 1.2 2001/05/24 09:59:09 icahoon Exp $";
  54. #include "Application.hxx"
  55. #include "Sptr.hxx"
  56. #include "FifoBase.h"
  57. #include <vector>
  58. #include <string>
  59. namespace Vocal {
  60.     namespace Signals {
  61.         class SignalSet;
  62.         class SignalAction;
  63.     }
  64.     namespace Configuration {
  65.         class Config;
  66.     }
  67. }
  68.     
  69. /** Vovida Open Communication Application Library.<br><br>
  70.  */
  71. namespace Vocal 
  72. {
  73. /** Infrastructure common to VOCAL to provide event based services.<br><br>
  74.  */
  75. namespace Services
  76. {
  77. using Vocal::Signals::SignalSet;
  78. using Vocal::Signals::SignalAction;
  79. using Vocal::Configuration::Config;
  80. class ServiceManager;
  81. class Event;
  82. /** Service based application.<br><br>
  83.  */
  84. class ServiceApplication : public Vocal::Process::Application
  85. {
  86.     public:
  87.      /** Create the service application. Initialization is done in init, 
  88.          *  not here.
  89.  */
  90.      ServiceApplication();
  91.      /** Destroy the service application. Uninitialization is done in 
  92.          *  uninit, not here.
  93.       */
  94.      virtual ~ServiceApplication();
  95.      /** Initialize the service application.
  96.       */
  97.      ReturnCode       init(int, char **, char **);
  98.     
  99. /** Cleanup.
  100.       */
  101. void          uninit();
  102.     
  103. /** Run the service application.
  104.       */
  105.      ReturnCode       run();
  106.     protected:
  107.         /** The user should provide a factory method for the user defined
  108.          *  configuration. If the user doesn't provide this, the default
  109.          *  (and somewhat incomplete) Config class will be used.
  110.          */
  111.         virtual Config *    createConfig() const;
  112.         
  113.         
  114.         /** The user can optionally provide the set of signals that will 
  115.          *  cause the application to terminate gracefully. The default 
  116.          *  signal set will include SIGHUP, SIGINT and SIGTERM.
  117.          */
  118.         virtual const vector<int> &     terminateSignals() const;
  119.         
  120.         
  121.         /** The user can provide the filename of the log. 
  122.          *  The config has been created when this is called.
  123.          */
  124.         virtual string  logFile() const;
  125.          
  126.         
  127.         /** The last thing called by init to give the user a chance to
  128.          *  initialize. All server objects have been initialized when
  129.          *  this is called.
  130.          */
  131.         virtual void    userInit();
  132.         /** The first thing called by uninit to give the user a chance to
  133.          *  cleanup.
  134.          */
  135.         virtual void    userUninit();
  136.         
  137.         
  138.         /** Config accessor
  139.          */        
  140.         Config &    config();
  141.         
  142.         
  143.         /** Config accessor
  144.          */
  145.         const Config &  config() const;
  146.   
  147.   
  148.         /** Fifo accessor
  149.          */ 
  150.         FifoBase< Sptr<Event> > &   fifo();
  151.         
  152.         
  153.         /** ServiceManager accessor
  154.          */
  155.         ServiceManager &    serviceManager();      
  156.     private:
  157.     
  158.      /** Server configuration information.
  159.  */
  160. Config              *   myConfig;
  161.      /** The set of signals we are observing.
  162.  */
  163. SignalSet        * myTerminateSignals;
  164.      /** The signal handler for the pervious signal set.
  165.  */
  166. SignalAction     * myTerminateAction;
  167.      /** Return message fifo. Used by the service manager to 
  168.  *  communicate with the subordinate threads / services.
  169.  */
  170. FifoBase< Sptr<Event> > *   myFifo;
  171.      /** Mananges all services. It starts, stops and shutsdown
  172.  *  the services.
  173.  */
  174.      ServiceManager   *   myServiceMgr;
  175. };
  176. } // namespace Services
  177. } // namespace Vocal
  178. #endif // !defined(VOCAL_SERVICE_APPLICATION_HXX)