Eclipse Plug-in Developer Guide (Galileo) - ILaunchConfigurationMigrationDelegate (Eclipse Platform API Specification)

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Eclipse Platform
Release 3.5

PREV CLASS NEXT CLASS

NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.eclipse.debug.core
Interface ILaunchConfigurationMigrationDelegate

public interface ILaunchConfigurationMigrationDelegate

Responsible for migrating launch configurations between different versions of Eclipse. A migration delegate is contributed as an optional attribute of a launchConfigurationType extension and is responsible for identifying migration candidates and migrating launch configurations of that type.

For example, since 3.2 launch configurations may have resources mapped to them. A migration delegate could assign appropriate resources to a launch configuration create in an earlier version.

Clients may implement this interface.

Since:: 3.2

Method Summary

boolean isCandidate ( ILaunchConfiguration candidate)
Returns whether the given launch configuration requires migration.

void migrate ( ILaunchConfiguration candidate)
Migrates the given launch configuration to be compatible with the current tooling.

Method Detail

isCandidate

boolean isCandidate(
ILaunchConfiguration candidate)
                    throws 
CoreException

Returns whether the given launch configuration requires migration.

Parameters:: candidate - potential migration candidate
Returns:: whether the given launch configuration requires migration
Throws:: CoreException - if an exception occurs determining the status of the given configuration

migrate

void migrate(
ILaunchConfiguration candidate)
             throws 
CoreException

Migrates the given launch configuration to be compatible with the current tooling.

Parameters:: candidate - the candidate to be migrated, which can be a launch configuration or working copy
Throws:: CoreException - if an exception occurs during migration