org.eclipse.mtj.core.sdk.device
Interface IDeviceImporter

public interface IDeviceImporter

Instances of IDeviceImporter are presented with a set of directories for which the instance may return one or more device instances. IDeviceImporters are provided to the system via the deviceImporter extension point.

MTJ provides 3 implementations for the deviceimporter E.P.. Bellow is the list of IDs:

• org.eclipse.mtj.toolkit.uei.importer
responsible for importing devices for all UEI compatible SDK's.
• org.eclipse.mtj.toolkit.mpowerplayer.importer
responsible for importing devices from the MPowerPlayer SDK.
• org.eclipse.mtj.toolkit.microemu.importer
responsible for importing devices from the MicroEmu SDK.

EXPERIMENTAL. This class or interface has been added as part of a work in progress. There is no guarantee that this API will work or that it will remain the same. Please do not use this API without consulting with the MTJ team.

Since:

1.0

See Also:

IDevice

Field Summary

static String

EXT_DEVICE_IMPORTERS The extension point for use in registering new device importers.

Method Summary

List<IDevice>

importDevices(File directory, IProgressMonitor monitor) Return the fully configured device instances found in the specified directory or null if no devices are recognized by this importer in this directory.

Field Detail

EXT_DEVICE_IMPORTERS

static final String EXT_DEVICE_IMPORTERS

The extension point for use in registering new device importers.

See Also:

Constant Field Values

Method Detail

importDevices

List<IDevice> importDevices(File directory,
                            IProgressMonitor monitor)
                            throws CoreException,
                                   InterruptedException

Return the fully configured device instances found in the specified directory or null if no devices are recognized by this importer in this directory.

Parameters:

directory - the directory in which the devices must be searched.

monitor - a progress monitor, or null if progress reporting is not desired.

Returns:

a list of devices instances imported from the specified directory or an empty list if no device was found.

Throws:

CoreException - if the device importer found an error occurred while searching for the devices.

InterruptedException - if the operation detects a request to cancel, using IProgressMonitor#isCanceled(), it should exit by throwing InterruptedException.