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

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #if !defined(VOCAL_POLL_FIFO_SERVICE_HXX)
  2. #define VOCAL_POLL_FIFO_SERVICE_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 $1,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 PollFifoService_hxx_Version = 
  53.     "$Id: PollFifoService.hxx,v 1.2 2001/04/03 07:51:11 icahoon Exp $";
  54. #include "Service.hxx"
  55. #include "PollFifo.hxx"
  56. #include <string>
  57. namespace Vocal {
  58.     namespace Transport {
  59.      class Protocol;
  60. class ProtocolException;
  61.     }
  62. }
  63. /** Infrastructure common to VOCAL.
  64.  */
  65. namespace Vocal 
  66. {
  67. /** Infrastructure common to VOCAL to provide event based services.<br><br>
  68.  */
  69. namespace Services
  70. {
  71. /** Extends the Service class, using a PollFifo.<br><br>
  72.  *
  73.  *  @see    Vocal::Services::Service
  74.  *  @see    Vocal::PollFifo
  75.  *  @see    Vocal::Transport::Protocol
  76.  *  @see    Vocal::SystemException
  77.  *  @see    Vocal::Transport::ProtocolException
  78.  *  @see    Vocal::Services::Event
  79.  */
  80. class PollFifoService : public Vocal::Services::Service
  81. {
  82.     public:
  83.     
  84. /** Create the PollFifoServer given a reference to the Fifo of
  85.  *  the Service Manager controling this Service, and an optional
  86.  *  name.
  87.  */
  88.      PollFifoService(
  89.     FifoBase< Sptr<Event> > & serviceMgrFifo,
  90.     const char * name = 0
  91. );
  92.      /** Virtual destructor
  93.  */
  94. virtual           ~PollFifoService();
  95.      /** Accessor for PollFifo.
  96.  */
  97. FifoBase< Sptr<Event> >      &   getFifo();
  98.      /** Accessor for PollFifo.
  99.  */
  100. const FifoBase< Sptr<Event> > &   getFifo() const;
  101.      /** Register the protocol for activity detection.
  102.  */
  103. void      registerProtocol(Protocol &);
  104.      /** Update the protocol's activity detection.
  105.       */
  106.      void      updateProtocol(Protocol &);
  107.      /** Register the protocol for activity detection.
  108.  */
  109. void      unregisterProtocol(Protocol &);
  110.     protected:
  111.      /** Handle an exception thrown by the fifo during wait. 
  112.       *  The default behavior is to ignore the exception.
  113.       *  Return true to shutdown, which will cause this thread to exit.
  114.  */
  115. virtual bool onVException(VException &);
  116.      /** Handle a transport exception thrown by the fifo during
  117.       *  wait. If we get this, poll is probably broken and other 
  118.       *  threads probably can't send events to us, so we need
  119.       *  to do a hard shutdown. Return true to shutdown, which
  120.       *  will cause this thread to exit.
  121.  */
  122. virtual bool onSystemException(SystemException &);
  123.      /** Handle a protocol exception thrown directly by a protocol
  124.       *  or thrown indirectly by a MessageObserver using a
  125.       *  protocol. The default action is to do nothing. Return true 
  126.       *  to shutdown, which will cause this thread to exit.
  127.  */
  128. virtual bool onProtocolException(Transport::ProtocolException &);
  129. /** Calls the FifoBase's processMessages, then processes
  130.       *  the protocols.
  131.  */
  132.      bool      processMessages(int numberFdsActive);
  133.     private:
  134.      void      processProtocols(int numberFdsActive);
  135.         PollFifo< Sptr<Event> >      myFifo;
  136. };
  137. } // namespace Services
  138. } // namespace Vocal
  139. #endif // !defined(VOCAL_POLL_FIFO_SERVICE_HXX)