ilog.views.maps.datasource

Class IlvMIDMIFDataSource

java.lang.Object

ilog.views.maps.datasource.IlvMapDataSource

ilog.views.maps.datasource.IlvHierarchicalDataSource

ilog.views.maps.datasource.IlvMIDMIFDataSource

All Implemented Interfaces:

IlvPersistentObject, Serializable

public class IlvMIDMIFDataSource
extends IlvHierarchicalDataSource

A data source to read MapInfo MID/MIF files.

Since:

JViews 7.5

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	IlvMIDMIFDataSource.MIDMIFFilter A specialized criterion filter that returns a key identifying the geometry type of the specified map feature as well as its style.

Nested classes/interfaces inherited from class ilog.views.maps.datasource.IlvHierarchicalDataSource

IlvHierarchicalDataSource.CriterionFilter, IlvHierarchicalDataSource.SingleAttributeFilter

Field Summary

Fields inherited from class ilog.views.maps.datasource.IlvHierarchicalDataSource

featureIterator, filename, nameMap, styleMap

Fields inherited from class ilog.views.maps.datasource.IlvMapDataSource

renderer, usingGeodeticComputation

Constructor Summary

Constructors

Constructor and Description
IlvMIDMIFDataSource(IlvInputStream stream) Constructs an IlvMIDMIFDataSource from the specified input stream.
IlvMIDMIFDataSource(String filename) Constructs an IlvMIDMIFDataSource from the specified file name.
IlvMIDMIFDataSource(URL url) Constructs an IlvMIDMIFDataSource from the specified URL.

Method Summary

Modifier and Type	Method and Description
IlvCoordinateSystem	getCoordinateSystem() Retrieves the coordinate system of this data source.
IlvMapReusableFeatureIterator	getFeatureIterator() Retrieves the feature iterator used by this data source.
IlvFeatureRenderer	getFeatureRenderer(IlvMapFeature feature) Gets the appropriate feature renderer for the specified IlvMapFeature.
protected IlvMapStyle	getStyle(IlvMapFeature feature) Returns a map style for the specified feature.
protected boolean	isSourceDataAvailable() Checks whether the source data this IlvMapDataSource is based on is available (file, database connection, url...).
void	start() Starts the data source.
void	write(IlvOutputStream stream) Writes this IlvMIDMIFDataSource to an IlvOutputStream.

Methods inherited from class ilog.views.maps.datasource.IlvHierarchicalDataSource

addCriterionFilter, addLayer, createFeatureRenderer, createInsertionLayer, createStyle, getCriterionFilters, getFeatureRenderer, getKey, getMapLayer, isAcceptNullValues, readInfo, removeAllCriterionFilters, removeCriterionFilter, reset, setAcceptNullValues, setupLayer

Methods inherited from class ilog.views.maps.datasource.IlvMapDataSource

addDataSourceListener, callListeners, getBackupDataSources, getDescription, getInsertionLayer, getManager, getName, getNode, getValidExtentions, hasInsertionLayer, initBackupDataSource, initInsertionLayer, isAttachingAttributes, isGrapherMode, isSaveBackupDataSources, isUsingBackupDataSource, isUsingGeodeticComputation, mapIntersects, removeDataSourceListener, setAttachingAttributes, setCoordinateSystem, setDescription, setFeatureRenderer, setForceUsingBackupDataSource, setGrapherMode, setInsertionLayer, setManager, setName, setSaveBackupDataSources, setValidExtentions, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvMIDMIFDataSource

public IlvMIDMIFDataSource(String filename)
                    throws MalformedURLException

Constructs an IlvMIDMIFDataSource from the specified file name.

Parameters:

filename - The name of the MID/MIF file to read.

Throws:

MalformedURLException - if the path cannot be parsed as a URL

IlvMIDMIFDataSource

public IlvMIDMIFDataSource(URL url)
                    throws MalformedURLException

Constructs an IlvMIDMIFDataSource from the specified URL.

Parameters:

url - The URL referring of the MID/MIF file to read.

Throws:

MalformedURLException - if the path cannot be parsed as a URL

Since:

JViews 7.5

IlvMIDMIFDataSource

public IlvMIDMIFDataSource(IlvInputStream stream)
                    throws IlvReadFileException

Constructs an IlvMIDMIFDataSource from the specified input stream.

Parameters:

stream - The IlvInputStream to read from.

Throws:

IlvReadFileException

Method Detail

write

public void write(IlvOutputStream stream)
           throws IOException

Writes this IlvMIDMIFDataSource to an IlvOutputStream.

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvHierarchicalDataSource

Parameters:

stream - The stream to write to.

Throws:

IOException

getCoordinateSystem

public IlvCoordinateSystem getCoordinateSystem()

Retrieves the coordinate system of this data source.

Overrides:

getCoordinateSystem in class IlvMapDataSource

Returns:

The coordinate system of this data source.

getFeatureRenderer

public IlvFeatureRenderer getFeatureRenderer(IlvMapFeature feature)
                                      throws Exception

Gets the appropriate feature renderer for the specified IlvMapFeature.

Overrides:

getFeatureRenderer in class IlvHierarchicalDataSource

Parameters:

feature - The feature to render.

Returns:

The IlvFeatureRenderer.

Throws:

Exception - if a feature renderer does not exist for the specified IlvMapFeature.

start

public void start()
           throws Exception

Starts the data source.

Overrides:

start in class IlvHierarchicalDataSource

Throws:

Exception

See Also:

IlvHierarchicalDataSource.start()

getFeatureIterator

public IlvMapReusableFeatureIterator getFeatureIterator()

Retrieves the feature iterator used by this data source.

Overrides:

getFeatureIterator in class IlvHierarchicalDataSource

Returns:

The feature iterator.

getStyle

protected IlvMapStyle getStyle(IlvMapFeature feature)
                        throws Exception

Returns a map style for the specified feature.

Overrides:

getStyle in class IlvHierarchicalDataSource

Parameters:

feature - The IlvMapFeature.

Returns:

A IlvMapStyle for the feature

Throws:

Exception - if an appropriate style could not be found for the specified feature.

isSourceDataAvailable

protected boolean isSourceDataAvailable()

Checks whether the source data this IlvMapDataSource is based on is available (file, database connection, url...). A .ivl, JViews Maps file keeps references to the original sources the map was built from. It can happen that these sources are not available when opening the map, for example, when the map is transferred to another machine. This method checks that availability. In the case where these sources are not available, all operations that need them are performed from the data embedded in the map, but there is a risk of loosing information (when reprojecting for example). This method should be overridden by subclasses.

Overrides:

isSourceDataAvailable in class IlvMapDataSource

Returns:

Returns true, if the original source data is available.