thredds.catalog
Class InvCatalogImpl

java.lang.Object
  thredds.catalog.InvCatalog
      thredds.catalog.InvCatalogImpl

public class InvCatalogImpl
extends InvCatalog

Concrete implementation of a Thredds catalog object. Use this when you are constructing or modifying.

Version:

$Revision: 48 $ $Date: 2006-07-12 16:15:40Z $

Author:

john caron

See Also:

InvCatalog

Field Summary

Fields inherited from class thredds.catalog.InvCatalog

baseURI, datasets, dsHash, expires, name, properties, serviceHash, services, topDataset, version

Constructor Summary

InvCatalogImpl(java.lang.String name, java.lang.String version, DateType expires, java.net.URI baseURI)
Construct an InvCatalog.

InvCatalogImpl(java.lang.String name, java.lang.String version, java.net.URI baseURI)
Construct an InvCatalog.

Method Summary

void	addDataset(InvDatasetImpl ds) Add Dataset (1.0)
void	addDatasetByID(InvDatasetImpl ds) Add Dataset to internal hash.
void	addDatasetRoot(InvProperty root) Add Dataset Root, key = path, value = location.
void	addProperty(InvProperty p) Add Property (1.0)
void	addPropertyChangeListener(java.beans.PropertyChangeListener l) Add a PropertyChangeEvent Listener.
void	addService(InvService s) Add Service (1.0)
void	appendErrorMessage(java.lang.String message, boolean isInvalid) Append an error message to the message log.
boolean	check(java.lang.StringBuffer out, boolean show) Check internal data structures.
java.lang.String	dump() Debugging: dump entire data structure.
boolean	equals(java.lang.Object o) InvCatalogImpl elements with same values are equal.
void	filter(DatasetFilter filter) Munge this catalog to remove any dataset that doesnt pass through the filter.
boolean	finish() Finish constructing after all elements have been added or modified.
java.net.URI	getBaseURI() Get the catalog base URI.
java.lang.String	getCreateFrom() String describing how the catalog was created, for debugging.
protected DatasetFilter	getDatasetFilter()
java.util.List	getDatasetRoots() Get dataset roots.
java.lang.String	getDTDid() get DTD string
java.lang.String	getLog()
boolean	hasFatalError() Check if there is a fatal error and catalog should not be used.
int	hashCode() Override Object.hashCode() to implement equals.
boolean	removeDataset(InvDatasetImpl ds) Remove the given dataset from this catalog if it is a direct child of this catalog.
void	removeDatasetByID(InvDatasetImpl ds) Find the dataset in this catalog by its ID.
void	removePropertyChangeListener(java.beans.PropertyChangeListener l) Remove a PropertyChangeEvent Listener.
boolean	replaceDataset(InvDatasetImpl remove, InvDatasetImpl add) Replace the given dataset if it is a nested dataset.
void	setBaseURI(java.net.URI baseURI) Set the catalog base URI.
void	setCatalogConverterToVersion1() Set the connverter to 1.0, typically to write a 0.6 out to a 1.0
void	setCreateFrom(java.lang.String createFrom) Set how the catalog was created, for debugging.
void	setDataset(InvDatasetImpl ds) Deprecated. Use addDataset() instead; datamodel now allows multiple top level datasets.
void	setDTDid(java.lang.String dtdID) set DTD
void	setExpires(DateType expiresDate) Set the expires date after which the catalog is no longer valid.
void	subset(InvDataset ds) Munge this catalog so the given dataset is the top catalog.
void	writeXML(java.io.OutputStream os) Write the catalog as an XML document to the specified stream.
void	writeXML(java.io.OutputStream os, boolean raw) Write the catalog as an XML document to the specified stream.

Methods inherited from class thredds.catalog.InvCatalog

check, findDatasetByID, findProperty, findService, getDataset, getDatasets, getExpires, getName, getProperties, getServices, getUriString, getVersion, resolveUri, setName

Methods inherited from class java.lang.Object

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

Constructor Detail

InvCatalogImpl

public InvCatalogImpl(java.lang.String name,
                      java.lang.String version,
                      java.net.URI baseURI)

Construct an InvCatalog. You must call finish() after all objects are added.

Parameters:

name - : catalog name.

version - : catalog version.

baseURI - : catalog base URI (external).

InvCatalogImpl

public InvCatalogImpl(java.lang.String name,
                      java.lang.String version,
                      DateType expires,
                      java.net.URI baseURI)

Construct an InvCatalog. You must call finish() after all objects are added.

Parameters:

name - : catalog name.

version - : catalog version.

expires - : date/time catalog expires.

baseURI - : catalog base URI (external).

Method Detail

subset

public void subset(InvDataset ds)

Munge this catalog so the given dataset is the top catalog.

Specified by:

subset in class InvCatalog

Parameters:

