/******************************************************************************* * Copyright (c) 2000, 2007 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/epl-v10.html * * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ package org.eclipse.debug.internal.core; import java.util.Collections; import java.util.HashMap; import java.util.HashSet; import java.util.Hashtable; import java.util.Iterator; import java.util.List; import java.util.Map; import java.util.Set; import org.eclipse.core.resources.IContainer; import org.eclipse.core.runtime.CoreException; import org.eclipse.core.runtime.IConfigurationElement; import org.eclipse.core.runtime.IStatus; import org.eclipse.core.runtime.PlatformObject; import org.eclipse.core.runtime.Status; import org.eclipse.debug.core.DebugPlugin; import org.eclipse.debug.core.ILaunchConfiguration; import org.eclipse.debug.core.ILaunchConfigurationMigrationDelegate; import org.eclipse.debug.core.ILaunchConfigurationType; import org.eclipse.debug.core.ILaunchConfigurationWorkingCopy; import org.eclipse.debug.core.ILaunchDelegate; import org.eclipse.debug.core.ILaunchManager; import org.eclipse.debug.core.ILaunchMode; import org.eclipse.debug.core.model.ILaunchConfigurationDelegate; import org.eclipse.debug.core.sourcelookup.ISourcePathComputer; import com.ibm.icu.text.MessageFormat; /** * A launch configuration type wrappers a configuration * element for a launchConfigurationType * extension. */ public class LaunchConfigurationType extends PlatformObject implements ILaunchConfigurationType { /** * The configuration element of the extension. */ private IConfigurationElement fElement; /** * a listing of modes contributed to this launch configuration type * * @since 3.3 */ private Set fModes = null; /** * A set of sets containing all of the supported mode combinations of this type * * @since 3.3 */ private Set fModeCombinations = null; /** * the default source path computer for this config type * * @since 3.3 */ private ISourcePathComputer fSourcePathComputer = null; /** * Cache for the migration delegate * * @since 3.3 */ private ILaunchConfigurationMigrationDelegate fMigrationDelegate = null; /** * The source locator id for this config type */ private String fSourceLocator = null; /** * The delegates for launch configurations of this type. * Delegates are instantiated lazily as required. There may * be different delegates for different modes (since 3.0). * Map of modes (Set of modes) to list of delegates */ private Map fDelegates = null; /** * The source provider cache entry */ private LaunchDelegate fSourceProvider = null; /** * A map of preferred launch delegates for mode combinations * * @since 3.3 */ private Map fPreferredDelegates = null; /** * Constructs a new launch configuration type on the * given configuration element. * * @param element configuration element */ protected LaunchConfigurationType(IConfigurationElement element) { fElement = element; initializePreferredDelegates(); } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getAttribute(java.lang.String) */ public String getAttribute(String attributeName) { return fElement.getAttribute(attributeName); } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getCategory() */ public String getCategory() { return fElement.getAttribute(IConfigurationElementConstants.CATEGORY); } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getDelegate() */ public ILaunchConfigurationDelegate getDelegate() throws CoreException { return getDelegate(ILaunchManager.RUN_MODE); } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getDelegate(java.lang.String) */ public ILaunchConfigurationDelegate getDelegate(String mode) throws CoreException { Set modes = new HashSet(); modes.add(mode); ILaunchDelegate[] delegates = getDelegates(modes); if (delegates.length > 0) { return delegates[0].getDelegate(); } IStatus status = null; ILaunchMode launchMode = DebugPlugin.getDefault().getLaunchManager().getLaunchMode(mode); if (launchMode == null) { status = new Status(IStatus.ERROR, DebugPlugin.getUniqueIdentifier(), MessageFormat.format(DebugCoreMessages.LaunchConfigurationType_7, new String[]{mode})); } else { status = new Status(IStatus.ERROR, DebugPlugin.getUniqueIdentifier(), MessageFormat.format(DebugCoreMessages.LaunchConfigurationType_7, new String[]{((LaunchManager)DebugPlugin.getDefault().getLaunchManager()).getLaunchModeName(mode)})); } throw new CoreException(status); } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getDelegates(java.util.Set) */ public ILaunchDelegate[] getDelegates(Set modes) throws CoreException { initializeDelegates(); Set delegates = (Set) fDelegates.get(modes); if (delegates == null) { delegates = Collections.EMPTY_SET; } return (ILaunchDelegate[]) delegates.toArray(new ILaunchDelegate[delegates.size()]); } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#setPreferredDelegate(java.util.Set, org.eclipse.debug.core.ILaunchDelegate) */ public void setPreferredDelegate(Set modes, ILaunchDelegate delegate) { if(fPreferredDelegates == null) { fPreferredDelegates = new HashMap(); } if (delegate == null) { fPreferredDelegates.remove(modes); } else { fPreferredDelegates.put(modes, delegate); } } /** * @see org.eclipse.debug.core.ILaunchConfigurationType#getPreferredDelegate(java.util.Set) */ public ILaunchDelegate getPreferredDelegate(Set modes) { return (ILaunchDelegate) fPreferredDelegates.get(modes); } /** * Internal use method to allow access to the listing of preferred delegates. Delegates are stored in the map by their mode set combinations. *

* preferred delegates are stored as: *

	 *  Map<modeset, delegate>
	 * 
*

* @return the java.util.Map of preferred delegates or an empty java.util.Map if no preferred delegates are specified, never null * * @since 3.3 */ public Map getPreferredDelegates() { return fPreferredDelegates; } /** * This method is used to initialize the listing of preferred launch delegates for this type * *

* Undecided if this code should live in the launch manager and have it load a listing of all preferred launch * delegates that each config type could then query as needed when looking for their preferred delegate. * Seems like it would be alot less work... *

* @since 3.3 */ private synchronized void initializePreferredDelegates() { if(fPreferredDelegates == null) { fPreferredDelegates = new HashMap(); initializeDelegates(); LaunchManager lm = (LaunchManager) DebugPlugin.getDefault().getLaunchManager(); ILaunchDelegate delegate = null; Set modes = null; for(Iterator iter = fDelegates.keySet().iterator(); iter.hasNext();) { modes = (Set) iter.next(); delegate = lm.getPreferredDelegate(getIdentifier(), modes); if(delegate != null) { fPreferredDelegates.put(modes, delegate); } } } } /** * Initializes the listing of launch delegates for this type */ private synchronized void initializeDelegates() { if (fDelegates == null) { // initialize delegate fDelegates = new Hashtable(); LaunchDelegate[] launchDelegates = getLaunchDelegateExtensions(); LaunchDelegate delegate = null; List modelist = null; Set modes = null, tmp = null; for (int i = 0; i < launchDelegates.length; i++) { delegate = launchDelegates[i]; modelist = delegate.getModes(); for(int j = 0; j < modelist.size(); j++) { //cache the delegate based on its set of modes and delegate modes = (Set) modelist.get(j); tmp = (Set) fDelegates.get(modes); if (tmp == null) { tmp = new HashSet(); fDelegates.put(modes, tmp); } tmp.add(delegate); } } } } /** * Returns all launch delegate extensions registered for this configuration type. * * @return all launch delegate extensions */ private LaunchDelegate[] getLaunchDelegateExtensions() { return ((LaunchManager) DebugPlugin.getDefault().getLaunchManager()).getLaunchDelegates(getIdentifier()); } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getIdentifier() */ public String getIdentifier() { return fElement.getAttribute(IConfigurationElementConstants.ID); } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getName() */ public String getName() { return fElement.getAttribute(IConfigurationElementConstants.NAME); } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getPluginId() */ public String getPluginIdentifier() { return fElement.getContributor().getName(); } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getSourceLocatorId() */ public String getSourceLocatorId() { if(fSourceLocator == null) { fSourceLocator = getAttribute(IConfigurationElementConstants.SOURCE_LOCATOR); //see if the cached source provider knows about it if(fSourceProvider != null) { fSourceLocator = fSourceProvider.getSourceLocatorId(); } //if not provided check all the applicable delegates for one and record the delegate if found, //so it can be reused to try and find the source path computer if(fSourceLocator == null) { LaunchDelegate[] delegates = getLaunchDelegateExtensions(); for(int i = 0; i < delegates.length; i++) { fSourceLocator = delegates[i].getSourceLocatorId(); if(fSourceLocator != null) { fSourceProvider = delegates[i]; return fSourceLocator; } } fSourceProvider = null; } } return fSourceLocator; } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getSourcePathComputer() */ public ISourcePathComputer getSourcePathComputer() { if(fSourcePathComputer == null) { //get the id String id = fElement.getAttribute(IConfigurationElementConstants.SOURCE_PATH_COMPUTER); //ask if the source provider knows about it if(fSourceProvider != null) { id = fSourceProvider.getSourcePathComputerId(); } if(id != null) { fSourcePathComputer = DebugPlugin.getDefault().getLaunchManager().getSourcePathComputer(id); } else { //if not provided check all the applicable delegates for one and record the delegate if found, //so it can be reused to try and find the source path computer LaunchDelegate[] delegates = getLaunchDelegateExtensions(); for(int i = 0; i < delegates.length; i++) { id = delegates[i].getSourcePathComputerId(); if(id != null) { fSourceProvider = delegates[i]; fSourcePathComputer = DebugPlugin.getDefault().getLaunchManager().getSourcePathComputer(id); if(fSourcePathComputer != null) { return fSourcePathComputer; } } } fSourceProvider = null; } } return fSourcePathComputer; } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getSupportedModes() */ public Set getSupportedModes() { if(fModes == null) { fModes = new HashSet(); LaunchDelegate[] delegates = getLaunchDelegateExtensions(); List modesets = null; for(int i= 0; i < delegates.length; i++) { modesets = delegates[i].getModes(); for(Iterator iter = modesets.iterator(); iter.hasNext();) { fModes.addAll((Set) iter.next()); } } } return fModes; } /** * @see org.eclipse.debug.core.ILaunchConfigurationType#getSupportedModeCombinations() */ public Set getSupportedModeCombinations() { if(fModeCombinations == null) { initializeDelegates(); fModeCombinations = new HashSet(); fModeCombinations = fDelegates.keySet(); } //return a clone or bad things happen HashSet set = new HashSet(); for(Iterator iter = fModeCombinations.iterator(); iter.hasNext();) { set.add(new HashSet((Set) iter.next())); } return set; } /** * determines if the specified candidate is suitable for migration by loading its delegate. * if we initialize the delegate and it has not been provided, return false instead of failing * @param candidate the candidate to inspect for migration suitability * @return true if the specified launch configuration is suitable for migration, false otherwise * @throws CoreException * * @since 3.2 */ public boolean isMigrationCandidate(ILaunchConfiguration candidate) throws CoreException { initializeMigrationDelegate(); if(fMigrationDelegate != null) { return fMigrationDelegate.isCandidate(candidate); } return false; } /** * This method initializes the migration delegate * @throws CoreException */ private synchronized void initializeMigrationDelegate() throws CoreException { if(fElement.getAttribute(IConfigurationElementConstants.MIGRATION_DELEGATE) != null && fMigrationDelegate == null) { fMigrationDelegate = (ILaunchConfigurationMigrationDelegate) fElement.createExecutableExtension(IConfigurationElementConstants.MIGRATION_DELEGATE); } } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#isPublic() */ public boolean isPublic() { String publicString = fElement.getAttribute(IConfigurationElementConstants.PUBLIC); if (publicString != null) { if (publicString.equalsIgnoreCase("false")) { //$NON-NLS-1$ return false; } } return true; } /** * Migrates the specified launch configuration by loading its delegate. * In the event the migration delegate has not been provided do nothing. * @param candidate the candidate launch configuration to migrate * @throws CoreException * * @since 3.2 */ public void migrate(ILaunchConfiguration candidate) throws CoreException { initializeMigrationDelegate(); if(fMigrationDelegate != null) { fMigrationDelegate.migrate(candidate); } } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#newInstance(org.eclipse.core.resources.IContainer, java.lang.String) */ public ILaunchConfigurationWorkingCopy newInstance(IContainer container, String name) { return new LaunchConfigurationWorkingCopy(container, name, this); } /** * @see org.eclipse.debug.core.ILaunchConfigurationType#supportsMode(java.lang.String) */ public boolean supportsMode(String mode) { if(fModeCombinations == null) { getSupportedModeCombinations(); } Set modes = null; for(Iterator iter = fModeCombinations.iterator(); iter.hasNext();) { modes = (Set) iter.next(); if(modes.size() == 1 && modes.contains(mode)) { return true; } } return false; } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#getContributorName() */ public String getContributorName() { return fElement.getContributor().getName(); } /* (non-Javadoc) * @see org.eclipse.debug.core.ILaunchConfigurationType#supportsModeCombination(java.util.Set) */ public boolean supportsModeCombination(Set modes) { if(fModeCombinations == null) { getSupportedModeCombinations(); } return fModeCombinations.contains(modes); } }