diff -r b5e266a4356c -r b80b84e87032 jaxws/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/parser/XSOMParser.java --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/jaxws/src/jdk.xml.bind/share/classes/com/sun/xml/internal/xsom/parser/XSOMParser.java Sun Aug 17 15:52:15 2014 +0100 @@ -0,0 +1,271 @@ +/* + * Copyright (c) 1997, 2013, 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 getDocuments() { + return new HashSet(context.parsedDocuments.keySet()); + } + + public EntityResolver getEntityResolver() { + return entityResolver; + } + /** + * Set an entity resolver that is used to resolve things + * like <xsd:import> and <xsd:include>. + */ + public void setEntityResolver( EntityResolver resolver ) { + this.entityResolver = resolver; + } + public ErrorHandler getErrorHandler() { + return userErrorHandler; + } + /** + * Set an error handler that receives all the errors encountered + * during the parsing. + */ + public void setErrorHandler(ErrorHandler errorHandler) { + this.userErrorHandler = errorHandler; + } + + /** + * Sets the annotation parser. + * + * Annotation parser can be used to parse application-specific + * annotations inside a schema. + * + *

+ * For each annotation, new instance of this class will be + * created and used to parse <xs:annotation>. + */ + public void setAnnotationParser( final Class annParser ) { + setAnnotationParser( new AnnotationParserFactory() { + public AnnotationParser create() { + try { + return (AnnotationParser)annParser.newInstance(); + } catch( InstantiationException e ) { + throw new InstantiationError(e.getMessage()); + } catch( IllegalAccessException e ) { + throw new IllegalAccessError(e.getMessage()); + } + } + }); + } + + /** + * Sets the annotation parser factory. + * + *

+ * The specified factory will be used to create AnnotationParsers. + */ + public void setAnnotationParser( AnnotationParserFactory factory ) { + this.apFactory = factory; + } + + public AnnotationParserFactory getAnnotationParserFactory() { + return apFactory; + } +}