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

流媒体/Mpeg4/MP4

开发平台:

C/C++

  1. /* ====================================================================
  2.  * The Vovida Software License, Version 1.0 
  3.  * 
  4.  * Copyright (c) 2000 Vovida Networks, Inc.  All rights reserved.
  5.  * 
  6.  * Redistribution and use in source and binary forms, with or without
  7.  * modification, are permitted provided that the following conditions
  8.  * are met:
  9.  * 
  10.  * 1. Redistributions of source code must retain the above copyright
  11.  *    notice, this list of conditions and the following disclaimer.
  12.  * 
  13.  * 2. Redistributions in binary form must reproduce the above copyright
  14.  *    notice, this list of conditions and the following disclaimer in
  15.  *    the documentation and/or other materials provided with the
  16.  *    distribution.
  17.  * 
  18.  * 3. The names "VOCAL", "Vovida Open Communication Application Library",
  19.  *    and "Vovida Open Communication Application Library (VOCAL)" must
  20.  *    not be used to endorse or promote products derived from this
  21.  *    software without prior written permission. For written
  22.  *    permission, please contact vocal@vovida.org.
  23.  *
  24.  * 4. Products derived from this software may not be called "VOCAL", nor
  25.  *    may "VOCAL" appear in their name, without prior written
  26.  *    permission of Vovida Networks, Inc.
  27.  * 
  28.  * THIS SOFTWARE IS PROVIDED "AS IS" AND ANY EXPRESSED OR IMPLIED
  29.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  30.  * OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND
  31.  * NON-INFRINGEMENT ARE DISCLAIMED.  IN NO EVENT SHALL VOVIDA
  32.  * NETWORKS, INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT DAMAGES
  33.  * IN EXCESS OF $1,000, NOR FOR ANY INDIRECT, INCIDENTAL, SPECIAL,
  34.  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  35.  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  36.  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
  37.  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  38.  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
  39.  * USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
  40.  * DAMAGE.
  41.  * 
  42.  * ====================================================================
  43.  * 
  44.  * This software consists of voluntary contributions made by Vovida
  45.  * Networks, Inc. and many individuals on behalf of Vovida Networks,
  46.  * Inc.  For more information on Vovida Networks, Inc., please see
  47.  * <http://www.vovida.org/>.
  48.  *
  49.  */
  50. static const char* const StateInterface_cxx_Version = 
  51.     "$Id: StateInterface.cxx,v 1.1 2001/03/30 02:49:20 icahoon Exp $";
  52. #include <cassert>
  53. #include "StateInterface.hxx"
  54. #include "Stimulus.hxx"
  55. #include "Action.hxx"
  56. #include "VLog.hxx"
  57. using Vocal::Behavioral::StateInterface;
  58. using Vocal::Behavioral::Stimulus;
  59. using Vocal::Behavioral::Action;
  60. using Vocal::Logging::VLog;
  61. using Vocal::ReturnCode;
  62. StateInterface::StateInterface(
  63.     const char      * name,
  64.     Action       * onEntry,
  65.     Action       * onExit
  66. )
  67.     : name_(name ? name : "NullState"),
  68.      entry_(onEntry),
  69.      exit_(onExit)
  70. {
  71.     const string    fn("StateInterface::StateInterface");
  72.     VLog         log(fn);
  73.     
  74.     VDEBUG(log) << fn << ": " << *this << VDEBUG_END(log);
  75. }
  76. StateInterface::~StateInterface()
  77. {
  78.     const string    fn("StateInterface::~StateInterface");
  79.     VLog         log(fn);
  80.     
  81.     VDEBUG(log) << fn << ": " << name_ << VDEBUG_END(log);
  82. }
  83. void     
  84. StateInterface::addAction(
  85.     const Stimulus      & stimulus,
  86.     Action            & action,
  87.     StateInterface          & nextState
  88. )
  89. {
  90.     const string    fn("StateInterface::addAction");
  91.     VLog         log(fn);
  92.     bool rc = stimulusTable_.insert(
  93.               StimulusPair(stimulus, StimulusData(action, nextState, 0))
  94.        ).second;
  95.     assert( rc );
  96.     VDEBUG(log) << fn 
  97.           << "ntState          :t" << name_
  98.           << "ntStimulus       :t" << stimulus
  99.      << "ntAction         :t" << action
  100.      << "ntNextState      :t" << nextState.name()
  101. << VDEBUG_END(log);
  102. }
  103. void     
  104. StateInterface::addAction(
  105.     const Stimulus      & stimulus,
  106.     Action            & action,
  107.     StateInterface          & nextState,
  108.     StateInterface          & nextStateOnFail
  109. )
  110. {
  111.     const string    fn("StateInterface::addAction");
  112.     VLog         log(fn);
  113.     bool rc = stimulusTable_.insert(
  114.               StimulusPair(stimulus, StimulusData(action, nextState, &nextStateOnFail))
  115.        ).second;
  116.     assert( rc );
  117.     VDEBUG(log) << fn 
  118.           << "ntState          :t" << name_
  119.           << "ntStimulus       :t" << stimulus
  120.      << "ntAction         :t" << action
  121.      << "ntNextState      :t" << nextState.name()
  122.      << "ntNextStateOnFail:t" << nextStateOnFail.name()
  123. << VDEBUG_END(log);
  124. }
  125. void             
  126. StateInterface::entryAction(Action & onEntry)
  127. {
  128.     entry_ = &onEntry;
  129. }
  130. void             
  131. StateInterface::exitAction(Action & onExit)
  132. {
  133.     exit_ = &onExit;
  134. }
  135. void             
  136. StateInterface::enter() throw ()
  137. {
  138.     const string    fn("StateInterface::enter");
  139.     VLog         log(fn);
  140.     if ( entry_ )
  141.     {
  142.      VDEBUG(log) << fn << ": State: " << name_
  143.          << ": Action: " << *entry_ << VDEBUG_END(log);
  144.      entry_->action();
  145.     }
  146. }
  147. StateInterface &    
  148. StateInterface::stimulate(
  149.     const Stimulus  &   stimulus
  150. ) throw ()
  151. {
  152.     const string    fn("StateInterface::stimuluate");
  153.     VLog         log(fn);
  154.     VDEBUG(log) << fn 
  155.           << "ntState: " << name_
  156.           << ",ttStimulus: " << stimulus 
  157. << VDEBUG_END(log);
  158.     // Lookup the stimulus in the stimulus table. 
  159.     //
  160.     StimulusTable::iterator it = stimulusTable_.find(stimulus);
  161.     
  162.     // If it doesn't exist, do nothing.
  163.     //
  164.     if ( it == stimulusTable_.end() )
  165.     {
  166.      VDEBUG(log) << fn 
  167.           << "ntState: " << name_
  168.           << ",ttAction: No Action" 
  169. << VDEBUG_END(log);
  170.      return ( *this );
  171.     }
  172.     
  173.     // If the stimulus exists first perform the exit action on this state, 
  174.     // then perform the action associated with the stimulus, and finally
  175.     // perform the entry action on the next state.
  176.     //
  177.     // Note that the exit action, the action associated with this stimulus, 
  178.     // and the entry action of the next state may throw an exception.
  179.     //
  180.     exit();
  181.     Action  & action = (*it).second.action_;
  182.     
  183.     VDEBUG(log) << fn 
  184.           << "ntState: " << name_
  185.           << ",ttAction: " << action 
  186. << VDEBUG_END(log);
  187.     ReturnCode rc = action.action(stimulus);
  188.     
  189.     StateInterface   &   nextState = 
  190.      ( rc != SUCCESS && (*it).second.nextStateOnFail_
  191.     ? *(*it).second.nextStateOnFail_
  192.     : (*it).second.nextState_ 
  193.      );
  194.     VDEBUG(log) << fn 
  195.           << "ntState: " << name_
  196.           << ",ttNext State: " << nextState.name() 
  197. << VDEBUG_END(log);
  198.     
  199.     nextState.enter();
  200.     
  201.     return ( nextState );
  202. }
  203. void             
  204. StateInterface::exit() throw ()
  205. {
  206.     const string    fn("StateInterface::enter");
  207.     VLog         log(fn);
  208.     if ( exit_ )
  209.     {
  210.      VDEBUG(log) << fn 
  211.          << "ntState: " << name_
  212.          << ",ttAction: " << *exit_ 
  213.     << VDEBUG_END(log);
  214.     
  215.      exit_->action();
  216.     }
  217. }
  218. ostream &           
  219. StateInterface::writeTo(ostream & out) const
  220. {
  221.     out << name() 
  222.      << "ntEntry:t" << ( entry_ ? *entry_ : Action() )
  223. << "ntExit:t" << ( exit_  ? *exit_  : Action() )
  224. << "ntStimuli:nt{";
  225.     
  226.     for (   StimulusTable::const_iterator it = stimulusTable_.begin();
  227.          it != stimulusTable_.end();
  228.     it++
  229. )
  230.     {
  231.      out << "nttStimulus       :t" << (*it).first
  232.     << "nttAction         :t" << (*it).second.action_
  233.     << "nttNextState      :t" << (*it).second.nextState_.name();
  234.      if ( (*it).second.nextStateOnFail_ )
  235. {
  236.     out << "nttNextStateOnFail:t"  << (*it).second.nextStateOnFail_->name();
  237. }
  238. out << 'n';
  239.     }
  240.     
  241.     return ( out << "nt}" );
  242. }
  243. const string &
  244. StateInterface::name() const
  245. {
  246.     return ( name_ );
  247. }
  248. StateInterface::StimulusData::StimulusData(
  249.     Action        &   action,
  250.     StateInterface      &   nextState,
  251.     StateInterface      *   nextStateOnFail
  252. )   
  253.     :   action_(action),
  254.      nextState_(nextState),
  255. nextStateOnFail_(nextStateOnFail)
  256. {
  257. }