001: /*--
002:
003: $Id: XML4JDOMAdapter.java,v 1.1 2005/04/27 09:32:42 wittek Exp $
004:
005: Copyright (C) 2000-2004 Jason Hunter & Brett McLaughlin.
006: All rights reserved.
007:
008: Redistribution and use in source and binary forms, with or without
009: modification, are permitted provided that the following conditions
010: are met:
011:
012: 1. Redistributions of source code must retain the above copyright
013: notice, this list of conditions, and the following disclaimer.
014:
015: 2. Redistributions in binary form must reproduce the above copyright
016: notice, this list of conditions, and the disclaimer that follows
017: these conditions in the documentation and/or other materials
018: provided with the distribution.
019:
020: 3. The name "JDOM" must not be used to endorse or promote products
021: derived from this software without prior written permission. For
022: written permission, please contact <request_AT_jdom_DOT_org>.
023:
024: 4. Products derived from this software may not be called "JDOM", nor
025: may "JDOM" appear in their name, without prior written permission
026: from the JDOM Project Management <request_AT_jdom_DOT_org>.
027:
028: In addition, we request (but do not require) that you include in the
029: end-user documentation provided with the redistribution and/or in the
030: software itself an acknowledgement equivalent to the following:
031: "This product includes software developed by the
032: JDOM Project (http://www.jdom.org/)."
033: Alternatively, the acknowledgment may be graphical using the logos
034: available at http://www.jdom.org/images/logos.
035:
036: THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
037: WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
038: OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
039: DISCLAIMED. IN NO EVENT SHALL THE JDOM AUTHORS OR THE PROJECT
040: CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
041: SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
042: LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
043: USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
044: ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
045: OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
046: OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
047: SUCH DAMAGE.
048:
049: This software consists of voluntary contributions made by many
050: individuals on behalf of the JDOM Project and was originally
051: created by Jason Hunter <jhunter_AT_jdom_DOT_org> and
052: Brett McLaughlin <brett_AT_jdom_DOT_org>. For more information
053: on the JDOM Project, please see <http://www.jdom.org/>.
054:
055: */
056:
057: package org.jdom.adapters;
058:
059: import java.io.*;
060: import java.lang.reflect.*;
061:
062: import org.jdom.*;
063: import org.jdom.input.*;
064: import org.w3c.dom.Document;
065: import org.xml.sax.*;
066:
067: /**
068: * An adapter for the IBM XML4J DOM parser.
069: *
070: * @version $Revision: 1.1 $, $Date: 2005/04/27 09:32:42 $
071: * @author Brett McLaughlin
072: * @author Jason Hunter
073: */
074: public class XML4JDOMAdapter extends AbstractDOMAdapter {
075:
076: private static final String CVS_ID = "@(#) $RCSfile: XML4JDOMAdapter.java,v $ $Revision: 1.1 $ $Date: 2005/04/27 09:32:42 $ $Name: $";
077:
078: /**
079: * This creates a new <code>{@link Document}</code> from an
080: * existing <code>InputStream</code> by letting a DOM
081: * parser handle parsing using the supplied stream.
082: *
083: * @param in <code>InputStream</code> to parse.
084: * @param validate <code>boolean</code> to indicate if validation should occur.
085: * @return <code>Document</code> - instance ready for use.
086: * @throws IOException when I/O error occurs.
087: * @throws JDOMException when errors occur in parsing.
088: */
089: public Document getDocument(InputStream in, boolean validate)
090: throws IOException, JDOMException {
091:
092: try {
093: /*
094: * IBM XML4J actually uses the Xerces parser, so this is
095: * all Xerces specific code.
096: */
097:
098: // Load the parser class
099: Class parserClass = Class
100: .forName("org.apache.xerces.parsers.DOMParser");
101: Object parser = parserClass.newInstance();
102:
103: // Set validation
104: Method setFeature = parserClass
105: .getMethod("setFeature", new Class[] {
106: java.lang.String.class, boolean.class });
107: setFeature.invoke(parser, new Object[] {
108: "http://xml.org/sax/features/validation",
109: new Boolean(validate) });
110:
111: // Set namespaces
112: setFeature.invoke(parser, new Object[] {
113: "http://xml.org/sax/features/namespaces",
114: new Boolean(false) });
115:
116: // Set the error handler
117: if (validate) {
118: Method setErrorHandler = parserClass.getMethod(
119: "setErrorHandler",
120: new Class[] { ErrorHandler.class });
121: setErrorHandler.invoke(parser,
122: new Object[] { new BuilderErrorHandler() });
123: }
124:
125: // Parse the document
126: Method parse = parserClass.getMethod("parse",
127: new Class[] { org.xml.sax.InputSource.class });
128: parse.invoke(parser, new Object[] { new InputSource(in) });
129:
130: // Get the Document object
131: Method getDocument = parserClass.getMethod("getDocument",
132: null);
133: Document doc = (Document) getDocument.invoke(parser, null);
134:
135: return doc;
136: } catch (InvocationTargetException e) {
137: Throwable targetException = e.getTargetException();
138: if (targetException instanceof org.xml.sax.SAXParseException) {
139: SAXParseException parseException = (SAXParseException) targetException;
140: throw new JDOMException("Error on line "
141: + parseException.getLineNumber()
142: + " of XML document: "
143: + parseException.getMessage(), parseException);
144: } else if (targetException instanceof IOException) {
145: IOException ioException = (IOException) targetException;
146: throw ioException;
147: } else {
148: throw new JDOMException(targetException.getMessage(),
149: targetException);
150: }
151: } catch (Exception e) {
152: throw new JDOMException(e.getClass().getName() + ": "
153: + e.getMessage(), e);
154: }
155: }
156:
157: /**
158: * This creates an empty <code>Document</code> object based
159: * on a specific parser implementation.
160: *
161: * @return <code>Document</code> - created DOM Document.
162: * @throws JDOMException when errors occur.
163: */
164: public Document createDocument() throws JDOMException {
165: try {
166: return (Document) Class.forName(
167: "org.apache.xerces.dom.DocumentImpl").newInstance();
168:
169: } catch (Exception e) {
170: throw new JDOMException(e.getClass().getName() + ": "
171: + e.getMessage() + " while creating document", e);
172: }
173: }
174: }
|