XMLPScanToken.hpp
上传用户:huihehuasu
上传日期:2007-01-10
资源大小:6948k
文件大小:7k
源码类别:

xml/soap/webservice

开发平台:

C/C++

  1. /*
  2.  * The Apache Software License, Version 1.1
  3.  * 
  4.  * Copyright (c) 1999-2000 The Apache Software Foundation.  All rights
  5.  * reserved.
  6.  * 
  7.  * Redistribution and use in source and binary forms, with or without
  8.  * modification, are permitted provided that the following conditions
  9.  * are met:
  10.  * 
  11.  * 1. Redistributions of source code must retain the above copyright
  12.  *    notice, this list of conditions and the following disclaimer. 
  13.  * 
  14.  * 2. Redistributions in binary form must reproduce the above copyright
  15.  *    notice, this list of conditions and the following disclaimer in
  16.  *    the documentation and/or other materials provided with the
  17.  *    distribution.
  18.  * 
  19.  * 3. The end-user documentation included with the redistribution,
  20.  *    if any, must include the following acknowledgment:  
  21.  *       "This product includes software developed by the
  22.  *        Apache Software Foundation (http://www.apache.org/)."
  23.  *    Alternately, this acknowledgment may appear in the software itself,
  24.  *    if and wherever such third-party acknowledgments normally appear.
  25.  * 
  26.  * 4. The names "Xerces" and "Apache Software Foundation" must
  27.  *    not be used to endorse or promote products derived from this
  28.  *    software without prior written permission. For written 
  29.  *    permission, please contact apache@apache.org.
  30.  * 
  31.  * 5. Products derived from this software may not be called "Apache",
  32.  *    nor may "Apache" appear in their name, without prior written
  33.  *    permission of the Apache Software Foundation.
  34.  * 
  35.  * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
  36.  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  37.  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  38.  * DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
  39.  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  40.  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  41.  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
  42.  * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
  43.  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
  44.  * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
  45.  * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  46.  * SUCH DAMAGE.
  47.  * ====================================================================
  48.  * 
  49.  * This software consists of voluntary contributions made by many
  50.  * individuals on behalf of the Apache Software Foundation, and was
  51.  * originally based on software copyright (c) 1999, International
  52.  * Business Machines, Inc., http://www.ibm.com .  For more information
  53.  * on the Apache Software Foundation, please see
  54.  * <http://www.apache.org/>.
  55.  */
  56. /*
  57.  * $Log: XMLPScanToken.hpp,v $
  58.  * Revision 1.4  2000/02/24 20:00:23  abagchi
  59.  * Swat for removing Log from API docs
  60.  *
  61.  * Revision 1.3  2000/02/15 01:21:31  roddey
  62.  * Some initial documentation improvements. More to come...
  63.  *
  64.  * Revision 1.2  2000/02/06 07:47:48  rahulj
  65.  * Year 2K copyright swat.
  66.  *
  67.  * Revision 1.1.1.1  1999/11/09 01:08:36  twl
  68.  * Initial checkin
  69.  *
  70.  * Revision 1.2  1999/11/08 20:44:39  rahul
  71.  * Swat for adding in Product name and CVS comment log variable.
  72.  *
  73.  */
  74. #if !defined(XMLPSCANTOKEN_HPP)
  75. #define XMLPSCANTOKEN_HPP
  76. class XMLScanner;
  77. /**
  78.  *  This simple class is used as a sanity check when the scanner is used to
  79.  *  do progressive parsing. It insures that things are not done out of
  80.  *  sequence and that sequences of scan calls are made correctly to the
  81.  *  right scanner instances.
  82.  *
  83.  *  To client code, it is just a magic cookie which is obtained when a
  84.  *  progressive parse is begun, and which is passed back in on each subsequent
  85.  *  call of the progressive parse.
  86.  */
  87. class XMLPARSER_EXPORT XMLPScanToken
  88. {
  89. public :
  90.     // -----------------------------------------------------------------------
  91.     //  Constructors and Destructor
  92.     // -----------------------------------------------------------------------
  93.     /** @name Constructor */
  94.     //@{
  95.     XMLPScanToken();
  96.     XMLPScanToken(const XMLPScanToken& toCopy);
  97.     //@}
  98.     /** @name Destructor */
  99.     //@{
  100.     ~XMLPScanToken();
  101.     //@}
  102.     // -----------------------------------------------------------------------
  103.     //  Public operators
  104.     // -----------------------------------------------------------------------
  105.     XMLPScanToken& operator=(const XMLPScanToken& toCopy);
  106. protected :
  107.     // -----------------------------------------------------------------------
  108.     //  XMLScanner is our friend, can you say friend? Sure...
  109.     // -----------------------------------------------------------------------
  110.     friend class XMLScanner;
  111.     // -----------------------------------------------------------------------
  112.     //  Hidden methods for use by XMLScanner
  113.     // -----------------------------------------------------------------------
  114.     void set
  115.     (
  116.         const   XMLUInt32   scannerId
  117.         , const XMLUInt32   sequenceId
  118.     );
  119. private :
  120.     // -----------------------------------------------------------------------
  121.     //  Private data members
  122.     //
  123.     //  fScannerId
  124.     //      This field is set to the id of the scanner, to catch problems
  125.     //      where a token is gotten from one scanner and passed to another.
  126.     //      Each scanner is assigned an incrementing id.
  127.     //
  128.     //  fSequenceId
  129.     //      In order to avoid problems such as calling scanNext() without
  130.     //      a call to scanFirst() and such, this value is set when scanFirst()
  131.     //      is called and matches this token to the current sequence id of
  132.     //      the scanner.
  133.     // -----------------------------------------------------------------------
  134.     XMLUInt32   fScannerId;
  135.     XMLUInt32   fSequenceId;
  136. };
  137. // ---------------------------------------------------------------------------
  138. //  XMLPScanToken: Constructors and Operators
  139. // ---------------------------------------------------------------------------
  140. inline XMLPScanToken::XMLPScanToken() :
  141.     fScannerId(0)
  142.     , fSequenceId(0)
  143. {
  144. }
  145. inline XMLPScanToken::XMLPScanToken(const XMLPScanToken& toCopy) :
  146.     fScannerId(toCopy.fScannerId)
  147.     , fSequenceId(toCopy.fSequenceId)
  148. {
  149. }
  150. inline XMLPScanToken::~XMLPScanToken()
  151. {
  152. }
  153. // ---------------------------------------------------------------------------
  154. //  XMLPScanToken: Public operators
  155. // ---------------------------------------------------------------------------
  156. inline XMLPScanToken& XMLPScanToken::operator=(const XMLPScanToken& toCopy)
  157. {
  158.     if (this == &toCopy)
  159.         return *this;
  160.     fScannerId = toCopy.fScannerId;
  161.     fSequenceId = toCopy.fSequenceId;
  162.     return *this;
  163. }
  164. // ---------------------------------------------------------------------------
  165. //  XMLPScanToken: Hidden methods
  166. // ---------------------------------------------------------------------------
  167. inline void XMLPScanToken::set( const   XMLUInt32   scannerId
  168.                                 , const XMLUInt32   sequenceId)
  169. {
  170.     fScannerId = scannerId;
  171.     fSequenceId = sequenceId;
  172. }
  173. #endif