thredds.catalog

Class InvDatasetFeatureCollection

java.lang.Object

thredds.catalog.InvDataset

thredds.catalog.InvDatasetImpl

thredds.catalog.InvCatalogRef

thredds.catalog.InvDatasetFeatureCollection

All Implemented Interfaces:

thredds.inventory.CollectionUpdateListener

Direct Known Subclasses:

InvDatasetFcFmrc, InvDatasetFcGrib, InvDatasetFcPoint

@ThreadSafe
public abstract class InvDatasetFeatureCollection
extends thredds.catalog.InvCatalogRef
implements thredds.inventory.CollectionUpdateListener

Abstract superclass for Feature Collection InvDatasets. 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

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 thredds.catalog.InvService	cdmrService
protected thredds.featurecollection.FeatureCollectionConfig	config
protected java.lang.String	configPath
protected static java.lang.String	context
protected thredds.inventory.MFileCollectionManager	datasetCollection
protected static java.lang.String	Default_Services
protected static java.lang.String	Download_Services
protected thredds.featurecollection.FeatureCollectionType	fcType
protected static java.lang.String	FILES
protected boolean	first
protected static java.lang.String	LATEST_DATASET_CATALOG
protected static java.lang.String	LATEST_SERVICE
protected java.lang.Object	lock
protected org.slf4j.Logger	logger
protected thredds.catalog.InvService	orgService
protected InvDatasetFeatureCollection.State	state
protected java.lang.String	topDirectory
protected static java.lang.String	VARIABLES
protected static java.lang.String	Virtual_Services
protected thredds.catalog.InvService	virtualService

Fields inherited from class thredds.catalog.InvDatasetImpl

log, mark, ncmlElement, tm, tmi

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(thredds.catalog.InvDatasetImpl parent, thredds.featurecollection.FeatureCollectionConfig config)

Method Summary

Modifier and Type	Method and Description
protected void	_showStatus(java.util.Formatter f, boolean summaryOnly, java.lang.String type)
protected static java.lang.String	buildCatalogServiceHref(java.lang.String path)
protected InvDatasetFeatureCollection.State	checkState() A request has come in, check that the state has been initialized.
static InvDatasetFeatureCollection	factory(thredds.catalog.InvDatasetImpl parent, thredds.featurecollection.FeatureCollectionConfig config)
protected void	finishConstruction()
protected void	firstInit()
protected java.lang.String	getCatalogHref(java.lang.String what)
java.lang.String	getCollectionName()
thredds.featurecollection.FeatureCollectionConfig	getConfig()
thredds.inventory.MCollection	getDatasetCollectionManager()
java.util.List<thredds.catalog.InvDataset>	getDatasets()
abstract ucar.nc2.ft.FeatureDataset	getFeatureDataset()
java.io.File	getFile(java.lang.String remaining)
ucar.nc2.dt.grid.GridDataset	getGridDataset(java.lang.String matchPath) Get the associated Grid Dataset, if any.
java.lang.String	getLatestFileName()
org.slf4j.Logger	getLogger()
ucar.nc2.dataset.NetcdfDataset	getNetcdfDataset(java.lang.String matchPath) Get the dataset named by the path.
java.lang.String	getPath()
java.lang.String	getTopDirectoryLocation()
abstract thredds.catalog.InvCatalogImpl	makeCatalog(java.lang.String match, java.lang.String orgPath, java.net.URI catURI) Get one of the catalogs contained in this collection, called by DataRootHandler.makeDynamicCatalog()
protected thredds.catalog.InvCatalogImpl	makeCatalogFiles(java.net.URI catURI, InvDatasetFeatureCollection.State localState, java.util.List<java.lang.String> filenames, boolean addLatest)
protected thredds.catalog.InvCatalogImpl	makeCatalogTop(java.net.URI catURI, InvDatasetFeatureCollection.State localState) Make the containing catalog of this feature collection "http://server:port/thredds/catalog/path/catalog.xml"
protected void	makeCollection()
protected abstract void	makeDatasetTop(InvDatasetFeatureCollection.State localState)
protected thredds.catalog.InvService	makeDefaultService()
protected thredds.catalog.InvService	makeDownloadService()
thredds.catalog.InvCatalogImpl	makeLatest(java.lang.String matchPath, java.lang.String reqPath, java.net.URI catURI)
protected java.lang.String	makeMetadataLink(java.lang.String datasetName, java.lang.String metadata)
protected thredds.catalog.InvService	makeServiceVirtual(thredds.catalog.InvService org)
void	sendEvent(thredds.inventory.CollectionUpdateType type)
static void	setCatalogServletName(java.lang.String catServletName)
static void	setCdmrFeatureServiceUrlPath(java.lang.String urlPath)
static void	setContext(java.lang.String c)
static void	setLoggerFactory(ucar.nc2.util.log.LoggerFactory fac)
void	showStatus(java.util.Formatter f)
java.lang.String	showStatusShort(java.lang.String type)
protected void	update(thredds.inventory.CollectionUpdateType force) Collection was changed, update internal objects.
protected abstract void	updateCollection(InvDatasetFeatureCollection.State localState, thredds.inventory.CollectionUpdateType force)

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, useRemoteCatalogService

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, 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, 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

