org.apache.xerces.impl
Interface ExternalSubsetResolver

All Superinterfaces:

org.apache.xerces.xni.parser.XMLEntityResolver

All Known Implementing Classes:

EntityResolver2Wrapper

public interface ExternalSubsetResolver

extends org.apache.xerces.xni.parser.XMLEntityResolver

This interface extends XMLEntityResolver providing a method to resolve external subsets for documents which do not explicitly provide one. The application can register an object that implements this interface with the parser configuration. If registered, it will be queried to locate an external subset when none is provided, even for documents that do not contain DOCTYPE declarations. If the registered external subset resolver does not provide an external subset for a given document, it should return null.

INTERNAL:

Usage of this class is not supported. It may be altered or removed at any time.

Version:

$Id: ExternalSubsetResolver.java,v 1.2 2004/10/04 21:45:49 mrglavas Exp $

Author:

Michael Glavassevich, IBM

Method Summary

org.apache.xerces.xni.parser.XMLInputSource

getExternalSubset(org.apache.xerces.xni.grammars.XMLDTDDescription grammarDescription) Locates an external subset for documents which do not explicitly provide one.

Methods inherited from interface org.apache.xerces.xni.parser.XMLEntityResolver

resolveEntity

Method Detail

getExternalSubset

public org.apache.xerces.xni.parser.XMLInputSource getExternalSubset(org.apache.xerces.xni.grammars.XMLDTDDescription grammarDescription)
                                                              throws org.apache.xerces.xni.XNIException,
                                                                     java.io.IOException

Locates an external subset for documents which do not explicitly provide one. If no external subset is provided, this method should return null.

Parameters:

grammarDescription - a description of the DTD

Throws:

org.apache.xerces.xni.XNIException - Thrown on general error.

java.io.IOException - Thrown if resolved entity stream cannot be opened or some other i/o error occurs.