ilog.views.maps.format.midmif

Class IlvMIDMIFReader

java.lang.Object

ilog.views.maps.format.midmif.IlvMIDMIFReader

All Implemented Interfaces:

IlvMapFeatureIterator

public class IlvMIDMIFReader
extends Object
implements IlvMapFeatureIterator

This class reads features and attributes from MapInfo® interchange files.
A MapInfo® interchange file consists of a MIF file containing the geometries and rendering attributes, and a MID file containing the attributes attached to each geometry.
The following example shows how to load a MID/MIF file into an IlvManager.

   IlvMapLoader loader = new IlvMapLoader(manager);
   IlvMIDMIFReader reader = new IlvMIDMIFReader("file.mif", "file.mid");
   IlvFeatureRenderer renderer = reader.getDefaultFeatureRenderer();
   loader.load(reader, renderer);
 

This reader conforms to The MapInfo Interchange File (MIF) Format Specification - October 1999.

Since:

JViews 5.0

Constructor Summary

Constructors

Constructor and Description
IlvMIDMIFReader(IlvMIFReader MIFReader, IlvMIDReader MIDReader) Constructs a MapInfo® Interchange Format reader to read from specified MIF reader and specified MID reader.
IlvMIDMIFReader(String MIFfilename, String MIDfilename) Constructs a MapInfo® Interchange Format reader to read from specified MIF file and specified MID file.
IlvMIDMIFReader(URL MIFURL, URL MIDURL) Constructs a MapInfo® Interchange Format reader to read from specified MIF file and specified MID URL.

Method Summary

Modifier and Type	Method and Description
void	dispose() Releases the resources allocated by this feature iterator.
void	finalize() Called by the Java Garbage Collector to release the resources allocated to the reader.
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.
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.
IlvMIDReader	getMIDReader() Returns the MID reader.
IlvMIFReader	getMIFReader() Returns the MIF reader.
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.
boolean	isGeoreferenced() Returns true if the map reader can provide the source coordinate system of its map features.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IlvMIDMIFReader

public IlvMIDMIFReader(String MIFfilename,
                       String MIDfilename)
                throws IOException,
                       IlvMapFormatException

Constructs a MapInfo® Interchange Format reader to read from specified MIF file and specified MID file.

Parameters:

MIFfilename - The name of the MIF file.

MIDfilename - The name of the MID file. If null, no attribute is read.

Throws:

IOException - If an I/O error occurs.

IlvMapFormatException - If the file format is not MID/MIF.

IlvMIDMIFReader

public IlvMIDMIFReader(URL MIFURL,
                       URL MIDURL)
                throws IOException,
                       IlvMapFormatException

Constructs a MapInfo® Interchange Format reader to read from specified MIF file and specified MID URL.

Parameters:

MIFURL - The name of the MIF URL.

MIDURL - The name of the MID URL. If null, no attribute is read.

Throws:

IOException - If an I/O error occurs.

IlvMapFormatException - If the file format is not MID/MIF.

Since:

JViews 7.5

IlvMIDMIFReader

public IlvMIDMIFReader(IlvMIFReader MIFReader,
                       IlvMIDReader MIDReader)

Constructs a MapInfo® Interchange Format reader to read from specified MIF reader and specified MID reader.

Parameters:

MIFReader - The MIF reader.

MIDReader - The MID reader. If null, no attribute is read.

Method Detail

getMIFReader

public IlvMIFReader getMIFReader()

Returns the MIF reader.

getMIDReader

public IlvMIDReader getMIDReader()

Returns the MID reader. The returned value can be null if no attribute reader or MID file has been specified at construction time.

dispose

public void dispose()

Releases the resources allocated by this feature iterator.

Specified by:

dispose in interface IlvMapFeatureIterator

finalize

public void finalize()

Called by the Java Garbage Collector to release the resources allocated to the reader. If the dispose method has not been called, it releases the resources used by the reader.

Overrides:

finalize in class Object

See Also:

dispose()

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

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

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

Returns:

An IlvMIFFeatureRenderer.

See Also:

IlvMIFFeatureRenderer

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.

isGeoreferenced

public boolean isGeoreferenced()

Returns true if the map reader can provide the source coordinate system of its map features.

Specified by:

isGeoreferenced in interface IlvMapFeatureIterator

getNextFeature

public IlvMapFeature getNextFeature()
                             throws IOException,
                                    IlvMapFormatException

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

Throws:

IOException - If an I/O exception occurs.

IlvMapFormatException - If the file format is wrong.