|
|
Java example source code file (SchemaBuilder.java)
This example Java source code file (SchemaBuilder.java) is included in the alvinalexander.com
"Java Source Code
Warehouse" project. The intent of this project is to help you "Learn
Java by Example" TM.
Learn more about this Java project at its project page.
The SchemaBuilder.java Java example source code
/*
* Copyright (c) 2005, 2010, 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.
*/
/*
* Copyright (C) 2004-2011
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*/
package com.sun.xml.internal.rngom.ast.builder;
import com.sun.xml.internal.rngom.ast.om.Location;
import com.sun.xml.internal.rngom.ast.om.ParsedElementAnnotation;
import com.sun.xml.internal.rngom.ast.om.ParsedNameClass;
import com.sun.xml.internal.rngom.ast.om.ParsedPattern;
import com.sun.xml.internal.rngom.parse.*;
import com.sun.xml.internal.rngom.parse.IllegalSchemaException;
import com.sun.xml.internal.rngom.parse.Parseable;
import java.util.List;
// TODO: define combine error check should be done by the parser.
public interface SchemaBuilder<
N extends ParsedNameClass,
P extends ParsedPattern,
E extends ParsedElementAnnotation,
L extends Location,
A extends Annotations<E,L,CL>,
CL extends CommentList<L>> {
/**
* Returns the {@link NameClassBuilder}, which is used to build name
* classes for this {@link SchemaBuilder}. The
* {@link com.sun.xml.internal.rngom.nc.NameClass}es that are built will then be
* fed into this {@link SchemaBuilder}to further build RELAX NG patterns.
*
* @return always return a non-null valid object. This method can (and
* probably should) always return the same object.
*/
NameClassBuilder<N,E,L,A,CL> getNameClassBuilder() throws BuildException;
P makeChoice(List<P> patterns, L loc, A anno) throws BuildException;
P makeInterleave(List<P> patterns, L loc, A anno) throws BuildException;
P makeGroup(List<P> patterns, L loc, A anno) throws BuildException;
P makeOneOrMore(P p, L loc, A anno) throws BuildException;
P makeZeroOrMore(P p, L loc, A anno) throws BuildException;
P makeOptional(P p, L loc, A anno) throws BuildException;
P makeList(P p, L loc, A anno) throws BuildException;
P makeMixed(P p, L loc, A anno) throws BuildException;
P makeEmpty(L loc, A anno);
P makeNotAllowed(L loc, A anno);
P makeText(L loc, A anno);
P makeAttribute(N nc, P p, L loc, A anno) throws BuildException;
P makeElement(N nc, P p, L loc, A anno) throws BuildException;
DataPatternBuilder makeDataPatternBuilder(String datatypeLibrary, String type, L loc) throws BuildException;
P makeValue(String datatypeLibrary, String type, String value,
Context c, String ns, L loc, A anno) throws BuildException;
/**
*
* @param parent
* The parent scope. null if there's no parent scope.
* For example, if the complete document looks like the following:
* <pre><![CDATA[
* <grammar>
* <start><element name="root"><empty/></element></start>
* </grammar>
* </xmp></pre>
* Then when the outer-most {@link Grammar} is created, it will
* receive the <tt>null</tt> parent.
*/
Grammar<P,E,L,A,CL> makeGrammar(Scope<P,E,L,A,CL> parent);
/**
* Called when annotation is found right inside a pattern
*
* such as,
*
* <pre><xmp>
* <element name="foo"> <!-- this becomes 'P' -->
* <foreign:annotation /> <!-- this becomes 'A' -->
* ...
* </element>
* </xmp></pre>
*/
P annotate(P p, A anno) throws BuildException;
/**
* Called when element annotation is found after a pattern.
*
* such as,
*
* <pre><xmp>
* <element name="foo">
* <empty /> <!-- this becomes 'P' -->
* <foreign:annotation /> <!-- this becomes 'E' -->
* </element>
* </xmp></pre>
*/
P annotateAfter(P p, E e) throws BuildException;
P commentAfter(P p, CL comments) throws BuildException;
/**
*
* @param current
* Current grammar that we are parsing. This is what contains
* externalRef.
* @param scope
* The parent scope. null if there's no parent scope.
* See {@link #makeGrammar(Scope)} for more details about
* when this parameter can be null.
*/
P makeExternalRef(Parseable current, String uri, String ns, Scope<P,E,L,A,CL> scope,
L loc, A anno) throws BuildException, IllegalSchemaException;
L makeLocation(String systemId, int lineNumber, int columnNumber);
/**
* Creates {@link Annotations} object to parse annotations on patterns.
*
* @return
* must be non-null.
*/
A makeAnnotations(CL comments, Context context);
ElementAnnotationBuilder<P,E,L,A,CL> makeElementAnnotationBuilder(String ns,
String localName, String prefix, L loc, CL comments,
Context context);
CL makeCommentList();
P makeErrorPattern();
/**
* If this {@link SchemaBuilder}is interested in actually parsing
* comments, this method returns true.
* <p>
* Returning false allows the schema parser to speed up the processing by
* skiping comment-related handlings.
*/
boolean usesComments();
/**
* Called after all the parsing is done.
*
* <p>
* This hook typically allows as {@link SchemaBuilder} to expand
* notAllowed (if it's following the simplification as in the spec.)
*/
P expandPattern( P p ) throws BuildException, IllegalSchemaException;
}
</pre>
<div id="after_source_code">
<h2>Other Java examples (source code examples)</h2>
<p>Here is a short list of links related to this Java SchemaBuilder.java source code file:</p>
<ul>
<li><a href="/java/jwarehouse"><img src="/images/scw/find.png" border="0"> The search page</a></li>
<li><a href="index.shtml"><img src="/images/scw/folder.png" border="0"> Other Java source code examples at this package level</a></li>
<li><a href="/java/jwarehouse/about.shtml"><img src="/images/scw/information.png" border="0"> Click here to learn more about this project</a></li>
</ul>
</div>
</td>
</tr>
</table>
</div>
</div>
<div style="padding-top: 1em; width: 310px; margin-left: auto; margin-right: auto; table {border-collapse: collapse; border: none;}; tr {border-collapse: collapse; border: none; text-align: center;};">
<table width="100%" cellspacing="0" cellpadding="0">
<tr>
<td colspan="2" style="border-collapse: collapse; border: none; text-align: center;};">
<em>... this post is sponsored by my books ...</em>
</td>
</tr>
<tr>
<td width="150" style="border-collapse: collapse; border: none; text-align: center;};">
<a href="https://kbhr.co/ckbk-v2"><img
src="/images/books/scala-cookbook-v2-cover-220h.jpg"
title="The Scala Cookbook, by Alvin Alexander" height="220" />
<br /><span style="opacity: 0.4;">#1 New Release!</span></a>
</td>
<td width="150" style="border-collapse: collapse; border: none; text-align: center; padding-left: 8px;">
<a href="http://kbhr.co/fps-book"><img
src="/images/books/functional-programming-simplified-small.jpg"
title="Functional Programming, Simplified, by Alvin Alexander"
height="220" />
<br /><span style="opacity: 0.4;">FP Best Seller</span></a>
</td>
</tr>
</table>
<p> </p>
</div>
<div id="whats_new">
<h2>new blog posts</h2>
<div id="whats_new_list">
<ul>
<li><a class="whats_new_link" href="/scala/scala-cli-compiling-running-scala-3-code-watching">Scala CLI (Compiling and Running Code)</a></li>
<li><a class="whats_new_link" href="/personal/ezoic-ads-vs-google-adsense-2024">Ezoic ads vs Google AdSense (2024, website advertising revenue/partner)</a></li>
<li><a class="whats_new_link" href="/misc/when-in-present-moment-some-questions-dont-make-sense">If you'''re truly living in the present moment, some questions don'''t make sense</a></li>
<br/>
<li><a class="whats_new_link" href="/misc/how-give-up-attachments-addiction-bhagavad-gita-true-self">Mindfulness/Meditation: How to give up attachment and addiction (from the Bhagavad Gita)</a></li>
<li><a class="whats_new_link" href="/misc/dream-vacation-for-meditator-meditation">A dream vacation for the meditator in your life</a></li>
<li><a class="whats_new_link" href="/scala/zio-zlayer-very-simple-example-dependency-injection-services">ZIO ZLayer: A simple '''Hello, world''' example (dependency injection, services)</a></li>
<br/>
<li><a class="whats_new_link" href="/misc/trying-find-way-love-everyone-in-world-dont-like-dark-night-soul">Trying to find a way to love everyone in a world ...</a></li>
<li><a class="whats_new_link" href="/scala/ammonite-repl-how-import-managed-dependencies-jar-files-syntax">Ammonite REPL: How to import managed dependencies (and JAR files, too)</a></li>
<li><a class="whats_new_link" href="/source-code/scala-how-use-zio-2-in-ammonite-repl">How to use ZIO 2 in the Ammonite REPL</a></li>
<br/>
<br/>
</div>
</ul>
</div>
<p> </p>
<p align="center"><font color="#000000" size="2"
face="Verdana,Arial">Copyright 1998-2021 Alvin Alexander, alvinalexander.com<br/>
All Rights Reserved.<br/>
<br/>
A percentage of advertising revenue from<br/>
pages under the <a href="/java/jwarehouse">/java/jwarehouse</a>
URI on this website is<br/>
paid back to open source projects.</p>
<script>
shuffle(books);
var div = document.getElementById("leftcol");
var pre = '<div style="margin: 0; padding-right: 1.6em"><h2 align="center">favorite books</h2>';
var post = '</div>';
if (adblock) {
var str = books.slice(0,3).join(" ");
div.insertAdjacentHTML('beforeend', pre + str + post);
} else {
var str = books.slice(0,1).join(" ");
div.insertAdjacentHTML('beforeend', pre + str + post);
}
</script>
<p style="padding-bottom: 80px;"> </p>
</body>
]]> |
