PageRenderTime 139ms CodeModel.GetById 64ms app.highlight 52ms RepoModel.GetById 4ms app.codeStats 0ms

/www/tags/NOV_07_2009/htdocs/api/com/microstar/xml/XmlHandler.html

#
HTML | 606 lines | 542 code | 54 blank | 10 comment | 0 complexity | 2ca704ffe151cd0479e8985c7d798cf7 MD5 | raw file
  1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
  2<!--NewPage-->
  3<HTML>
  4<HEAD>
  5<!-- Generated by javadoc (build 1.5.0_14) on Tue Jul 22 07:13:42 GMT-08:00 2008 -->
  6<TITLE>
  7XmlHandler (jEdit API)
  8</TITLE>
  9
 10<META NAME="keywords" CONTENT="com.microstar.xml.XmlHandler interface">
 11
 12<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
 13
 14
 15<NOSCRIPT>
 16</NOSCRIPT>
 17
 18</HEAD>
 19
 20<BODY BGCOLOR="white" >
 21
 22
 23<!-- ========= START OF TOP NAVBAR ======= -->
 24<A NAME="navbar_top"><!-- --></A>
 25<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
 26<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
 27<TR>
 28<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
 29<A NAME="navbar_top_firstrow"><!-- --></A>
 30<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
 31  <TR ALIGN="center" VALIGN="top">
 32  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
 33  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
 34  <TD BGCOLOR="#00008B" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
 35  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/XmlHandler.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
 36  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
 37  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
 38  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
 39  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
 40  </TR>
 41</TABLE>
 42</TD>
 43<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
 44</EM>
 45</TD>
 46</TR>
 47
 48<TR>
 49<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 50&nbsp;<A HREF="../../../com/microstar/xml/XmlException.html" title="class in com.microstar.xml"><B>PREV CLASS</B></A>&nbsp;
 51&nbsp;<A HREF="../../../com/microstar/xml/XmlParser.html" title="class in com.microstar.xml"><B>NEXT CLASS</B></A></FONT></TD>
 52<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
 53  <A HREF="../../../index.html?com/microstar/xml/XmlHandler.html" target="_top"><B>FRAMES</B></A>  &nbsp;
 54&nbsp;<A HREF="XmlHandler.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
 55&nbsp;
 56<NOSCRIPT>
 57  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
 58</NOSCRIPT>
 59
 60
 61</FONT></TD>
 62</TR>
 63<TR>
 64<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 65  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
 66<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
 67DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
 68</TR>
 69</TABLE>
 70<A NAME="skip-navbar_top"></A>
 71<!-- ========= END OF TOP NAVBAR ========= -->
 72
 73<HR>
 74<!-- ======== START OF CLASS DATA ======== -->
 75<H2>
 76<FONT SIZE="-1">
 77com.microstar.xml</FONT>
 78<BR>
 79Interface XmlHandler</H2>
 80<DL>
 81<DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../com/microstar/xml/HandlerBase.html" title="class in com.microstar.xml">HandlerBase</A></DD>
 82</DL>
 83<HR>
 84<B>Deprecated.</B>
 85<P>
 86<DL>
 87<DT><PRE>public interface <B>XmlHandler</B></DL>
 88</PRE>
 89
 90<P>
 91XML Processing Interface.
 92 <p>Whenever you parse an XML document, you must provide an object
 93 from a class that implements this interface to receive the parsing 
 94 events.
 95 <p>If you do not want to implement this entire interface, you
 96 can extend the <code>HandlerBase</code> convenience class and
 97 then implement only what you need.
 98 <p>If you are using SAX, you should implement the SAX handler
 99 interfaces rather than this one.
