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

public 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

public 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

public 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

public void close()

Ends the connection, performing any necessary cleanup.