thredds.inventory

Class CollectionManagerAbstract

java.lang.Object

thredds.inventory.CollectionAbstract

thredds.inventory.CollectionManagerAbstract

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, CollectionManager, CollectionUpdateListener, MCollection

Direct Known Subclasses:

CollectionManagerCatalog, MFileCollectionManager

public abstract class CollectionManagerAbstract
extends CollectionAbstract
implements CollectionManager

Abstract superclass for implementations of CollectionManager.

Since:

Jan 19, 2010

Nested Class Summary

Nested classes/interfaces inherited from class thredds.inventory.CollectionAbstract

CollectionAbstract.DateSorter, CollectionAbstract.MyStreamFilter

Nested classes/interfaces inherited from interface thredds.inventory.CollectionManager

CollectionManager.ChangeChecker, CollectionManager.TriggerEvent, CollectionManager.TriggerListener

Field Summary

Fields

Modifier and Type	Field and Description
protected TimeDuration	recheck

Fields inherited from class thredds.inventory.CollectionAbstract

auxInfo, CATALOG, collectionName, dateExtractor, DIR, FILE, GLOB, lastModified, LIST, logger, NCX_SUFFIX, protoChoice, root, sfilter, startCollection

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CollectionManagerAbstract(java.lang.String collectionName, org.slf4j.Logger logger)

Method Summary

Modifier and Type	Method and Description
void	addEventListener(CollectionManager.TriggerListener l) Register to get Trigger events
void	close() Close and release any resources.
protected void	createListenerManager()
CloseableIterator<MFile>	getFileIterator() Get the current collection of MFile, no guaranteed order.
byte[]	getMetadata(MFile file, java.lang.String key)
TimeDuration	getRecheck() Get how often to rescan
boolean	isStatic() static means doesnt need to be monitored for changes; can be externally triggered, or read in at startup.
static CollectionManager	open(java.lang.String collectionName, java.lang.String collectionSpec, java.lang.String olderThan, java.util.Formatter errlog)
void	putMetadata(MFile file, java.lang.String key, byte[] value)
void	removeEventListener(CollectionManager.TriggerListener l)
boolean	scanIfNeeded() If isScanNeeded(), do a scan.
void	sendEvent(CollectionUpdateType type)
static void	setMetadataStore(StoreKeyValue.Factory _storeFactory)
void	setStatic(boolean aStatic)

Methods inherited from class thredds.inventory.CollectionAbstract

cleanName, extractDate, getAuxInfo, getCollectionName, getFilenames, getIndexFilename, getLastModified, getLatestFile, getPartitionDate, getProtoIndex, getRoot, hasDateExtractor, makeFileListSorted, parseOlderThanString, putAuxInfo, setDateExtractor, setRoot, setStreamFilter

Methods inherited from class java.lang.Object

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

Methods inherited from interface thredds.inventory.CollectionManager

getLastChanged, getLastScanned, isScanNeeded, scan

Methods inherited from interface thredds.inventory.MCollection

extractDate, getAuxInfo, getCollectionName, getFilenames, getFilesSorted, getIndexFilename, getLastModified, getLatestFile, getPartitionDate, getProtoIndex, getRoot, hasDateExtractor, putAuxInfo

Methods inherited from interface thredds.inventory.CollectionUpdateListener

getCollectionName

Field Detail

recheck

protected TimeDuration recheck

Constructor Detail

CollectionManagerAbstract

protected CollectionManagerAbstract(java.lang.String collectionName,
                                    org.slf4j.Logger logger)

Method Detail

open

public static CollectionManager open(java.lang.String collectionName,
                                     java.lang.String collectionSpec,
                                     java.lang.String olderThan,
                                     java.util.Formatter errlog)
                              throws java.io.IOException

Throws:

java.io.IOException

isStatic

public boolean isStatic()

Description copied from interface: CollectionManager

static means doesnt need to be monitored for changes; can be externally triggered, or read in at startup. true if no recheckAfter and no update.rescan

Specified by:

isStatic in interface CollectionManager

Returns:

if static

setStatic

public void setStatic(boolean aStatic)

getRecheck

public TimeDuration getRecheck()

Description copied from interface: CollectionManager

Get how often to rescan

Specified by:

getRecheck in interface CollectionManager

Returns:

time duration of rescan period, or null if none.

getFileIterator

public CloseableIterator<MFile> getFileIterator()
                                         throws java.io.IOException

Description copied from interface: MCollection

Get the current collection of MFile, no guaranteed order. May be faster than getFilesSorted() for large collections, use when order is not important.

     try (CloseableIterator iter = getFileIterator()) {
      while (iter.hasNext()) {
        MFile file = iter.next();
      }
    }
 

Specified by:

getFileIterator in interface MCollection

Returns:

current collection of MFile as an CloseableIterator.

Throws:

java.io.IOException

close

public void close()

Description copied from interface: MCollection

Close and release any resources. Do not make further calls on this object.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface MCollection

scanIfNeeded

public boolean scanIfNeeded()
                     throws java.io.IOException

Description copied from interface: CollectionManager

If isScanNeeded(), do a scan. Do not send an event.

Specified by:

scanIfNeeded in interface CollectionManager

Returns:

true if scan was done, and anything changed.

Throws:

java.io.IOException - on io error

setMetadataStore

public static void setMetadataStore(StoreKeyValue.Factory _storeFactory)

putMetadata

public void putMetadata(MFile file,
                        java.lang.String key,
                        byte[] value)

getMetadata

public byte[] getMetadata(MFile file,
                          java.lang.String key)

sendEvent

public void sendEvent(CollectionUpdateType type)

Specified by:

sendEvent in interface CollectionUpdateListener

addEventListener

public void addEventListener(CollectionManager.TriggerListener l)

Description copied from interface: CollectionManager

Register to get Trigger events

Specified by:

addEventListener in interface CollectionManager

Parameters:

l - listener

removeEventListener

public void removeEventListener(CollectionManager.TriggerListener l)

Specified by:

removeEventListener in interface CollectionManager

createListenerManager

protected void createListenerManager()