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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
|
// HandlerBase.java: Simple base class for AElfred processors.
// NO WARRANTY! See README, and copyright below.
// $Id: HandlerBase.java 12845 2008-06-13 19:42:59Z ezust $
package com.microstar.xml;
import com.microstar.xml.XmlHandler;
import com.microstar.xml.XmlException;
import java.io.Reader;
/**
* Convenience base class for AElfred handlers.
* <p>This base class implements the XmlHandler interface with
* (mostly empty) default handlers. You are not required to use this,
* but if you need to handle only a few events, you might find
* it convenient to extend this class rather than implementing
* the entire interface. This example overrides only the
* <code>charData</code> method, using the defaults for the others:
* <pre>
* import com.microstar.xml.HandlerBase;
*
* public class MyHandler extends HandlerBase {
* public void charData (char ch[], int start, int length)
* {
* System.out.println("Data: " + new String (ch, start, length));
* }
* }
* </pre>
* <p>This class is optional, but if you use it, you must also
* include the <code>XmlException</code> class.
* <p>Do not extend this if you are using SAX; extend
* <code>org.xml.sax.HandlerBase</code> instead.
* @author Copyright (c) 1998 by Microstar Software Ltd.
* @author written by David Megginson <dmeggins@microstar.com>
* @version 1.1
* @see XmlHandler
* @see XmlException
* @see org.xml.sax.HandlerBase
* @deprecated use org.xml.sax.helpers.DefaultHandler
*/
public class HandlerBase implements XmlHandler {
/**
* Handle the start of the document.
* <p>The default implementation does nothing.
* @see com.microstar.xml.XmlHandler#startDocument
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void startDocument ()
throws java.lang.Exception
{
}
/**
* Handle the end of the document.
* <p>The default implementation does nothing.
* @see com.microstar.xml.XmlHandler#endDocument
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void endDocument ()
throws java.lang.Exception
{
}
/**
* Resolve an external entity.
* <p>The default implementation simply returns the supplied
* system identifier.
* @see com.microstar.xml.XmlHandler#resolveEntity
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public Object resolveEntity (String publicId, String systemId)
throws java.lang.Exception
{
return null;
}
/**
* Handle the start of an external entity.
* <p>The default implementation does nothing.
* @see com.microstar.xml.XmlHandler#startExternalEntity
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void startExternalEntity (String systemId)
throws java.lang.Exception
{
}
/**
* Handle the end of an external entity.
* <p>The default implementation does nothing.
* @see com.microstar.xml.XmlHandler#endExternalEntity
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void endExternalEntity (String systemId)
throws java.lang.Exception
{
}
/**
* Handle a document type declaration.
* <p>The default implementation does nothing.
* @see com.microstar.xml.XmlHandler#doctypeDecl
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void doctypeDecl (String name, String publicId, String systemId)
throws java.lang.Exception
{
}
/**
* Handle an attribute assignment.
* <p>The default implementation does nothing.
* @see com.microstar.xml.XmlHandler#attribute
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void attribute (String aname, String value, boolean isSpecified)
throws java.lang.Exception
{
}
/**
* Handle the start of an element.
* <p>The default implementation does nothing.
* @see com.microstar.xml.XmlHandler#startElement
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void startElement (String elname)
throws java.lang.Exception
{
}
/**
* Handle the end of an element.
* <p>The default implementation does nothing.
* @see com.microstar.xml.XmlHandler#endElement
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void endElement (String elname)
throws java.lang.Exception
{
}
/**
* Handle character data.
* <p>The default implementation does nothing.
* @see com.microstar.xml.XmlHandler#charData
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void charData (char ch[], int start, int length)
throws java.lang.Exception
{
}
/**
* Handle ignorable whitespace.
* <p>The default implementation does nothing.
* @see com.microstar.xml.XmlHandler#ignorableWhitespace
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void ignorableWhitespace (char ch[], int start, int length)
throws java.lang.Exception
{
}
/**
* Handle a processing instruction.
* <p>The default implementation does nothing.
* @see com.microstar.xml.XmlHandler#processingInstruction
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void processingInstruction (String target, String data)
throws java.lang.Exception
{
}
/**
* Throw an exception for a fatal error.
* <p>The default implementation throws <code>XmlException</code>.
* @see com.microstar.xml.XmlHandler#error
* @exception com.microstar.xml.XmlException A specific parsing error.
* @exception java.lang.Exception Derived methods may throw exceptions.
*/
public void error (String message, String systemId, int line, int column)
throws XmlException, java.lang.Exception
{
throw new XmlException(message, systemId, line, column);
}
}
|
