annotate NGSrich_0.5.5/src/org/jdom/adapters/XML4JDOMAdapter.java @ 0:89ad0a9cca52 default tip

Uploaded
author pfrommolt
date Mon, 21 Nov 2011 08:12:19 -0500
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
1 /*--
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
2
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
3 $Id: XML4JDOMAdapter.java,v 1.18 2007/11/10 05:28:59 jhunter Exp $
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
4
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
5 Copyright (C) 2000-2007 Jason Hunter & Brett McLaughlin.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
6 All rights reserved.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
7
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
8 Redistribution and use in source and binary forms, with or without
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
9 modification, are permitted provided that the following conditions
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
10 are met:
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
11
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
12 1. Redistributions of source code must retain the above copyright
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
13 notice, this list of conditions, and the following disclaimer.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
14
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
15 2. Redistributions in binary form must reproduce the above copyright
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
16 notice, this list of conditions, and the disclaimer that follows
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
17 these conditions in the documentation and/or other materials
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
18 provided with the distribution.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
19
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
20 3. The name "JDOM" must not be used to endorse or promote products
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
21 derived from this software without prior written permission. For
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
22 written permission, please contact <request_AT_jdom_DOT_org>.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
23
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
24 4. Products derived from this software may not be called "JDOM", nor
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
25 may "JDOM" appear in their name, without prior written permission
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
26 from the JDOM Project Management <request_AT_jdom_DOT_org>.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
27
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
28 In addition, we request (but do not require) that you include in the
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
29 end-user documentation provided with the redistribution and/or in the
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
30 software itself an acknowledgement equivalent to the following:
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
31 "This product includes software developed by the
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
32 JDOM Project (http://www.jdom.org/)."
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
33 Alternatively, the acknowledgment may be graphical using the logos
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
34 available at http://www.jdom.org/images/logos.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
35
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
36 THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
37 WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
38 OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
39 DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
40 CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
41 SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
42 LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
43 USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
44 ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
45 OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
46 OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
47 SUCH DAMAGE.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
48
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
49 This software consists of voluntary contributions made by many
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
50 individuals on behalf of the JDOM Project and was originally
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
51 created by Jason Hunter <jhunter_AT_jdom_DOT_org> and
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
52 Brett McLaughlin <brett_AT_jdom_DOT_org>. For more information
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
53 on the JDOM Project, please see <http://www.jdom.org/>.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
54
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
55 */
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
56
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
57 package org.jdom.adapters;
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
58
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
59 import java.io.*;
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
60 import java.lang.reflect.*;
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
61
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
62 import org.jdom.*;
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
63 import org.jdom.input.*;
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
64 import org.w3c.dom.Document;
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
65 import org.xml.sax.*;
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
66
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
67 /**
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
68 * An adapter for the IBM XML4J DOM parser.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
69 *
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
70 * @version $Revision: 1.18 $, $Date: 2007/11/10 05:28:59 $
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
71 * @author Brett McLaughlin
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
72 * @author Jason Hunter
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
73 */
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
74 public class XML4JDOMAdapter extends AbstractDOMAdapter {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
75
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
76 private static final String CVS_ID =
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
77 "@(#) $RCSfile: XML4JDOMAdapter.java,v $ $Revision: 1.18 $ $Date: 2007/11/10 05:28:59 $ $Name: jdom_1_1_1 $";
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
78
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
79 /**
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
80 * This creates a new <code>{@link Document}</code> from an
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
81 * existing <code>InputStream</code> by letting a DOM
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
82 * parser handle parsing using the supplied stream.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
83 *
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
84 * @param in <code>InputStream</code> to parse.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
85 * @param validate <code>boolean</code> to indicate if validation should occur.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
86 * @return <code>Document</code> - instance ready for use.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
87 * @throws IOException when I/O error occurs.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
88 * @throws JDOMException when errors occur in parsing.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
89 */
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
90 public Document getDocument(InputStream in, boolean validate)
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
91 throws IOException, JDOMException {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
92
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
93 try {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
94 /*
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
95 * IBM XML4J actually uses the Xerces parser, so this is
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
96 * all Xerces specific code.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
97 */
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
98
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
99 // Load the parser class
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
100 Class parserClass = Class.forName("org.apache.xerces.parsers.DOMParser");
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
101 Object parser = parserClass.newInstance();
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
102
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
103 // Set validation
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
104 Method setFeature =
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
105 parserClass.getMethod("setFeature",
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
106 new Class[] {java.lang.String.class,
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
107 boolean.class});
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
108 setFeature.invoke(parser, new Object[] {"http://xml.org/sax/features/validation",
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
109 new Boolean(validate)});
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
110
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
111 // Set namespaces
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
112 setFeature.invoke(parser, new Object[] {"http://xml.org/sax/features/namespaces",
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
113 new Boolean(false)});
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
114
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
115 // Set the error handler
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
116 if (validate) {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
117 Method setErrorHandler =
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
118 parserClass.getMethod("setErrorHandler",
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
119 new Class[] {ErrorHandler.class});
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
120 setErrorHandler.invoke(parser, new Object[] {new BuilderErrorHandler()});
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
121 }
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
122
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
123 // Parse the document
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
124 Method parse =
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
125 parserClass.getMethod("parse",
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
126 new Class[] {org.xml.sax.InputSource.class});
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
127 parse.invoke(parser, new Object[]{new InputSource(in)});
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
128
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
129 // Get the Document object
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
130 Method getDocument = parserClass.getMethod("getDocument", null);
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
131 Document doc = (Document)getDocument.invoke(parser, null);
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
132
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
133 return doc;
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
134 } catch (InvocationTargetException e) {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
135 Throwable targetException = e.getTargetException();
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
136 if (targetException instanceof org.xml.sax.SAXParseException) {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
137 SAXParseException parseException = (SAXParseException)targetException;
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
138 throw new JDOMException("Error on line " + parseException.getLineNumber() +
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
139 " of XML document: " + parseException.getMessage(), parseException);
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
140 } else if (targetException instanceof IOException) {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
141 IOException ioException = (IOException) targetException;
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
142 throw ioException;
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
143 } else {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
144 throw new JDOMException(targetException.getMessage(), targetException);
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
145 }
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
146 } catch (Exception e) {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
147 throw new JDOMException(e.getClass().getName() + ": " +
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
148 e.getMessage(), e);
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
149 }
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
150 }
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
151
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
152 /**
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
153 * This creates an empty <code>Document</code> object based
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
154 * on a specific parser implementation.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
155 *
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
156 * @return <code>Document</code> - created DOM Document.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
157 * @throws JDOMException when errors occur.
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
158 */
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
159 public Document createDocument() throws JDOMException {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
160 try {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
161 return
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
162 (Document)Class.forName(
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
163 "org.apache.xerces.dom.DocumentImpl")
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
164 .newInstance();
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
165
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
166 } catch (Exception e) {
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
167 throw new JDOMException(e.getClass().getName() + ": " +
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
168 e.getMessage() + " while creating document", e);
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
169 }
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
170 }
89ad0a9cca52 Uploaded
pfrommolt
parents:
diff changeset
171 }