01: /*
02: * Copyright (c) 2001 World Wide Web Consortium,
03: * (Massachusetts Institute of Technology, Institut National de
04: * Recherche en Informatique et en Automatique, Keio University). All
05: * Rights Reserved. This program is distributed under the W3C's Software
06: * Intellectual Property License. This program is distributed in the
07: * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
08: * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
09: * 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: import org.w3c.dom.ls.LSSerializer;
16:
17: /**
18: * @deprecated
19: * A Abstract Schema serialization interface.
20: * <p> DOMASWriters provides an API for serializing Abstract Schemas out in
21: * the form of a source Abstract Schema. The Abstract Schema is written to
22: * an output stream, the type of which depends on the specific language
23: * bindings in use.
24: * <p> DOMASWriter is a generic Abstract Schema serialization interface. It
25: * can be applied to both an internal Abstract Schema and/or an external
26: * Abstract Schema. DOMASWriter is applied to serialize a single Abstract
27: * Schema. Serializing a document with an active Internal Abstract Schema
28: * will serialize this internal Abstract Schema with the document as it is
29: * part of the Document (see <code>LSSerializer</code>).
30: * <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
31: and Save Specification</a>.
32: */
33: public interface DOMASWriter extends LSSerializer {
34: /**
35: * Write out the specified Abstract Schema to the specified destination.
36: * Does it write a DTD or an XML Schema (or something else)? Is it
37: * possible to use this method to convert a DTD to an XML Schema?
38: * @param destination The destination for the data to be written.
39: * @param model The Abstract Schema to serialize.
40: * @exception DOMSystemException
41: * This exception will be raised in response to any sort of IO or system
42: * error that occurs while writing to the destination. It may wrap an
43: * underlying system exception.
44: */
45: public void writeASModel(java.io.OutputStream destination,
46: ASModel model) throws Exception;
47:
48: }
|