100<P>
101
102<P>
103<DL>
104<DT><B>See Also:</B><DD><A HREF="../../../com/microstar/xml/XmlParser.html" title="class in com.microstar.xml"><CODE>XmlParser</CODE></A>, 
105<A HREF="../../../com/microstar/xml/HandlerBase.html" title="class in com.microstar.xml"><CODE>HandlerBase</CODE></A>, 
106<CODE>org.xml.sax.EntityHandler</CODE>, 
107<CODE>DocumentHandler</CODE>, 
108<CODE>ErrorHandler</CODE></DL>
109<HR>
110
111<P>
112
113<!-- ========== METHOD SUMMARY =========== -->
114
115<A NAME="method_summary"><!-- --></A>
116<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
117<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
118<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
119<B>Method Summary</B></FONT></TH>
120</TR>
121<TR BGCOLOR="white" CLASS="TableRowColor">
122<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
123<CODE>&nbsp;void</CODE></FONT></TD>
124<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#attribute(java.lang.String, java.lang.String, boolean)">attribute</A></B>(java.lang.String&nbsp;aname,
125          java.lang.String&nbsp;value,
126          boolean&nbsp;isSpecified)</CODE>
127
128<BR>
129&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;Attribute.</TD>
130</TR>
131<TR BGCOLOR="white" CLASS="TableRowColor">
132<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
133<CODE>&nbsp;void</CODE></FONT></TD>
134<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#charData(char[], int, int)">charData</A></B>(char[]&nbsp;ch,
135         int&nbsp;start,
136         int&nbsp;length)</CODE>
137
138<BR>
139&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;Character data.</TD>
140</TR>
141<TR BGCOLOR="white" CLASS="TableRowColor">
142<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
143<CODE>&nbsp;void</CODE></FONT></TD>
144<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#doctypeDecl(java.lang.String, java.lang.String, java.lang.String)">doctypeDecl</A></B>(java.lang.String&nbsp;name,
145            java.lang.String&nbsp;publicId,
146            java.lang.String&nbsp;systemId)</CODE>
147
148<BR>
149&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;Document type declaration.</TD>
150</TR>
151<TR BGCOLOR="white" CLASS="TableRowColor">
152<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
153<CODE>&nbsp;void</CODE></FONT></TD>
154<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#endDocument()">endDocument</A></B>()</CODE>
155
156<BR>
157&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;End the document.</TD>
158</TR>
159<TR BGCOLOR="white" CLASS="TableRowColor">
160<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
161<CODE>&nbsp;void</CODE></FONT></TD>
162<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#endElement(java.lang.String)">endElement</A></B>(java.lang.String&nbsp;elname)</CODE>
163
164<BR>
165&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;End an element.</TD>
166</TR>
167<TR BGCOLOR="white" CLASS="TableRowColor">
168<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
169<CODE>&nbsp;void</CODE></FONT></TD>
170<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#endExternalEntity(java.lang.String)">endExternalEntity</A></B>(java.lang.String&nbsp;systemId)</CODE>
171
172<BR>
173&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;End an external entity.</TD>
174</TR>
175<TR BGCOLOR="white" CLASS="TableRowColor">
176<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
177<CODE>&nbsp;void</CODE></FONT></TD>
178<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#error(java.lang.String, java.lang.String, int, int)">error</A></B>(java.lang.String&nbsp;message,
179      java.lang.String&nbsp;systemId,
180      int&nbsp;line,
181      int&nbsp;column)</CODE>
182
183<BR>
184&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;Fatal XML parsing error.</TD>
185</TR>
186<TR BGCOLOR="white" CLASS="TableRowColor">
187<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
188<CODE>&nbsp;void</CODE></FONT></TD>
189<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#ignorableWhitespace(char[], int, int)">ignorableWhitespace</A></B>(char[]&nbsp;ch,
190                    int&nbsp;start,
191                    int&nbsp;length)</CODE>
192
193<BR>
194&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;Ignorable whitespace.</TD>
195</TR>
196<TR BGCOLOR="white" CLASS="TableRowColor">
197<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
198<CODE>&nbsp;void</CODE></FONT></TD>
199<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#processingInstruction(java.lang.String, java.lang.String)">processingInstruction</A></B>(java.lang.String&nbsp;target,
200                      java.lang.String&nbsp;data)</CODE>
201
202<BR>
203&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;Processing instruction.</TD>
204</TR>
205<TR BGCOLOR="white" CLASS="TableRowColor">
206<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
207<CODE>&nbsp;java.lang.Object</CODE></FONT></TD>
208<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#resolveEntity(java.lang.String, java.lang.String)">resolveEntity</A></B>(java.lang.String&nbsp;publicId,
209              java.lang.String&nbsp;systemId)</CODE>
210
211<BR>
212&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;Resolve an External Entity.</TD>
213</TR>
214<TR BGCOLOR="white" CLASS="TableRowColor">
215<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
216<CODE>&nbsp;void</CODE></FONT></TD>
217<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#startDocument()">startDocument</A></B>()</CODE>
218
219<BR>
220&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;Start the document.</TD>
221</TR>
222<TR BGCOLOR="white" CLASS="TableRowColor">
223<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
224<CODE>&nbsp;void</CODE></FONT></TD>
225<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#startElement(java.lang.String)">startElement</A></B>(java.lang.String&nbsp;elname)</CODE>
226
227<BR>
228&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;Start an element.</TD>
229</TR>
230<TR BGCOLOR="white" CLASS="TableRowColor">
231<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
232<CODE>&nbsp;void</CODE></FONT></TD>
233<TD><CODE><B><A HREF="../../../com/microstar/xml/XmlHandler.html#startExternalEntity(java.lang.String)">startExternalEntity</A></B>(java.lang.String&nbsp;systemId)</CODE>
234
235<BR>
236&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<B>Deprecated.</B>&nbsp;Begin an external entity.</TD>
237</TR>
238</TABLE>
239&nbsp;
240<P>
241
242<!-- ============ METHOD DETAIL ========== -->
243
244<A NAME="method_detail"><!-- --></A>
245<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
246<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
247<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
248<B>Method Detail</B></FONT></TH>
249</TR>
250</TABLE>
251
252<A NAME="startDocument()"><!-- --></A><H3>
253startDocument</H3>
254<PRE>
255void <B>startDocument</B>()
256                   throws java.lang.Exception</PRE>
257<DL>
258<DD><B>Deprecated.</B>&nbsp;<DD>Start the document.
259 <p>&AElig;lfred will call this method just before it
260 attempts to read the first entity (the root of the document).
261 It is guaranteed that this will be the first method called.
262<P>
263<DD><DL>
264
265<DT><B>Throws:</B>
266<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.<DT><B>See Also:</B><DD><A HREF="../../../com/microstar/xml/XmlHandler.html#endDocument()"><CODE>endDocument()</CODE></A></DL>
267</DD>
268</DL>
269<HR>
270
271<A NAME="endDocument()"><!-- --></A><H3>
272endDocument</H3>
273<PRE>
274void <B>endDocument</B>()
275                 throws java.lang.Exception</PRE>
276<DL>
277<DD><B>Deprecated.</B>&nbsp;<DD>End the document.
278 <p>&AElig;lfred will call this method once, when it has
279 finished parsing the XML document.
280 It is guaranteed that this will be the last method called.
281<P>
282<DD><DL>
283
284<DT><B>Throws:</B>
285<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.<DT><B>See Also:</B><DD><A HREF="../../../com/microstar/xml/XmlHandler.html#startDocument()"><CODE>startDocument()</CODE></A></DL>
286</DD>
287</DL>
288<HR>
289
290<A NAME="resolveEntity(java.lang.String, java.lang.String)"><!-- --></A><H3>
291resolveEntity</H3>
292<PRE>
293java.lang.Object <B>resolveEntity</B>(java.lang.String&nbsp;publicId,
294                               java.lang.String&nbsp;systemId)
295                               throws java.lang.Exception</PRE>
296<DL>
297<DD><B>Deprecated.</B>&nbsp;<DD>Resolve an External Entity.
298 <p>Give the handler a chance to redirect external entities
299 to different URIs.  &AElig;lfred will call this method for the
300 top-level document entity, for external text (XML) entities, 
301 and the external DTD subset (if any).
302<P>
303<DD><DL>
304<DT><B>Parameters:</B><DD><CODE>publicId</CODE> - The public identifier, or null if none was supplied.<DD><CODE>systemId</CODE> - The system identifier.
305<DT><B>Returns:</B><DD>The replacement system identifier, or null to use
306         the default.
307<DT><B>Throws:</B>
308<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.<DT><B>See Also:</B><DD><A HREF="../../../com/microstar/xml/XmlHandler.html#startExternalEntity(java.lang.String)"><CODE>startExternalEntity(java.lang.String)</CODE></A>, 
309<A HREF="../../../com/microstar/xml/XmlHandler.html#endExternalEntity(java.lang.String)"><CODE>endExternalEntity(java.lang.String)</CODE></A></DL>
310</DD>
311</DL>
312<HR>
313
314<A NAME="startExternalEntity(java.lang.String)"><!-- --></A><H3>
315startExternalEntity</H3>
316<PRE>
317void <B>startExternalEntity</B>(java.lang.String&nbsp;systemId)
318                         throws java.lang.Exception</PRE>
319<DL>
320<DD><B>Deprecated.</B>&nbsp;<DD>Begin an external entity.
321 <p>&AElig;lfred will call this method at the beginning of
322 each external entity, including the top-level document entity
323 and the external DTD subset (if any).
324 <p>If necessary, you can use this method to track the location
325 of the current entity so that you can resolve relative URIs
326 correctly.
327<P>
328<DD><DL>
329<DT><B>Parameters:</B><DD><CODE>systemId</CODE> - The URI of the external entity that is starting.
330<DT><B>Throws:</B>
331<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.<DT><B>See Also:</B><DD><A HREF="../../../com/microstar/xml/XmlHandler.html#endExternalEntity(java.lang.String)"><CODE>endExternalEntity(java.lang.String)</CODE></A>, 
332<A HREF="../../../com/microstar/xml/XmlHandler.html#resolveEntity(java.lang.String, java.lang.String)"><CODE>resolveEntity(java.lang.String, java.lang.String)</CODE></A></DL>
333</DD>
334</DL>
335<HR>
336
337<A NAME="endExternalEntity(java.lang.String)"><!-- --></A><H3>
338endExternalEntity</H3>
339<PRE>
340void <B>endExternalEntity</B>(java.lang.String&nbsp;systemId)
341                       throws java.lang.Exception</PRE>
342<DL>
343<DD><B>Deprecated.</B>&nbsp;<DD>End an external entity.
344 <p>&AElig;lfred will call this method at the end of
345 each external entity, including the top-level document entity
346 and the external DTD subset.
347 <p>If necessary, you can use this method to track the location
348 of the current entity so that you can resolve relative URIs
349 correctly.
350<P>
351<DD><DL>
352<DT><B>Parameters:</B><DD><CODE>systemId</CODE> - The URI of the external entity that is ending.
353<DT><B>Throws:</B>
354<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.<DT><B>See Also:</B><DD><A HREF="../../../com/microstar/xml/XmlHandler.html#startExternalEntity(java.lang.String)"><CODE>startExternalEntity(java.lang.String)</CODE></A>, 
355<A HREF="../../../com/microstar/xml/XmlHandler.html#resolveEntity(java.lang.String, java.lang.String)"><CODE>resolveEntity(java.lang.String, java.lang.String)</CODE></A></DL>
356</DD>
357</DL>
358<HR>
359
360<A NAME="doctypeDecl(java.lang.String, java.lang.String, java.lang.String)"><!-- --></A><H3>
361doctypeDecl</H3>
362<PRE>
363void <B>doctypeDecl</B>(java.lang.String&nbsp;name,
364                 java.lang.String&nbsp;publicId,
365                 java.lang.String&nbsp;systemId)
366                 throws java.lang.Exception</PRE>
367<DL>
368<DD><B>Deprecated.</B>&nbsp;<DD>Document type declaration.
369 <p>&AElig;lfred will call this method when or if it encounters
370 the document type (DOCTYPE) declaration.
371 <p>Please note that the public and system identifiers will
372 not always be a reliable indication of the DTD in use.
373<P>
374<DD><DL>
375<DT><B>Parameters:</B><DD><CODE>name</CODE> - The document type name.<DD><CODE>publicId</CODE> - The public identifier, or null if unspecified.<DD><CODE>systemId</CODE> - The system identifier, or null if unspecified.
376<DT><B>Throws:</B>
377<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.</DL>
378</DD>
379</DL>
380<HR>
381
382<A NAME="attribute(java.lang.String, java.lang.String, boolean)"><!-- --></A><H3>
383attribute</H3>
384<PRE>
385void <B>attribute</B>(java.lang.String&nbsp;aname,
386               java.lang.String&nbsp;value,
387               boolean&nbsp;isSpecified)
388               throws java.lang.Exception</PRE>
389<DL>
390<DD><B>Deprecated.</B>&nbsp;<DD>Attribute.
391 <p>&AElig;lfred will call this method once for each attribute 
392 (specified or defaulted) before reporting a startElement event.
393 It is up to your handler to collect the attributes, if
394 necessary.
395 <p>You may use XmlParser.getAttributeType() to find the attribute's
396 declared type.
397<P>
398<DD><DL>
399<DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the attribute.<DD><CODE>type</CODE> - The type of the attribute (see below).<DD><CODE>value</CODE> - The value of the attribute, or null if the attribute
400        is <code>#IMPLIED</code>.<DD><CODE>isSpecified</CODE> - True if the value was specified, false if it
401       was defaulted from the DTD.
402<DT><B>Throws:</B>
403<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.<DT><B>See Also:</B><DD><A HREF="../../../com/microstar/xml/XmlHandler.html#startElement(java.lang.String)"><CODE>startElement(java.lang.String)</CODE></A>, 
404<A HREF="../../../com/microstar/xml/XmlParser.html#declaredAttributes(java.lang.String)"><CODE>XmlParser.declaredAttributes(java.lang.String)</CODE></A>, 
405<A HREF="../../../com/microstar/xml/XmlParser.html#getAttributeType(java.lang.String, java.lang.String)"><CODE>XmlParser.getAttributeType(java.lang.String, java.lang.String)</CODE></A>, 
406<A HREF="../../../com/microstar/xml/XmlParser.html#getAttributeDefaultValue(java.lang.String, java.lang.String)"><CODE>XmlParser.getAttributeDefaultValue(java.lang.String, java.lang.String)</CODE></A></DL>
407</DD>
408</DL>
409<HR>
410
411<A NAME="startElement(java.lang.String)"><!-- --></A><H3>
412startElement</H3>
413<PRE>
414void <B>startElement</B>(java.lang.String&nbsp;elname)
415                  throws java.lang.Exception</PRE>
416<DL>
417<DD><B>Deprecated.</B>&nbsp;<DD>Start an element.
418 <p>&AElig;lfred will call this method at the beginning of each
419 element.  By the time this is called, all of the attributes
420 for the element will already have been reported using the
421 <code>attribute</code> method.
422<P>
423<DD><DL>
424<DT><B>Parameters:</B><DD><CODE>elname</CODE> - The element type name.
425<DT><B>Throws:</B>
426<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.<DT><B>See Also:</B><DD><A HREF="../../../com/microstar/xml/XmlHandler.html#attribute(java.lang.String, java.lang.String, boolean)"><CODE>attribute(java.lang.String, java.lang.String, boolean)</CODE></A>, 
427<A HREF="../../../com/microstar/xml/XmlHandler.html#endElement(java.lang.String)"><CODE>endElement(java.lang.String)</CODE></A>, 
428<A HREF="../../../com/microstar/xml/XmlParser.html#declaredElements()"><CODE>XmlParser.declaredElements()</CODE></A>, 
429<A HREF="../../../com/microstar/xml/XmlParser.html#getElementContentType(java.lang.String)"><CODE>XmlParser.getElementContentType(java.lang.String)</CODE></A></DL>
430</DD>
431</DL>
432<HR>
433
434<A NAME="endElement(java.lang.String)"><!-- --></A><H3>
435endElement</H3>
436<PRE>
437void <B>endElement</B>(java.lang.String&nbsp;elname)
438                throws java.lang.Exception</PRE>
439<DL>
440<DD><B>Deprecated.</B>&nbsp;<DD>End an element.
441 <p>&AElig;lfred will call this method at the end of each element
442 (including EMPTY elements).
443<P>
444<DD><DL>
445<DT><B>Parameters:</B><DD><CODE>elname</CODE> - The element type name.
446<DT><B>Throws:</B>
447<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.<DT><B>See Also:</B><DD><A HREF="../../../com/microstar/xml/XmlHandler.html#startElement(java.lang.String)"><CODE>startElement(java.lang.String)</CODE></A>, 
448<A HREF="../../../com/microstar/xml/XmlParser.html#declaredElements()"><CODE>XmlParser.declaredElements()</CODE></A>, 
449<A HREF="../../../com/microstar/xml/XmlParser.html#getElementContentType(java.lang.String)"><CODE>XmlParser.getElementContentType(java.lang.String)</CODE></A></DL>
450</DD>
451</DL>
452<HR>
453
454<A NAME="charData(char[], int, int)"><!-- --></A><H3>
455charData</H3>
456<PRE>
457void <B>charData</B>(char[]&nbsp;ch,
458              int&nbsp;start,
459              int&nbsp;length)
460              throws java.lang.Exception</PRE>
461<DL>
462<DD><B>Deprecated.</B>&nbsp;<DD>Character data.
463 <p>&AElig;lfred will call this method once for each chunk of
464 character data found in the contents of elements.  Note that
465 the parser may break up a long sequence of characters into
466 smaller chunks and call this method once for each chunk.
467 <p>Do <em>not</em> attempt to read more than <var>length</var>
468 characters from the array, or to read before the 
469 <var>start</var> position.
470<P>
471<DD><DL>
472<DT><B>Parameters:</B><DD><CODE>ch</CODE> - The character data.<DD><CODE>start</CODE> - The starting position in the array.<DD><CODE>length</CODE> - The number of characters available.
473<DT><B>Throws:</B>
474<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.</DL>
475</DD>
476</DL>
477<HR>
478
479<A NAME="ignorableWhitespace(char[], int, int)"><!-- --></A><H3>
480ignorableWhitespace</H3>
481<PRE>
482void <B>ignorableWhitespace</B>(char[]&nbsp;ch,
483                         int&nbsp;start,
484                         int&nbsp;length)
485                         throws java.lang.Exception</PRE>
486<DL>
487<DD><B>Deprecated.</B>&nbsp;<DD>Ignorable whitespace.
488 <p>&AElig;lfred will call this method once for each sequence
489 of ignorable whitespace in element content (never in mixed content).
490 <p>For details, see section 2.10 of the XML 1.0 recommendation.
491 <p>Do <em>not</em> attempt to read more than <var>length</var>
492 characters from the array or to read before the <var>start</var>
493 position.
494<P>
495<DD><DL>
496<DT><B>Parameters:</B><DD><CODE>ch</CODE> - The literal whitespace characters.<DD><CODE>start</CODE> - The starting position in the array.<DD><CODE>length</CODE> - The number of whitespace characters available.
497<DT><B>Throws:</B>
498<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.</DL>
499</DD>
500</DL>
501<HR>
502
503<A NAME="processingInstruction(java.lang.String, java.lang.String)"><!-- --></A><H3>
504processingInstruction</H3>
505<PRE>
506void <B>processingInstruction</B>(java.lang.String&nbsp;target,
507                           java.lang.String&nbsp;data)
508                           throws java.lang.Exception</PRE>
509<DL>
510<DD><B>Deprecated.</B>&nbsp;<DD>Processing instruction.
511 <p>&AElig;lfred will call this method once for each
512 processing instruction.  Note that processing instructions may
513 appear outside of the top-level element.  The
514<P>
515<DD><DL>
516<DT><B>Parameters:</B><DD><CODE>target</CODE> - The target (the name at the start of the PI).<DD><CODE>data</CODE> - The data, if any (the rest of the PI).
517<DT><B>Throws:</B>
518<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.</DL>
519</DD>
520</DL>
521<HR>
522
523<A NAME="error(java.lang.String, java.lang.String, int, int)"><!-- --></A><H3>
524error</H3>
525<PRE>
526void <B>error</B>(java.lang.String&nbsp;message,
527           java.lang.String&nbsp;systemId,
528           int&nbsp;line,
529           int&nbsp;column)
530           throws java.lang.Exception</PRE>
531<DL>
532<DD><B>Deprecated.</B>&nbsp;<DD>Fatal XML parsing error.
533 <p>&AElig;lfred will call this method whenever it encounters
534 a serious error.  The parser will attempt to continue past this 
535 point so that you can find more possible error points, but if
536 this method is called you should assume that the document is
537 corrupt and you should not try to use its contents.
538 <p>Note that you can use the <code>XmlException</code> class
539 to encapsulate all of the information provided, though the
540 use of the class is not mandatory.
541<P>
542<DD><DL>
543<DT><B>Parameters:</B><DD><CODE>message</CODE> - The error message.<DD><CODE>systemId</CODE> - The system identifier of the entity that 
544        contains the error.<DD><CODE>line</CODE> - The approximate line number of the error.<DD><CODE>column</CODE> - The approximate column number of the error.
545<DT><B>Throws:</B>
546<DD><CODE>java.lang.Exception</CODE> - The handler may throw any exception.<DT><B>See Also:</B><DD><A HREF="../../../com/microstar/xml/XmlException.html" title="class in com.microstar.xml"><CODE>XmlException</CODE></A></DL>
547</DD>
548</DL>
549<!-- ========= END OF CLASS DATA ========= -->
550<HR>
551
552
553<!-- ======= START OF BOTTOM NAVBAR ====== -->
554<A NAME="navbar_bottom"><!-- --></A>
555<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
556<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
557<TR>
558<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
559<A NAME="navbar_bottom_firstrow"><!-- --></A>
560<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
561  <TR ALIGN="center" VALIGN="top">
562  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
563  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
564  <TD BGCOLOR="#00008B" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
565  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/XmlHandler.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
566  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
567  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
568  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
569  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
570  </TR>
571</TABLE>
572</TD>
573<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
574</EM>
575</TD>
576</TR>
577
578<TR>
579<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
580&nbsp;<A HREF="../../../com/microstar/xml/XmlException.html" title="class in com.microstar.xml"><B>PREV CLASS</B></A>&nbsp;
581&nbsp;<A HREF="../../../com/microstar/xml/XmlParser.html" title="class in com.microstar.xml"><B>NEXT CLASS</B></A></FONT></TD>
582<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
583  <A HREF="../../../index.html?com/microstar/xml/XmlHandler.html" target="_top"><B>FRAMES</B></A>  &nbsp;
584&nbsp;<A HREF="XmlHandler.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
585&nbsp;
586<NOSCRIPT>
587  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
588</NOSCRIPT>
589
590
591</FONT></TD>
592</TR>
593<TR>
594<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
595  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
596<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
597DETAIL:&nbsp;FIELD&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
598</TR>
599</TABLE>
600<A NAME="skip-navbar_bottom"></A>
601<!-- ======== END OF BOTTOM NAVBAR ======= -->
602
603<HR>
604
605</BODY>
606</HTML>