Package org.geotools.jdbc

Class JDBCUpdateInsertFeatureWriter

Object

JDBCFeatureReader

JDBCUpdateFeatureWriter

JDBCUpdateInsertFeatureWriter

All Implemented Interfaces:

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

public class JDBCUpdateInsertFeatureWriter
extends JDBCUpdateFeatureWriter

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
JDBCUpdateInsertFeatureWriter(String sql, Connection cx, JDBCFeatureSource featureSource, Query query)
JDBCUpdateInsertFeatureWriter(PreparedStatement ps, Connection cx, JDBCFeatureSource featureSource, String[] attributeNames, Query query)

Method Summary

Modifier and Type	Method	Description
void	close()	Release the underlying resources associated with this stream.
boolean	hasNext()	Query whether this FeatureReader has another Feature.
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, init, readNextFeature, setNext

Methods inherited from class Object

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

Methods inherited from interface FeatureWriter

getFeatureType

Constructor Detail

JDBCUpdateInsertFeatureWriter

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

Throws:

SQLException

IOException

JDBCUpdateInsertFeatureWriter

public JDBCUpdateInsertFeatureWriter(PreparedStatement ps,
                                     Connection cx,
                                     JDBCFeatureSource featureSource,
                                     String[] attributeNames,
                                     Query query)
                              throws SQLException,
                                     IOException

Throws:

SQLException

IOException

Method Detail

hasNext

public boolean hasNext()
                throws IOException

Description copied from interface: FeatureReader

Query whether this FeatureReader has another Feature.

Specified by:

hasNext in interface FeatureReader<SimpleFeatureType,SimpleFeature>

Specified by:

hasNext in interface FeatureWriter<SimpleFeatureType,SimpleFeature>

Overrides:

hasNext in class JDBCFeatureReader

Returns:

True if there are more Features to be read. In other words, true if calls to next would return a feature rather than throwing an exception.

Throws:

IOException - If an error occurs determining if there are more Features.

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 JDBCUpdateFeatureWriter

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>

Overrides:

remove in class JDBCUpdateFeatureWriter

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>

Overrides:

write in class JDBCUpdateFeatureWriter

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 JDBCUpdateFeatureWriter

Throws:

IOException - if an I/O error occurs