com.sun.resolver.readers
Interface CatalogReader

All Known Implementing Classes:

DOMCatalogReader, SAXCatalogReader, TextCatalogReader

public interface CatalogReader

The CatalogReader interface.

Copyright © 2000, 2001 Sun Microsystems, Inc. All Rights Reserved. This software is the proprietary information of Sun Microsystems, Inc. Use is subject to license terms.

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 This class reads a catalog from an input stream.
void	readCatalog(Catalog catalog, java.lang.String fileUrl) Read a catalog from a file This class reads a catalog from a URL.

Method Detail

readCatalog

public 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

public 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