content: /*
   * 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 mf.org.apache.xerces.dom3.as;
  
  import mf.org.w3c.dom.ls.LSInput;
  import mf.org.w3c.dom.ls.LSParser;
  
  /**
   * @deprecated 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>.
   */
  @Deprecated
  public interface DOMASBuilder extends LSParser {
      /**
       * Associate an <code>ASModel</code> with a <code>LSParser</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>.
       */
      ASModel getAbstractSchema();
  
      /**
       * Associate an <code>ASModel</code> with a <code>LSParser</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>.
       */
      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.
       * @throws 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>.
       * @throws 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.
       */
      ASModel parseASURI(String uri)
              throws Exception;
  
      /**
       * Parse a Abstract Schema from a location identified by an
       * <code>LSInput</code>.
       *
       * @param is The <code>LSInput</code> from which the source
       *           Abstract Schema is to be read.
       * @return The newly created <code>ASModel</code>.
       * @throws 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>.
       * @throws 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.
       */
      ASModel parseASInputSource(LSInput is)
              throws Exception;
  
  }
  