LATEST_DATASET_CATALOG

protected static final java.lang.String LATEST_DATASET_CATALOG

See Also:

Constant Field Values

LATEST_SERVICE

protected static final java.lang.String LATEST_SERVICE

See Also:

Constant Field Values

VARIABLES

protected static final java.lang.String VARIABLES

See Also:

Constant Field Values

FILES

protected static final java.lang.String FILES

See Also:

Constant Field Values

Virtual_Services

protected static final java.lang.String Virtual_Services

See Also:

Constant Field Values

Default_Services

protected static final java.lang.String Default_Services

See Also:

Constant Field Values

Download_Services

protected static final java.lang.String Download_Services

context

protected static java.lang.String context

orgService

protected thredds.catalog.InvService orgService

virtualService

protected thredds.catalog.InvService virtualService

cdmrService

protected thredds.catalog.InvService cdmrService

logger

protected org.slf4j.Logger logger

configPath

protected final java.lang.String configPath

fcType

protected final thredds.featurecollection.FeatureCollectionType fcType

config

protected final thredds.featurecollection.FeatureCollectionConfig config

topDirectory

protected java.lang.String topDirectory

datasetCollection

protected thredds.inventory.MFileCollectionManager datasetCollection

state

protected InvDatasetFeatureCollection.State state

first

protected boolean first

lock

protected final java.lang.Object lock

Constructor Detail

InvDatasetFeatureCollection

protected InvDatasetFeatureCollection(thredds.catalog.InvDatasetImpl parent,
                                      thredds.featurecollection.FeatureCollectionConfig config)

Method Detail

setContext

public static void setContext(java.lang.String c)

setCatalogServletName

public static void setCatalogServletName(java.lang.String catServletName)

buildCatalogServiceHref

protected static java.lang.String buildCatalogServiceHref(java.lang.String path)

setCdmrFeatureServiceUrlPath

public static void setCdmrFeatureServiceUrlPath(java.lang.String urlPath)

setLoggerFactory

public static void setLoggerFactory(ucar.nc2.util.log.LoggerFactory fac)

factory

public static InvDatasetFeatureCollection factory(thredds.catalog.InvDatasetImpl parent,
                                                  thredds.featurecollection.FeatureCollectionConfig config)

makeCollection

protected void makeCollection()

finishConstruction

protected void finishConstruction()

getCollectionName

public java.lang.String getCollectionName()

Specified by:

getCollectionName in interface thredds.inventory.CollectionUpdateListener

sendEvent

public void sendEvent(thredds.inventory.CollectionUpdateType type)

Specified by:

sendEvent in interface thredds.inventory.CollectionUpdateListener

showStatus

public void showStatus(java.util.Formatter f)

showStatusShort

public java.lang.String showStatusShort(java.lang.String type)

_showStatus

protected void _showStatus(java.util.Formatter f,
                           boolean summaryOnly,
                           java.lang.String type)
                    throws java.io.IOException

