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

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. #if !defined(THREAD_DOT_H)
  2. #define THREAD_DOT_H
  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 Thread_hxx_Version = 
  53.     "$Id: Thread.hxx,v 1.13 2001/06/29 03:42:31 bko Exp $";
  54. #include "Writer.hxx"
  55. #include "TransportCommon.hxx"
  56. #include "VThread.hxx"
  57. #include "VMutex.h"
  58. #include <map>
  59. /** Infrastructure common to VOCAL.
  60.  */
  61. namespace Vocal 
  62. {
  63. /** Infrastructure common to VOCAL to create and manage processes.
  64.  */
  65. namespace Process
  66. {
  67. class Runnable;
  68. class SignalHandler;
  69. /** Executes a Runnable in it's own thread of execution.<br><br>
  70.  *
  71.  *  Each thread creates a SignalHandler.
  72.  *
  73.  *  @see    Vocal::Process::Runnable
  74.  *  @see    Vocal::Process::Application
  75.  *  @see    Vocal::Process::SignalHandler
  76.  *  @see    Vocal::ReturnCode
  77.  */
  78. class Thread : public Vocal::IO::Writer
  79. {
  80.     public:
  81.     
  82.      /** Globally initialize the Thread facility. This should be done
  83.  *  in Application::init on the context of the initial thread. 
  84.  *  When called, the current thread is added to the ThreadMap so 
  85.  *  that self() will work in the initial thread.
  86.  */
  87.      static void          init();
  88.      /** Globally uninitialize the Thread facility. This should be done
  89.  *  in Application::uninit.
  90.  */
  91. static void          uninit();
  92.      /** Returns the Thread class associated with the calling thread.
  93.  */
  94.      static Thread *         self();
  95.      /** Globally initialize the Thread facility. This should be done
  96.  *  in Application::init
  97.  */
  98.      static vthread_t        selfId();
  99.      /** Start a new thread. The thread starts running during construction.
  100.  */
  101.      Thread(Runnable &, const char * name = 0);
  102.     
  103. /** Delete Thread object. This does not stop the thread from executing.
  104.  */
  105.      ~Thread();
  106.      /** Join the thread. Must be called from outside the thread of
  107.  *  execution. Returns the result of the Runnable's run() method.
  108.  */
  109. ReturnCode            join();
  110. /** Exit the thread. Must be called from within the thread
  111.  *  of execution.
  112.  */
  113. void               exit();
  114. /** Return the runnable associated with this thread. If called in the
  115.  *  initializing thread, the Application is returned.
  116.  */
  117. Runnable &            runnable();
  118. /** Return the signalHandler associated with this thread.
  119.  */
  120. SignalHandler &          signalHandler();
  121.      /** Write thread information to stream. See Writer.
  122.  */
  123. ostream &                writeTo(ostream &) const;
  124.     private:
  125.      // The function that is run when the thread is spawned.
  126. //
  127.      static void *          threadMain(void * data);
  128.      /** Default constructor for main (Application's) thread. Called
  129.  *  from init().
  130.  */
  131.      Thread();
  132. typedef map<vthread_t, Thread *>     ThreadMap;
  133.      static ThreadMap    *   threadMap_;
  134.      static VMutex                    threadMapMutex_;
  135. static Thread                  *   mainThread_;
  136.      VThread                *   thread_;
  137. Runnable               &   runnable_;
  138. SignalHandler           *   signalHandler_;
  139. string                    name_;
  140. };
  141. } // namespace Process
  142. } // namespace Vocal
  143. #endif // !defined(THREAD_DOT_H)