org.conqat.lib.commons.xml

Class OfflineSaxHandlerBase

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.conqat.lib.commons.xml.OfflineSaxHandlerBase

All Implemented Interfaces:

org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler

public class OfflineSaxHandlerBase
extends org.xml.sax.helpers.DefaultHandler

Base class for SAX parser handlers. This class has a default implementation of resolveEntity(String, String) that works around a bug in the Java SAX parser implementation: If resolveEntity(String, String) returns null for a given DTD (the default behavior of DefaultHandler), the Java SAX parser will try to download that DTD. This will fail on machines that have no Internet connection or require a proxy to access the Internet or for DTDs where the URI is not a valid URL. This class' default implementation instead returns an empty InputSource, which effectively causes the parser to skip DTD validation. Please note that downloading the DTD from the Internet is against the DTD specification (as the DTD URI is not required to be a valid URL) and is highly error-prone, resulting in a hard to interpret error message. It is thus recommended you use this base class and never return null from resolveEntity(String, String).

Constructor Summary

Constructors

Constructor and Description
OfflineSaxHandlerBase()

Method Summary

Modifier and Type	Method and Description
org.xml.sax.InputSource	resolveEntity(java.lang.String publicId, java.lang.String systemId) Default implementation that can be overwritten by subclasses.

Methods inherited from class org.xml.sax.helpers.DefaultHandler

characters, endDocument, endElement, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

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

Constructor Detail

OfflineSaxHandlerBase

public OfflineSaxHandlerBase()

Method Detail

resolveEntity

public org.xml.sax.InputSource resolveEntity(java.lang.String publicId,
                                             java.lang.String systemId)
                                      throws java.io.IOException,
                                             org.xml.sax.SAXException

Default implementation that can be overwritten by subclasses. This implementation returns an empty document for any entity that should be resolved. This effectively causes the parser to skip DTD validation.

Specified by:

resolveEntity in interface org.xml.sax.EntityResolver

Overrides:

resolveEntity in class org.xml.sax.helpers.DefaultHandler

Throws:

java.io.IOException - may be thrown by subclasses.

org.xml.sax.SAXException - may be thrown by subclasses.