wfsdatastore.html

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

<DT><B>Returns:</B><DD>DOCUMENT ME!
<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/AbstractDataStore.html#getSchema(java.lang.String)"><CODE>AbstractDataStore.getSchema(java.lang.String)</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="getSchemaGet(java.lang.String)"><!-- --></A><H3>
getSchemaGet</H3>
<PRE>
protected <A HREF="../../../../org/geotools/feature/FeatureType.html" title="interface in org.geotools.feature">FeatureType</A> <B>getSchemaGet</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;typeName)
                            throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/org/xml/sax/SAXException.html" title="class or interface in org.xml.sax">SAXException</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>

<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/org/xml/sax/SAXException.html" title="class or interface in org.xml.sax">SAXException</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="getSchemaPost(java.lang.String)"><!-- --></A><H3>
getSchemaPost</H3>
<PRE>
protected <A HREF="../../../../org/geotools/feature/FeatureType.html" title="interface in org.geotools.feature">FeatureType</A> <B>getSchemaPost</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;typeName)
                             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>,
                                    <A HREF="http://java.sun.com/j2se/1.4/docs/api/org/xml/sax/SAXException.html" title="class or interface in org.xml.sax">SAXException</A></PRE>
<DL>
<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>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/org/xml/sax/SAXException.html" title="class or interface in org.xml.sax">SAXException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="getFeatureReaderGet(org.geotools.data.Query, org.geotools.data.Transaction)"><!-- --></A><H3>
getFeatureReaderGet</H3>
<PRE>
protected <A HREF="../../../../org/geotools/data/FeatureReader.html" title="interface in org.geotools.data">FeatureReader</A> <B>getFeatureReaderGet</B>(<A HREF="../../../../org/geotools/data/Query.html" title="interface in org.geotools.data">Query</A>&nbsp;request,
                                            <A HREF="../../../../org/geotools/data/Transaction.html" title="interface in org.geotools.data">Transaction</A>&nbsp;transaction)
                                     throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/UnsupportedEncodingException.html" title="class or interface in java.io">UnsupportedEncodingException</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="http://java.sun.com/j2se/1.4/docs/api/org/xml/sax/SAXException.html" title="class or interface in org.xml.sax">SAXException</A></PRE>
<DL>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/UnsupportedEncodingException.html" title="class or interface in java.io">UnsupportedEncodingException</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="http://java.sun.com/j2se/1.4/docs/api/org/xml/sax/SAXException.html" title="class or interface in org.xml.sax">SAXException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="getFeatureReaderPost(org.geotools.data.Query, org.geotools.data.Transaction)"><!-- --></A><H3>
getFeatureReaderPost</H3>
<PRE>
protected <A HREF="../../../../org/geotools/data/FeatureReader.html" title="interface in org.geotools.data">FeatureReader</A> <B>getFeatureReaderPost</B>(<A HREF="../../../../org/geotools/data/Query.html" title="interface in org.geotools.data">Query</A>&nbsp;query,
                                             <A HREF="../../../../org/geotools/data/Transaction.html" title="interface in org.geotools.data">Transaction</A>&nbsp;transaction)
                                      throws <A HREF="http://java.sun.com/j2se/1.4/docs/api/org/xml/sax/SAXException.html" title="class or interface in org.xml.sax">SAXException</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>

<DT><B>Throws:</B>
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/org/xml/sax/SAXException.html" title="class or interface in org.xml.sax">SAXException</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="getFeatureReader(java.lang.String)"><!-- --></A><H3>
getFeatureReader</H3>
<PRE>
protected <A HREF="../../../../org/geotools/data/FeatureReader.html" title="interface in org.geotools.data">FeatureReader</A> <B>getFeatureReader</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;typeName)
                                  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><B>Description copied from class: <CODE><A HREF="../../../../org/geotools/data/AbstractDataStore.html" title="class in org.geotools.data">AbstractDataStore</A></CODE></B></DD>
<DD>Subclass must implement.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../../org/geotools/data/AbstractDataStore.html#getFeatureReader(java.lang.String)">getFeatureReader</A></CODE> in class <CODE><A HREF="../../../../org/geotools/data/AbstractDataStore.html" title="class in org.geotools.data">AbstractDataStore</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>typeName</CODE> - 
<DT><B>Returns:</B><DD>FeatureReader over contents of typeName
<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="getFeatureReader(java.lang.String, org.geotools.data.Query)"><!-- --></A><H3>
getFeatureReader</H3>
<PRE>
protected <A HREF="../../../../org/geotools/data/FeatureReader.html" title="interface in org.geotools.data">FeatureReader</A> <B>getFeatureReader</B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A>&nbsp;typeName,
                                         <A HREF="../../../../org/geotools/data/Query.html" title="interface in org.geotools.data">Query</A>&nbsp;query)
                                  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><B>Description copied from class: <CODE><A HREF="../../../../org/geotools/data/AbstractDataStore.html" title="class in org.geotools.data">AbstractDataStore</A></CODE></B></DD>
