Class ElementParticle

  • All Implemented Interfaces:
    ComponentReference, UserSchemaComponent, javax.xml.transform.SourceLocator, Location, SchemaComponent, org.xml.sax.Locator

    public class ElementParticle
    extends Particle
    A reference to an element declaration within the content model of a complex type. This corresponds to an <xs:element ref="x"> element in the XML representation of a schema. Where a local element declaration appears in a content model, using the form <xs:element name="x">, both an element declaration and an element particle are created.
    • Constructor Detail

      • ElementParticle

        public ElementParticle​(EnterpriseConfiguration config,
                               javax.xml.transform.SourceLocator locator)
        Creates a new element particle
        Parameters:
        config - the Configuration to which this element declaration belongs
        locator - identifies the location of the element declaration in the source schema document
    • Method Detail

      • copy

        public ElementParticle copy()
        Copy an element particle
        Returns:
        a copy of this particle
      • getDisplayName

        public java.lang.String getDisplayName()
        Returns the display name of this Element particle. This will be in the form of a lexical QName typically using the original prefix
        Returns:
        the local name of this element declaration
      • getNamespaceURI

        public NamespaceUri getNamespaceURI()
        Get the namespace URI of this element particle
        Returns:
        the target namespace of the element. Returns "" for the no-namespace case.
      • getName

        public java.lang.String getName()
        Returns the local name of this Element particle. The name returned, if not null, will be an NCName.
        Returns:
        the name of this element declaration
      • getDeclaration

        public ElementDecl getDeclaration()
                                   throws MissingComponentException
        Returns the ElementDecl that this element definition references.
        Returns:
        the ElementDecl that this element definition references.
        Throws:
        MissingComponentException - if the reference from the element particle to the corresponding element declaration has not been resolved
      • setReference

        public void setReference​(ElementDecl declaration)
        Set the reference to a specific (typically non-global) element declaration
        Parameters:
        declaration - the element declaration to which this particle refers.
      • isEmptiable

        public boolean isEmptiable()
        Determine if this particle can be empty
        Specified by:
        isEmptiable in class Particle
        Returns:
        true if this element, considered as a particle in a content model, can be matched by empty content (which is true if the minOccurs value is zero). The result is undefined for a global element declaration.
      • isPointless

        public boolean isPointless​(ModelGroup container)
        Test whether the particle is pointless, as described in XML Schema Part 1 Schema Component Constraint: Particle Valid (Restriction)
        Specified by:
        isPointless in class Particle
        Parameters:
        container - the model group containing this particle; null if there is no containing model group
        Returns:
        true if the particle is pointless (for example, a sequence of one item)
      • lookForCycles

        public void lookForCycles​(java.util.Stack<SchemaComponent> references,
                                  SchemaCompiler compiler)
                           throws SchemaException,
                                  MissingComponentException
        Description copied from class: SchemaStructure
        This method is called to look for cycles. The object implementing this method is required (a) to raise an exception if the object itself appears in the list of references, (b) to add itself to the list of references, and (c) to call the lookForCycles method on all the objects that it references. This is a dummy implementation that does nothing; it must be overridden for components that can participate in cycles.
        Specified by:
        lookForCycles in interface UserSchemaComponent
        Overrides:
        lookForCycles in class SchemaStructure
        Parameters:
        references - A stack of objects that contain direct or indirect references to this object, and that must therefore not be referred to from this object.
        compiler - the schema compiler
        Throws:
        SchemaException - if cycles are found
        MissingComponentException
      • validate

        public boolean validate​(SchemaCompiler compiler)
                         throws SchemaException
        Check the validity (consistency) of this element definition.
        Specified by:
        validate in interface UserSchemaComponent
        Specified by:
        validate in class Particle
        Parameters:
        compiler - the schema compiler
        Returns:
        true if validation succeeded, false if errors were found.
        Throws:
        SchemaException - if an error is found and the error listener decides that the error is fatal
      • compile

        public void compile​(SchemaCompiler compiler)
                     throws SchemaException
        Compile this local element declaration, considered as a particle of some complex type, by compiling its own complex type definition.
        Specified by:
        compile in class Particle
        Parameters:
        compiler - the schema compiler
        Throws:
        SchemaException - if compilation fails.
      • getElementParticleType

        public SchemaType getElementParticleType​(int elementFingerprint)
        Find an element particle within this complex type definition having a given element name (identified by elementName), and return the schema type associated with that element particle. If there is no such particle, return null. If the elementName matches an element wildcard, return the type of the global element declaration with the given name if one exists, or AnyType if none exists and lax validation is permitted by the wildcard.
        Specified by:
        getElementParticleType in class Particle
        Parameters:
        elementFingerprint - Identifies the name of the child element within this content model
        Returns:
        the type of the element identified by the given name fingerprint. The consistency rule "Element Declarations Consistent" ensures that if there are multiple matching declarations, they have consistent types
      • containsElementWildcard

        public boolean containsElementWildcard()
        Ask whether the particle contains an element wildcard
        Specified by:
        containsElementWildcard in class Particle
        Returns:
        true if the particle is an element wildcard, or contains one
      • gatherAllPermittedElements

        public void gatherAllPermittedElements​(IntHashSet result,
                                               boolean ignoreWildcards)
                                        throws MissingComponentException
        Find the set of all element particles allowed within the content model of this particle, identified by their integer fingerprints. Ignore wildcards.
        Specified by:
        gatherAllPermittedElements in class Particle
        Parameters:
        result - an initially-empty integer set in which the results are accumulated
        ignoreWildcards - if true, wildcards are ignored. If false, the result will be a set containing the value XS_INVALID, meaning that it is not possible to enumerate
        Throws:
        MissingComponentException
      • toString

        public java.lang.String toString()
        Overrides:
        toString in class java.lang.Object