2000-09-15 19:56:39 +00:00
|
|
|
<html><head>
|
|
|
|
|
<title>GSSAXHandler</title>
|
|
|
|
|
</head>
|
|
|
|
|
<body>
|
|
|
|
|
<a href="GSXMLParser.html">[Previous]</a>
|
|
|
|
|
<a href="GSXML.html">[Up]</a>
|
|
|
|
|
<h1>GSSAXHandler</h1>
|
|
|
|
|
<h3>Authors</h3>
|
|
|
|
|
<dl>
|
|
|
|
|
<dt>Michael Pakhantsov
|
|
|
|
|
<dd>
|
|
|
|
|
<dt>Richard Frith-Macdonald
|
|
|
|
|
<dd>
|
|
|
|
|
</dl>
|
|
|
|
|
<p>Version: 0.2</p>
|
|
|
|
|
<p>Date: 15 september, 2000</p>
|
|
|
|
|
<h2><a name="cont-0">GSSAXHandler</a></h2>
|
|
|
|
|
<h2><a name="GSSAXHandler">GSSAXHandler</a></h2>
|
|
|
|
|
<p><b>Declared in:</b> GSXML.h</p>
|
2000-09-20 06:45:02 +00:00
|
|
|
<p><b>Inherits from:</b> NSObject</p>
|
2000-09-15 19:56:39 +00:00
|
|
|
<hr>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
XML SAX Handler.</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
2000-09-20 06:45:02 +00:00
|
|
|
|
|
|
|
|
GSSAXHandler is a callback-based interface to the XML parser
|
|
|
|
|
that operates in a similar (though not identical) manner to
|
|
|
|
|
SAX.
|
|
|
|
|
</p>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
2000-09-20 06:45:02 +00:00
|
|
|
Each GSSAXHandler object is associated with a GSXMLParser
|
|
|
|
|
object. As parsing progresses, the mathods of the GSSAXHandler
|
|
|
|
|
are invoked by the parser, so the handler is able to deal
|
|
|
|
|
with the elements and entities being parsed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
The callback methods in the GSSAXHandler class do nothing - it
|
|
|
|
|
is intended that you subclass GSSAXHandler and override them.
|
2000-09-15 19:56:39 +00:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<h2>Instance Variables</h2>
|
|
|
|
|
<ul>
|
|
|
|
|
</ul>
|
|
|
|
|
<h2>Methods</h2>
|
|
|
|
|
<ul>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-0">+handler</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-8">-attribute:value:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-27">-attributeDecl:name:type:typeDefValue:defaultValue:</a>
|
2000-09-20 06:45:02 +00:00
|
|
|
<li><a href="GSSAXHandler.html#method-13">-cdataBlock:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-9">-characters:</a>
|
2000-09-15 19:56:39 +00:00
|
|
|
<li><a href="GSSAXHandler.html#method-12">-comment:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-28">-elementDecl:type:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-4">-endDocument</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-7">-endElement</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-26">-entityDecl:type:publicId:systemId:content:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-15">-error:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-16">-fatalError:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-22">-getEntity:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-23">-getParameterEntity:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-14">-globalNamespace:href:prefix:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-19">-hasExternalSubset:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-18">-hasInternalSubset:</a>
|
2000-09-20 06:45:02 +00:00
|
|
|
<li><a href="GSSAXHandler.html#method-10">-ignoreWhitespace:</a>
|
2000-09-15 19:56:39 +00:00
|
|
|
<li><a href="GSSAXHandler.html#method-20">-internalSubset:externalID:systemID:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-5">-isStandalone</a>
|
2000-09-19 20:47:56 +00:00
|
|
|
<li><a href="GSSAXHandler.html#method-1">-lib</a>
|
2000-09-15 19:56:39 +00:00
|
|
|
<li><a href="GSSAXHandler.html#method-24">-namespaceDecl:href:prefix:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-25">-notationDecl:systemId:</a>
|
2000-09-19 20:47:56 +00:00
|
|
|
<li><a href="GSSAXHandler.html#method-2">-parser</a>
|
2000-09-15 19:56:39 +00:00
|
|
|
<li><a href="GSSAXHandler.html#method-11">-processInstruction:value:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-30">-reference:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-21">-resolveEntity:systemID:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-3">-startDocument</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-6">-startElement:attributes:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-29">-unparsedEntityDecl:public:system:notationName:</a>
|
|
|
|
|
<li><a href="GSSAXHandler.html#method-17">-warning:</a>
|
|
|
|
|
</ul>
|
|
|
|
|
<hr><h2>Class Methods</h2>
|
|
|
|
|
<h3><a name="method-0">handler</a></h3>
|
|
|
|
|
+ (<A HREF="GSSAXHandler.html#GSSAXHandler">GSSAXHandler</A>*) <b>handler</b>;<br>
|
|
|
|
|
|
2000-09-19 20:47:56 +00:00
|
|
|
<p>
|
2000-09-15 19:56:39 +00:00
|
|
|
Create a new SAX handler.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<hr><h2>Instances Methods</h2>
|
2000-09-19 20:47:56 +00:00
|
|
|
<h3><a name="method-1">lib</a></h3>
|
|
|
|
|
- (void*) <b>lib</b>;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
2000-09-19 20:47:56 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
Return pointer to xmlSAXHandler structure.
|
2000-09-15 19:56:39 +00:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
2000-09-19 20:47:56 +00:00
|
|
|
<h3><a name="method-2">parser</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (GSXMLParser*) <b>parser</b>;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
2000-09-19 20:47:56 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
Return the parser object with which this handler is
|
|
|
|
|
associated. This may occasionally be useful.
|
2000-09-15 19:56:39 +00:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-3">startDocument</a></h3>
|
|
|
|
|
- (void) <b>startDocument</b>;<br>
|
|
|
|
|
|
2000-09-19 20:47:56 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
Called when the document start being processed.
|
2000-09-15 19:56:39 +00:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-4">endDocument</a></h3>
|
|
|
|
|
- (void) <b>endDocument</b>;<br>
|
|
|
|
|
|
2000-09-19 20:47:56 +00:00
|
|
|
<p>
|
|
|
|
|
|
|
|
|
|
Called when the document end has been detected.
|
2000-09-15 19:56:39 +00:00
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-5">isStandalone</a></h3>
|
2000-09-19 20:47:56 +00:00
|
|
|
- (int) <b>isStandalone</b>;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
2000-09-19 20:47:56 +00:00
|
|
|
<p>
|
2000-09-15 19:56:39 +00:00
|
|
|
Called if the document is standalone.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-6">startElement:attributes:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>startElement:</b> (NSString*)elementName <b>attributes:</b> (NSMutableDictionary*)elementAttributes;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
2000-09-20 06:45:02 +00:00
|
|
|
<p>
|
2000-09-15 19:56:39 +00:00
|
|
|
Called when an opening tag has been processed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-7">endElement</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>endElement</b> (NSString*)elementName;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
2000-09-20 06:45:02 +00:00
|
|
|
<p>
|
2000-09-15 19:56:39 +00:00
|
|
|
Called when the end of an element has been detected.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-8">attribute:value:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>attribute:</b> (NSString*)name <b>value:</b> (NSString*)value;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
2000-09-20 06:45:02 +00:00
|
|
|
<p>
|
2000-09-15 19:56:39 +00:00
|
|
|
Handle an attribute that has been read by the parser.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
2000-09-20 06:45:02 +00:00
|
|
|
<h3><a name="method-9">characters:</a></h3>
|
|
|
|
|
- (void) <b>characters:</b> (NSString*)name;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
2000-09-20 06:45:02 +00:00
|
|
|
<p>
|
2000-09-15 19:56:39 +00:00
|
|
|
Receiving some chars from the parser.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
2000-09-20 06:45:02 +00:00
|
|
|
<h3><a name="method-10">ignoreWhitespace:</a></h3>
|
|
|
|
|
- (void) <b>ignoreWhitespace:</b> (NSString*)ch;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Receiving some ignorable whitespaces from the parser.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-11">processInstruction:value:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>processInstruction:</b> (NSString*)targetName <b>value:</b> (NSString*)PIData;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
2000-09-20 06:45:02 +00:00
|
|
|
<p>
|
2000-09-15 19:56:39 +00:00
|
|
|
A processing instruction has been parsed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-12">comment:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>comment:</b> (NSString*)value;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
2000-09-20 06:45:02 +00:00
|
|
|
<p>
|
2000-09-15 19:56:39 +00:00
|
|
|
A comment has been parsed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
2000-09-20 06:45:02 +00:00
|
|
|
<h3><a name="method-13">cdataBlock:</a></h3>
|
|
|
|
|
- (void) <b>cdataBlock:</b> (NSString*)value;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Called when a pcdata block has been parsed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-14">globalNamespace:href:prefix:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>globalNamespace:</b> (NSString*)name <b>href:</b> (NSString*)href <b>prefix:</b> (NSString*)prefix;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
An old global namespace has been parsed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-15">error:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>error:</b> (NSString*)message;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Called when found a error.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-16">fatalError:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>fatalError:</b> (NSString*)message;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Called when found a fatal error.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-17">warning:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>warning:</b> (NSString*)message;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Called when found a warning.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-18">hasInternalSubset:</a></h3>
|
2000-09-19 20:47:56 +00:00
|
|
|
- (int) <b>hasInternalSubset:</b>;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Callback on internal subset declaration.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-19">hasExternalSubset:</a></h3>
|
2000-09-19 20:47:56 +00:00
|
|
|
- (int) <b>hasExternalSubset:</b>;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Does this document have an external subset.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-20">internalSubset:externalID:systemID:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>internalSubset:</b> (NSString*)name <b>externalID:</b> (NSString*)externalID <b>systemID:</b> (NSString*)systemID;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Callback on internal subset declaration.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-21">resolveEntity:systemID:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void*) <b>resolveEntity:</b> (NSString*)publicID <b>systemID:</b> (NSString*)systemID;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
The entity loader, to control the loading of external entities,
|
|
|
|
|
the application can either.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-22">getEntity:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void*) <b>getEntity:</b> (NSString*)name;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Get an entity by name.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-23">getParameterEntity:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void*) <b>getParameterEntity:</b> (NSString*)name;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Get a parameter entity by name.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-24">namespaceDecl:href:prefix:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>namespaceDecl:</b> (NSString*)name <b>href:</b> (NSString*)href <b>prefix:</b> (NSString*)prefix;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
A namespace has been parsed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-25">notationDecl:systemId:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>notationDecl:</b> (NSString*)publicId <b>systemId:</b> (NSString*)systemId;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
What to do when a notation declaration has been parsed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-26">entityDecl:type:publicId:systemId:content:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>entityDecl:</b> (NSString*)name <b>type:</b> (int)type <b>publicId:</b> (NSString*)publicId <b>systemId:</b> (NSString*)systemId <b>content:</b> (NSString*)content;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
An entity definition has been parsed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-27">attributeDecl:name:type:typeDefValue:defaultValue:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>attributeDecl:</b> (NSString*)nameElement <b>name:</b> (NSString*)name <b>type:</b> (int)type <b>typeDefValue:</b> (int)defType <b>defaultValue:</b> (NSString*)value;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
An attribute definition has been parsed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-28">elementDecl:type:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>elementDecl:</b> (NSString*)name <b>type:</b> (int)type;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
An element definition has been parsed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-29">unparsedEntityDecl:public:system:notationName:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>unparsedEntityDecl:</b> (NSString*)name <b>public:</b> (NSString*)publicId <b>system:</b> (NSString*)systemId <b>notationName:</b> (NSString*)notation;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
What to do when an unparsed entity declaration is parsed.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
<h3><a name="method-30">reference:</a></h3>
|
2000-09-20 06:45:02 +00:00
|
|
|
- (void) <b>reference:</b> (NSString*)name;<br>
|
2000-09-15 19:56:39 +00:00
|
|
|
|
|
|
|
|
<p>
|
|
|
|
|
Called when an entity reference is detected.
|
|
|
|
|
</p>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<hr>
|
|
|
|
|
</body>
|
|
|
|
|
|
|
|
|
|
</html>
|
