1 /* 2 * Copyright (c) 2001 World Wide Web Consortium, 3 * (Massachusetts Institute of Technology, Institut National de 4 * Recherche en Informatique et en Automatique, Keio University). All 5 * Rights Reserved. This program is distributed under the W3C's Software 6 * Intellectual Property License. This program is distributed in the 7 * hope that it will be useful, but WITHOUT ANY WARRANTY; without even 8 * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR 9 * PURPOSE. 10 * See W3C License http://www.w3.org/Consortium/Legal/ for more details. 11 */ 12 13 package org.apache.xerces.dom3.as; 14 15 /** 16 * @deprecated 17 * This interface allows creation of an <code>ASModel</code>. The expectation 18 * is that an instance of the <code>DOMImplementationAS</code> interface can 19 * be obtained by using binding-specific casting methods on an instance of 20 * the <code>DOMImplementation</code> interface when the DOM implementation 21 * supports the feature "<code>AS-EDIT</code>". 22 * <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 23 and Save Specification</a>. 24 */ 25 public interface DOMImplementationAS { 26 /** 27 * Creates an ASModel. 28 * @param isNamespaceAware Allow creation of <code>ASModel</code> with 29 * this attribute set to a specific value. 30 * @return A <code>null</code> return indicates failure.what is a 31 * failure? Could be a system error. 32 */ 33 public ASModel createAS(boolean isNamespaceAware); 34 35 /** 36 * Creates an <code>DOMASBuilder</code>.Do we need the method since we 37 * already have <code>DOMImplementationLS.createDOMParser</code>? 38 * @return a DOMASBuilder 39 */ 40 public DOMASBuilder createDOMASBuilder(); 41 42 /** 43 * Creates an <code>DOMASWriter</code>. 44 * @return a DOMASWriter 45 */ 46 public DOMASWriter createDOMASWriter(); 47 48 } 49