1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
package com.jclark.xml.parse.awt;
import java.io.IOException;
import java.awt.AWTException;
import java.util.Locale;
import com.jclark.xml.parse.*;
/**
* An XML Parser.
* @see Application
* @see EntityManager
* @version $Revision: 1.1 $ $Date: 1998/05/08 06:38:56 $
*/
public interface Parser {
/**
* Sets the <code>EntityManager</code> which will be used
* to access external entities referenced in the document.
*/
void setEntityManager(EntityManager entityManager);
/**
* Sets the <code>Application</code>, which will receive information
* about the XML document.
*/
void setApplication(Application application);
/**
* Sets the locale to be used for error messages.
*/
void setLocale(Locale locale);
/**
* Parses an XML document. The current <code>EntityManager</code>,
* <code>Application</code> and <code>Locale</code> will be used
* for the entire parse. If no <code>EntityManager</code> has been
* set, a default <code>EntityManager</code> will be used.
* If no <code>Locale</code> has been set, the default <code>Locale</code>
* as returned by <code>Locale.getDefault</code> will be used.
* If no <code>Application</code> has been set, no information about
* the document will be reported, but an exception will be thrown if
* the document is not well-formed.
*
* @param entity the document entity of the XML document; the InputStream
* of the document entity will be closed after parsing
* @exception NotWellFormedException if the document is not well-formed
* @exception IOException if an IO error occurs
* @exception AWTException if a method in <code>Application</code> throws
* an <code>AWTException</code>
*/
void parseDocument(OpenEntity entity) throws IOException, AWTException;
}
|
