thredds.catalog

Class InvDatasetFeatureCollection

java.lang.Object

thredds.catalog.InvDataset

thredds.catalog.InvDatasetImpl

thredds.catalog.InvCatalogRef

thredds.catalog.InvDatasetFeatureCollection

All Implemented Interfaces:

CollectionManager.TriggerListener

Direct Known Subclasses:

InvDatasetFcFmrc, InvDatasetFcPoint

@ThreadSafe
public abstract class InvDatasetFeatureCollection
extends InvCatalogRef
implements CollectionManager.TriggerListener

Abstract superclass for Feature Collection Datasets. This is a InvCatalogRef subclass. So the reference is placed in the parent, but the catalog itself isnt constructed until the following call from DataRootHandler.makeDynamicCatalog(): match.dataRoot.featCollection.makeCatalog(match.remaining, path, baseURI);

The InvDatasetFeatureCollection object is created once and held in the DataRootHandler's collection of DataRoots.

Since:

Mar 3, 2010

Author:

caron

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	InvDatasetFeatureCollection.State

Field Summary

Fields

Modifier and Type	Field and Description
protected InvService	cdmrService
protected FeatureCollectionConfig	config
protected static String	context
protected CollectionManager	dcm
protected FeatureType	featureType
protected static String	FILES
protected static String	LATEST_DATASET
protected static String	LATEST_DATASET_NAME
protected static String	LATEST_SERVICE
protected Object	lock
protected InvService	orgService
protected String	path
protected InvDatasetFeatureCollection.State	state
protected String	topDirectory
protected static String	Virtual_Services
protected InvService	virtualService

Fields inherited from class thredds.catalog.InvDatasetImpl

log, mark, ncmlElement, tm, tmi, tmi6

Fields inherited from class thredds.catalog.InvDataset

access, authorityName, catalog, collectionType, contributors, creators, dataFormatType, datasets, dataType, dates, defaultService, docs, gc, harvest, id, keywords, metadata, name, parent, projects, properties, publishers, restrictAccess, services, tc, variableMapLink, variables

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	InvDatasetFeatureCollection(InvDatasetImpl parent, String name, String path, FeatureType featureType, FeatureCollectionConfig config)

Method Summary

Methods

Modifier and Type	Method and Description
protected abstract InvDatasetFeatureCollection.State	checkState() a request has come in, check that the state is up-to-date
static InvDatasetFeatureCollection	factory(InvDatasetImpl parent, String name, String path, FeatureType featureType, FeatureCollectionConfig config)
protected void	finishConstruction()
protected void	firstInit()
protected String	getCatalogHref(String what)
FeatureCollectionConfig	getConfig()
CollectionManager	getDatasetCollectionManager()
List<InvDataset>	getDatasets() Get a list of all the nested datasets.
FeatureDatasetPoint	getFeatureDatasetPoint()
File	getFile(String remaining)
GridDataset	getGridDataset(String matchPath) Get the associated Grid Dataset, if any.
NetcdfDataset	getNetcdfDataset(String matchPath) Get the dataset named by the path.
String	getPath()
InvDatasetScan	getRawFileScan()
String	getTopDirectoryLocation()
void	handleCollectionEvent(CollectionManager.TriggerEvent event)
abstract InvCatalogImpl	makeCatalog(String match, String orgPath, URI baseURI) Get one of the catalogs contained in this collection, called by DataRootHandler.makeDynamicCatalog()
protected InvCatalogImpl	makeCatalogTop(URI baseURI, InvDatasetFeatureCollection.State localState) Make the containing catalog of this feature collection
protected InvService	makeVirtualService(InvService org)
static void	setCatalogServletName(String catServletName)
static void	setCdmrFeatureServiceUrlPath(String urlPath)
static void	setContext(String c)
abstract void	update(CollectionManager.Force force) Collection was changed, update internal objects.
abstract void	updateProto() update the proto dataset being used.

Methods inherited from class thredds.catalog.InvCatalogRef

equals, findDatasetByName, findProperty, findService, finish, getAccess, getAccess, getAlias, getAuthority, getCalendarDateCoverage, getCollectionType, getContributors, getCreators, getDataFormatType, getDataType, getDates, getDocumentation, getDocumentation, getFullName, getGeospatialCoverage, getID, getKeywords, getMark, getMetadata, getMetadata, getName, getParent, getProjects, getProperties, getProxyDataset, getPublishers, getServiceDefault, getUniqueID, getURI, getUrlPath, getUserProperty, getVariableMapLink, getVariables, getXlinkHref, hasAccess, hashCode, hasNestedDatasets, isHarvest, isRead, readAsynch, release, setXlinkHref

Methods inherited from class thredds.catalog.InvDatasetImpl

addAccess, addAccess, addDataset, addDataset, addDocumentation, addProperty, addService, canonicalize, dump, getAccessLocal, getDataSize, getLastModifiedDate, getLocalMetadata, getLocalMetadataInheritable, getNcmlElement, getParentReal, getServiceName, getServicesLocal, main, removeDataset, removeLocalMetadata, removeService, replaceDataset, resolve, setAlias, setAuthority, setCatalog, setCollectionType, setContributors, setDataFormatType, setDataSize, setDataType, setGeospatialCoverage, setHarvest, setID, setKeywords, setLastModifiedDate, setLastModifiedDate, setLocalMetadata, setMark, setName, setNcmlElement, setParent, setProjects, setPublishers, setResourceControl, setServiceName, setServicesLocal, setTimeCoverage, setUrlPath, setUserProperty, toString, transferMetadata, writeHtmlDescription, writeHtmlDescription

