jdbcfeaturestore.html

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

 <p>
 All our implementations here are rely on
 FeatureWriter to check the locks.
 </p>
 <p>
 When making your own SQL opperations, have a look at
 assertFids( Set fids ), and assertFids( Filter ). You 
 may use these to check against the lockingManager if one is used.
 </p>
 If the lockingManager is not used, ie is null, it assumed that you are
 making use of native database locks. Or doing your own thing.
 </p>
 <p>
 That is the assertFids functions only when lockingManager is non null.
 </p>
<P>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>LockingManager</DL>
</DD>
</DL>
<HR>

<A NAME="fids(org.geotools.filter.Filter)"><!-- --></A><H3>
fids</H3>
<PRE>
protected <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>fids</B>(<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/util/NoSuchElementException.html" title="class or interface in java.util">NoSuchElementException</A>,
                   <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/IOException.html" title="class or interface in java.io">IOException</A>,
                   <A HREF="../../../../org/geotools/feature/IllegalAttributeException.html" title="class in org.geotools.feature">IllegalAttributeException</A></PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/NoSuchElementException.html" title="class or interface in java.util">NoSuchElementException</A></CODE>
<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>
<DD><CODE><A HREF="../../../../org/geotools/feature/IllegalAttributeException.html" title="class in org.geotools.feature">IllegalAttributeException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="assertFilter(org.geotools.filter.Filter)"><!-- --></A><H3>
assertFilter</H3>
<PRE>
protected void <B>assertFilter</B>(<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><DL>
</DL>
</DD>
<DD><DL>

<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></DL>
</DD>
</DL>
<HR>

<A NAME="assertFids(java.util.Set)"><!-- --></A><H3>
assertFids</H3>
<PRE>
protected void <B>assertFids</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/Set.html" title="class or interface in java.util">Set</A>&nbsp;fids)
                   throws <A HREF="../../../../org/geotools/data/FeatureLockException.html" title="class in org.geotools.data">FeatureLockException</A></PRE>
<DL>
<DD><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../org/geotools/data/FeatureLockException.html" title="class in org.geotools.data">FeatureLockException</A></CODE></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>
 modifyFeatures( new AttributeType[]{ type, }, new Object[]{ value, }, filter );
 </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><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><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.data.FeatureWriter)"><!-- --></A><H3>
modifyFeatures</H3>
<PRE>
protected 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/data/FeatureWriter.html" title="interface in org.geotools.data">FeatureWriter</A>&nbsp;writer)
                       throws <A HREF="../../../../org/geotools/data/DataSourceException.html" title="class in org.geotools.data">DataSourceException</A>,
                              <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><DL>
</DL>
</DD>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../org/geotools/data/DataSourceException.html" title="class in org.geotools.data">DataSourceException</A></CODE>
<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></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();
 writer.close();
 
 return set;
 </code>
 </pre>
 
 <p>
 (If you don't have a FeatureReader handy DataUtilities.reader() may be
 able to help out)
 </p>