1 /* 2 * Copyright (c) 2004 World Wide Web Consortium, 3 * 4 * (Massachusetts Institute of Technology, European Research Consortium for 5 * Informatics and Mathematics, Keio University). All Rights Reserved. This 6 * work is distributed under the W3C(r) Software License [1] in the hope that 7 * it will be useful, but WITHOUT ANY WARRANTY; without even the implied 8 * warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. 9 * 10 * [1] http://www.w3.org/Consortium/Legal/2002/copyright-software-20021231 11 */ 12 13 package org.w3c.dom.ls; 14 15 import org.w3c.dom.DOMConfiguration; 16 import org.w3c.dom.DOMException; 17 import org.w3c.dom.Document; 18 import org.w3c.dom.Node; 19 20 /** 21 * An interface to an object that is able to build, or augment, a DOM tree 22 * from various input sources. 23 * <p> <code>LSParser</code> provides an API for parsing XML and building the 24 * corresponding DOM document structure. A <code>LSParser</code> instance 25 * can be obtained by invoking the 26 * <code>DOMImplementationLS.createLSParser()</code> method. 27 * <p> As specified in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] 28 * , when a document is first made available via the LSParser: 29 * <ul> 30 * <li> there will 31 * never be two adjacent nodes of type NODE_TEXT, and there will never be 32 * empty text nodes. 33 * </li> 34 * <li> it is expected that the <code>value</code> and 35 * <code>nodeValue</code> attributes of an <code>Attr</code> node initially 36 * return the <a href='http://www.w3.org/TR/2004/REC-xml-20040204#AVNormalize'>XML 1.0 37 * normalized value</a>. However, if the parameters "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-validate-if-schema'> 38 * validate-if-schema</a>" and "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-datatype-normalization'> 39 * datatype-normalization</a>" are set to <code>true</code>, depending on the attribute normalization 40 * used, the attribute values may differ from the ones obtained by the XML 41 * 1.0 attribute normalization. If the parameters "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-datatype-normalization'> 42 * datatype-normalization</a>" is set to <code>false</code>, the XML 1.0 attribute normalization is 43 * guaranteed to occur, and if the attributes list does not contain 44 * namespace declarations, the <code>attributes</code> attribute on 45 * <code>Element</code> node represents the property <b>[attributes]</b> defined in [<a href='http://www.w3.org/TR/2004/REC-xml-infoset-20040204/'>XML Information Set</a>] 46 * . 47 * </li> 48 * </ul> 49 * <p> Asynchronous <code>LSParser</code> objects are expected to also 50 * implement the <code>events::EventTarget</code> interface so that event 51 * listeners can be registered on asynchronous <code>LSParser</code> 52 * objects. 53 * <p> Events supported by asynchronous <code>LSParser</code> objects are: 54 * <dl> 55 * <dt>load</dt> 56 * <dd> 57 * The <code>LSParser</code> finishes to load the document. See also the 58 * definition of the <code>LSLoadEvent</code> interface. </dd> 59 * <dt>progress</dt> 60 * <dd> The 61 * <code>LSParser</code> signals progress as data is parsed. This 62 * specification does not attempt to define exactly when progress events 63 * should be dispatched. That is intentionally left as 64 * implementation-dependent. Here is one example of how an application might 65 * dispatch progress events: Once the parser starts receiving data, a 66 * progress event is dispatched to indicate that the parsing starts. From 67 * there on, a progress event is dispatched for every 4096 bytes of data 68 * that is received and processed. This is only one example, though, and 69 * implementations can choose to dispatch progress events at any time while 70 * parsing, or not dispatch them at all. See also the definition of the 71 * <code>LSProgressEvent</code> interface. </dd> 72 * </dl> 73 * <p ><b>Note:</b> All events defined in this specification use the 74 * namespace URI <code>"http://www.w3.org/2002/DOMLS"</code>. 75 * <p> While parsing an input source, errors are reported to the application 76 * through the error handler (<code>LSParser.domConfig</code>'s "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> 77 * error-handler</a>" parameter). This specification does in no way try to define all possible 78 * errors that can occur while parsing XML, or any other markup, but some 79 * common error cases are defined. The types (<code>DOMError.type</code>) of 80 * errors and warnings defined by this specification are: 81 * <dl> 82 * <dt> 83 * <code>"check-character-normalization-failure" [error]</code> </dt> 84 * <dd> Raised if 85 * the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-check-character-normalization'> 86 * check-character-normalization</a>" is set to true and a string is encountered that fails normalization 87 * checking. </dd> 88 * <dt><code>"doctype-not-allowed" [fatal]</code></dt> 89 * <dd> Raised if the 90 * configuration parameter "disallow-doctype" is set to <code>true</code> 91 * and a doctype is encountered. </dd> 92 * <dt><code>"no-input-specified" [fatal]</code></dt> 93 * <dd> 94 * Raised when loading a document and no input is specified in the 95 * <code>LSInput</code> object. </dd> 96 * <dt> 97 * <code>"pi-base-uri-not-preserved" [warning]</code></dt> 98 * <dd> Raised if a processing 99 * instruction is encountered in a location where the base URI of the 100 * processing instruction can not be preserved. One example of a case where 101 * this warning will be raised is if the configuration parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-entities'> 102 * entities</a>" is set to <code>false</code> and the following XML file is parsed: 103 * <pre> 104 * <!DOCTYPE root [ <!ENTITY e SYSTEM 'subdir/myentity.ent' ]> 105 * <root> &e; </root></pre> 106 * And <code>subdir/myentity.ent</code> 107 * contains: 108 * <pre><one> <two/> </one> <?pi 3.14159?> 109 * <more/></pre> 110 * </dd> 111 * <dt><code>"unbound-prefix-in-entity" [warning]</code></dt> 112 * <dd> An 113 * implementation dependent warning that may be raised if the configuration 114 * parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-namespaces'> 115 * namespaces</a>" is set to <code>true</code> and an unbound namespace prefix is 116 * encountered in an entity's replacement text. Raising this warning is not 117 * enforced since some existing parsers may not recognize unbound namespace 118 * prefixes in the replacement text of entities. </dd> 119 * <dt> 120 * <code>"unknown-character-denormalization" [fatal]</code></dt> 121 * <dd> Raised if the 122 * configuration parameter "ignore-unknown-character-denormalizations" is 123 * set to <code>false</code> and a character is encountered for which the 124 * processor cannot determine the normalization properties. </dd> 125 * <dt> 126 * <code>"unsupported-encoding" [fatal]</code></dt> 127 * <dd> Raised if an unsupported 128 * encoding is encountered. </dd> 129 * <dt><code>"unsupported-media-type" [fatal]</code></dt> 130 * <dd> 131 * Raised if the configuration parameter "supported-media-types-only" is set 132 * to <code>true</code> and an unsupported media type is encountered. </dd> 133 * </dl> 134 * <p> In addition to raising the defined errors and warnings, implementations 135 * are expected to raise implementation specific errors and warnings for any 136 * other error and warning cases such as IO errors (file not found, 137 * permission denied,...), XML well-formedness errors, and so on. 138 * <p>See also the <a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-LS-20040407'>Document Object Model (DOM) Level 3 Load 139 and Save Specification</a>. 140 */ 141 public interface LSParser { 142 /** 143 * The <code>DOMConfiguration</code> object used when parsing an input 144 * source. This <code>DOMConfiguration</code> is specific to the parse 145 * operation. No parameter values from this <code>DOMConfiguration</code> 146 * object are passed automatically to the <code>DOMConfiguration</code> 147 * object on the <code>Document</code> that is created, or used, by the 148 * parse operation. The DOM application is responsible for passing any 149 * needed parameter values from this <code>DOMConfiguration</code> 150 * object to the <code>DOMConfiguration</code> object referenced by the 151 * <code>Document</code> object. 152 * <br> In addition to the parameters recognized in on the <a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#DOMConfiguration'> 153 * DOMConfiguration</a> interface defined in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] 154 * , the <code>DOMConfiguration</code> objects for <code>LSParser</code> 155 * add or modify the following parameters: 156 * <dl> 157 * <dt> 158 * <code>"charset-overrides-xml-encoding"</code></dt> 159 * <dd> 160 * <dl> 161 * <dt><code>true</code></dt> 162 * <dd>[<em>optional</em>] (<em>default</em>) If a higher level protocol such as HTTP [<a href='http://www.ietf.org/rfc/rfc2616.txt'>IETF RFC 2616</a>] provides an 163 * indication of the character encoding of the input stream being 164 * processed, that will override any encoding specified in the XML 165 * declaration or the Text declaration (see also section 4.3.3, 166 * "Character Encoding in Entities", in [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]). 167 * Explicitly setting an encoding in the <code>LSInput</code> overrides 168 * any encoding from the protocol. </dd> 169 * <dt><code>false</code></dt> 170 * <dd>[<em>required</em>] The parser ignores any character set encoding information from 171 * higher-level protocols. </dd> 172 * </dl></dd> 173 * <dt><code>"disallow-doctype"</code></dt> 174 * <dd> 175 * <dl> 176 * <dt> 177 * <code>true</code></dt> 178 * <dd>[<em>optional</em>] Throw a fatal <b>"doctype-not-allowed"</b> error if a doctype node is found while parsing the document. This is 179 * useful when dealing with things like SOAP envelopes where doctype 180 * nodes are not allowed. </dd> 181 * <dt><code>false</code></dt> 182 * <dd>[<em>required</em>] (<em>default</em>) Allow doctype nodes in the document. </dd> 183 * </dl></dd> 184 * <dt> 185 * <code>"ignore-unknown-character-denormalizations"</code></dt> 186 * <dd> 187 * <dl> 188 * <dt> 189 * <code>true</code></dt> 190 * <dd>[<em>required</em>] (<em>default</em>) If, while verifying full normalization when [<a href='http://www.w3.org/TR/2004/REC-xml11-20040204/'>XML 1.1</a>] is 191 * supported, a processor encounters characters for which it cannot 192 * determine the normalization properties, then the processor will 193 * ignore any possible denormalizations caused by these characters. 194 * This parameter is ignored for [<a href='http://www.w3.org/TR/2004/REC-xml-20040204'>XML 1.0</a>]. </dd> 195 * <dt> 196 * <code>false</code></dt> 197 * <dd>[<em>optional</em>] Report an fatal <b>"unknown-character-denormalization"</b> error if a character is encountered for which the processor cannot 198 * determine the normalization properties. </dd> 199 * </dl></dd> 200 * <dt><code>"infoset"</code></dt> 201 * <dd> See 202 * the definition of <code>DOMConfiguration</code> for a description of 203 * this parameter. Unlike in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] 204 * , this parameter will default to <code>true</code> for 205 * <code>LSParser</code>. </dd> 206 * <dt><code>"namespaces"</code></dt> 207 * <dd> 208 * <dl> 209 * <dt><code>true</code></dt> 210 * <dd>[<em>required</em>] (<em>default</em>) Perform the namespace processing as defined in [<a href='http://www.w3.org/TR/1999/REC-xml-names-19990114/'>XML Namespaces</a>] 211 * and [<a href='http://www.w3.org/TR/2004/REC-xml-names11-20040204/'>XML Namespaces 1.1</a>] 212 * . </dd> 213 * <dt><code>false</code></dt> 214 * <dd>[<em>optional</em>] Do not perform the namespace processing. </dd> 215 * </dl></dd> 216 * <dt> 217 * <code>"resource-resolver"</code></dt> 218 * <dd>[<em>required</em>] A reference to a <code>LSResourceResolver</code> object, or null. If 219 * the value of this parameter is not null when an external resource 220 * (such as an external XML entity or an XML schema location) is 221 * encountered, the implementation will request that the 222 * <code>LSResourceResolver</code> referenced in this parameter resolves 223 * the resource. </dd> 224 * <dt><code>"supported-media-types-only"</code></dt> 225 * <dd> 226 * <dl> 227 * <dt> 228 * <code>true</code></dt> 229 * <dd>[<em>optional</em>] Check that the media type of the parsed resource is a supported media 230 * type. If an unsupported media type is encountered, a fatal error of 231 * type <b>"unsupported-media-type"</b> will be raised. The media types defined in [<a href='http://www.ietf.org/rfc/rfc3023.txt'>IETF RFC 3023</a>] must always 232 * be accepted. </dd> 233 * <dt><code>false</code></dt> 234 * <dd>[<em>required</em>] (<em>default</em>) Accept any media type. </dd> 235 * </dl></dd> 236 * <dt><code>"validate"</code></dt> 237 * <dd> See the definition of 238 * <code>DOMConfiguration</code> for a description of this parameter. 239 * Unlike in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] 240 * , the processing of the internal subset is always accomplished, even 241 * if this parameter is set to <code>false</code>. </dd> 242 * <dt> 243 * <code>"validate-if-schema"</code></dt> 244 * <dd> See the definition of 245 * <code>DOMConfiguration</code> for a description of this parameter. 246 * Unlike in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] 247 * , the processing of the internal subset is always accomplished, even 248 * if this parameter is set to <code>false</code>. </dd> 249 * <dt> 250 * <code>"well-formed"</code></dt> 251 * <dd> See the definition of 252 * <code>DOMConfiguration</code> for a description of this parameter. 253 * Unlike in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] 254 * , this parameter cannot be set to <code>false</code>. </dd> 255 * </dl> 256 */ getDomConfig()257 public DOMConfiguration getDomConfig(); 258 259 /** 260 * When a filter is provided, the implementation will call out to the 261 * filter as it is constructing the DOM tree structure. The filter can 262 * choose to remove elements from the document being constructed, or to 263 * terminate the parsing early. 264 * <br> The filter is invoked after the operations requested by the 265 * <code>DOMConfiguration</code> parameters have been applied. For 266 * example, if "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-validate'> 267 * validate</a>" is set to <code>true</code>, the validation is done before invoking the 268 * filter. 269 */ getFilter()270 public LSParserFilter getFilter(); 271 /** 272 * When a filter is provided, the implementation will call out to the 273 * filter as it is constructing the DOM tree structure. The filter can 274 * choose to remove elements from the document being constructed, or to 275 * terminate the parsing early. 276 * <br> The filter is invoked after the operations requested by the 277 * <code>DOMConfiguration</code> parameters have been applied. For 278 * example, if "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-validate'> 279 * validate</a>" is set to <code>true</code>, the validation is done before invoking the 280 * filter. 281 */ setFilter(LSParserFilter filter)282 public void setFilter(LSParserFilter filter); 283 284 /** 285 * <code>true</code> if the <code>LSParser</code> is asynchronous, 286 * <code>false</code> if it is synchronous. 287 */ getAsync()288 public boolean getAsync(); 289 290 /** 291 * <code>true</code> if the <code>LSParser</code> is currently busy 292 * loading a document, otherwise <code>false</code>. 293 */ getBusy()294 public boolean getBusy(); 295 296 /** 297 * Parse an XML document from a resource identified by a 298 * <code>LSInput</code>. 299 * @param input The <code>LSInput</code> from which the source of the 300 * document is to be read. 301 * @return If the <code>LSParser</code> is a synchronous 302 * <code>LSParser</code>, the newly created and populated 303 * <code>Document</code> is returned. If the <code>LSParser</code> is 304 * asynchronous, <code>null</code> is returned since the document 305 * object may not yet be constructed when this method returns. 306 * @exception DOMException 307 * INVALID_STATE_ERR: Raised if the <code>LSParser</code>'s 308 * <code>LSParser.busy</code> attribute is <code>true</code>. 309 * @exception LSException 310 * PARSE_ERR: Raised if the <code>LSParser</code> was unable to load 311 * the XML document. DOM applications should attach a 312 * <code>DOMErrorHandler</code> using the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> 313 * error-handler</a>" if they wish to get details on the error. 314 */ parse(LSInput input)315 public Document parse(LSInput input) 316 throws DOMException, LSException; 317 318 /** 319 * Parse an XML document from a location identified by a URI reference [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]. If the URI 320 * contains a fragment identifier (see section 4.1 in [<a href='http://www.ietf.org/rfc/rfc2396.txt'>IETF RFC 2396</a>]), the 321 * behavior is not defined by this specification, future versions of 322 * this specification may define the behavior. 323 * @param uri The location of the XML document to be read. 324 * @return If the <code>LSParser</code> is a synchronous 325 * <code>LSParser</code>, the newly created and populated 326 * <code>Document</code> is returned, or <code>null</code> if an error 327 * occured. If the <code>LSParser</code> is asynchronous, 328 * <code>null</code> is returned since the document object may not yet 329 * be constructed when this method returns. 330 * @exception DOMException 331 * INVALID_STATE_ERR: Raised if the <code>LSParser.busy</code> 332 * attribute is <code>true</code>. 333 * @exception LSException 334 * PARSE_ERR: Raised if the <code>LSParser</code> was unable to load 335 * the XML document. DOM applications should attach a 336 * <code>DOMErrorHandler</code> using the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> 337 * error-handler</a>" if they wish to get details on the error. 338 */ parseURI(String uri)339 public Document parseURI(String uri) 340 throws DOMException, LSException; 341 342 // ACTION_TYPES 343 /** 344 * Append the result of the parse operation as children of the context 345 * node. For this action to work, the context node must be an 346 * <code>Element</code> or a <code>DocumentFragment</code>. 347 */ 348 public static final short ACTION_APPEND_AS_CHILDREN = 1; 349 /** 350 * Replace all the children of the context node with the result of the 351 * parse operation. For this action to work, the context node must be an 352 * <code>Element</code>, a <code>Document</code>, or a 353 * <code>DocumentFragment</code>. 354 */ 355 public static final short ACTION_REPLACE_CHILDREN = 2; 356 /** 357 * Insert the result of the parse operation as the immediately preceding 358 * sibling of the context node. For this action to work the context 359 * node's parent must be an <code>Element</code> or a 360 * <code>DocumentFragment</code>. 361 */ 362 public static final short ACTION_INSERT_BEFORE = 3; 363 /** 364 * Insert the result of the parse operation as the immediately following 365 * sibling of the context node. For this action to work the context 366 * node's parent must be an <code>Element</code> or a 367 * <code>DocumentFragment</code>. 368 */ 369 public static final short ACTION_INSERT_AFTER = 4; 370 /** 371 * Replace the context node with the result of the parse operation. For 372 * this action to work, the context node must have a parent, and the 373 * parent must be an <code>Element</code> or a 374 * <code>DocumentFragment</code>. 375 */ 376 public static final short ACTION_REPLACE = 5; 377 378 /** 379 * Parse an XML fragment from a resource identified by a 380 * <code>LSInput</code> and insert the content into an existing document 381 * at the position specified with the <code>context</code> and 382 * <code>action</code> arguments. When parsing the input stream, the 383 * context node (or its parent, depending on where the result will be 384 * inserted) is used for resolving unbound namespace prefixes. The 385 * context node's <code>ownerDocument</code> node (or the node itself if 386 * the node of type <code>DOCUMENT_NODE</code>) is used to resolve 387 * default attributes and entity references. 388 * <br> As the new data is inserted into the document, at least one 389 * mutation event is fired per new immediate child or sibling of the 390 * context node. 391 * <br> If the context node is a <code>Document</code> node and the action 392 * is <code>ACTION_REPLACE_CHILDREN</code>, then the document that is 393 * passed as the context node will be changed such that its 394 * <code>xmlEncoding</code>, <code>documentURI</code>, 395 * <code>xmlVersion</code>, <code>inputEncoding</code>, 396 * <code>xmlStandalone</code>, and all other such attributes are set to 397 * what they would be set to if the input source was parsed using 398 * <code>LSParser.parse()</code>. 399 * <br> This method is always synchronous, even if the 400 * <code>LSParser</code> is asynchronous (<code>LSParser.async</code> is 401 * <code>true</code>). 402 * <br> If an error occurs while parsing, the caller is notified through 403 * the <code>ErrorHandler</code> instance associated with the "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> 404 * error-handler</a>" parameter of the <code>DOMConfiguration</code>. 405 * <br> When calling <code>parseWithContext</code>, the values of the 406 * following configuration parameters will be ignored and their default 407 * values will always be used instead: "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-validate'> 408 * validate</a>", "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-validate-if-schema'> 409 * validate-if-schema</a>", and "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-element-content-whitespace'> 410 * element-content-whitespace</a>". Other parameters will be treated normally, and the parser is expected 411 * to call the <code>LSParserFilter</code> just as if a whole document 412 * was parsed. 413 * @param input The <code>LSInput</code> from which the source document 414 * is to be read. The source document must be an XML fragment, i.e. 415 * anything except a complete XML document (except in the case where 416 * the context node of type <code>DOCUMENT_NODE</code>, and the action 417 * is <code>ACTION_REPLACE_CHILDREN</code>), a DOCTYPE (internal 418 * subset), entity declaration(s), notation declaration(s), or XML or 419 * text declaration(s). 420 * @param contextArg The node that is used as the context for the data 421 * that is being parsed. This node must be a <code>Document</code> 422 * node, a <code>DocumentFragment</code> node, or a node of a type 423 * that is allowed as a child of an <code>Element</code> node, e.g. it 424 * cannot be an <code>Attribute</code> node. 425 * @param action This parameter describes which action should be taken 426 * between the new set of nodes being inserted and the existing 427 * children of the context node. The set of possible actions is 428 * defined in <code>ACTION_TYPES</code> above. 429 * @return Return the node that is the result of the parse operation. If 430 * the result is more than one top-level node, the first one is 431 * returned. 432 * @exception DOMException 433 * HIERARCHY_REQUEST_ERR: Raised if the content cannot replace, be 434 * inserted before, after, or as a child of the context node (see also 435 * <code>Node.insertBefore</code> or <code>Node.replaceChild</code> in [<a href='http://www.w3.org/TR/2004/REC-DOM-Level-3-Core-20040407'>DOM Level 3 Core</a>] 436 * ). 437 * <br> NOT_SUPPORTED_ERR: Raised if the <code>LSParser</code> doesn't 438 * support this method, or if the context node is of type 439 * <code>Document</code> and the DOM implementation doesn't support 440 * the replacement of the <code>DocumentType</code> child or 441 * <code>Element</code> child. 442 * <br> NO_MODIFICATION_ALLOWED_ERR: Raised if the context node is a 443 * read only node and the content is being appended to its child list, 444 * or if the parent node of the context node is read only node and the 445 * content is being inserted in its child list. 446 * <br> INVALID_STATE_ERR: Raised if the <code>LSParser.busy</code> 447 * attribute is <code>true</code>. 448 * @exception LSException 449 * PARSE_ERR: Raised if the <code>LSParser</code> was unable to load 450 * the XML fragment. DOM applications should attach a 451 * <code>DOMErrorHandler</code> using the parameter "<a href='http://www.w3.org/TR/DOM-Level-3-Core/core.html#parameter-error-handler'> 452 * error-handler</a>" if they wish to get details on the error. 453 */ parseWithContext(LSInput input, Node contextArg, short action)454 public Node parseWithContext(LSInput input, 455 Node contextArg, 456 short action) 457 throws DOMException, LSException; 458 459 /** 460 * Abort the loading of the document that is currently being loaded by 461 * the <code>LSParser</code>. If the <code>LSParser</code> is currently 462 * not busy, a call to this method does nothing. 463 */ abort()464 public void abort(); 465 466 } 467