org.apache.xml.resolver.readers
Interface CatalogReader

All Known Implementing Classes:

DOMCatalogReader, ExtendedXMLCatalogReader, OASISXMLCatalogReader, SAXCatalogReader, TextCatalogReader, TR9401CatalogReader, XCatalogReader

public interface CatalogReader

The CatalogReader interface.

The Catalog class requires that classes implement this interface in order to be used to read catalogs. Examples of CatalogReaders include the TextCatalogReader, the SAXCatalogReader, and the DOMCatalogReader.

Version:

1.0

Author:

Norman Walsh Norman.Walsh@Sun.COM

See Also:

Catalog

Method Summary

void	readCatalog(Catalog catalog, java.io.InputStream is) Read a catalog from an input stream.
void	readCatalog(Catalog catalog, java.lang.String fileUrl) Read a catalog from a file.

Method Detail

readCatalog

void readCatalog(Catalog catalog,
                 java.lang.String fileUrl)
                 throws java.net.MalformedURLException,
                        java.io.IOException,
                        CatalogException

Read a catalog from a file.

This class reads a catalog from a URL.

Parameters:

catalog - The catalog for which this reader is called.

fileUrl - The URL of a document to be read.

Throws:

java.net.MalformedURLException - if the specified URL cannot be turned into a URL object.

java.io.IOException - if the URL cannot be read.

UnknownCatalogFormatException - if the catalog format is not recognized.

UnparseableCatalogException - if the catalog cannot be parsed. (For example, if it is supposed to be XML and isn't well-formed.)

CatalogException

readCatalog

void readCatalog(Catalog catalog,
                 java.io.InputStream is)
                 throws java.io.IOException,
                        CatalogException

Read a catalog from an input stream.

This class reads a catalog from an input stream.

Parameters:

catalog - The catalog for which this reader is called.

is - The input stream that is to be read.

Throws:

java.io.IOException - if the URL cannot be read.

UnknownCatalogFormatException - if the catalog format is not recognized.

UnparseableCatalogException - if the catalog cannot be parsed. (For example, if it is supposed to be XML and isn't well-formed.)

CatalogException