org.apache.xerces.xni.grammars.XMLSchemaDescription Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of xercesImpl Show documentation
Show all versions of xercesImpl Show documentation
Xerces2 is the next generation of high performance, fully compliant XML parsers in the Apache Xerces family.
This new version of Xerces introduces the Xerces Native Interface (XNI), a complete framework for building
parser components and configurations that is extremely modular and easy to program. The Apache Xerces2 parser is
the reference implementation of XNI but other parser components, configurations, and parsers can be written
using the Xerces Native Interface. For complete design and implementation documents, refer to the XNI Manual.
Xerces2 is a fully conforming XML Schema 1.0 processor. A partial experimental implementation of the XML Schema
1.1 Structures and Datatypes Working Drafts (December 2009) and an experimental implementation of the XML Schema
Definition Language (XSD): Component Designators (SCD) Candidate Recommendation (January 2010) are provided for
evaluation. For more information, refer to the XML Schema page. Xerces2 also provides a complete implementation
of the Document Object Model Level 3 Core and Load/Save W3C Recommendations and provides a complete
implementation of the XML Inclusions (XInclude) W3C Recommendation. It also provides support for OASIS XML
Catalogs v1.1. Xerces2 is able to parse documents written according to the XML 1.1 Recommendation, except that
it does not yet provide an option to enable normalization checking as described in section 2.13 of this
specification. It also handles namespaces according to the XML Namespaces 1.1 Recommendation, and will correctly
serialize XML 1.1 documents if the DOM level 3 load/save APIs are in use.
The newest version!
/*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership.
* The ASF licenses this file to You under the Apache License, Version 2.0
* (the "License"); you may not use this file except in compliance with
* the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apache.xerces.xni.grammars;
import org.apache.xerces.xni.QName;
import org.apache.xerces.xni.XMLAttributes;
/**
* All information specific to XML Schema grammars.
*
* @author Sandy Gao, IBM
*
* @version $Id: XMLSchemaDescription.java 570134 2007-08-27 14:14:28Z mrglavas $
*/
public interface XMLSchemaDescription extends XMLGrammarDescription {
// used to indicate what triggered the call
/**
* Indicate that the current schema document is <include>d by another
* schema document.
*/
public final static short CONTEXT_INCLUDE = 0;
/**
* Indicate that the current schema document is <redefine>d by another
* schema document.
*/
public final static short CONTEXT_REDEFINE = 1;
/**
* Indicate that the current schema document is <import>ed by another
* schema document.
*/
public final static short CONTEXT_IMPORT = 2;
/**
* Indicate that the current schema document is being preparsed.
*/
public final static short CONTEXT_PREPARSE = 3;
/**
* Indicate that the parse of the current schema document is triggered
* by xsi:schemaLocation/noNamespaceSchemaLocation attribute(s) in the
* instance document. This value is only used if we don't defer the loading
* of schema documents.
*/
public final static short CONTEXT_INSTANCE = 4;
/**
* Indicate that the parse of the current schema document is triggered by
* the occurrence of an element whose namespace is the target namespace
* of this schema document. This value is only used if we do defer the
* loading of schema documents until a component from that namespace is
* referenced from the instance.
*/
public final static short CONTEXT_ELEMENT = 5;
/**
* Indicate that the parse of the current schema document is triggered by
* the occurrence of an attribute whose namespace is the target namespace
* of this schema document. This value is only used if we do defer the
* loading of schema documents until a component from that namespace is
* referenced from the instance.
*/
public final static short CONTEXT_ATTRIBUTE = 6;
/**
* Indicate that the parse of the current schema document is triggered by
* the occurrence of an "xsi:type" attribute, whose value (a QName) has
* the target namespace of this schema document as its namespace.
* This value is only used if we do defer the loading of schema documents
* until a component from that namespace is referenced from the instance.
*/
public final static short CONTEXT_XSITYPE = 7;
/**
* Get the context. The returned value is one of the pre-defined
* CONTEXT_xxx constants.
*
* @return the value indicating the context
*/
public short getContextType();
/**
* If the context is "include" or "redefine", then return the target
* namespace of the enclosing schema document; otherwise, the expected
* target namespace of this document.
*
* @return the expected/enclosing target namespace
*/
public String getTargetNamespace();
/**
* For import and references from the instance document, it's possible to
* have multiple hints for one namespace. So this method returns an array,
* which contains all location hints.
*
* @return an array of all location hints associated to the expected
* target namespace
*/
public String[] getLocationHints();
/**
* If a call is triggered by an element/attribute/xsi:type in the instance,
* this call returns the name of such triggering component: the name of
* the element/attribute, or the value of the xsi:type.
*
* @return the name of the triggering component
*/
public QName getTriggeringComponent();
/**
* If a call is triggered by an attribute or xsi:type, then this method
* returns the enclosing element of such element.
*
* @return the name of the enclosing element
*/
public QName getEnclosingElementName();
/**
* If a call is triggered by an element/attribute/xsi:type in the instance,
* this call returns all attributes of such an element (or enclosing element).
*
* @return all attributes of the triggering/enclosing element
*/
public XMLAttributes getAttributes();
} // XSDDescription