| /* |
| * Copyright (c) 2001 World Wide Web Consortium, |
| * (Massachusetts Institute of Technology, Institut National de |
| * Recherche en Informatique et en Automatique, Keio University). All |
| * Rights Reserved. This program is distributed under the W3C's Software |
| * Intellectual Property License. This program 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 W3C License http://www.w3.org/Consortium/Legal/ for more details. |
| */ |
| |
| package org.apache.xerces.dom3.as; |
| |
| import org.apache.xerces.dom3.ls.DOMInputSource; |
| import org.apache.xerces.dom3.ls.DOMBuilder; |
| |
| /** |
| * An Abstract Schema parser interface. |
| * <p><code>DOMASBuilder</code> provides an API for parsing Abstract Schemas |
| * and building the corresponding <code>ASModel</code> tree. |
| * <p>See also the <a href='http://www.w3.org/TR/2001/WD-DOM-Level-3-ASLS-20011025'>Document Object Model (DOM) Level 3 Abstract Schemas and Load |
| and Save Specification</a>. |
| */ |
| public interface DOMASBuilder extends DOMBuilder { |
| /** |
| * Associate an <code>ASModel</code> with a <code>DOMBuilder</code>. This |
| * <code>ASModel</code> will be used by the " |
| * <code>validate-if-schema</code>" and " |
| * <code>datatype-normalization</code>" options during the load of a new |
| * <code>Document</code>. |
| */ |
| public ASModel getAbstractSchema(); |
| /** |
| * Associate an <code>ASModel</code> with a <code>DOMBuilder</code>. This |
| * <code>ASModel</code> will be used by the " |
| * <code>validate-if-schema</code>" and " |
| * <code>datatype-normalization</code>" options during the load of a new |
| * <code>Document</code>. |
| */ |
| public void setAbstractSchema(ASModel abstractSchema); |
| |
| /** |
| * Parse a Abstract Schema from a location identified by an URI reference. |
| * @param uri The location of the Abstract Schema to be read. |
| * @return The newly created Abstract Schema. |
| * @exception DOMASException |
| * Exceptions raised by <code>parseASURI()</code> originate with the |
| * installed ErrorHandler, and thus depend on the implementation of |
| * the <code>DOMErrorHandler</code> interfaces. The default error |
| * handlers will raise a <code>DOMASException</code> if any form of |
| * Abstract Schema inconsistencies or warning occurs during the parse, |
| * but application defined errorHandlers are not required to do so. |
| * <br> WRONG_MIME_TYPE_ERR: Raised when <code>mimeTypeCheck</code> is |
| * <code>true</code> and the input source has an incorrect MIME Type. |
| * See the attribute <code>mimeTypeCheck</code>. |
| * @exception DOMSystemException |
| * Exceptions raised by <code>parseURI()</code> originate with the |
| * installed ErrorHandler, and thus depend on the implementation of |
| * the <code>DOMErrorHandler</code> interfaces. The default error |
| * handlers will raise a DOMSystemException if any form I/O or other |
| * system error occurs during the parse, but application defined error |
| * handlers are not required to do so. |
| */ |
| public ASModel parseASURI(String uri) |
| throws DOMASException, Exception; |
| |
| /** |
| * Parse a Abstract Schema from a location identified by an |
| * <code>DOMInputSource</code>. |
| * @param is The <code>DOMInputSource</code> from which the source |
| * Abstract Schema is to be read. |
| * @return The newly created <code>ASModel</code>. |
| * @exception DOMASException |
| * Exceptions raised by <code>parseASURI()</code> originate with the |
| * installed ErrorHandler, and thus depend on the implementation of |
| * the <code>DOMErrorHandler</code> interfaces. The default error |
| * handlers will raise a <code>DOMASException</code> if any form of |
| * Abstract Schema inconsistencies or warning occurs during the parse, |
| * but application defined errorHandlers are not required to do so. |
| * <br> Raise a WRONG_MIME_TYPE_ERR when <code>mimeTypeCheck</code> is |
| * <code>true</code> and the inputsource has an incorrect MIME Type. |
| * See attribute <code>mimeTypeCheck</code>. |
| * @exception DOMSystemException |
| * Exceptions raised by <code>parseURI()</code> originate with the |
| * installed ErrorHandler, and thus depend on the implementation of |
| * the <code>DOMErrorHandler</code> interfaces. The default error |
| * handlers will raise a DOMSystemException if any form I/O or other |
| * system error occurs during the parse, but application defined error |
| * handlers are not required to do so. |
| */ |
| public ASModel parseASInputSource(DOMInputSource is) |
| throws DOMASException, Exception; |
| |
| } |