ilog.views.maps.defense.format.dafif

Class IlvDAFIFReader

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

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.