com.esri.arcgis.system

Class DatabaseUtilities

java.lang.Object

com.esri.arcgis.system.DatabaseUtilities

public class DatabaseUtilities
extends java.lang.Object

The DatabaseUtilities class provides convenient methods which allows obtaining Iterator<IFeature> from searching an IFeatureClass with different query parameters and obtaining Iterator<IRow> from searching an ITable with different query parameters.

Since:

10.9.1

Constructor Summary

Constructors

Constructor and Description
DatabaseUtilities()

Method Summary

Modifier and Type	Method and Description
static java.util.Iterator	searchFeatures(IFeatureClass fc) Returns all features in the feature class with the recycling cursor.
static java.util.Iterator	searchFeatures(IFeatureClass fc, java.lang.String where) Returns all features in the feature class matching the given where clause with the recycling cursor.
static java.util.Iterator	searchFeatures(IFeatureClass fc, java.lang.String where, boolean recycling) Returns all features in the feature class matching the given where clause.
static java.util.Iterator	searchFeatures(IFeatureClass fc, java.lang.String where, IGeometry geometry) Searches the FeatureClass for features matching the given where-clause and intersecting the given geometry with recycling cursor.
static java.util.Iterator	searchFeatures(IFeatureClass fc, java.lang.String where, IGeometry geometry, int spatialRel) Searches the FeatureClass for features matching the given where clause and having the given relationship to the input geometry with recycling cursor.
static java.util.Iterator	searchFeatures(IFeatureClass fc, java.lang.String where, IGeometry geometry, int spatialRel, boolean recycling) Searches the FeatureClass for features matching the given where clause and having the given spatial relationship to the input geometry.
static java.util.Iterator	searchRows(ITable table) Returns all rows in the table with the recycling cursor.
static java.util.Iterator	searchRows(ITable table, java.lang.String where) Returns all rows in the table matching the given where clause with the recycling cursor.
static java.util.Iterator	searchRows(ITable table, java.lang.String where, boolean recycling) Returns all rows in the table matching the given where clause.

Methods inherited from class java.lang.Object

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

Constructor Detail

DatabaseUtilities

public DatabaseUtilities()

Method Detail

searchFeatures

public static java.util.Iterator searchFeatures(IFeatureClass fc)
                                         throws java.io.IOException

Returns all features in the feature class with the recycling cursor. If you want to use non-recycling cursor, call the DataUtilities.searchFeatures(IFeatureClass fc, String where, boolean recycling) method.

Parameters:

fc - the feature class (IFeatureClass) to search.

Returns:

a collection of features Iterator as the search result.

Throws:

java.io.IOException

searchFeatures

public static java.util.Iterator searchFeatures(IFeatureClass fc,
                                                java.lang.String where)
                                         throws java.io.IOException

Returns all features in the feature class matching the given where clause with the recycling cursor. If you want to use non-recycling cursor, call the DataUtilities.searchFeatures(IFeatureClass fc, String where, boolean recycling) method.

Parameters:

fc - the feature class (IFeatureClass) to search.

where - the Stringwhere clause to perform search.

Returns:

a collection of features Iterator as the search result.

Throws:

java.io.IOException

searchFeatures

public static java.util.Iterator searchFeatures(IFeatureClass fc,
                                                java.lang.String where,
                                                boolean recycling)
                                         throws java.io.IOException

Returns all features in the feature class matching the given where clause. Recycling behavior can also be controlled.

Parameters:

fc - the feature class (IFeatureClass) to search.

where - the Stringwhere clause to perform search.

recycling - true if recycling cursor is used and false is non-recycling cursor is used.

Returns:

a collection of features Iterator as the search result.

Throws:

java.io.IOException

searchFeatures

public static java.util.Iterator searchFeatures(IFeatureClass fc,
                                                java.lang.String where,
                                                IGeometry geometry,
                                                int spatialRel,
                                                boolean recycling)
                                         throws java.io.IOException,
                                                AutomationException

Searches the FeatureClass for features matching the given where clause and having the given spatial relationship to the input geometry. Recycling behavior is controlled.

Parameters:

fc - the feature class (IFeatureClass) to search.

where - the Stringwhere clause to perform search.

geometry - the input IGeometry that matching features intersect.

spatialRel - the spatial relationship defined as esriSpatialRelEnum.

recycling - true if recycling cursor is used and false if non-recycling cursor is used.

Returns:

a collection of features Iterator as the search result.

Throws:

java.io.IOException

AutomationException

searchFeatures

public static java.util.Iterator searchFeatures(IFeatureClass fc,
                                                java.lang.String where,
                                                IGeometry geometry,
                                                int spatialRel)
                                         throws java.io.IOException

Searches the FeatureClass for features matching the given where clause and having the given relationship to the input geometry with recycling cursor.

Parameters:

fc - the feature class (IFeatureClass) to search.

where - the Stringwhere clause to perform search.

geometry - the defined IGeometry that matching features intersect.

spatialRel - the spatial relationship defined as esriSpatialRelEnum.

Returns:

a collection of features Iterator as the search result.

Throws:

java.io.IOException

searchFeatures

public static java.util.Iterator searchFeatures(IFeatureClass fc,
                                                java.lang.String where,
                                                IGeometry geometry)
                                         throws java.io.IOException

Searches the FeatureClass for features matching the given where-clause and intersecting the given geometry with recycling cursor.

Parameters:

fc - the feature class (IFeatureClass) to search.

where - the Stringwhere clause to perform search.

geometry - the defined IGeometry that matching features intersect.

Returns:

a collection of features in Iterator as the search result.

Throws:

java.io.IOException

searchRows

public static java.util.Iterator searchRows(ITable table)
                                     throws java.io.IOException

Returns all rows in the table with the recycling cursor. If you want to use non-recycling cursor, call the DataUtilities.searchRows(ITable table, String where, boolean recycling) method.

Parameters:

table - the table (ITable) to search.

Returns:

a collection of rows in Iterator as the search result.

Throws:

java.io.IOException

searchRows

public static java.util.Iterator searchRows(ITable table,
                                            java.lang.String where)
                                     throws java.io.IOException

Returns all rows in the table matching the given where clause with the recycling cursor. If you want to use non-recycling cursor, call the DataUtilities.searchRows(ITable table, String where, boolean recycling) method.

Parameters:

table - the table (ITable) to search.

where - the Stringwhere clause to perform search.

Returns:

a collection of rows Iterator as the search result.

Throws:

java.io.IOException

searchRows

public static java.util.Iterator searchRows(ITable table,
                                            java.lang.String where,
                                            boolean recycling)
                                     throws java.io.IOException

Returns all rows in the table matching the given where clause. Recycling behavior can also be controlled.

Parameters:

table - the table (ITable) to search.

where - the Stringwhere clause to perform search.

recycling - true if recycling cursor is used and false is non-recycling cursor is used.

Returns:

a collection of rows Iterator as the search result.

Throws:

java.io.IOException