org.geotools.gce.imagemosaic.catalog

Class CachingDataStoreGranuleCatalog

Object

GranuleCatalog

CachingDataStoreGranuleCatalog

public class CachingDataStoreGranuleCatalog
extends GranuleCatalog

This class simply builds an SRTREE spatial index in memory for fast indexed geometric queries.

Since the ImageMosaicReader heavily uses spatial queries to find out which are the involved tiles during mosaic creation, it is better to do some caching and keep the index in memory as much as possible, hence we came up with this index.

Since:

2.5

Author:

Simone Giannecchini, S.A.S., Stefan Alfons Krueger (alfonx), Wikisquare.de : Support for jar:file:foo.jar/bar.properties URLs

Field Summary

Fields inherited from class GranuleCatalog

configurations, hints, multiScaleROIProvider

Constructor Summary

Constructors

Constructor and Description
CachingDataStoreGranuleCatalog(GranuleCatalog adaptee)

Method Summary

Modifier and Type	Method and Description
void	addGranule(String typeName, SimpleFeature granule, Transaction transaction)
void	addGranules(String typeName, Collection<SimpleFeature> granules, Transaction transaction)
void	computeAggregateFunction(Query q, FeatureCalc function)
void	createType(SimpleFeatureType featureType)
void	createType(String identification, String typeSpec)
void	createType(String namespace, String typeName, String typeSpec)
void	dispose()
void	drop() Drop the underlying catalog, all the individual granule indexes.
GranuleCatalog	getAdaptee()
BoundingBox	getBounds(String typeName)
BoundingBox	getBounds(String typeName, Transaction t)
protected CatalogConfigurationBeans	getConfigurations()
List<File>	getFootprintFiles(SimpleFeature sf) Returns the list of footprint files for the given granule
protected GranuleDescriptor	getGranuleDescriptor(CatalogConfigurationBean configuration, SimpleFeature sf)
void	getGranuleDescriptors(Query q, GranuleCatalogVisitor visitor)
protected MultiLevelROI	getGranuleFootprint(SimpleFeature sf) Returns the footprint for the given granule.
SimpleFeatureCollection	getGranules(Query q)
SimpleFeatureCollection	getGranules(Query q, Transaction t)
int	getGranulesCount(Query q)
Hints	getHints()
protected String	getParentLocation()
QueryCapabilities	getQueryCapabilities(String typeName)
SimpleFeatureType	getType(String typeName)
String[]	getTypeNames()
protected Query	mergeHints(Query q) Merges the wrapper hints with the query ones, making sure not to overwrite the query ones
protected boolean	polygonOverlap(Geometry g1, Geometry g2)
int	removeGranules(Query query)
int	removeGranules(Query query, Transaction transaction)
void	removeType(String typeName)
void	setMultiScaleROIProvider(MultiLevelROIProvider footprintProvider)

Methods inherited from class Object

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

Constructor Detail

CachingDataStoreGranuleCatalog

public CachingDataStoreGranuleCatalog(GranuleCatalog adaptee)

Method Detail

getGranules

public SimpleFeatureCollection getGranules(Query q)
                                    throws IOException

Throws:

IOException

getGranules

public SimpleFeatureCollection getGranules(Query q,
                                           Transaction t)
                                    throws IOException

Throws:

IOException

getGranuleDescriptors

public void getGranuleDescriptors(Query q,
                                  GranuleCatalogVisitor visitor)
                           throws IOException

Throws:

IOException

getGranuleDescriptor

protected GranuleDescriptor getGranuleDescriptor(CatalogConfigurationBean configuration,
                                                 SimpleFeature sf)

polygonOverlap

protected boolean polygonOverlap(Geometry g1,
                                 Geometry g2)

removeGranules

public int removeGranules(Query query)

removeGranules

public int removeGranules(Query query,
                          Transaction transaction)

addGranules

public void addGranules(String typeName,
                        Collection<SimpleFeature> granules,
                        Transaction transaction)
                 throws IOException

Specified by:

addGranules in class GranuleCatalog

Throws:

IOException

computeAggregateFunction

public void computeAggregateFunction(Query q,
                                     FeatureCalc function)
                              throws IOException

Specified by:

computeAggregateFunction in class GranuleCatalog

Throws:

IOException

createType

public void createType(String namespace,
                       String typeName,
                       String typeSpec)
                throws IOException,
                       SchemaException

Specified by:

createType in class GranuleCatalog

Throws:

IOException

SchemaException

createType

public void createType(SimpleFeatureType featureType)
                throws IOException

Specified by:

createType in class GranuleCatalog

Throws:

IOException

createType

public void createType(String identification,
                       String typeSpec)
                throws SchemaException,
                       IOException

Specified by:

createType in class GranuleCatalog

Throws:

SchemaException

IOException

dispose

public void dispose()

Specified by:

dispose in class GranuleCatalog

getBounds

public BoundingBox getBounds(String typeName)

Specified by:

getBounds in class GranuleCatalog

getGranulesCount

public int getGranulesCount(Query q)
                     throws IOException

Specified by:

getGranulesCount in class GranuleCatalog

Throws:

IOException

getQueryCapabilities

public QueryCapabilities getQueryCapabilities(String typeName)

Specified by:

getQueryCapabilities in class GranuleCatalog

getType

public SimpleFeatureType getType(String typeName)
                          throws IOException

Specified by:

getType in class GranuleCatalog

Throws:

IOException

removeType

public void removeType(String typeName)
                throws IOException

Specified by:

removeType in class GranuleCatalog

Throws:

IOException

getTypeNames

public String[] getTypeNames()

Specified by:

getTypeNames in class GranuleCatalog

drop

public void drop()
          throws IOException

Description copied from class: GranuleCatalog

Drop the underlying catalog, all the individual granule indexes.

This is usuallu done when deleting an ImageMosaic storre.

Specified by:

drop in class GranuleCatalog

Throws:

IOException - in case something bad happens

getParentLocation

protected String getParentLocation()

Specified by:

getParentLocation in class GranuleCatalog

addGranule

public void addGranule(String typeName,
                       SimpleFeature granule,
                       Transaction transaction)
                throws IOException

Overrides:

addGranule in class GranuleCatalog

Throws:

IOException

getBounds

public BoundingBox getBounds(String typeName,
                             Transaction t)

Overrides:

getBounds in class GranuleCatalog

mergeHints

protected Query mergeHints(Query q)

Description copied from class: GranuleCatalog

Merges the wrapper hints with the query ones, making sure not to overwrite the query ones

Overrides:

mergeHints in class GranuleCatalog

setMultiScaleROIProvider

public void setMultiScaleROIProvider(MultiLevelROIProvider footprintProvider)

Overrides:

setMultiScaleROIProvider in class GranuleCatalog

getGranuleFootprint

protected MultiLevelROI getGranuleFootprint(SimpleFeature sf)

Description copied from class: GranuleCatalog

Returns the footprint for the given granule. Mind, when applying insets we might have the case of the geometry being empty (negative buffer eroded it fully), in that case the granule must not be loaded

Overrides:

getGranuleFootprint in class GranuleCatalog

getFootprintFiles

public List<File> getFootprintFiles(SimpleFeature sf)
                             throws IOException

Description copied from class: GranuleCatalog

Returns the list of footprint files for the given granule

Overrides:

getFootprintFiles in class GranuleCatalog

Throws:

IOException

getConfigurations

protected CatalogConfigurationBeans getConfigurations()

Overrides:

getConfigurations in class GranuleCatalog

getHints

public Hints getHints()

Overrides:

getHints in class GranuleCatalog

getAdaptee

public GranuleCatalog getAdaptee()