Package org.geotools.jdbc

Class JDBCUpdateFeatureWriter

Object

JDBCFeatureReader

JDBCUpdateFeatureWriter

All Implemented Interfaces:

Closeable, AutoCloseable, FeatureReader<SimpleFeatureType,SimpleFeature>, FeatureWriter<SimpleFeatureType,SimpleFeature>

Direct Known Subclasses:

JDBCUpdateInsertFeatureWriter

public class JDBCUpdateFeatureWriter
extends JDBCFeatureReader
implements FeatureWriter<SimpleFeatureType,SimpleFeature>

Nested Class Summary

Nested classes/interfaces inherited from class JDBCFeatureReader

JDBCFeatureReader.ResultSetFeature

Field Summary

Fields inherited from class JDBCFeatureReader

builder, callback, columnNames, cx, dataStore, featureSource, featureType, geometryFactory, hints, LOGGER, md, next, offset, pkey, query, rs, screenMap, st, TRACE_ENABLED, tracer, tx

Constructor Summary

Constructors

Constructor	Description
JDBCUpdateFeatureWriter(String sql, Connection cx, JDBCFeatureSource featureSource, Query query)
JDBCUpdateFeatureWriter(PreparedStatement ps, Connection cx, JDBCFeatureSource featureSource, Query query)

Method Summary

Modifier and Type	Method	Description
void	close()	Release the underlying resources associated with this stream.
SimpleFeature	next()	Reads the next Feature in the FeatureReader.
void	remove()	Removes current Feature, must be called before hasNext.
void	write()	Writes the current Feature, must be called before hasNext.

Methods inherited from class JDBCFeatureReader

cleanup, ensureNext, ensureOpen, finalize, getFeatureType, getPrimaryKey, getQuery, hasNext, init, readNextFeature, setNext

Methods inherited from class Object

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

Methods inherited from interface FeatureWriter

getFeatureType, hasNext

Constructor Details

JDBCUpdateFeatureWriter

public JDBCUpdateFeatureWriter(String sql,
 Connection cx,
 JDBCFeatureSource featureSource,
 Query query)
                        throws SQLException,
IOException

Throws:

SQLException

IOException

JDBCUpdateFeatureWriter

public JDBCUpdateFeatureWriter(PreparedStatement ps,
 Connection cx,
 JDBCFeatureSource featureSource,
 Query query)
                        throws SQLException,
IOException

Throws:

SQLException

IOException

Method Details

next

public SimpleFeature next()
                   throws IOException,
IllegalArgumentException,
NoSuchElementException

Description copied from interface: FeatureReader

Reads the next Feature in the FeatureReader.

Specified by:

next in interface FeatureReader<SimpleFeatureType,SimpleFeature>

Specified by:

next in interface FeatureWriter<SimpleFeatureType,SimpleFeature>

Overrides:

next in class JDBCFeatureReader

Returns:

The next feature in the reader.

Throws:

IOException - If an error occurs reading the Feature.

NoSuchElementException - If there are no more Features in the Reader.

IllegalArgumentException

remove

public void remove()
            throws IOException

Description copied from interface: FeatureWriter

Removes current Feature, must be called before hasNext.

FeatureWriters will need to allow all FeatureSources of the same typeName to issue a FeatureEvent event of type FeatureEvent.FEATURES_REMOVED when this method is called.

If this FeatureWriter is opperating against a Transaction FEATURES_REMOVED events should only be sent to FeatureSources operating on the same Transaction. When Transaction commit() is called other FeatureSources will be informed of the modifications.

When the current Feature has been provided as new content, this method "cancels" the add opperation (and notification needed).

Specified by:

remove in interface FeatureWriter<SimpleFeatureType,SimpleFeature>

Throws:

IOException

write

public void write()
           throws IOException

Description copied from interface: FeatureWriter

Writes the current Feature, must be called before hasNext.

FeautreWriters will need to allow FeatureSources of the same typeName to issue a FeatureEvent:

• FeatureEvent.FEATURES_ADDED: when next() has been called with hasNext() equal to false.
• FeatureEvent.FEATURES_MODIFIED: when next has been called with hasNext() equal to true and the resulting Feature has indeed been modified.

If this FeatureWriter is opperating against a Transaction the FEATURES_MODIFIED or FEATURES_ADDED events should only be sent to FeatureSources opperating on the same Transaction. When Transaction commit() is called other FeatureSources will be informed of the modifications.

If you have not called write() when you call hasNext() or next(), no modification will occur().

Specified by:

write in interface FeatureWriter<SimpleFeatureType,SimpleFeature>

Throws:

IOException

close

public void close()
           throws IOException

Description copied from interface: FeatureReader

Release the underlying resources associated with this stream.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in interface FeatureReader<SimpleFeatureType,SimpleFeature>

Specified by:

close in interface FeatureWriter<SimpleFeatureType,SimpleFeature>

Overrides:

close in class JDBCFeatureReader

Throws:

IOException - if an I/O error occurs