Package ddf.catalog.resource

Interface ResourceReader

All Superinterfaces:

Describable, org.codice.ddf.platform.services.common.Describable

All Known Subinterfaces:

CatalogStore, ConnectedSource, FederatedSource, OAuthFederatedSource, RemoteSource

public interface ResourceReader
extends Describable

A ResourceReader is used to obtain a Resource.

For example the

invalid reference

URLResourceReader

obtains a Resource based on supported URI schemes.

Author:

Michael Menousek

Method Summary

Modifier and Type	Method	Description
Set<String>	getOptions(Metacard metacard)	Obtain a set of all options supported by this ResourceReader.
Set<String>	getSupportedSchemes()	Returns a set of URI schemes that the ResourceReader can accept when doing a Resource lookup.
ResourceResponse	retrieveResource(URI uri, Map<String,Serializable> arguments)	Retrieves a Resource based on a URI and provided arguments.

Methods inherited from interface ddf.catalog.util.Describable

getDescription, getId, getOrganization, getTitle, getVersion

Method Details

retrieveResource

ResourceResponse retrieveResource(URI uri,
 Map<String,Serializable> arguments)
                           throws IOException,
ResourceNotFoundException,
ResourceNotSupportedException

Retrieves a Resource based on a URI and provided arguments.

Parameters:

uri - A URI that defines what Resource to retrieve and how to do it.

arguments - Any additional arguments that should be passed to the ResourceReader.

Returns:

A ResourceResponse containing the retrieved Resource.

Throws:

IOException

ResourceNotFoundException

ResourceNotSupportedException

getSupportedSchemes

Set<String> getSupportedSchemes()

Returns a set of URI schemes that the ResourceReader can accept when doing a Resource lookup. Custom schemes can be created for a ResourceReader to support.

Returns:

Set of supported schemes

getOptions

Set<String> getOptions(Metacard metacard)

Obtain a set of all options supported by this ResourceReader. Options are used to obtain the Resource in a unique way.

Parameters:

metacard -

Returns:

Set of all options that this ResourceReader supports. This will be an empty set if no options are supported.