jas.util.xml
Class JASDOMParser

java.lang.Object
  jas.util.xml.JASDOMParser

Direct Known Subclasses:

JAXPDOMParser, XercesDOMParser

public abstract class JASDOMParser
extends Object

Ideally wouldnt need this interface, except that the DOM specification only specifies how to extract information from a DOM, not how to create a DOM from an XML file. The JASDOMParser interface is meant to make up for that deficiency.

Nested Class Summary

static class

JASDOMParser.JASXMLException An exception that gets thrown if there is an error reading an XML file.

Constructor Summary

JASDOMParser()

Method Summary

static JASDOMParser	instance() Creates a default instance of a JASDOMParser
abstract Document	parse(Reader in, String fileName) Create a DOM document by reading an XML file
abstract Document	parse(Reader in, String fileName, EntityResolver resolver) Create a DOM document by reading an XML file with an explicit entity resolver.

Methods inherited from class java.lang.Object

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

Constructor Detail

JASDOMParser

public JASDOMParser()

Method Detail

parse

public abstract Document parse(Reader in,
                               String fileName)
                        throws JASDOMParser.JASXMLException

Create a DOM document by reading an XML file

Parameters:

in - A reader set up to read an XML file

fileName - The name of the file being read (used in error messages)

Returns:

Document The resulting DOM

Throws:

JASDOMParser.JASXMLException - thrown if there is an error reading the XML

parse

public abstract Document parse(Reader in,
                               String fileName,
                               EntityResolver resolver)
                        throws JASDOMParser.JASXMLException

Create a DOM document by reading an XML file with an explicit entity resolver. An entity resolver is typically used to specify where to find the DTD for the XML document.

Parameters:

in - A reader set up to read an XML file

fileName - The name of the file being read (used in error messages)

resolver - An entity resolver to use when reading the XML file

Returns:

Document The resulting DOM

Throws:

JASDOMParser.JASXMLException - thrown if there is an error reading the XML

instance

public static JASDOMParser instance()

Creates a default instance of a JASDOMParser

Returns:

A JASDOMParser