org.geotools.gce.imagemosaic.jdbc.custom

Class JDBCPGRasterConfigurationBuilder

Object

JDBCPGRasterConfigurationBuilder

public class JDBCPGRasterConfigurationBuilder
extends Object

A JDBC PGRaster configuration builder class. It allows to configure a PGRaster based ImageMosaicJDBC starting from: - a folder containing several tiles previously created through gdal_retile - a configuration bean specifying PG credentials, database, table, coverage name and files extensions

The configuration may be specified in 2 different ways: 1) through an input string with the following format: pgraster://USER:PASS@HOST:PORT:DATABASE.SCHEMA.TABLE@EPSGCODE:*.FILE_EXTENSION?OPTIONS#/PATH/TO/RASTER_TILES/"

In this case, a JDBCPGRasterConfigurationBean instance will be created on top of this String. That String also contains the RASTER_TILES PATH representing the folder containing tiles previously created with gdal_retile. Note that gdal_retile will create tiles using that structure: - level 0 is put into the target dir - level i is put into subfolder i inside target dir

NOTE that -useDirForEachRow gdal option isn't currently supported by the importer.

FILE_EXTENSION and OPTIONS configuration properties are optional (in case the user did the tiles import on his own)

2) a JDBCPGRasterConfigurationBean instance. The input string simply contains the RASTER_TILES PATH on this case.

Author:

Daniele Romagnoli, GeoSolutions SAS

Constructor Summary

Constructors

Constructor and Description
JDBCPGRasterConfigurationBuilder(JDBCPGrasterConfigurationBean configBean, URL configDir) A configuration builder constructor

Method Summary

Modifier and Type	Method and Description
static void	checkRaster2Pgsql() Check the availability of raster2pgsql command
static URL	createConfiguration(String url, Hints hints) Prepare the PGRaster configuration steps: - importing tiles into the DB and create metadata table if needed - prepare the URL of the XML configuration file and return that URL.
static boolean	isRaster2PgsqlAvailable() Check whether the raster2pgsql script is available

Methods inherited from class Object

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

Constructor Detail

JDBCPGRasterConfigurationBuilder

public JDBCPGRasterConfigurationBuilder(JDBCPGrasterConfigurationBean configBean,
                                        URL configDir)

A configuration builder constructor

Parameters:

configBean - the configuration bean

configDir - the directory containing data to be configured

Method Detail

isRaster2PgsqlAvailable

public static boolean isRaster2PgsqlAvailable()

Check whether the raster2pgsql script is available

Returns:

checkRaster2Pgsql

public static void checkRaster2Pgsql()

Check the availability of raster2pgsql command

createConfiguration

public static URL createConfiguration(String url,
                                      Hints hints)

Prepare the PGRaster configuration steps: - importing tiles into the DB and create metadata table if needed - prepare the URL of the XML configuration file and return that URL.

The input url String may represent: - 1) the path of the folder containing tiles to be mosaicked, previously generated with gdal_retile. 2) an inline configuration specification in that form: pgraster://USER:PASS@HOST:PORT:DATABASE.SCHEMA.TABLE@EPSGCODE:*.FILE_EXTENSION?OPTIONS#/PATH/TO/RASTER_TILES/"

Parameters:

url - a String referring to the mosaic to be configured.

hints - hints containing a JDBCPGrasterConfigurationBean bean in case the url string doesn't specify the configuration params inline.

Returns:

the URL of the generated XML file containing the ImageMosaicJDBC configuration (mapping + connection + coverage configs)