net.sf.practicalxml

Class ParseUtil

java.lang.Object

net.sf.practicalxml.ParseUtil

public class ParseUtil
extends Object

A collection of static methods for parsing XML into a DOM, with or without validation.

Constructor Summary

Constructors

Constructor and Description
ParseUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static Document	parse(File file) Parses a file using a namespace-aware, non-validating parser.
static Document	parse(InputSource source) Parses the supplied source with a namespace-aware, non-validating parser, using the built-in error handler that throws on parse errors and ignores warnings.
static Document	parse(InputSource source, ErrorHandler errHandler) Parses the supplied source with a namespace-aware, non-validating parser, using a caller-supplied error handler.
static Document	parse(InputStream in) Parses the supplied source with a namespace-aware, non-validating parser, using the built-in error handler that throws on parse errors and ignores warnings.
static Document	parse(String xml) Parses a string containing XML, using a namespace-aware, non-validating parser.
static Document	parseFromClasspath(String resourcePath) Parses a resource loaded from the classpath, using the current thread's context classloader, and a default error handler.
static Document	parseFromClasspath(String resourcePath, Class<?> klass) Parses a resource loaded from the classpath, using the classloader associated with the specified class, and a default error handler.
static Document	parseFromClasspath(String resourcePath, Class<?> klass, ErrorHandler errorHandler) Parses a resource loaded from the classpath, using the classloader associated with the specified class, and the specified error handler.
static Document	parseFromClasspath(String resourcePath, ErrorHandler errorHandler) Parses a resource loaded from the classpath, using the current thread's context classloader, and a specified error handler.
static Document	validatingParse(InputSource source, EntityResolver resolver, ErrorHandler errHandler) Parses the supplied source with a namespace-aware, DTD-validating parser, using a caller-supplied error handler and entity resolver.
static Document	validatingParse(InputSource source, ErrorHandler errHandler) Parses the supplied source with a namespace-aware, DTD-validating parser, using a caller-supplied error handler and default entity resolver.
static Document	validatingParse(InputSource source, Schema schema, ErrorHandler errHandler) Parses the supplied source with a namespace-aware, XSD-validating parser, using a caller-supplied error handler and entity resolver.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ParseUtil

public ParseUtil()

Method Detail

parse

public static Document parse(InputSource source,
             ErrorHandler errHandler)

Parses the supplied source with a namespace-aware, non-validating parser, using a caller-supplied error handler.

Throws:

XmlException - for any configuration or fatal execution error.

parse

public static Document parse(InputSource source)

Parses the supplied source with a namespace-aware, non-validating parser, using the built-in error handler that throws on parse errors and ignores warnings.

Throws:

XmlException - for any configuration or execution error.

parse

public static Document parse(InputStream in)

Parses the supplied source with a namespace-aware, non-validating parser, using the built-in error handler that throws on parse errors and ignores warnings. Closes the stream after parsing is complete.

Throws:

XmlException - for any configuration or execution error, including IOException

Since:

1.1.18

parse

public static Document parse(String xml)

Parses a string containing XML, using a namespace-aware, non-validating parser. Note that this ignores any encoding specification in the prologue; if you read the string from a file, make sure that you used the correct encoding.

Throws:

XmlException - for any configuration or execution error.

parse

public static Document parse(File file)

Parses a file using a namespace-aware, non-validating parser. Ensures that there are no dangling FileInputStreams for the finalizer to close.

Throws:

XmlException - for any error, including file-not-found.

Since:

1.1.11

validatingParse

public static Document validatingParse(InputSource source,
                       EntityResolver resolver,
                       ErrorHandler errHandler)

Parses the supplied source with a namespace-aware, DTD-validating parser, using a caller-supplied error handler and entity resolver. Both of these objects may be null, to use the built-in defaults.

Throws:

XmlException - for any configuration or fatal execution error.

validatingParse

public static Document validatingParse(InputSource source,
                       ErrorHandler errHandler)

Parses the supplied source with a namespace-aware, DTD-validating parser, using a caller-supplied error handler and default entity resolver. This is useful when the DTD is publicly accessible.

Throws:

XmlException - for any configuration or fatal execution error.

validatingParse

public static Document validatingParse(InputSource source,
                       Schema schema,
                       ErrorHandler errHandler)

Parses the supplied source with a namespace-aware, XSD-validating parser, using a caller-supplied error handler and entity resolver. Both of these objects may be null, to use the built-in defaults.

Throws:

XmlException - for any configuration or fatal execution error.

parseFromClasspath

public static Document parseFromClasspath(String resourcePath)

Parses a resource loaded from the classpath, using the current thread's context classloader, and a default error handler.

parseFromClasspath

public static Document parseFromClasspath(String resourcePath,
                          ErrorHandler errorHandler)

Parses a resource loaded from the classpath, using the current thread's context classloader, and a specified error handler.

parseFromClasspath

public static Document parseFromClasspath(String resourcePath,
                          Class<?> klass)

Parses a resource loaded from the classpath, using the classloader associated with the specified class, and a default error handler.

parseFromClasspath

public static Document parseFromClasspath(String resourcePath,
                          Class<?> klass,
                          ErrorHandler errorHandler)

Parses a resource loaded from the classpath, using the classloader associated with the specified class, and the specified error handler.