Java Doc for FeatureReader.java in  » GIS » GeoTools-2.4.1 » org » geotools » data » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Typical use is as follows:

 FeatureReader reader = null;
 try{
 for( reader = data.getFeatureReader( filter ); reader.hasNext(); ){
 f = reader.next();
 ...
 }
 }
 catch (IOException problem){
 ...
 }
 finally {
 if( reader != null ){
 try {
 reader.close();
 }
 catch( IOException eek){
 }
 }
 }
 

Questions and Suggestions

• Q: Should FeatureReader provide access to the AttributeReaders it uses?
  A: No, it looks like we will make a lazy Feature in order to cleanly allow for lazy parsing of attribtues.
• Q:FeatureReader has a close method, but no open method?
  A: This is by design allowing FeatureReader to encapsulate its InputStream or Rowset). Please assume that FeatureReaders are a single use proposition.
• Q: All that exception handling is a pain! A: Yes it is, we have constructed semi-normal Java iterators to cut down on the pain. But you *do* still have to close 'em - this is IO after all.
• Q: Can we include skip(int) - SeanG A: The order of the contents is not "known" or predicatable to the end user, so skip( int ) would be useless. For random access (a higher order of abstraction then FeatureReader) please look at FeatureList.