abstractfeaturestore.html

Geotools是一个开源的Java GIS工具包,可利用它来开发符合标准的地理信息系统。Geotools提供了OGC(Open Geospatial Consortium)规范的一个实现来作为他们的

 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/geotools/data/AbstractFeatureStore.html#setFeatures(org.geotools.data.FeatureReader)">setFeatures</A></B>(<A HREF="../../../org/geotools/data/FeatureReader.html" title="interface in org.geotools.data">FeatureReader</A>&nbsp;reader)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Replace with contents of reader.
 
 </TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../org/geotools/data/AbstractFeatureStore.html#setTransaction(org.geotools.data.Transaction)">setTransaction</A></B>(<A HREF="../../../org/geotools/data/Transaction.html" title="interface in org.geotools.data">Transaction</A>&nbsp;transaction)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Provides a transaction for commit/rollback control of this FeatureStore.

 </TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_AbstractFeatureSource"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="../../../org/geotools/data/AbstractFeatureSource.html" title="class in org.geotools.data">AbstractFeatureSource</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../org/geotools/data/AbstractFeatureSource.html#getBounds()">getBounds</A>, <A HREF="../../../org/geotools/data/AbstractFeatureSource.html#getBounds(org.geotools.data.Query)">getBounds</A>, <A HREF="../../../org/geotools/data/AbstractFeatureSource.html#getCount(org.geotools.data.Query)">getCount</A>, <A HREF="../../../org/geotools/data/AbstractFeatureSource.html#getFeatures()">getFeatures</A>, <A HREF="../../../org/geotools/data/AbstractFeatureSource.html#getFeatures(org.geotools.filter.Filter)">getFeatures</A>, <A HREF="../../../org/geotools/data/AbstractFeatureSource.html#getFeatures(org.geotools.data.Query)">getFeatures</A>, <A HREF="../../../org/geotools/data/AbstractFeatureSource.html#namedQuery(org.geotools.data.Query)">namedQuery</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_Object"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_FeatureSource"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from interface <A HREF="../../../org/geotools/data/FeatureSource.html" title="interface in org.geotools.data">FeatureSource</A></B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE><A HREF="../../../org/geotools/data/FeatureSource.html#addFeatureListener(org.geotools.data.FeatureListener)">addFeatureListener</A>, <A HREF="../../../org/geotools/data/FeatureSource.html#getBounds()">getBounds</A>, <A HREF="../../../org/geotools/data/FeatureSource.html#getBounds(org.geotools.data.Query)">getBounds</A>, <A HREF="../../../org/geotools/data/FeatureSource.html#getCount(org.geotools.data.Query)">getCount</A>, <A HREF="../../../org/geotools/data/FeatureSource.html#getDataStore()">getDataStore</A>, <A HREF="../../../org/geotools/data/FeatureSource.html#getFeatures()">getFeatures</A>, <A HREF="../../../org/geotools/data/FeatureSource.html#getFeatures(org.geotools.filter.Filter)">getFeatures</A>, <A HREF="../../../org/geotools/data/FeatureSource.html#getFeatures(org.geotools.data.Query)">getFeatures</A>, <A HREF="../../../org/geotools/data/FeatureSource.html#getSchema()">getSchema</A>, <A HREF="../../../org/geotools/data/FeatureSource.html#removeFeatureListener(org.geotools.data.FeatureListener)">removeFeatureListener</A></CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->

<A NAME="field_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Field Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="transaction"><!-- --></A><H3>
transaction</H3>
<PRE>
protected <A HREF="../../../org/geotools/data/Transaction.html" title="interface in org.geotools.data">Transaction</A> <B>transaction</B></PRE>
<DL>
<DD>Current Transaction this FeatureSource is opperating against
<P>
<DL>
</DL>
</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="AbstractFeatureStore()"><!-- --></A><H3>
AbstractFeatureStore</H3>
<PRE>
public <B>AbstractFeatureStore</B>()</PRE>
<DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="getTransaction()"><!-- --></A><H3>
getTransaction</H3>
<PRE>
public <A HREF="../../../org/geotools/data/Transaction.html" title="interface in org.geotools.data">Transaction</A> <B>getTransaction</B>()</PRE>
<DL>
<DD>Retrieve the Transaction this FeatureSource is opperating against.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../org/geotools/data/FeatureStore.html#getTransaction()">getTransaction</A></CODE> in interface <CODE><A HREF="../../../org/geotools/data/FeatureStore.html" title="interface in org.geotools.data">FeatureStore</A></CODE><DT><B>Overrides:</B><DD><CODE><A HREF="../../../org/geotools/data/AbstractFeatureSource.html#getTransaction()">getTransaction</A></CODE> in class <CODE><A HREF="../../../org/geotools/data/AbstractFeatureSource.html" title="class in org.geotools.data">AbstractFeatureSource</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>Transaction FeatureSource is operating against</DL>
</DD>
</DL>
<HR>

