org.geotools.data

Class EmptyFeatureWriter

Object

EmptyFeatureWriter

All Implemented Interfaces:

Closeable, AutoCloseable, FeatureWriter<SimpleFeatureType,SimpleFeature>

public class EmptyFeatureWriter
extends Object
implements FeatureWriter<SimpleFeatureType,SimpleFeature>

Represents an Empty, Typed, FeatureWriter.

Author:

Jody Garnett, Refractions Research

Constructor Summary

Constructors

Constructor and Description
EmptyFeatureWriter(SimpleFeatureType featureType) An Empty FeatureWriter of the provided featureType.

Method Summary

Modifier and Type	Method and Description
void	close() Cleans up after Empty FeatureWriter.
SimpleFeatureType	getFeatureType() FeatureType this reader has been configured to create.
boolean	hasNext() There is no next Feature.
SimpleFeature	next() Throws NoSuchElementException as this is an Empty FeatureWriter.
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 Object

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

Constructor Detail

EmptyFeatureWriter

public EmptyFeatureWriter(SimpleFeatureType featureType)

An Empty FeatureWriter of the provided featureType.

Method Detail

getFeatureType

public SimpleFeatureType getFeatureType()

Description copied from interface: FeatureWriter

FeatureType this reader has been configured to create.

Specified by:

getFeatureType in interface FeatureWriter<SimpleFeatureType,SimpleFeature>

Returns:

FeatureType this writer has been configured to create.

See Also:

FeatureWriter.getFeatureType()

next

public SimpleFeature next()
                   throws NoSuchElementException

Throws NoSuchElementException as this is an Empty FeatureWriter.

Specified by:

next in interface FeatureWriter<SimpleFeatureType,SimpleFeature>

Returns:

Does not return

Throws:

NoSuchElementException

See Also:

FeatureWriter.next()

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

See Also:

FeatureWriter.remove()

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

See Also:

FeatureWriter.remove()

hasNext

public boolean hasNext()

There is no next Feature.

Specified by:

hasNext in interface FeatureWriter<SimpleFeatureType,SimpleFeature>

Returns:

false

See Also:

FeatureWriter.hasNext()

close

public void close()

Cleans up after Empty FeatureWriter.

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface FeatureWriter<SimpleFeatureType,SimpleFeature>

See Also:

FeatureWriter.close()