public interface FeatureWriter<T extends FeatureType,F extends Feature> extends Closeable
Capabilities:
false
to allow new feature creation. These
changes
One thing that is really nice about the approach to adding content is that the generation of FID is not left in the users control.
Modifier and Type | Method and Description |
---|---|
void |
close()
Release the underlying resources.
|
T |
getFeatureType()
FeatureType this reader has been configured to create.
|
boolean |
hasNext()
Query whether this FeatureWriter has another Feature.
|
F |
next()
Reads a Feature from the underlying AttributeReader.
|
void |
remove()
Removes current Feature, must be called before hasNext.
|
void |
write()
Writes the current Feature, must be called before hasNext.
|
T getFeatureType()
F next() throws IOException
This method may return a Feature even though hasNext() returns false
, this
allows FeatureWriters to provide an ability to append content.
IOException
- if the writer has been closed or an I/O error occurs reading the next
Feature
.void remove() throws IOException
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).
IOException
- DOCUMENT ME!void write() throws IOException
FeautreWriters will need to allow FeatureSources of the same typeName to issue a FeatureEvent:
false
.
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().
IOException
boolean hasNext() throws IOException
Please note: it is more efficient to construct your FeatureWriter with a Filer (to skip entries you do not want), than to force the creation of entire Features only to skip over them.
FeatureWriters that support append operations will allow calls to next, even when
hasNext() returns false
.
true
if an additional Feature
is available, false
if not.IOException
- if an I/O error occurs.void close() throws IOException
close
in interface AutoCloseable
close
in interface Closeable
IOException
- if there there are problems releasing underlying resources, or possibly
if close has been called (up to the implementation).IOException
- if an I/O error occursCopyright © 1996–2019 Geotools. All rights reserved.