IlvDAFIFReader (Perforce JViews 10.0 API)

java.lang.Object
- ilog.views.maps.defense.format.dafif.IlvDAFIFReader

All Implemented Interfaces:

IlvPersistentObject, IlvMapFeatureIterator, IlvMapReusableFeatureIterator, IlvMapRegionOfInterestIterator, Serializable
```
public class IlvDAFIFReader
extends Object
implements IlvMapRegionOfInterestIterator, IlvPersistentObject
```
This class reads DAFIF files.

Since:

JViews 8.0

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description
`IlvDAFIFReader()` Creates an empty reader.
`IlvDAFIFReader(IlvInputStream stream)` Reconstructs a DAFIF reader from parameters read from an input stream.
`IlvDAFIFReader(String fileName)` Reads a DAFIF directory.
`IlvDAFIFReader(URL url)` Reads a DAFIF directory.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected boolean`	`acceptTable(IlvDAFIFTableDescription tableDescr)` Indicates if the table should be read by this reader.
`protected Rectangle2D`	`computeBounds()` Computes the bounds of the features selected.
`IlvMapRegionOfInterestIterator`	`deriveReader(IlvFeatureClassInformation vfeatureClass, IlvGeometryClassFilter vgeometryClass)` Creates a derived reader that only returns features with the selected feature and geometry classes.
`void`	`dispose()` Releases the resources allocated by the feature iterator (files, connections, and so on).
`IlvCoordinateSystem`	`getCoordinateSystem()` Returns the spatial reference system that describes the coordinate system of geometric coordinates of the map features.
`IlvFeatureRenderer`	`getDefaultFeatureRenderer()` Returns a renderer that can be used to translate the map features returned by this iterator into graphic objects.
`Rectangle2D`	`getLatLonBounds()` Returns or computes the bounds for all the features read.
`IlvCoordinate`	`getLowerRightCorner()` Returns the lower right corner of the rectangle containing all the map feature of the list, or `null` if the iterator cannot provide this information.
`IlvThreadMonitoringData`	`getMonitoringData()` Returns the thread monitoring information.
`IlvMapFeature`	`getNextFeature()` Returns the next map feature of the iterator or `null` if the iteration is finished.
`IlvCoordinate`	`getUpperLeftCorner()` Returns the upper left corner of the rectangle containing all the map features of the list, or `null` if the iterator cannot provide this information.
`URL`	`getUrl()` Returns the URL set for this reader.
`boolean`	`isGeoreferenced()` Returns `true` if the map reader can provide the source projection of its map features.
`protected void`	`readAllAcceptedTables()` Reads all tables in the DAFIF structure that are accepted by the `acceptTable(IlvDAFIFTableDescription)` method.
`void`	`restart()` Rewinds the iterator for a new use.
`void`	`setFeatureClassFilter(IlvFeatureClassInformation vfeatureClass)` Sets a filter on the DAFIF table.
`void`	`setMonitoringData(IlvThreadMonitoringData monitorData)` Sets the thread monitoring information.
`void`	`setRegionOfInterest(double minX, double minY, double maxX, double maxY)` Sets the region of interest to return features for.
`void`	`setSource(IlvDAFIFDataSource dataSource)` Sets the data source used to filter out tables.
`void`	`setUrl(URL url)` Sets the URL of the DAFIFT directory for this reader.
`protected void`	`updateProgress(int progress)` Updates the progress of the reader, if `monitoringData` has been set.
`void`	`write(IlvOutputStream stream)` Writes the attributes of the reader.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - IlvDAFIFReader
```
public IlvDAFIFReader()
```
    Creates an empty reader.
  - IlvDAFIFReader
```
public IlvDAFIFReader(String fileName)
               throws IOException
```
    Reads a DAFIF directory.
    
    Parameters:
    
    fileName - The DAFIFT directory to read.
    
    Throws:
    
    IOException
  - IlvDAFIFReader
```
public IlvDAFIFReader(URL url)
               throws IOException