<DD>GR: this method is called from inside getFeatureReader(Query ,Transaction )
 to allow subclasses return an optimized FeatureReader wich supports the
 filter and attributes truncation specified in <code>query</code>
 <p>
 A subclass that supports the creation of such an optimized FeatureReader
 shold override this method. Otherwise, it just returns
 <code>getFeatureReader(typeName)</code>
 <p>
<P>
<DD><DL>
<DT><B>Overrides:</B><DD><CODE><A HREF="../../../../org/geotools/data/AbstractDataStore.html#getFeatureReader(java.lang.String, org.geotools.data.Query)">getFeatureReader</A></CODE> in class <CODE><A HREF="../../../../org/geotools/data/AbstractDataStore.html" title="class in org.geotools.data">AbstractDataStore</A></CODE></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="getFeatureReader(org.geotools.data.Query, org.geotools.data.Transaction)"><!-- --></A><H3>
getFeatureReader</H3>
<PRE>
public <A HREF="../../../../org/geotools/data/FeatureReader.html" title="interface in org.geotools.data">FeatureReader</A> <B>getFeatureReader</B>(<A HREF="../../../../org/geotools/data/Query.html" title="interface in org.geotools.data">Query</A>&nbsp;query,
                                      <A HREF="../../../../org/geotools/data/Transaction.html" title="interface in org.geotools.data">Transaction</A>&nbsp;transaction)
                               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><B>Description copied from interface: <CODE><A HREF="../../../../org/geotools/data/DataStore.html" title="interface in org.geotools.data">DataStore</A></CODE></B></DD>
<DD>Access a FeatureReader providing access to Feature information.

 <p>
 <b>Filter</b> is used as a low-level indication of constraints.
 (Implementations may resort to using a FilteredFeatureReader, or
 provide their own optimizations)
 </p>

 <p>
 <b>FeatureType</b> provides a template for the returned FeatureReader
 </p>

 <ul>
 <li>
 featureType.getTypeName(): used by JDBC as the table reference to query
 against. Shapefile reader may need to store a lookup to the required
 filename.
 </li>
 <li>
 featureType.getAttributeTypes(): describes the requested content. This
 may be a subset of the complete FeatureType defined by the DataStore.
 </li>
 <li>
 getType.getNamespace(): describes the requested namespace for the
 results (may be different then the one used internally)
 </li>
 </ul>

 <p>
 <b>Transaction</b> to externalize DataStore state on a per Transaction
 basis. The most common example is a JDBC datastore saving a Connection
 for use across several FeatureReader requests. Similarly a Shapefile
 reader may wish to redirect FeatureReader requests to a alternate
 filename over the course of a Transaction.
 </p>

 <p>
 <b>Notes For Implementing DataStore</b>
 </p>

 <p>
 Subclasses may need to retrieve additional attributes, beyond those
 requested by featureType.getAttributeTypes(), in order to correctly
 apply the <code>filter</code>.<br>
 These Additional <b>attribtues</b> should be not be returned by
 FeatureReader. Subclasses may use ReTypeFeatureReader to aid in
 acomplishing this.
 </p>
 <p>
 Helper classes for implementing a FeatureReader (in order):
 </p>
 <ul>
 <li>
 DefaultFeatureReader
 - basic support for creating a FeatureReader for an AttributeReader
 </li>
 <li>
 FilteringFeatureReader
 - filtering support
 </li>
 <li>
 DiffFeatureReader
 - In-Process Transaction Support (see TransactionStateDiff)
 </li>
 <li>
 ReTypeFeatureReader
 - Feature Type schema manipulation of namesspace and attribute type subsets
 </li>
 <li>
 EmptyFeatureReader
 - provides no content for Filter.ALL optimizations
 </li>
 </ul>
 <p>
 Sample use (not optimized):
 </p>
 <pre><code>
 if (filter == Filter.ALL) {
      return new EmptyFeatureReader(featureType);
  }

  String typeName = featureType.getTypeName();