org.dataone.client

Class ObjectFormatCache

java.lang.Object

org.dataone.service.types.v1.util.ObjectFormatServiceImpl

org.dataone.client.ObjectFormatCache

public class ObjectFormatCache
extends ObjectFormatServiceImpl

The ObjectFormatCache is a wrapper class for the DataONE ObjectFormatList type. It loads the most current object format list from a Coordinating Node, and falls back to on-disk cache version. It provides accessor methods to query and manipulate the object format list. To load an object format list other than the one configured for your environment, set the property "ObjectFormatCache.overriding.CN_URL" in your application's configuration. This is mainly used for integration and pre-registration testing.

Author:

cjones, rnahf

Field Summary

Fields

Modifier and Type	Field and Description
protected Date	lastRefreshDate
protected static int	throttleIntervalSec
static boolean	usingFallbackFormatList

Fields inherited from class org.dataone.service.types.v1.util.ObjectFormatServiceImpl

objectFormatList, objectFormatMap

Method Summary

Methods

Modifier and Type	Method and Description
ObjectFormat	getFormat(ObjectFormatIdentifier formatId) Lookup and return the format specified by the Identifier.
ObjectFormat	getFormat(String fmtidStr) Deprecated.
static ObjectFormatCache	getInstance() Create the object format cache instance if it hasn't already been created.
Date	getLastRefreshDate() Returns the date of the last refresh from the CN.
int	getMinimalRefreshInterval() Returns the minimal refresh interval (seconds)
boolean	isUsingFallbackFormatList() Returns true if the cache has not been able to successfully refresh from the CN
ObjectFormatList	listFormats() List the object formats registered with the object format service.

Methods inherited from class org.dataone.service.types.v1.util.ObjectFormatServiceImpl

getObjectFormatFile, getObjectFormatMap

Methods inherited from class java.lang.Object

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

Field Detail

usingFallbackFormatList

public static boolean usingFallbackFormatList

throttleIntervalSec

protected static int throttleIntervalSec

lastRefreshDate

protected Date lastRefreshDate

Method Detail

getInstance

public static ObjectFormatCache getInstance()
                                     throws ServiceFailure

Create the object format cache instance if it hasn't already been created.

Throws:

ServiceFailure - - upon problems creating the cache

listFormats

public ObjectFormatList listFormats()

List the object formats registered with the object format service.

Overrides:

listFormats in class ObjectFormatServiceImpl

Returns:

objectFormatList - the list of object formats

getMinimalRefreshInterval

public int getMinimalRefreshInterval()

Returns the minimal refresh interval (seconds)

getLastRefreshDate

public Date getLastRefreshDate()

Returns the date of the last refresh from the CN. If null, no successful refresh has occurred.

isUsingFallbackFormatList

public boolean isUsingFallbackFormatList()

Returns true if the cache has not been able to successfully refresh from the CN

getFormat

@Deprecated
public ObjectFormat getFormat(String fmtidStr)
                       throws NotFound

Deprecated.

Get the object format based on the given identifier string.

This method is deprecated in favor of the type-safe getFormat(ObjectFormatIdentifier) method

Parameters:

format - - the object format identifier string

Returns:

objectFormat - the ObjectFormat represented by the format identifier

Throws:

NotFound

getFormat

public ObjectFormat getFormat(ObjectFormatIdentifier formatId)
                       throws NotFound

Lookup and return the format specified by the Identifier. If cache is stale or ID not in the cache, will refresh and try (again). returns the formatId or exception

Overrides:

getFormat in class ObjectFormatServiceImpl

Parameters:

formatId - - the object format identifier

Returns:

objectFormat - the ObjectFormat represented by the format identifier

Throws:

ServiceFailure

NotFound

NotImplemented