src/share/jaxws_classes/com/sun/xml/internal/rngom/parse/Parseable.java

Thu, 12 Oct 2017 19:44:07 +0800

author
aoqi
date
Thu, 12 Oct 2017 19:44:07 +0800
changeset 760
e530533619ec
parent 0
373ffda63c9a
permissions
-rw-r--r--

merge

aoqi@0 1 /*
aoqi@0 2 * Copyright (c) 2005, 2010, Oracle and/or its affiliates. All rights reserved.
aoqi@0 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
aoqi@0 4 *
aoqi@0 5 * This code is free software; you can redistribute it and/or modify it
aoqi@0 6 * under the terms of the GNU General Public License version 2 only, as
aoqi@0 7 * published by the Free Software Foundation. Oracle designates this
aoqi@0 8 * particular file as subject to the "Classpath" exception as provided
aoqi@0 9 * by Oracle in the LICENSE file that accompanied this code.
aoqi@0 10 *
aoqi@0 11 * This code is distributed in the hope that it will be useful, but WITHOUT
aoqi@0 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
aoqi@0 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
aoqi@0 14 * version 2 for more details (a copy is included in the LICENSE file that
aoqi@0 15 * accompanied this code).
aoqi@0 16 *
aoqi@0 17 * You should have received a copy of the GNU General Public License version
aoqi@0 18 * 2 along with this work; if not, write to the Free Software Foundation,
aoqi@0 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
aoqi@0 20 *
aoqi@0 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
aoqi@0 22 * or visit www.oracle.com if you need additional information or have any
aoqi@0 23 * questions.
aoqi@0 24 */
aoqi@0 25 /*
aoqi@0 26 * Copyright (C) 2004-2011
aoqi@0 27 *
aoqi@0 28 * Permission is hereby granted, free of charge, to any person obtaining a copy
aoqi@0 29 * of this software and associated documentation files (the "Software"), to deal
aoqi@0 30 * in the Software without restriction, including without limitation the rights
aoqi@0 31 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
aoqi@0 32 * copies of the Software, and to permit persons to whom the Software is
aoqi@0 33 * furnished to do so, subject to the following conditions:
aoqi@0 34 *
aoqi@0 35 * The above copyright notice and this permission notice shall be included in
aoqi@0 36 * all copies or substantial portions of the Software.
aoqi@0 37 *
aoqi@0 38 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
aoqi@0 39 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
aoqi@0 40 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
aoqi@0 41 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
aoqi@0 42 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
aoqi@0 43 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
aoqi@0 44 * THE SOFTWARE.
aoqi@0 45 */
aoqi@0 46 package com.sun.xml.internal.rngom.parse;
aoqi@0 47
aoqi@0 48 import com.sun.xml.internal.rngom.ast.builder.*;
aoqi@0 49 import com.sun.xml.internal.rngom.ast.om.*;
aoqi@0 50
aoqi@0 51 /**
aoqi@0 52 * An input that can be turned into a RELAX NG pattern.
aoqi@0 53 *
aoqi@0 54 * <p>
aoqi@0 55 * This is either a RELAX NG schema in the XML format, or a RELAX NG
aoqi@0 56 * schema in the compact syntax.
aoqi@0 57 */
aoqi@0 58 public interface Parseable {
aoqi@0 59 /**
aoqi@0 60 * Parses this {@link Parseable} object into a RELAX NG pattern.
aoqi@0 61 *
aoqi@0 62 * @param sb
aoqi@0 63 * The builder of the schema object model. This object
aoqi@0 64 * dictates how the actual pattern is constructed.
aoqi@0 65 *
aoqi@0 66 * @return
aoqi@0 67 * a parsed object. Always returns a non-null valid object.
aoqi@0 68 */
aoqi@0 69 <P extends ParsedPattern> P parse(SchemaBuilder<?,P,?,?,?,?> sb) throws BuildException, IllegalSchemaException;
aoqi@0 70
aoqi@0 71 /**
aoqi@0 72 * Called from {@link Include} in response to
aoqi@0 73 * {@link Include#endInclude(Parseable, String, String, Location, Annotations)}
aoqi@0 74 * to parse the included grammar.
aoqi@0 75 *
aoqi@0 76 * @param g
aoqi@0 77 * receives the events from the included grammar.
aoqi@0 78 */
aoqi@0 79 <P extends ParsedPattern> P parseInclude(String uri, SchemaBuilder<?,P,?,?,?,?> f, IncludedGrammar<P,?,?,?,?> g, String inheritedNs)
aoqi@0 80 throws BuildException, IllegalSchemaException;
aoqi@0 81
aoqi@0 82 /**
aoqi@0 83 * Called from {@link SchemaBuilder} in response to
aoqi@0 84 * {@link SchemaBuilder#makeExternalRef(Parseable, String, String, Scope, Location, Annotations)}
aoqi@0 85 * to parse the referenced grammar.
aoqi@0 86 *
aoqi@0 87 * @param f
aoqi@0 88 * receives the events from the referenced grammar.
aoqi@0 89 */
aoqi@0 90 <P extends ParsedPattern> P parseExternal(String uri, SchemaBuilder<?,P,?,?,?,?> f, Scope s, String inheritedNs)
aoqi@0 91 throws BuildException, IllegalSchemaException;
aoqi@0 92 }

mercurial