/*
* Geotoolkit - An Open Source Java GIS Toolkit
* http://www.geotoolkit.org
*
* (C) 2004-2008, Open Source Geospatial Foundation (OSGeo)
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation;
* version 2.1 of the License.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*/
package org.geotoolkit.data;
import java.net.URI;
import org.apache.sis.storage.DataStoreException;
/**
* FileFeatureStoreFactory for working with formats based on a single URI.
* <p>
* This interface provides a mechanism of discovery for DataStoreFactories
* which support singular files.
* </p>
*
* @author dzwiers
* @author Johann Sorel (Geomatys)
* @module
*/
public interface FileFeatureStoreFactory extends FeatureStoreFactory {
/**
* The list of filename extentions handled by this factory.
*
* @return List of file extensions which can be read by this FeatureStore.
*/
String[] getFileExtensions();
/**
* Tests if the provided uri can be handled by this factory.
*
* @param uri URL to a real file (may not be local)
*
* @return <code>true</code> if this uri can when this FeatureStore can resolve and read the data specified
*/
boolean canProcess(URI uri);
/**
* A FeatureStore attached to the provided uri, may be created if needed.
* <p>
* Please note that additional configuration options may be available
* via the traditional createFeatureStore( Map ) method provided by the
* superclass.
* <p>
* @param uri The data location for the
*
* @return Returns a FeatureStore created from the data source provided.
*
* @throws DataStoreException
*/
FeatureStore createDataStore(URI uri) throws DataStoreException;
}