thredds.cataloggen

Class StandardCatalogBuilder

java.lang.Object

thredds.cataloggen.StandardCatalogBuilder

All Implemented Interfaces:

CatalogBuilder

public class StandardCatalogBuilder
extends java.lang.Object
implements CatalogBuilder

_more_

Since:

Dec 6, 2005 1:45:07 PM

Author:

edavis

Constructor Summary

Constructors

Constructor and Description

StandardCatalogBuilder(java.lang.String collectionPath, java.lang.String collectionName, CrawlableDataset collectionCrDs, CrawlableDatasetFilter filter, InvService service, java.lang.String collectionId, CrawlableDatasetLabeler identifier, CrawlableDatasetLabeler namer, boolean doAddDatasetSize, CrawlableDatasetSorter sorter, java.util.Map proxyDatasetHandlers, java.util.List childEnhancerList, InvDatasetImpl topLevelMetadataContainer, CatalogRefExpander catalogRefExpander)

Method Summary

Methods

Modifier and Type	Method and Description
InvCatalogImpl	generateCatalog(CrawlableDataset catalogCrDs) Return an InvCatalog for the level in the collection hierarchy specified by catalogPath.
org.jdom.Document	generateCatalogAsDocument(CrawlableDataset catalogCrDs) Return a JDOM Document representation of the catalog for the level in the collection hierarchy specified by catalogPath.
java.lang.String	generateCatalogAsString(CrawlableDataset catalogCrDs) Return a String containing the XML representation of the catalog for the level in the collection hierarchy specified by catalogPath.
InvCatalogImpl	generateProxyDsResolverCatalog(CrawlableDataset catalogCrDs, ProxyDatasetHandler pdh) Generate the catalog for a resolver request of the given ProxyDatasetHandler.
CrawlableDataset	requestCrawlableDataset(java.lang.String path) Return the CrawlableDataset for the given path, null if this CatalogBuilder does not allow the requested CrawlableDataset.

Methods inherited from class java.lang.Object

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

Constructor Detail

StandardCatalogBuilder

public StandardCatalogBuilder(java.lang.String collectionPath,
                      java.lang.String collectionName,
                      CrawlableDataset collectionCrDs,
                      CrawlableDatasetFilter filter,
                      InvService service,
                      java.lang.String collectionId,
                      CrawlableDatasetLabeler identifier,
                      CrawlableDatasetLabeler namer,
                      boolean doAddDatasetSize,
                      CrawlableDatasetSorter sorter,
                      java.util.Map proxyDatasetHandlers,
                      java.util.List childEnhancerList,
                      InvDatasetImpl topLevelMetadataContainer,
                      CatalogRefExpander catalogRefExpander)

Method Detail

requestCrawlableDataset

public CrawlableDataset requestCrawlableDataset(java.lang.String path)
                                         throws java.io.IOException

Description copied from interface: CatalogBuilder

Return the CrawlableDataset for the given path, null if this CatalogBuilder does not allow the requested CrawlableDataset.

This method can handle requests for regular datasets and proxy datasets.

Specified by:

requestCrawlableDataset in interface CatalogBuilder

Parameters:

path - the path of the requested CrawlableDataset

Returns:

the CrawlableDataset for the given path or null if the path is not allowed by this CatalogBuilder either due to filtering or due to the path not being a descendant (or self) of the collection level path.

Throws:

java.io.IOException - if an I/O error occurs while locating the children datasets.

generateCatalog

public InvCatalogImpl generateCatalog(CrawlableDataset catalogCrDs)
                               throws java.io.IOException

Description copied from interface: CatalogBuilder

Return an InvCatalog for the level in the collection hierarchy specified by catalogPath.

Specified by:

generateCatalog in interface CatalogBuilder

Parameters:

catalogCrDs - the location in the collection at which to generate a catalog

Returns:

an InvCatalog for the specified location

Throws:

java.io.IOException - if problems accessing the dataset collection.

generateProxyDsResolverCatalog

public InvCatalogImpl generateProxyDsResolverCatalog(CrawlableDataset catalogCrDs,
                                            ProxyDatasetHandler pdh)
                                              throws java.io.IOException

Description copied from interface: CatalogBuilder

Generate the catalog for a resolver request of the given ProxyDatasetHandler. This method is optional, it does not need to be supported by all CatalogBuilder implementations.

Specified by:

generateProxyDsResolverCatalog in interface CatalogBuilder

Parameters:

catalogCrDs - the location in the collection at which to generate a catalog

pdh - the ProxyDatasetHandler corresponding to the resolver request.

Returns:

the catalog for a resolver request of the given proxy dataset.

Throws:

java.io.IOException

generateCatalogAsDocument

public org.jdom.Document generateCatalogAsDocument(CrawlableDataset catalogCrDs)
                                            throws java.io.IOException

Description copied from interface: CatalogBuilder

Return a JDOM Document representation of the catalog for the level in the collection hierarchy specified by catalogPath.

Specified by:

generateCatalogAsDocument in interface CatalogBuilder

Parameters:

catalogCrDs - the location in the collection at which to generate a catalog

Returns:

an org.jdom.Document representing the catalog for the specified location

Throws:

java.io.IOException - if problems accessing the dataset collection.

generateCatalogAsString

public java.lang.String generateCatalogAsString(CrawlableDataset catalogCrDs)
                                         throws java.io.IOException

Description copied from interface: CatalogBuilder

Return a String containing the XML representation of the catalog for the level in the collection hierarchy specified by catalogPath.

Specified by:

generateCatalogAsString in interface CatalogBuilder

Parameters:

catalogCrDs - the location in the collection at which to generate a catalog

Returns:

a String containing the XML representation of the catalog for the specified location

Throws:

java.io.IOException - if problems accessing the dataset collection.