thredds.cataloggen

Interface ProxyDatasetHandler

All Known Implementing Classes:

LatestCompleteProxyDsHandler, SimpleLatestProxyDsHandler

public interface ProxyDatasetHandler

The ProxyDatasetHandler interface allows implementors to define a proxy CrawlableDataset, how its corresponding InvDataset should be added to collection InvDatasets, and how the proxy CrawlableDataset maps to the underlying concrete CrawlableDataset. This interface is used by both thredds.cataloggen.CollectionLevelScanner and thredds.catalog.InvDatasetScan. In CollectionLevelScanner, it is used to add proxy datasets to the InvCatalog being generated. In InvDatasetScan, it is used to map (proxy) dataset requests to the underlying CrawlableDataset. NOTE: todo Would this be better named AliasDatasetHandler???

Since:

Nov 29, 2005 8:42:37 AM

Method Summary

Modifier and Type	Method and Description
CrawlableDataset	createProxyDataset(CrawlableDataset parent) Create a new dataset to add to the parent collection dataset.
InvCrawlablePair	getActualDataset(java.util.List possibleDatasets) Determine the InvCrawlablePair from the given dataset collection (java.util.List) being proxied by this ProxyDatasetHandler.
java.lang.String	getActualDatasetName(InvCrawlablePair actualDataset, java.lang.String baseName)
java.lang.Object	getConfigObject() Return the configuration object.
int	getProxyDatasetLocation(CrawlableDataset parent, int collectionDatasetSize) Return an integer which indicates the location/index at which the new dataset should be added to the parent collection dataset.
java.lang.String	getProxyDatasetName() Return the name of the proxy dataset.
InvService	getProxyDatasetService(CrawlableDataset parent) Return the InvService to be used by the InvDataset that corresponds to the created dataset.
boolean	isProxyDatasetResolver()

Method Detail

getProxyDatasetName

java.lang.String getProxyDatasetName()

Return the name of the proxy dataset.

Returns:

the name of the proxy dataset.

createProxyDataset

CrawlableDataset createProxyDataset(CrawlableDataset parent)

Create a new dataset to add to the parent collection dataset.

Parameters:

parent - the collection dataset in which to add the dataset being created.

Returns:

A new CrawlableDataset to be added to the parent dataset (in the InvDataset arena).

getProxyDatasetService

InvService getProxyDatasetService(CrawlableDataset parent)

Return the InvService to be used by the InvDataset that corresponds to the created dataset.

Parameters:

parent - the collection dataset in which to add the dataset being created.

Returns:

the InvService used by the InvDataset that corresponds to the created dataset.

getProxyDatasetLocation

int getProxyDatasetLocation(CrawlableDataset parent,
                            int collectionDatasetSize)

Return an integer which indicates the location/index at which the new dataset should be added to the parent collection dataset.

Parameters:

parent - the collection dataset in which to add the dataset being created.

collectionDatasetSize - the number of datasets currentlyin the parent collection dataset.

Returns:

The location at which the new dataset is to be added to the parent collection dataset.

isProxyDatasetResolver

boolean isProxyDatasetResolver()

getActualDataset

InvCrawlablePair getActualDataset(java.util.List possibleDatasets)

Determine the InvCrawlablePair from the given dataset collection (java.util.List) being proxied by this ProxyDatasetHandler.

Parameters:

possibleDatasets - a list of InvCrawlablePair objects representing a dataset collection.

Returns:

the InvCrawlablePair being proxied by this proxy dataset

getActualDatasetName

java.lang.String getActualDatasetName(InvCrawlablePair actualDataset,
                                      java.lang.String baseName)

getConfigObject

java.lang.Object getConfigObject()

Return the configuration object.

Returns:

the configuration Object (may be null).