```
    Reads a DAFIF directory.
    
    Parameters:
    
    url - The URL of the DAFIFT directory.
    
    Throws:
    
    IOException - if the URL cannot be opened.
  - IlvDAFIFReader
```
public IlvDAFIFReader(IlvInputStream stream)
```
    Reconstructs a DAFIF reader from parameters read from an input stream.
    
    Parameters:
    
    stream - The stream to read from.
- Method Detail
  - getUrl
```
public URL getUrl()
```
    Returns the URL set for this reader.
    
    Returns:
    
    Returns the URL set for this reader.
  - setUrl
```
public void setUrl(URL url)
            throws IOException
```
    Sets the URL of the DAFIFT directory for this reader.
    
    Parameters:
    
    url - The URL of the DAFIFT directory.
    
    Throws:
    
    IOException - if the directory is not accessible or if the URL is malformed.
  - getLatLonBounds
```
public Rectangle2D getLatLonBounds()
```
    Returns or computes the bounds for all the features read.
    
    Specified by:
    
    getLatLonBounds in interface IlvMapRegionOfInterestIterator
    
    Returns:
    
    The enclosing lat/lon bounds (in degrees).
  - computeBounds
```
protected Rectangle2D computeBounds()
```
    Computes the bounds of the features selected. The default implementation goes through all the accepted features and adds all the geometry bounds. The resulting bounds are a radian-based coordinates rectangle.
    
    Returns:
    
    The bounds of all the features selected.
  - setRegionOfInterest
```
public void setRegionOfInterest(double minX,
                                double minY,
                                double maxX,
                                double maxY)
```
    Sets the region of interest to return features for. After this method is called, the IlvMapFeatureIterator.getNextFeature() method should not return any feature which geometry is outside this area.
    
    Specified by:
    
    setRegionOfInterest in interface IlvMapRegionOfInterestIterator
    
    Parameters:
    
    minX - longitude min in radians.
    
    minY - latitude min in radians.
    
    maxX - longitude max in radians.
    
    maxY - latitude max in radians.
    
    See Also:
    
    IlvMapRegionOfInterestIterator.setRegionOfInterest(double, double, double, double)
  - updateProgress
```
protected void updateProgress(int progress)
```
    Updates the progress of the reader, if monitoringData has been set.
    
    Parameters:
    
    progress - value between 0 and 100.
    
    See Also:
    
    getMonitoringData()
  - readAllAcceptedTables
```
protected void readAllAcceptedTables()
                              throws IOException
