featurecollection.html
来自「Geotools是一个开源的Java GIS工具包,可利用它来开发符合标准的地理」· HTML 代码 · 共 746 行 · 第 1/3 页
HTML
746 行
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc (build 1.4.2_13) on Tue Jun 05 11:36:24 GMT-05:00 2007 --><META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><TITLE>FeatureCollection (Geotools 2.3.x 2.3.2 API)</TITLE><META NAME="keywords" CONTENT="org.geotools.feature.FeatureCollection interface"><META NAME="keywords" CONTENT="features()"><META NAME="keywords" CONTENT="close()"><META NAME="keywords" CONTENT="addListener()"><META NAME="keywords" CONTENT="removeListener()"><META NAME="keywords" CONTENT="getFeatureType()"><META NAME="keywords" CONTENT="getSchema()"><META NAME="keywords" CONTENT="accepts()"><META NAME="keywords" CONTENT="subCollection()"><META NAME="keywords" CONTENT="sort()"><LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"><SCRIPT type="text/javascript">function windowTitle(){ parent.document.title="FeatureCollection (Geotools 2.3.x 2.3.2 API)";}</SCRIPT></HEAD><BODY BGCOLOR="white" onload="windowTitle();"><!-- ========= START OF TOP NAVBAR ======= --><A NAME="navbar_top"><!-- --></A><A HREF="#skip-navbar_top" title="Skip navigation links"></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""><TR><TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_firstrow"><!-- --></A><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/FeatureCollection.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../org/geotools/feature/FeatureAttributeType.html" title="interface in org.geotools.feature"><B>PREV CLASS</B></A> <A HREF="../../../org/geotools/feature/FeatureCollectionIteration.Handler.html" title="interface in org.geotools.feature"><B>NEXT CLASS</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A> <A HREF="FeatureCollection.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--></SCRIPT><NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A></NOSCRIPT></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: NESTED | FIELD | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">DETAIL: FIELD | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD></TR></TABLE><A NAME="skip-navbar_top"></A><!-- ========= END OF TOP NAVBAR ========= --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">org.geotools.feature</FONT><BR>Interface FeatureCollection</H2><DL><DT><B>All Superinterfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/Collection.html" title="class or interface in java.util">Collection</A>, <A HREF="../../../org/geotools/feature/Feature.html" title="interface in org.geotools.feature">Feature</A>, <A HREF="../../../org/geotools/data/FeatureResults.html" title="interface in org.geotools.data">FeatureResults</A>, <A HREF="../../../org/geotools/data/collection/ResourceCollection.html" title="interface in org.geotools.data.collection">ResourceCollection</A></DD></DL><DL><DT><B>All Known Subinterfaces:</B> <DD><A HREF="../../../org/geotools/feature/FeatureDocument.html" title="interface in org.geotools.feature">FeatureDocument</A>, <A HREF="../../../org/geotools/feature/FeatureList.html" title="interface in org.geotools.feature">FeatureList</A>, <A HREF="../../../org/geotools/feature/IndexedFeatureCollection.html" title="interface in org.geotools.feature">IndexedFeatureCollection</A>, <A HREF="../../../org/geotools/feature/collection/RandomFeatureAccess.html" title="interface in org.geotools.feature.collection">RandomFeatureAccess</A></DD></DL><DL><DT><B>All Known Implementing Classes:</B> <DD><A HREF="../../../org/geotools/feature/collection/AbstractFeatureCollection.html" title="class in org.geotools.feature.collection">AbstractFeatureCollection</A>, <A HREF="../../../org/geotools/feature/AbstractFeatureCollection.html" title="class in org.geotools.feature">AbstractFeatureCollection</A>, <A HREF="../../../org/geotools/feature/collection/AbstractFeatureList.html" title="class in org.geotools.feature.collection">AbstractFeatureList</A>, <A HREF="../../../org/geotools/data/store/DataFeatureCollection.html" title="class in org.geotools.data.store">DataFeatureCollection</A>, <A HREF="../../../org/geotools/feature/DefaultFeatureCollection.html" title="class in org.geotools.feature">DefaultFeatureCollection</A>, <A HREF="../../../org/geotools/data/memory/MemoryFeatureCollection.html" title="class in org.geotools.data.memory">MemoryFeatureCollection</A>, <A HREF="../../../org/geotools/feature/collection/SubFeatureCollection.html" title="class in org.geotools.feature.collection">SubFeatureCollection</A>, <A HREF="../../../org/geotools/feature/collection/SubFeatureList.html" title="class in org.geotools.feature.collection">SubFeatureList</A></DD></DL><HR><DL><DT>public interface <B>FeatureCollection</B><DT>extends <A HREF="../../../org/geotools/data/collection/ResourceCollection.html" title="interface in org.geotools.data.collection">ResourceCollection</A>, <A HREF="../../../org/geotools/data/FeatureResults.html" title="interface in org.geotools.data">FeatureResults</A>, <A HREF="../../../org/geotools/feature/Feature.html" title="interface in org.geotools.feature">Feature</A></DL><P>Represents a collection of features. <p> Implementations (and client code) should adhere to the rules set forth by java.util.Collection. That is, some methods are optional to implement, and may throw an UnsupportedOperationException. </p> <p> FeatureCollection house rules: <ul> <li>FeatureCollection.close( iterator ) must be called (see example below) <li>Features are not specifically ordered within the FeatureCollection (see FeatureList) <li>Two instances cannot exist with the same Feature ID (Feature contract) <li>(unsure) the same Instance can be in the collection more then once </ul> In programmer speak a FeatureCollection is a "Bag" with an index based ID. </p> <p> <h3>Life Cycle of Iterator</h3> <p> We have also adopted an additional constraint on the use of iterator. You must call FeatureCollection.close( iterator ) to allow FeatureCollection to clean up any operating system resources used to acces information. </p> <p> Example (safe) use:<pre><code> Iterator iterator = collection.iterator(); try { for( Iterator i=collection.iterator(); i.hasNext();){ Feature feature = (Feature) i.hasNext(); System.out.println( feature.getID() ); } } finally { collection.close( iterator ); } </code></pre> </p> <p> Handy Tip: Although many resource backed collections will choose to release resources at when the iterator has reached the end of its contents this is not something you should rely on. </p> <h2>Notes for FeatureCollection Implementors</h2> <p> Many users will be treating this as a straight forward Collection, there code will break often enough due to latency - try and close up resources for them when you can detect that an Iterator is not useful anymore. </p> <p> Collections are used in two fashions, basically as you see them, and also as "range" for common opperations. You can see this with List.subCollection( Filter ). Existing RnD effort is going towards supporting this kind of use at the FeatureCollection level. </p><P><P><DL><DT><B>Author:</B></DT> <DD>Ian Turton, CCG, Rob Hranac, VFNY, Ian Schneider, USDA-ARS, Jody Garnett, Refractions Research, Inc.</DD><DT><B>See Also:</B><DD><CODE>java.util.Collection, org.geotools.Feature</CODE><DT><B>Module:</B></DT><DD><CODE><B>module/api</B></CODE> (<A HREF="http://maven.geotools.fr/repository/org/geotools/gt2-api/"><CODE>gt2-api.jar</CODE></A>) (<A HREF="http://maven.geotools.fr/reports/api/index.html">Maven report</A>) (<A HREF="http://svn.geotools.org/geotools/tags/2.3.2/module/api/src/org/geotools/feature/FeatureCollection.java">SVN head</A>)</DD></DL><HR><P><!-- ======== NESTED CLASS SUMMARY ======== --><A NAME="nested_class_summary"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Nested Class Summary</B></FONT></TD></TR></TABLE> <A NAME="nested_classes_inherited_from_class_org.geotools.feature.Feature"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TD><B>Nested classes inherited from class <A HREF="../../../org/geotools/feature/Feature.html" title="interface in org.geotools.feature">Feature</A></B></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><A HREF="../../../org/geotools/feature/Feature.NULL.html" title="class in org.geotools.feature">Feature.NULL</A></CODE></TD></TR></TABLE> <!-- =========== FIELD SUMMARY =========== --><!-- ======== CONSTRUCTOR SUMMARY ======== --><!-- ========== METHOD SUMMARY =========== --><A NAME="method_summary"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Method Summary</B></FONT></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../org/geotools/feature/FeatureCollection.html#accepts(org.geotools.feature.visitor.FeatureVisitor, org.geotools.util.ProgressListener)">accepts</A></B>(<A HREF="../../../org/geotools/feature/visitor/FeatureVisitor.html" title="interface in org.geotools.feature.visitor">FeatureVisitor</A> visitor, <A HREF="../../../org/geotools/util/ProgressListener.html" title="interface in org.geotools.util">ProgressListener</A> progress)</CODE><BR> Will visit the contents of the feature collection. </TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../org/geotools/feature/FeatureCollection.html#addListener(org.geotools.feature.CollectionListener)">addListener</A></B>(<A HREF="../../../org/geotools/feature/CollectionListener.html" title="interface in org.geotools.feature">CollectionListener</A> listener)</CODE><BR> Adds a listener for collection events. </TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../org/geotools/feature/FeatureCollection.html#close(org.geotools.feature.FeatureIterator)">close</A></B>(<A HREF="../../../org/geotools/feature/FeatureIterator.html" title="interface in org.geotools.feature">FeatureIterator</A> close)</CODE><BR> Clean up any resources assocaited with this iterator in a manner similar to JDO collections. </TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../org/geotools/feature/FeatureCollection.html#close(java.util.Iterator)">close</A></B>(<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/util/Iterator.html" title="class or interface in java.util">Iterator</A> close)</CODE><BR> Clean up after any resources assocaited with this itterator in a manner similar to JDO collections. </TD>⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?