ds - make this top; must be existing dataset in this catalog.

filter

public void filter(DatasetFilter filter)

Munge this catalog to remove any dataset that doesnt pass through the filter.

Specified by:

filter in class InvCatalog

Parameters:

filter - remove datasets that dont pass this filter.

getDatasetFilter

protected DatasetFilter getDatasetFilter()

finish

public boolean finish()

Finish constructing after all elements have been added or modified. This routine will do any needed internal consistency work. Its ok to call multiple times.

Returns:

true if successful.

addDatasetByID

public void addDatasetByID(InvDatasetImpl ds)

Add Dataset to internal hash.

Parameters:

ds - : add this dataset if ds.getID() != null

See Also:

InvCatalog.findDatasetByID(java.lang.String)

removeDatasetByID

public void removeDatasetByID(InvDatasetImpl ds)

Find the dataset in this catalog by its ID. If found, remove it.

Parameters:

ds -

addDataset

public void addDataset(InvDatasetImpl ds)

Add Dataset (1.0)

removeDataset

public boolean removeDataset(InvDatasetImpl ds)

Remove the given dataset from this catalog if it is a direct child of this catalog.

replaceDataset

public boolean replaceDataset(InvDatasetImpl remove,
                              InvDatasetImpl add)

Replace the given dataset if it is a nested dataset.

Parameters:

remove - - the dataset element to be removed

add - - the dataset element to be added

Returns:

true on success

addProperty

public void addProperty(InvProperty p)

Add Property (1.0)

addService

public void addService(InvService s)

Add Service (1.0)

setDataset

public void setDataset(InvDatasetImpl ds)

Deprecated. Use addDataset() instead; datamodel now allows multiple top level datasets.

Add top-level InvDataset to this catalog.

getCreateFrom

public java.lang.String getCreateFrom()

String describing how the catalog was created, for debugging.

setCreateFrom

public void setCreateFrom(java.lang.String createFrom)

Set how the catalog was created, for debugging.

setBaseURI

public void setBaseURI(java.net.URI baseURI)

Set the catalog base URI. Its used to resolve reletive URLS.

getBaseURI

public java.net.URI getBaseURI()

Get the catalog base URI.

getDTDid

public java.lang.String getDTDid()

get DTD string

setDTDid

public void setDTDid(java.lang.String dtdID)

set DTD

setExpires

public void setExpires(DateType expiresDate)

Set the expires date after which the catalog is no longer valid.

Parameters:

expiresDate - a DateType representing the date after which the catlog is no longer valid.

hasFatalError

public boolean hasFatalError()

Check if there is a fatal error and catalog should not be used.

Returns:

true if catalog not useable.

appendErrorMessage

public void appendErrorMessage(java.lang.String message,
                               boolean isInvalid)

Append an error message to the message log. Call check() to get the log when everything is done.

Parameters:

message - append this message to log

isInvalid - true if this is a fatal error.

check

public boolean check(java.lang.StringBuffer out,
                     boolean show)

Check internal data structures.

Specified by:

check in class InvCatalog

Parameters:

out - : print errors here

show - : print messages for each object (debug)

Returns:

true if no fatal consistency errors.

getLog

public java.lang.String getLog()

dump

public java.lang.String dump()

Debugging: dump entire data structure.

Returns:

String representation.

addPropertyChangeListener

public void addPropertyChangeListener(java.beans.PropertyChangeListener l)

Add a PropertyChangeEvent Listener. THIS IS EXPERIMENTAL DO NOT RELY ON. Throws a PropertyChangeEvent:

• propertyName = "InvCatalogRefInit", getNewValue() = InvCatalogRef that was just initialized

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener l)

Remove a PropertyChangeEvent Listener.

setCatalogConverterToVersion1

public void setCatalogConverterToVersion1()

Set the connverter to 1.0, typically to write a 0.6 out to a 1.0

getDatasetRoots

public java.util.List getDatasetRoots()

Get dataset roots.

Returns:

List of InvProperty. May be empty, may not be null.

addDatasetRoot

public void addDatasetRoot(InvProperty root)

Add Dataset Root, key = path, value = location.

writeXML

public void writeXML(java.io.OutputStream os)
              throws java.io.IOException

Write the catalog as an XML document to the specified stream.

Parameters:

os - write to this OutputStream

Throws:

java.io.IOException - on an error.

writeXML

public void writeXML(java.io.OutputStream os,
                     boolean raw)
              throws java.io.IOException

Write the catalog as an XML document to the specified stream.

Parameters:

os - write to this OutputStream

raw - if true, write original (server) version, else write client version

Throws:

java.io.IOException - on an error.

equals

public boolean equals(java.lang.Object o)

InvCatalogImpl elements with same values are equal.

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Override Object.hashCode() to implement equals.

Overrides:

hashCode in class java.lang.Object