```
    Reads all tables in the DAFIF structure that are accepted by the acceptTable(IlvDAFIFTableDescription) method.
    
    Throws:
    
    IOException, - if the DAFIF schema cannot be analyzed.
    
    IOException
    
    See Also:
    
    IlvDAFIFTable.readContent(boolean, URL)
  - acceptTable
```
protected boolean acceptTable(IlvDAFIFTableDescription tableDescr)
```
    Indicates if the table should be read by this reader.
    Parameters:
    tableDescr - The description to check. The default implementation checks:
    
    When a source is set, if the source accepts the table name as a code.
    When a featureClass is set, if its code is the table name.
    Returns:
    
    Returns whether the table should be read or not.
    
    See Also:
    
    setSource(IlvDAFIFDataSource), setFeatureClassFilter(IlvFeatureClassInformation), IlvFeatureClassInformation.getCode(), IlvDefaultTilableDataSource.acceptsCode(Object)
  - restart
```
public void restart()
```
    Rewinds the iterator for a new use.
    
    Specified by:
    
    restart in interface IlvMapReusableFeatureIterator
    
    See Also:
    
    IlvMapReusableFeatureIterator.restart()
  - getMonitoringData
```
public IlvThreadMonitoringData getMonitoringData()
```
    Returns the thread monitoring information.
    
    Returns:
    
    Returns the thread monitoring information.
  - setMonitoringData
```
public void setMonitoringData(IlvThreadMonitoringData monitorData)
```
    Sets the thread monitoring information.
    
    Parameters:
    
    monitorData - The thread monitoring information to set.
  - getNextFeature
```
public IlvMapFeature getNextFeature()
```
    Returns the next map feature of the iterator or null if the iteration is finished. The returned map feature must be considered as volatile and can be modified by the reader during the next call to its getNextFeature function.
    
    Specified by:
    
    getNextFeature in interface IlvMapFeatureIterator
    
    See Also:
    
    IlvMapFeatureIterator.getNextFeature()
  - isGeoreferenced
```
public boolean isGeoreferenced()
```
    Returns true if the map reader can provide the source projection of its map features.
    
    Specified by:
    
    isGeoreferenced in interface IlvMapFeatureIterator
    
    See Also:
    
    IlvMapFeatureIterator.isGeoreferenced()
  - getCoordinateSystem
```
public IlvCoordinateSystem getCoordinateSystem()
```
    Returns the spatial reference system that describes the coordinate system of geometric coordinates of the map features.
    
    Specified by:
    
    getCoordinateSystem in interface IlvMapFeatureIterator
    
    Returns:
    
    The coordinate system, or null if the coordinate system is unknown.
    
    See Also:
    
    IlvMapFeatureIterator.getCoordinateSystem()
  - getUpperLeftCorner
```
public IlvCoordinate getUpperLeftCorner()
```
    Returns the upper left corner of the rectangle containing all the map features of the list, or null if the iterator cannot provide this information.
    
    Specified by:
    
    getUpperLeftCorner in interface IlvMapFeatureIterator
    
    See Also:
    
    IlvMapFeatureIterator.getUpperLeftCorner()
  - getLowerRightCorner
```
public IlvCoordinate getLowerRightCorner()
```
    Returns the lower right corner of the rectangle containing all the map feature of the list, or null if the iterator cannot provide this information.
    
    Specified by:
    
    getLowerRightCorner in interface IlvMapFeatureIterator
    
    See Also:
    
    IlvMapFeatureIterator.getLowerRightCorner()
  - getDefaultFeatureRenderer
```
public IlvFeatureRenderer getDefaultFeatureRenderer()
```
    Returns a renderer that can be used to translate the map features returned by this iterator into graphic objects. Feature iterators that store some rendering information in the attributes of the map features, such as color, text font, line thickness and so on, can return a specific renderer which is able to take these attributes into account during the rendering process.
    
    Specified by:
    
    getDefaultFeatureRenderer in interface IlvMapFeatureIterator
    
    See Also:
    
    IlvMapFeatureIterator.getDefaultFeatureRenderer()
  - dispose
```
public void dispose()
```
    Releases the resources allocated by the feature iterator (files, connections, and so on).
    
    Specified by:
    
    dispose in interface IlvMapFeatureIterator
    
    See Also:
    
    IlvMapFeatureIterator.dispose()
  - deriveReader
```
public IlvMapRegionOfInterestIterator deriveReader(IlvFeatureClassInformation vfeatureClass,
                                                   IlvGeometryClassFilter vgeometryClass)
```
    Creates a derived reader that only returns features with the selected feature and geometry classes.
    
    Parameters:
    
    vfeatureClass - The feature class to filter features with.
    
    vgeometryClass - A subclass of IlvMapGeometry to prevent the mixing of different types of features on the same layer.
    
    Returns:
    
    A new reader, based on the geometries of this reader.
  - setSource
```
public void setSource(IlvDAFIFDataSource dataSource)
```
    Sets the data source used to filter out tables.
    
    Parameters:
    
    dataSource - The data source used to filter out tables.
  - setFeatureClassFilter
```
public void setFeatureClassFilter(IlvFeatureClassInformation vfeatureClass)
```
    Sets a filter on the DAFIF table.
    
    Parameters:
    
    vfeatureClass - The information about the feature to filter.
  - write
```
public void write(IlvOutputStream stream)
           throws IOException
```
    Writes the attributes of the reader.
    
    Specified by:
    
    write in interface IlvPersistentObject
    
    Parameters:
    
    stream - The output stream.
    
    Throws:
    
    IOException - thrown when an exception occurs during the write operation for this object.

Class IlvDAFIFReader

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

IlvDAFIFReader

IlvDAFIFReader

IlvDAFIFReader

IlvDAFIFReader

Method Detail

getUrl

setUrl

getLatLonBounds

computeBounds

setRegionOfInterest

updateProgress

readAllAcceptedTables

acceptTable

restart

getMonitoringData

setMonitoringData

getNextFeature

isGeoreferenced

getCoordinateSystem

getUpperLeftCorner

getLowerRightCorner

getDefaultFeatureRenderer

dispose

deriveReader

setSource

setFeatureClassFilter

write