jas.util.xml
Class JASDOMParser

java.lang.Object
  |
  +--jas.util.xml.JASDOMParser

Direct Known Subclasses:

XercesDOMParser

public abstract class JASDOMParser

extends java.lang.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.

Inner Class Summary

static class

JASDOMParser.XMLException 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 org.w3c.dom.Document	parse(java.io.Reader in, java.lang.String fileName) Create a DOM document by reading an XML file
abstract org.w3c.dom.Document	parse(java.io.Reader in, java.lang.String fileName, org.xml.sax.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 org.w3c.dom.Document parse(java.io.Reader in,
                                           java.lang.String fileName)
                                    throws JASDOMParser.XMLException

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.XMLException - thrown if there is an error reading the XML

parse

public abstract org.w3c.dom.Document parse(java.io.Reader in,
                                           java.lang.String fileName,
                                           org.xml.sax.EntityResolver resolver)
                                    throws JASDOMParser.XMLException

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.XMLException - thrown if there is an error reading the XML

instance

public static JASDOMParser instance()

Creates a default instance of a JASDOMParser

Returns:

A JASDOMParser