Methods inherited from class thredds.catalog.InvDataset

findAccess, getCatalogUrl, getHistory, getParentCatalog, getProcessing, getRestrictAccess, getRights, getSubsetUrl, getSummary, getTimeCoverage, getVariables

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

FILES

protected static final String FILES

See Also:

Constant Field Values

LATEST_DATASET

protected static final String LATEST_DATASET

See Also:

Constant Field Values

LATEST_DATASET_NAME

protected static final String LATEST_DATASET_NAME

See Also:

Constant Field Values

LATEST_SERVICE

protected static final String LATEST_SERVICE

See Also:

Constant Field Values

Virtual_Services

protected static final String Virtual_Services

See Also:

Constant Field Values

context

protected static String context

orgService

protected InvService orgService

virtualService

protected InvService virtualService

cdmrService

protected InvService cdmrService

path

protected final String path

featureType

protected final FeatureType featureType

config

protected final FeatureCollectionConfig config

topDirectory

protected final String topDirectory

dcm

protected CollectionManager dcm

state

protected InvDatasetFeatureCollection.State state

lock

protected final Object lock

Constructor Detail

InvDatasetFeatureCollection

protected InvDatasetFeatureCollection(InvDatasetImpl parent,
                           String name,
                           String path,
                           FeatureType featureType,
                           FeatureCollectionConfig config)

Method Detail

setContext

public static void setContext(String c)

setCatalogServletName

public static void setCatalogServletName(String catServletName)

setCdmrFeatureServiceUrlPath

public static void setCdmrFeatureServiceUrlPath(String urlPath)

getCatalogHref

protected String getCatalogHref(String what)

factory

public static InvDatasetFeatureCollection factory(InvDatasetImpl parent,
                                  String name,
                                  String path,
                                  FeatureType featureType,
                                  FeatureCollectionConfig config)

finishConstruction

protected void finishConstruction()

firstInit

protected void firstInit()

handleCollectionEvent

public void handleCollectionEvent(CollectionManager.TriggerEvent event)

Specified by:

handleCollectionEvent in interface CollectionManager.TriggerListener

update

public abstract void update(CollectionManager.Force force)

Collection was changed, update internal objects. called by CollectionUpdater, trigger via handleCollectionEvent, so in a quartz scheduler thread

Parameters:

force - test : update index if anything changed or nocheck - use index if it exists

updateProto

public abstract void updateProto()

update the proto dataset being used. called by CollectionUpdater via handleCollectionEvent, so in a quartz scheduler thread

checkState

protected abstract InvDatasetFeatureCollection.State checkState()
                                                         throws IOException

a request has come in, check that the state is up-to-date

Returns:

the State, updated if needed

Throws:

IOException - on read error

getPath

public String getPath()

getTopDirectoryLocation

public String getTopDirectoryLocation()

getConfig

public FeatureCollectionConfig getConfig()

getDatasetCollectionManager

public CollectionManager getDatasetCollectionManager()

getRawFileScan

public InvDatasetScan getRawFileScan()

getDatasets

public List<InvDataset> getDatasets()

Description copied from class: InvCatalogRef

Get a list of all the nested datasets.

Overrides:

getDatasets in class InvCatalogRef

Returns:

Datasets. This triggers a read of the referenced catalog the first time its called.

makeVirtualService

protected InvService makeVirtualService(InvService org)

makeCatalog

public abstract InvCatalogImpl makeCatalog(String match,
                         String orgPath,
                         URI baseURI)

Get one of the catalogs contained in this collection, called by DataRootHandler.makeDynamicCatalog()

Parameters:

match - match.remaining

orgPath - the path for the request.

baseURI - the base URI for the catalog, used to resolve relative URLs.

Returns:

containing catalog

makeCatalogTop

protected InvCatalogImpl makeCatalogTop(URI baseURI,
                            InvDatasetFeatureCollection.State localState)
                                 throws IOException,
                                        URISyntaxException

Make the containing catalog of this feature collection

Parameters:

baseURI - base URI of the request

localState - current state to use

Returns:

the top FMRC catalog

Throws:

IOException - on I/O error

URISyntaxException - if path is misformed

getGridDataset

public GridDataset getGridDataset(String matchPath)
                           throws IOException

Get the associated Grid Dataset, if any. called by DatasetHandler.openGridDataset()

Parameters:

matchPath - match.remaining

Returns:

Grid Dataset, or null if n/a

Throws:

IOException - on error

getFeatureDatasetPoint

public FeatureDatasetPoint getFeatureDatasetPoint()

getNetcdfDataset

public NetcdfDataset getNetcdfDataset(String matchPath)
                               throws IOException

Get the dataset named by the path. called by DatasetHandler.getNetcdfFile()

Parameters:

matchPath - remaining path from match

Returns:

requested dataset

Throws:

IOException - if read error

getFile

public File getFile(String remaining)