com.vividsolutions.jump.io.datasource
Interface Connection


public interface Connection

A channel of communication with a DataSource.


Method Summary
 void close()
          Ends the connection, performing any necessary cleanup.
 FeatureCollection executeQuery(java.lang.String query, java.util.Collection exceptions, TaskMonitor monitor)
          Returns from a DataSource a dataset specified using a query string (the format of which is implementation-dependent).
 FeatureCollection executeQuery(java.lang.String query, TaskMonitor monitor)
          Returns from a DataSource a dataset specified using a query string (the format of which is implementation-dependent).
 void executeUpdate(java.lang.String query, FeatureCollection featureCollection, TaskMonitor monitor)
          Modifies data in the DataSource accordinate to a query string (the format of which is implementation-dependent).
 

Method Detail

executeQuery

FeatureCollection executeQuery(java.lang.String query,
                               java.util.Collection exceptions,
                               TaskMonitor monitor)
Returns from a DataSource a dataset specified using a query string (the format of which is implementation-dependent). Callers: be sure to call DataSource#setCoordinateSystem on the returned FeatureCollection.

Parameters:
query - identifies the dataset; may take the form of a SQL statement, a table name, null (if there is only one dataset), or other format
exceptions - a Collection to hold exceptions that occurred (so that processing can continue).
Returns:
null if a FeatureCollection could not be created because of a serious problem (indicated in the exceptions)

executeQuery

FeatureCollection executeQuery(java.lang.String query,
                               TaskMonitor monitor)
                               throws java.lang.Exception
Returns from a DataSource a dataset specified using a query string (the format of which is implementation-dependent). If an exception occurs, processing is stopped and the exception thrown. Callers: be sure to call DataSource#setCoordinateSystem on the returned FeatureCollection.

Throws:
java.lang.Exception

executeUpdate

void executeUpdate(java.lang.String query,
                   FeatureCollection featureCollection,
                   TaskMonitor monitor)
                   throws java.lang.Exception
Modifies data in the DataSource accordinate to a query string (the format of which is implementation-dependent).

Throws:
java.lang.Exception

close

void close()
Ends the connection, performing any necessary cleanup.