/*
* Copyright (c) 1997, 2015, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package com.sun.xml.internal.xsom.parser;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.Reader;
import java.net.URL;
import java.util.Set;
import java.util.HashSet;
import javax.xml.parsers.SAXParserFactory;
import org.xml.sax.ContentHandler;
import org.xml.sax.EntityResolver;
import org.xml.sax.ErrorHandler;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import com.sun.xml.internal.xsom.XSSchemaSet;
import com.sun.xml.internal.xsom.impl.parser.NGCCRuntimeEx;
import com.sun.xml.internal.xsom.impl.parser.ParserContext;
import com.sun.xml.internal.xsom.impl.parser.state.Schema;
/**
* Parses possibly multiple W3C XML Schema files and compose
* them into one grammar.
*
* @author
* Kohsuke Kawaguchi (kohsuke.kawaguchi@sun.com)
*/
public final class XSOMParser {
private EntityResolver entityResolver;
private ErrorHandler userErrorHandler;
private AnnotationParserFactory apFactory;
private final ParserContext context;
/**
* Creates a new XSOMParser by using a SAX parser from JAXP.
* @deprecated Unsafe, use XSOMParser(factory) instead with
* security features initialized by setting
* XMLConstants.FEATURE_SECURE_PROCESSING feature.
*/
public XSOMParser() {
this(new JAXPParser());
}
/**
* Creates a new XSOMParser that uses the given SAXParserFactory
* for creating new SAX parsers.
*
* The caller needs to configure
* it properly. Don't forget to call setNamespaceAware(true)
* or you'll see some strange errors.
*/
public XSOMParser( SAXParserFactory factory ) {
this( new JAXPParser(factory) );
}
/**
* Creates a new XSOMParser that reads XML Schema from non-standard
* inputs.
*
* By implementing the {@link XMLParser} interface, XML Schema
* can be read from something other than XML.
*
* @param parser
* This parser will be called to parse XML Schema documents.
*/
public XSOMParser(XMLParser parser) {
context = new ParserContext(this,parser);
}
/**
* Parses a new XML Schema document.
*
*
* When using this method, XSOM does not know the system ID of * this document, therefore, when this stream contains relative * references to other schemas, XSOM will fail to resolve them. * To specify an system ID with a stream, use {@link InputSource} */ public void parse( InputStream is ) throws SAXException { parse(new InputSource(is)); } /** * Parses a new XML Schema document. * *
* When using this method, XSOM does not know the system ID of * this document, therefore, when this reader contains relative * references to other schemas, XSOM will fail to resolve them. * To specify an system ID with a reader, use {@link InputSource} */ public void parse( Reader reader ) throws SAXException { parse(new InputSource(reader)); } /** * Parses a new XML Schema document. */ public void parse( File schema ) throws SAXException, IOException { parse(schema.toURL()); } /** * Parses a new XML Schema document. */ public void parse( URL url ) throws SAXException { parse( url.toExternalForm() ); } /** * Parses a new XML Schema document. */ public void parse( String systemId ) throws SAXException { parse(new InputSource(systemId)); } /** * Parses a new XML Schema document. * *
* Note that if the {@link InputSource} does not have a system ID, * XSOM will fail to resolve them. */ public void parse( InputSource source ) throws SAXException { context.parse(source); } /** * Gets the parser implemented as a ContentHandler. * * One can feed XML Schema as SAX events to this interface to * parse a schema. To parse multiple schema files, feed multiple * sets of events. * *
* If you don't send a complete event sequence from a startDocument * event to an endDocument event, the state of XSOMParser can become * unstable. This sometimes happen when you encounter an error while * generating SAX events. Don't call the getResult method in that case. * *
* This way of reading XML Schema can be useful when XML Schema is
* not available as a stand-alone XML document.
* For example, one can feed XML Schema inside a WSDL document.
*/
public ContentHandler getParserHandler() {
NGCCRuntimeEx runtime = context.newNGCCRuntime();
Schema s = new Schema(runtime,false,null);
runtime.setRootHandler(s);
return runtime;
}
/**
* Gets the parsed result. Don't call this method until
* you parse all the schemas.
*
* @return
* If there was any parse error, this method returns null.
* To receive error information, specify your error handler
* through the setErrorHandler method.
* @exception SAXException
* This exception will never be thrown unless it is thrown
* by an error handler.
*/
public XSSchemaSet getResult() throws SAXException {
return context.getResult();
}
/**
* Gets the set of {@link SchemaDocument} that represents
* parsed documents so far.
*
* @return
* can be empty but never null.
*/
public Set
* For each annotation, new instance of this class will be
* created and used to parse {@code
* The specified factory will be used to create AnnotationParsers.
*/
public void setAnnotationParser( AnnotationParserFactory factory ) {
this.apFactory = factory;
}
public AnnotationParserFactory getAnnotationParserFactory() {
return apFactory;
}
}