Throws:

java.io.IOException

updateCollection

protected abstract void updateCollection(InvDatasetFeatureCollection.State localState,
                                         thredds.inventory.CollectionUpdateType force)

makeDatasetTop

protected abstract void makeDatasetTop(InvDatasetFeatureCollection.State localState)
                                throws java.io.IOException

Throws:

java.io.IOException

getCatalogHref

protected java.lang.String getCatalogHref(java.lang.String what)

firstInit

protected void firstInit()

checkState

protected InvDatasetFeatureCollection.State checkState()
                                                throws java.io.IOException

A request has come in, check that the state has been initialized. this is called from the request thread.

Returns:

a copy of the State

Throws:

java.io.IOException

update

protected void update(thredds.inventory.CollectionUpdateType force)
               throws java.io.IOException

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

Parameters:

force - update type

Throws:

java.io.IOException

getPath

public java.lang.String getPath()

getLatestFileName

public java.lang.String getLatestFileName()

getTopDirectoryLocation

public java.lang.String getTopDirectoryLocation()

getConfig

public thredds.featurecollection.FeatureCollectionConfig getConfig()

getDatasetCollectionManager

public thredds.inventory.MCollection getDatasetCollectionManager()

getLogger

public org.slf4j.Logger getLogger()

getDatasets

public java.util.List<thredds.catalog.InvDataset> getDatasets()

Overrides:

getDatasets in class thredds.catalog.InvCatalogRef

makeDefaultService

protected thredds.catalog.InvService makeDefaultService()

makeDownloadService

protected thredds.catalog.InvService makeDownloadService()

makeServiceVirtual

protected thredds.catalog.InvService makeServiceVirtual(thredds.catalog.InvService org)

makeCatalog

public abstract thredds.catalog.InvCatalogImpl makeCatalog(java.lang.String match,
                                                           java.lang.String orgPath,
                                                           java.net.URI catURI)
                                                    throws java.io.IOException

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

Parameters:

match - match.remaining

orgPath - the path for the request.

catURI - the base URI for the catalog to be made, used to resolve relative URLs.

Returns:

containing catalog

Throws:

java.io.IOException

makeCatalogTop

protected thredds.catalog.InvCatalogImpl makeCatalogTop(java.net.URI catURI,
                                                        InvDatasetFeatureCollection.State localState)
                                                 throws java.io.IOException,
                                                        java.net.URISyntaxException

Make the containing catalog of this feature collection "http://server:port/thredds/catalog/path/catalog.xml"

Parameters:

catURI - base URI of the request

localState - current state to use

Returns:

the top FMRC catalog

Throws:

java.io.IOException - on I/O error

java.net.URISyntaxException - if path is misformed

makeCatalogFiles

protected thredds.catalog.InvCatalogImpl makeCatalogFiles(java.net.URI catURI,
                                                          InvDatasetFeatureCollection.State localState,
                                                          java.util.List<java.lang.String> filenames,
                                                          boolean addLatest)
                                                   throws java.io.IOException

Throws:

java.io.IOException

makeMetadataLink

protected java.lang.String makeMetadataLink(java.lang.String datasetName,
                                            java.lang.String metadata)

makeLatest

public thredds.catalog.InvCatalogImpl makeLatest(java.lang.String matchPath,
                                                 java.lang.String reqPath,
                                                 java.net.URI catURI)
                                          throws java.io.IOException

Throws:

java.io.IOException

getGridDataset

public ucar.nc2.dt.grid.GridDataset getGridDataset(java.lang.String matchPath)
                                            throws java.io.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:

java.io.IOException - on error

getFeatureDataset

public abstract ucar.nc2.ft.FeatureDataset getFeatureDataset()

getNetcdfDataset

public ucar.nc2.dataset.NetcdfDataset getNetcdfDataset(java.lang.String matchPath)
                                                throws java.io.IOException

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

Parameters:

matchPath - remaining path from match

Returns:

requested dataset

Throws:

java.io.IOException - if read error

getFile

public java.io.File getFile(java.lang.String remaining)