|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-77ECD89F-84BB-55F1-9876-382E043F0C0D" xml:lang="en"><title>XML |
|
13 Error Handling Reference</title><shortdesc>This section describes how the different components dealing with |
|
14 XML manage error conditions. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
15 <p>In all cases, ensure that your XML is valid and well-formed when using |
|
16 one of the parsers below. </p> |
|
17 <p> <b>libxml2 component</b> </p> |
|
18 <p>The libxml2 C library has its own error codes and returns <codeph>NULL</codeph> pointers |
|
19 in Out-Of-Memory conditions. It also stores the last parsing error in a member |
|
20 of the global <codeph>_xmlGlobalState</codeph> structure. Access this variable |
|
21 using TLS (Thread-Local Storage). </p> |
|
22 <p>The methods of the Utilities wrapper leave when they detect an Out-Of-Memory |
|
23 condition in the libxml2 library. </p> |
|
24 <p> <b>XML DOM Engine</b> </p> |
|
25 <p>When calling a method of the XML DOM Engine, check its return value for |
|
26 an error code. </p> |
|
27 <p>Methods that leave do so in Out-Of-Memory conditions. Methods that read |
|
28 or write files also leave on I/O errors. </p> |
|
29 <p> <b>XML DOM Engine Serialiser</b> </p> |
|
30 <p>The serialiser does not forward all the libxml2 errors and may leave with |
|
31 the Symbian platform mechanism instead. </p> |
|
32 <p> <b>XML Framework</b> </p> |
|
33 <p>The libxml2 SAX plugin maps the errors received from the libxml2 parser |
|
34 to parsing events. The leave mechanism only applies when the error is fatal |
|
35 for the libxml2 parser. </p> |
|
36 <p>The Expat and WBXML parser plugins use a combination of parsing events |
|
37 and leaves to handle errors. </p> |
|
38 </conbody><related-links> |
|
39 <link href="GUID-33D50AB9-AFA8-521F-8A85-031C24EA7D25.dita"><linktext>libxml2</linktext> |
|
40 </link> |
|
41 <link href="GUID-5ACFA8E4-3C4B-5851-A43E-9FA72D0B8403.dita"><linktext>XML DOM Engine</linktext> |
|
42 </link> |
|
43 <link href="GUID-F79E4F18-19E2-577E-8409-8B82BD48AC66.dita"><linktext>XML Framework</linktext> |
|
44 </link> |
|
45 </related-links></concept> |