<A NAME="modifyFeatures(org.geotools.feature.AttributeType, java.lang.Object, org.geotools.filter.Filter)"><!-- --></A><H3>
modifyFeatures</H3>
<PRE>
public void <B>modifyFeatures</B>(<A HREF="../../../org/geotools/feature/AttributeType.html" title="interface in org.geotools.feature">AttributeType</A>&nbsp;type,
                           <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>&nbsp;value,
                           <A HREF="../../../org/geotools/filter/Filter.html" title="interface in org.geotools.filter">Filter</A>&nbsp;filter)
                    throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
<DL>
<DD>Modifies features matching <code>filter</code>.
 
 <p>
 Equivelent to:
 </p>
 <pre><code>
 FeatureWriter writer = dataStore.getFeatureWriter( typeName, filter, transaction );
 while( writer.hasNext() ){
    feature = writer.next();
    feature.setAttribute( type.getName(), value );
    writer.write();
 }
 writer.close();
 </code>
 </pre>
 
 <p>
 Subclasses may override this method to perform the appropriate
 optimization for this result.
 </p>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../org/geotools/data/FeatureStore.html#modifyFeatures(org.geotools.feature.AttributeType, java.lang.Object, org.geotools.filter.Filter)">modifyFeatures</A></CODE> in interface <CODE><A HREF="../../../org/geotools/data/FeatureStore.html" title="interface in org.geotools.data">FeatureStore</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>type</CODE> - Attribute to modify<DD><CODE>value</CODE> - Modification being made to type<DD><CODE>filter</CODE> - Identifies features to modify
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE> - If modification could not be made<DT><B>See Also:</B><DD><A HREF="../../../org/geotools/data/FeatureStore.html#modifyFeatures(org.geotools.feature.AttributeType, java.lang.Object, org.geotools.filter.Filter)"><CODE>FeatureStore.modifyFeatures(org.geotools.feature.AttributeType,
      java.lang.Object, org.geotools.filter.Filter)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="modifyFeatures(org.geotools.feature.AttributeType[], java.lang.Object[], org.geotools.filter.Filter)"><!-- --></A><H3>
modifyFeatures</H3>
<PRE>
public void <B>modifyFeatures</B>(<A HREF="../../../org/geotools/feature/AttributeType.html" title="interface in org.geotools.feature">AttributeType</A>[]&nbsp;type,
                           <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A>[]&nbsp;value,
                           <A HREF="../../../org/geotools/filter/Filter.html" title="interface in org.geotools.filter">Filter</A>&nbsp;filter)
                    throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
<DL>
<DD>Modifies features matching <code>filter</code>.
 
 <p>
 Equivelent to:
 </p>
 <pre><code>
 FeatureWriter writer = dataStore.getFeatureWriter( typeName, filter, transaction );
 Feature feature;
 while( writer.hasNext() ){
    feature = writer.next();
    feature.setAttribute( type[0].getName(), value[0] );
    feature.setAttribute( type[1].getName(), value[1] );
    ...
    feature.setAttribute( type[N].getName(), value[N] ); 
    writer.write();
 }
 writer.close();
 </code>
 </pre>
 
 <p>
 Subclasses may override this method to perform the appropriate
 optimization for this result.
 </p>
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../org/geotools/data/FeatureStore.html#modifyFeatures(org.geotools.feature.AttributeType[], java.lang.Object[], org.geotools.filter.Filter)">modifyFeatures</A></CODE> in interface <CODE><A HREF="../../../org/geotools/data/FeatureStore.html" title="interface in org.geotools.data">FeatureStore</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>type</CODE> - Attributes to modify<DD><CODE>value</CODE> - Modifications being made to type<DD><CODE>filter</CODE> - Identifies features to modify
<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></CODE> - If we could not modify Feature
<DD><CODE><A HREF="../../../org/geotools/data/DataSourceException.html" title="class in org.geotools.data">DataSourceException</A></CODE> - See IOException<DT><B>See Also:</B><DD><A HREF="../../../org/geotools/data/FeatureStore.html#modifyFeatures(org.geotools.feature.AttributeType, java.lang.Object, org.geotools.filter.Filter)"><CODE>FeatureStore.modifyFeatures(org.geotools.feature.AttributeType,
      java.lang.Object, org.geotools.filter.Filter)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="addFeatures(org.geotools.data.FeatureReader)"><!-- --></A><H3>
addFeatures</H3>
<PRE>
public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/Set.html" title="class or interface in java.util">Set</A> <B>addFeatures</B>(<A HREF="../../../org/geotools/data/FeatureReader.html" title="interface in org.geotools.data">FeatureReader</A>&nbsp;reader)
                throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A></PRE>
<DL>
<DD>Add Features from reader to this FeatureStore.
 
 <p>
 Equivelent to:
 </p>
 <pre><code>
 Set set = new HashSet();
 FeatureWriter writer = dataStore.getFeatureWriter( typeName, true, transaction );
 Featrue feature, newFeature;
 while( reader.hasNext() ){
    feature = reader.next();
    newFeature = writer.next();
    newFeature.setAttributes( feature.getAttribtues( null ) );
    writer.write();
    set.add( newfeature.getID() );
 }
 reader.close();