com.topologi.diffx.xml.XMLHelper Maven / Gradle / Ivy
Show all versions of docx4j Show documentation
/*
* This file is part of the DiffX library.
*
* For licensing information please see the file license.txt included in the release.
* A copy of this licence can also be found at
* http://www.opensource.org/licenses/artistic-license-2.0.php
*/
package com.topologi.diffx.xml;
import java.io.BufferedInputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import javax.xml.parsers.ParserConfigurationException;
import javax.xml.parsers.SAXParserFactory;
import org.xml.sax.ContentHandler;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import org.xml.sax.XMLReader;
/**
* Utility class that provides common XML operations so that the calling class uses lighter
* code.
*
* Most methdos in this implementation will forward the exceptions should occur, so they
* will have to be handled externally.
*
* @author Christophe Lauret - Allette Systems (Australia)
* @version 1.0, 6 May 2004
*/
public final class XMLHelper {
/**
* Prevents creation of instances.
*/
private XMLHelper() {
}
/**
* Creates a non-validating, non-namespace-aware {@link XMLReader} using the specified
* {@link ContentHandler}.
*
*
If the given {@link ContentHandler} is null, the {@link XMLReader} is
* not initialised.
*
* @param handler The content handler to use.
*
* @return The requested {@link XMLReader}
*
* @throws SAXException Should a SAX exception occur
* @throws ParserConfigurationException Should a parser config exception occur
*/
public static XMLReader makeXMLReader(ContentHandler handler)
throws SAXException, ParserConfigurationException {
SAXParserFactory factory = SAXParserFactory.newInstance();
factory.setNamespaceAware(false);
factory.setValidating(false);
XMLReader reader = factory.newSAXParser().getXMLReader();
if (handler != null) {
reader.setContentHandler(handler);
}
return reader;
}
/**
* Parses the given {@link File} with the specified {@link XMLReader}.
*
*
This method assumes the XML is in 'UTF-8', it will not sniff the XML to
* determine the encoding to use.
*
* @param xmlreader The XML reader to use.
* @param file The file to parse
*
* @throws FileNotFoundException If the file does not exists
* @throws SAXException Should an SAX exception occur
* @throws IOException Should an I/O exception occur
*/
public static void parse(XMLReader xmlreader, File file)
throws FileNotFoundException, SAXException, IOException {
// create the input source
InputStream bin = new BufferedInputStream(new FileInputStream(file));
Reader reader = new InputStreamReader(bin, "utf-8");
InputSource source = new InputSource(reader);
// parse the file
xmlreader.parse(source);
reader.close();
}
}