com.xmlmind.xml.load

Interface DTDAccelerator

All Known Implementing Classes:

DTDAcceleratorImpl

public interface DTDAccelerator

Specifies a DTD cache used to accelerate the loading of documents conforming to large DTDs such as DocBook.

The acceleration is obtained by replacing the DTD referenced in the <!DOCTYPE> of the document being loaded by a fake DTD containing only the entities declared in the actual DTD. The actual DTD and fake DTD are expected to be both cached by implementations of this interface.

See Also:

LoadDocument

Method Summary

Modifier and Type	Method and Description
void	clear(Console console) Clear the cache.
InputSource	get(URL dtdURL, DTDSpec[] dtdSpec, Console console) Fetch the fake DTD from the cache.

Method Detail

get

InputSource get(URL dtdURL,
                DTDSpec[] dtdSpec,
                Console console)

Fetch the fake DTD from the cache. Load the actual DTD, create the fake DTD and cache both if needed too.

Parameters:

dtdURL - The URL of the DTD of interest

dtdSpec - Both an in and out argument:

in

Specifies the document type name, public ID, system ID and base URL of the DTD of interest.

out

This method adds the declarations of elements and attributes (which have been compiled and cached) of the DTD of interest.

console - Information messages are reported using this console. May be null.

Returns:

The input source allowing to read the fake DTD or null if the DTD cannot be loaded or cannot be accelerated

clear

void clear(Console console)

Clear the cache.

Parameters:

console - Information messages are reported using this console. May be null.