/*
* GeoTools - The Open Source Java GIS Toolkit
* http://geotools.org
*
* (C) 2002-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.geotools.feature;
import java.awt.RenderingHints;
import java.util.Collections;
import java.util.Map;
import org.geotools.data.simple.SimpleFeatureCollection;
import org.geotools.factory.CommonFactoryFinder;
import org.geotools.factory.Factory;
import org.geotools.factory.GeoTools;
/**
* A utility class for working with FeatureCollections.
* Provides a mechanism for obtaining a SimpleFeatureCollection instance.
* @author Ian Schneider
*
* @source $URL$
*/
public abstract class FeatureCollections implements Factory {
private static FeatureCollections instance() {
// depend on CommonFactoryFinder's FactoryRegistry to hold singleton
return CommonFactoryFinder.getFeatureCollections( GeoTools.getDefaultHints() );
}
/**
* create a new SimpleFeatureCollection using the current default factory.
* @return A SimpleFeatureCollection instance.
*/
public static SimpleFeatureCollection newCollection() {
return instance().createCollection();
}
/**
* Creates a new SimpleFeatureCollection with a particular id using the current
* default factory.
*
* @param id The id of the feature collection.
*
* @return A new SimpleFeatureCollection intsance with the specified id.
*
* @since 2.4
*/
public static SimpleFeatureCollection newCollection( String id ) {
return instance().createCollection( id );
}
/**
* Subclasses must implement this to return a new SimpleFeatureCollection object.
* @return A new FeatureCollection
*/
protected abstract SimpleFeatureCollection createCollection();
/**
* Subclasses must implement this to return a new SimpleFeatureCollection object
* with a particular id.
*
* @param id The identification of the feature collection.
*
* @return A new SimpleFeatureCollection with the specified id.
*/
protected abstract SimpleFeatureCollection createCollection( String id );
/**
* Returns the implementation hints. The default implementation returns en empty map.
*/
public Map<RenderingHints.Key,Object> getImplementationHints() {
return Collections.emptyMap();
}
}