SchemaValidator.hpp
上传用户:zhuqijet
上传日期:2013-06-25
资源大小:10074k
文件大小:21k
源码类别:

词法分析

开发平台:

Visual C++

  1. /*
  2.  * The Apache Software License, Version 1.1
  3.  *
  4.  * Copyright (c) 2001-2003 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) 2001, 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: SchemaValidator.hpp,v $
  58.  * Revision 1.17  2003/05/18 14:02:08  knoaman
  59.  * Memory manager implementation: pass per instance manager.
  60.  *
  61.  * Revision 1.16  2003/05/16 21:43:21  knoaman
  62.  * Memory manager implementation: Modify constructors to pass in the memory manager.
  63.  *
  64.  * Revision 1.15  2003/05/16 03:15:51  knoaman
  65.  * Partial implementation of the configurable memory manager.
  66.  *
  67.  * Revision 1.14  2003/05/15 18:57:27  knoaman
  68.  * Partial implementation of the configurable memory manager.
  69.  *
  70.  * Revision 1.13  2003/01/20 19:04:48  knoaman
  71.  * Fix for particle derivation checking.
  72.  *
  73.  * Revision 1.12  2003/01/13 20:16:51  knoaman
  74.  * [Bug 16024] SchemaSymbols.hpp conflicts C++ Builder 6 dir.h
  75.  *
  76.  * Revision 1.11  2003/01/09 22:34:54  tng
  77.  * [Bug 14955] error validating parser.
  78.  *
  79.  * Revision 1.10  2002/11/07 21:57:37  tng
  80.  * Fix the following Schema Test Failures:
  81.  * 1. Typo when comparing miscFlags with FIXED
  82.  * 2. If xsi:type is specified, need to validate using that xsitype validator even if the type was any
  83.  * 3. Need to check ID/IDREFs for element value
  84.  * 4. Need to duplicate attribute id for wildcard scenario.
  85.  *
  86.  * Revision 1.9  2002/11/04 14:49:42  tng
  87.  * C++ Namespace Support.
  88.  *
  89.  * Revision 1.8  2002/09/04 18:17:41  tng
  90.  * Do not set IDREF to used during prevalidation.
  91.  *
  92.  * Revision 1.7  2002/07/11 18:55:45  knoaman
  93.  * Add a flag to the preContentValidation method to indicate whether to validate
  94.  * default/fixed attributes or not.
  95.  *
  96.  * Revision 1.6  2002/06/17 18:09:29  tng
  97.  * DOM L3: support "datatype-normalization"
  98.  *
  99.  * Revision 1.5  2002/05/22 20:54:14  knoaman
  100.  * Prepare for DOM L3 :
  101.  * - Make use of the XMLEntityHandler/XMLErrorReporter interfaces, instead of using
  102.  * EntityHandler/ErrorHandler directly.
  103.  * - Add 'AbstractDOMParser' class to provide common functionality for XercesDOMParser
  104.  * and DOMBuilder.
  105.  *
  106.  * Revision 1.4  2002/04/19 13:33:23  knoaman
  107.  * Fix for bug 8236.
  108.  *
  109.  * Revision 1.3  2002/04/01 15:47:06  knoaman
  110.  * Move Element Consistency checking (ref to global declarations) to SchemaValidator.
  111.  *
  112.  * Revision 1.2  2002/03/25 20:25:32  knoaman
  113.  * Move particle derivation checking from TraverseSchema to SchemaValidator.
  114.  *
  115.  * Revision 1.1.1.1  2002/02/01 22:22:47  peiyongz
  116.  * sane_include
  117.  *
  118.  * Revision 1.8  2001/11/13 13:25:08  tng
  119.  * Deprecate function XMLValidator::checkRootElement.
  120.  *
  121.  * Revision 1.7  2001/06/05 16:51:21  knoaman
  122.  * Add 'const' to getGrammar - submitted by Peter A. Volchek.
  123.  *
  124.  * Revision 1.6  2001/05/11 15:17:48  tng
  125.  * Schema: Nillable fixes.
  126.  *
  127.  * Revision 1.5  2001/05/11 13:27:37  tng
  128.  * Copyright update.
  129.  *
  130.  * Revision 1.4  2001/05/03 20:34:45  tng
  131.  * Schema: SchemaValidator update
  132.  *
  133.  * Revision 1.3  2001/04/19 18:17:40  tng
  134.  * Schema: SchemaValidator update, and use QName in Content Model
  135.  *
  136.  * Revision 1.2  2001/03/30 16:35:20  tng
  137.  * Schema: Whitespace normalization.
  138.  *
  139.  * Revision 1.1  2001/03/21 21:56:33  tng
  140.  * Schema: Add Schema Grammar, Schema Validator, and split the DTDValidator into DTDValidator, DTDScanner, and DTDGrammar.
  141.  *
  142.  */
  143. #if !defined(SCHEMAVALIDATOR_HPP)
  144. #define SCHEMAVALIDATOR_HPP
  145. #include <xercesc/framework/XMLValidator.hpp>
  146. #include <xercesc/framework/XMLBuffer.hpp>
  147. #include <xercesc/util/ValueStackOf.hpp>
  148. #include <xercesc/validators/common/ContentSpecNode.hpp>
  149. #include <xercesc/validators/schema/SchemaGrammar.hpp>
  150. #include <xercesc/validators/schema/XSDErrorReporter.hpp>
  151. XERCES_CPP_NAMESPACE_BEGIN
  152. class GrammarResolver;
  153. class DatatypeValidator;
  154. class SchemaElementDecl;
  155. //
  156. //  This is a derivative of the abstract validator interface. This class
  157. //  implements a validator that supports standard XML Schema semantics.
  158. //  This class handles scanning the of the schema, and provides
  159. //  the standard validation services against the Schema info it found.
  160. //
  161. class VALIDATORS_EXPORT SchemaValidator : public XMLValidator
  162. {
  163. public:
  164.     // -----------------------------------------------------------------------
  165.     //  Constructors and Destructor
  166.     // -----------------------------------------------------------------------
  167.     SchemaValidator
  168.     (
  169.           XMLErrorReporter* const errReporter = 0
  170.           , MemoryManager* const  manager = XMLPlatformUtils::fgMemoryManager
  171.     );
  172.     virtual ~SchemaValidator();
  173.     // -----------------------------------------------------------------------
  174.     //  Implementation of the XMLValidator interface
  175.     // -----------------------------------------------------------------------
  176.     virtual int checkContent
  177.     (
  178.         XMLElementDecl* const   elemDecl
  179.         , QName** const         children
  180.         , const unsigned int    childCount
  181.     );
  182.     virtual void faultInAttr
  183.     (
  184.                 XMLAttr&    toFill
  185.         , const XMLAttDef&  attDef
  186.     )   const;
  187.     virtual void preContentValidation(bool reuseGrammar,
  188.                                       bool validateDefAttr = false);
  189.     virtual void postParseValidation();
  190.     virtual void reset();
  191.     virtual bool requiresNamespaces() const;
  192.     virtual void validateAttrValue
  193.     (
  194.         const   XMLAttDef*                  attDef
  195.         , const XMLCh* const                attrValue
  196.         , bool                              preValidation = false
  197.         , const XMLElementDecl*             elemDecl = 0
  198.     );
  199.     virtual void validateElement
  200.     (
  201.         const   XMLElementDecl*             elemDef
  202.     );
  203.     virtual Grammar* getGrammar() const;
  204.     virtual void setGrammar(Grammar* aGrammar);
  205.     // -----------------------------------------------------------------------
  206.     //  Virtual DTD handler interface.
  207.     // -----------------------------------------------------------------------
  208.     virtual bool handlesDTD() const;
  209.     // -----------------------------------------------------------------------
  210.     //  Virtual Schema handler interface. handlesSchema() always return false.
  211.     // -----------------------------------------------------------------------
  212.     virtual bool handlesSchema() const;
  213.     // -----------------------------------------------------------------------
  214.     //  Schema Validator methods
  215.     // -----------------------------------------------------------------------
  216.     void normalizeWhiteSpace(DatatypeValidator* dV, const XMLCh* const value, XMLBuffer& toFill);
  217.     // -----------------------------------------------------------------------
  218.     //  Setter methods
  219.     // -----------------------------------------------------------------------
  220.     void setGrammarResolver(GrammarResolver* grammarResolver);
  221.     void setXsiType(const XMLCh* const        prefix
  222.       , const XMLCh* const        localPart
  223.        , const unsigned int        uriId);
  224.     void setNillable(bool isNil);
  225.     void setErrorReporter(XMLErrorReporter* const errorReporter);
  226.     void setExitOnFirstFatal(const bool newValue);
  227.     void setDatatypeBuffer(const XMLCh* const value);
  228.     // -----------------------------------------------------------------------
  229.     //  Getter methods
  230.     // -----------------------------------------------------------------------
  231.     ComplexTypeInfo* getCurrentTypeInfo() const;
  232. private:
  233.     // -----------------------------------------------------------------------
  234.     //  Element Consitency Checking methods
  235.     // -----------------------------------------------------------------------
  236.     void checkRefElementConsistency(SchemaGrammar* const currentGrammar,
  237.                                     const ComplexTypeInfo* const curTypeInfo,
  238.                                     const XercesGroupInfo* const curGroup = 0);
  239.     // -----------------------------------------------------------------------
  240.     //  Particle Derivation Checking methods
  241.     // -----------------------------------------------------------------------
  242.     void checkParticleDerivation(SchemaGrammar* const currentGrammar,
  243.                                  const ComplexTypeInfo* const typeInfo);
  244.     void checkParticleDerivationOk(SchemaGrammar* const currentGrammar,
  245.                                    ContentSpecNode* const curNode,
  246.                                    const int derivedScope,
  247.                                    ContentSpecNode* const baseNode,
  248.                                    const int baseScope,
  249.                                    const ComplexTypeInfo* const baseInfo = 0,
  250.                                    const bool toCheckOccurrence = true);
  251.     ContentSpecNode* checkForPointlessOccurrences(ContentSpecNode* const specNode,
  252.                                                   const ContentSpecNode::NodeTypes nodeType,
  253.                                                   ValueVectorOf<ContentSpecNode*>* const nodes);
  254.     void gatherChildren(const ContentSpecNode::NodeTypes parentNodeType,
  255.                         ContentSpecNode* const specNode,
  256.                         ValueVectorOf<ContentSpecNode*>* const nodes);
  257.     bool isOccurrenceRangeOK(const int min1, const int max1, const int min2, const int max2);
  258.     void checkNSCompat(const ContentSpecNode* const derivedSpecNode,
  259.                        const ContentSpecNode* const baseSpecNode,
  260.                        const bool toCheckOccurence);
  261.     bool wildcardEltAllowsNamespace(const ContentSpecNode* const baseSpecNode,
  262.                                     const unsigned int derivedURI);
  263.     void checkNameAndTypeOK(SchemaGrammar* const currentGrammar,
  264.                             const ContentSpecNode* const derivedSpecNode,
  265.                             const int derivedScope,
  266.                             const ContentSpecNode* const baseSpecNode,
  267.                             const int baseScope,
  268.                             const ComplexTypeInfo* const baseInfo = 0);
  269.     SchemaElementDecl* findElement(const int scope,
  270.                                    const unsigned int uriIndex,
  271.                                    const XMLCh* const name,
  272.                                    SchemaGrammar* const grammar,
  273.                                    const ComplexTypeInfo* const typeInfo = 0);
  274.     void checkICRestriction(const SchemaElementDecl* const derivedElemDecl,
  275.                             const SchemaElementDecl* const baseElemDecl,
  276.                             const XMLCh* const derivedElemName,
  277.                             const XMLCh* const baseElemName);
  278.     void checkTypesOK(const SchemaElementDecl* const derivedElemDecl,
  279.                       const SchemaElementDecl* const baseElemDecl,
  280.                       const XMLCh* const derivedElemName);
  281.     void checkRecurseAsIfGroup(SchemaGrammar* const currentGrammar,
  282.                                ContentSpecNode* const derivedSpecNode,
  283.                                const int derivedScope,
  284.                                const ContentSpecNode* const baseSpecNode,
  285.                                const int baseScope,
  286.                                ValueVectorOf<ContentSpecNode*>* const nodes,
  287.                                const ComplexTypeInfo* const baseInfo);
  288.     void checkRecurse(SchemaGrammar* const currentGrammar,
  289.                       const ContentSpecNode* const derivedSpecNode,
  290.                       const int derivedScope,
  291.                       ValueVectorOf<ContentSpecNode*>* const derivedNodes,
  292.                       const ContentSpecNode* const baseSpecNode,
  293.                       const int baseScope,
  294.                       ValueVectorOf<ContentSpecNode*>* const baseNodes,
  295.                       const ComplexTypeInfo* const baseInfo,
  296.                       const bool toLax = false);
  297.     void checkNSSubset(const ContentSpecNode* const derivedSpecNode,
  298.                        const ContentSpecNode* const baseSpecNode);
  299.     bool isWildCardEltSubset(const ContentSpecNode* const derivedSpecNode,
  300.                              const ContentSpecNode* const baseSpecNode);
  301.     void checkNSRecurseCheckCardinality(SchemaGrammar* const currentGrammar,
  302.                                         const ContentSpecNode* const derivedSpecNode,
  303.                                         ValueVectorOf<ContentSpecNode*>* const derivedNodes,
  304.                                         const int derivedScope,
  305.                                         ContentSpecNode* const baseSpecNode,
  306.                                         const bool toCheckOccurence);
  307.     void checkRecurseUnordered(SchemaGrammar* const currentGrammar,
  308.                                const ContentSpecNode* const derivedSpecNode,
  309.                                ValueVectorOf<ContentSpecNode*>* const derivedNodes,
  310.                                const int derivedScope,
  311.                                ContentSpecNode* const baseSpecNode,
  312.                                ValueVectorOf<ContentSpecNode*>* const baseNodes,
  313.                                const int baseScope,
  314.                                const ComplexTypeInfo* const baseInfo);
  315.     void checkMapAndSum(SchemaGrammar* const currentGrammar,
  316.                         const ContentSpecNode* const derivedSpecNode,
  317.                         ValueVectorOf<ContentSpecNode*>* const derivedNodes,
  318.                         const int derivedScope,
  319.                         ContentSpecNode* const baseSpecNode,
  320.                         ValueVectorOf<ContentSpecNode*>* const baseNodes,
  321.                         const int baseScope,
  322.                         const ComplexTypeInfo* const baseInfo);
  323.     // -----------------------------------------------------------------------
  324.     //  Private data members
  325.     //
  326.     // -----------------------------------------------------------------------
  327.     //  The following comes from or set by the Scanner
  328.     //  fSchemaGrammar
  329.     //      The current schema grammar used by the validator
  330.     //
  331.     //  fGrammarResolver
  332.     //      All the schema grammar stored
  333.     //
  334.     //  fXsiType
  335.     //      Store the Schema Type Attribute Value if schema type is specified
  336.     //
  337.     //  fNil
  338.     //      Indicates if Nillable has been set
  339.     // -----------------------------------------------------------------------
  340.     //  The following used internally in the validator
  341.     //
  342.     //  fXsiTypeValidator
  343.     //      The validator used for xsi type validation
  344.     //
  345.     //  fDatatypeBuffer
  346.     //      Buffer for simple type element string content
  347.     //
  348.     //  fTrailing
  349.     //      Previous chunk had a trailing space
  350.     //
  351.     //  fSeenId
  352.     //      Indicate if an attribute of ID type has been seen already, reset per element.
  353.     //
  354.     //  fSchemaErrorReporter
  355.     //      Report schema process errors
  356.     //
  357.     //  fTypeStack
  358.     //      Stack of complex type declarations.
  359.     // -----------------------------------------------------------------------
  360.     MemoryManager*                  fMemoryManager;
  361.     SchemaGrammar*                  fSchemaGrammar;
  362.     GrammarResolver*                fGrammarResolver;
  363.     QName*                          fXsiType;
  364.     bool                            fNil;
  365.     DatatypeValidator*              fXsiTypeValidator;
  366.     XMLBuffer                       fDatatypeBuffer;
  367.     bool                            fTrailing;
  368.     bool                            fSeenId;
  369.     XSDErrorReporter                fSchemaErrorReporter;
  370.     ValueStackOf<ComplexTypeInfo*>* fTypeStack;
  371. };
  372. // ---------------------------------------------------------------------------
  373. //  SchemaValidator: Setter methods
  374. // ---------------------------------------------------------------------------
  375. inline void SchemaValidator::setGrammarResolver(GrammarResolver* grammarResolver) {
  376.     fGrammarResolver = grammarResolver;
  377. }
  378. inline void SchemaValidator::setXsiType(const XMLCh* const        prefix
  379.       , const XMLCh* const        localPart
  380.        , const unsigned int        uriId)
  381. {
  382.     delete fXsiType;
  383.     fXsiType = new (fMemoryManager) QName(prefix, localPart, uriId, fMemoryManager);
  384. }
  385. inline void SchemaValidator::setNillable(bool isNil) {
  386.     fNil = isNil;
  387. }
  388. inline void SchemaValidator::setExitOnFirstFatal(const bool newValue) {
  389.     fSchemaErrorReporter.setExitOnFirstFatal(newValue);
  390. }
  391. inline void SchemaValidator::setDatatypeBuffer(const XMLCh* const value)
  392. {
  393.     fDatatypeBuffer.append(value);
  394. }
  395. // ---------------------------------------------------------------------------
  396. //  SchemaValidator: Getter methods
  397. // ---------------------------------------------------------------------------
  398. inline ComplexTypeInfo* SchemaValidator::getCurrentTypeInfo() const {
  399.     if (fTypeStack->empty())
  400.         return 0;
  401.     return fTypeStack->peek();
  402. }
  403. // ---------------------------------------------------------------------------
  404. //  Virtual interface
  405. // ---------------------------------------------------------------------------
  406. inline Grammar* SchemaValidator::getGrammar() const {
  407.     return fSchemaGrammar;
  408. }
  409. inline void SchemaValidator::setGrammar(Grammar* aGrammar) {
  410.     fSchemaGrammar = (SchemaGrammar*) aGrammar;
  411. }
  412. inline void SchemaValidator::setErrorReporter(XMLErrorReporter* const errorReporter) {
  413.     XMLValidator::setErrorReporter(errorReporter);
  414.     fSchemaErrorReporter.setErrorReporter(errorReporter);
  415. }
  416. // ---------------------------------------------------------------------------
  417. //  SchemaValidator: DTD handler interface
  418. // ---------------------------------------------------------------------------
  419. inline bool SchemaValidator::handlesDTD() const
  420. {
  421.     // No DTD scanning
  422.     return false;
  423. }
  424. // ---------------------------------------------------------------------------
  425. //  SchemaValidator: Schema handler interface
  426. // ---------------------------------------------------------------------------
  427. inline bool SchemaValidator::handlesSchema() const
  428. {
  429.     return true;
  430. }
  431. // ---------------------------------------------------------------------------
  432. //  SchemaValidator: Particle derivation checking
  433. // ---------------------------------------------------------------------------
  434. inline bool
  435. SchemaValidator::isOccurrenceRangeOK(const int min1, const int max1,
  436.                                      const int min2, const int max2) {
  437.     if (min1 >= min2 &&
  438.         (max2 == SchemaSymbols::XSD_UNBOUNDED ||
  439.          (max1 != SchemaSymbols::XSD_UNBOUNDED && max1 <= max2))) {
  440.         return true;
  441.     }
  442.     return false;
  443. }
  444. XERCES_CPP_NAMESPACE_END
  445. #endif