org.opengis.feature.FeatureVisitor Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of gt-opengis Show documentation

Standard interfaces implemented throughout the library.

There is a newer version: 24.2-oss84-1

/*
 *    GeoTools - The Open Source Java GIS Toolkit
 *    http://geotools.org
 *
 *    (C) 2011, Open Source Geospatial Foundation (OSGeo)
 *    (C) 2004-2007 Open Geospatial Consortium Inc.
 *
 *    All Rights Reserved. http://www.opengis.org/legal/
 */

package org.opengis.feature;

/**
 * FeatureVisitor interface to allow for container optimised traversal.
 *
 * The iterator construct from the Collections api is well understood and loved, but breaks down
 * for working with large GIS data volumes. By using a visitor we allow the implementor of a Feature
 * Collection to make use of additional resources (such as multiple processors or tiled data)
 * concurrently. This interface is most often used for calculations and data transformations and an
 * implementations may intercept known visitors (such as "bounds" or reprojection) and engage an
 * alternate work flow.
 *
 * @author Cory Horner (Refractions Research, Inc)
 */
public interface FeatureVisitor {
    /**
     * Visit the provided feature.
     *
     * Please consult the documentation for the FeatureCollection you are visiting to learn more
     * - the provided feature may be invalid, or read only.
     */
    void visit(Feature feature);
}