org.openstreetmap.josm.io

Class FileImporter

java.lang.Object

org.openstreetmap.josm.io.FileImporter

All Implemented Interfaces:

Comparable<FileImporter>, MapView.LayerChangeListener

Direct Known Subclasses:

AllFormatsImporter, GpxImporter, JpgImporter, NMEAImporter, NoteImporter, OsmChangeImporter, OsmImporter, SessionImporter, WMSLayerImporter

public abstract class FileImporter
extends Object
implements Comparable<FileImporter>, MapView.LayerChangeListener

Abstract file importer.

Since:

1637

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	enabled
ExtensionFileFilter	filter The extension file filter used to accept files.

Constructor Summary

Constructors

Constructor and Description
FileImporter(ExtensionFileFilter filter) Constructs a new FileImporter with the given extension file filter.

Method Summary

Modifier and Type	Method and Description
boolean	acceptFile(File pathname) Determines if this file importer accepts the given file.
void	activeLayerChange(Layer oldLayer, Layer newLayer) Notifies this listener that the active layer has changed.
int	compareTo(FileImporter other)
private static void	displayCancel(Throwable t)
private static void	displayError(File f, Exception e)
double	getPriority() If multiple files (with multiple file formats) are selected, they are opened in the order of their priorities.
void	importData(File file, ProgressMonitor progressMonitor) Needs to be implemented if isBatchImporter() returns false.
void	importData(List<File> files, ProgressMonitor progressMonitor) Needs to be implemented if isBatchImporter() returns true.
boolean	importDataHandleExceptions(File f, ProgressMonitor progressMonitor) Wrapper to importData(File, ProgressMonitor) to give meaningful output if things go wrong.
boolean	importDataHandleExceptions(List<File> files, ProgressMonitor progressMonitor) Wrapper to importData(List, ProgressMonitor) to give meaningful output if things go wrong.
boolean	isBatchImporter() A batch importer is a file importer that prefers to read multiple files at the same time.
boolean	isEnabled() Returns the enabled state of this FileImporter.
void	layerAdded(Layer newLayer) Notifies this listener that a layer has been added.
void	layerRemoved(Layer oldLayer) Notifies this listener that a layer has been removed.
void	setEnabled(boolean enabled) Sets the enabled state of the FileImporter.

Methods inherited from class java.lang.Object

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

Field Detail

filter

public final ExtensionFileFilter filter

The extension file filter used to accept files.

enabled

private boolean enabled

Constructor Detail

FileImporter

public FileImporter(ExtensionFileFilter filter)

Constructs a new FileImporter with the given extension file filter.

Parameters:

filter - The extension file filter

Method Detail

acceptFile

public boolean acceptFile(File pathname)

Determines if this file importer accepts the given file.

Parameters:

pathname - The file to test

Returns:

true if this file importer accepts the given file, false otherwise

isBatchImporter

public boolean isBatchImporter()

A batch importer is a file importer that prefers to read multiple files at the same time.

Returns:

true if this importer is a batch importer

importData

public void importData(File file,
                       ProgressMonitor progressMonitor)
                throws IOException,
                       IllegalDataException

Needs to be implemented if isBatchImporter() returns false.

Parameters:

file - file to import

progressMonitor - progress monitor

Throws:

IOException - if any I/O error occurs

IllegalDataException - if invalid data is read

importData

public void importData(List<File> files,
                       ProgressMonitor progressMonitor)
                throws IOException,
                       IllegalDataException

Needs to be implemented if isBatchImporter() returns true.

Parameters:

files - files to import

progressMonitor - progress monitor

Throws:

IOException - if any I/O error occurs

IllegalDataException - if invalid data is read

importDataHandleExceptions

public boolean importDataHandleExceptions(File f,
                                          ProgressMonitor progressMonitor)

Wrapper to importData(File, ProgressMonitor) to give meaningful output if things go wrong.

Parameters:

f - data file to import

progressMonitor - progress monitor

Returns:

true if data import was successful

displayError

private static void displayError(File f,
                                 Exception e)

displayCancel

private static void displayCancel(Throwable t)

importDataHandleExceptions

public boolean importDataHandleExceptions(List<File> files,
                                          ProgressMonitor progressMonitor)

Wrapper to importData(List, ProgressMonitor) to give meaningful output if things go wrong.

Parameters:

files - data files to import

progressMonitor - progress monitor

Returns:

true if data import was successful

getPriority

public double getPriority()

If multiple files (with multiple file formats) are selected, they are opened in the order of their priorities. Highest priority comes first.

Returns:

priority

compareTo

public int compareTo(FileImporter other)

Specified by:

compareTo in interface Comparable<FileImporter>

isEnabled

public final boolean isEnabled()

Returns the enabled state of this FileImporter. When enabled, it is listed and usable in "File->Open" dialog.

Returns:

true if this FileImporter is enabled

Since:

5459

setEnabled

public final void setEnabled(boolean enabled)

Sets the enabled state of the FileImporter. When enabled, it is listed and usable in "File->Open" dialog.

Parameters:

enabled - true to enable this FileImporter, false to disable it

Since:

5459

activeLayerChange

public void activeLayerChange(Layer oldLayer,
                              Layer newLayer)

Description copied from interface: MapView.LayerChangeListener

Notifies this listener that the active layer has changed.

Specified by:

activeLayerChange in interface MapView.LayerChangeListener

Parameters:

oldLayer - The previous active layer

newLayer - The new activer layer

layerAdded

public void layerAdded(Layer newLayer)

Description copied from interface: MapView.LayerChangeListener

Notifies this listener that a layer has been added.

Specified by:

layerAdded in interface MapView.LayerChangeListener

Parameters:

newLayer - The new added layer

layerRemoved

public void layerRemoved(Layer oldLayer)

Description copied from interface: MapView.LayerChangeListener

Notifies this listener that a layer has been removed.

Specified by:

layerRemoved in interface MapView.LayerChangeListener

Parameters:

oldLayer - The old removed layer