diff options
Diffstat (limited to 'org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationWorkingCopy.java')
-rw-r--r-- | org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationWorkingCopy.java | 234 |
1 files changed, 0 insertions, 234 deletions
diff --git a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationWorkingCopy.java b/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationWorkingCopy.java deleted file mode 100644 index 36e7ee96e..000000000 --- a/org.eclipse.debug.core/core/org/eclipse/debug/core/ILaunchConfigurationWorkingCopy.java +++ /dev/null @@ -1,234 +0,0 @@ -/******************************************************************************* - * Copyright (c) 2000, 2005 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.core; - - -import java.util.List; -import java.util.Map; -import java.util.Set; - -import org.eclipse.core.resources.IContainer; -import org.eclipse.core.resources.IResource; -import org.eclipse.core.runtime.CoreException; -import org.eclipse.core.runtime.IAdaptable; - -/** - * An editable copy of a launch configuration. Attributes of a - * launch configuration are modified by modifying the attributes - * of a working copy, and then saving the working copy. - * <p> - * This interface is not intended to be implemented by clients. Clients - * that define a launch configuration delegate extension implement the - * <code>ILaunchConfigurationDelegate</code> interface. - * </p> - * @see ILaunchConfiguration - * @see ILaunchConfigurationType - * @see org.eclipse.debug.core.model.ILaunchConfigurationDelegate - * @since 2.0 - */ -public interface ILaunchConfigurationWorkingCopy extends ILaunchConfiguration, IAdaptable { - - /** - * Returns whether this configuration has been modified - * since it was last saved or created. - * - * @return whether this configuration has been modified - * since it was last saved or created - */ - public boolean isDirty(); - - /** - * Saves this working copy to its underlying file and returns - * a handle to the resulting launch configuration. - * Has no effect if this configuration does not need saving. - * Creates the underlying file if not yet created. - * - * @exception CoreException if an exception occurs while - * writing this configuration to its underlying file. - */ - public ILaunchConfiguration doSave() throws CoreException; - - /** - * Sets the integer-valued attribute with the given name. - * - * @param attributeName the name of the attribute, cannot be <code>null</code> - * @param value the value - */ - public void setAttribute(String attributeName, int value); - - /** - * Sets the String-valued attribute with the given name. - * If the value is <code>null</code>, the attribute is removed from - * this launch configuration. - * - * @param attributeName the name of the attribute, cannot be <code>null</code> - * @param value the value, or <code>null</code> if the attribute is to be undefined - */ - public void setAttribute(String attributeName, String value); - - /** - * Sets the <code>java.util.List</code>-valued attribute with the given name. - * The specified List <em>must</em> contain only String-valued entries. - * If the value is <code>null</code>, the attribute is removed from - * this launch configuration. - * - * @param attributeName the name of the attribute, cannot be <code>null</code> - * @param value the value, or <code>null</code> if the attribute is to be undefined - */ - public void setAttribute(String attributeName, List value); - - /** - * Sets the <code>java.util.Map</code>-valued attribute with the given name. - * The specified Map <em>must</em> contain only String keys and String values. - * If the value is <code>null</code>, the attribute is removed from - * this launch configuration. - * - * @param attributeName the name of the attribute, cannot be <code>null</code> - * @param value the value, or <code>null</code> if the attribute is to be undefined - */ - public void setAttribute(String attributeName, Map value); - - /** - * Sets the boolean-valued attribute with the given name. - * - * @param attributeName the name of the attribute, cannot be <code>null</code> - * @param value the value - */ - public void setAttribute(String attributeName, boolean value); - - /** - * Returns the original launch configuration this working copy - * was created from, or <code>null</code> if this is a new - * working copy created from a launch configuration type. - * - * @return the original launch configuration, or <code>null</code> - */ - public ILaunchConfiguration getOriginal(); - - /** - * Renames this launch configuration to the specified name. - * The new name cannot be <code>null</code>. Has no effect if the name - * is the same as the current name. If this working copy is based - * on an existing launch configuration, this will cause - * the underlying launch configuration file to be renamed when - * this working copy is saved. - * - * @param name the new name for this configuration - */ - public void rename(String name); - - /** - * Sets the container this launch configuration will be stored - * in when saved. When set to <code>null</code>, this configuration - * will be stored locally with the workspace. The specified - * container must exist, if specified. - * <p> - * If this configuration is changed from local to non-local, - * a file will be created in the specified container when - * saved. The local file associated with this configuration - * will be deleted. - * </p> - * <p> - * If this configuration is changed from non-local to local, - * a file will be created locally when saved. - * The original file associated with this configuration in - * the workspace will be deleted. - * </p> - * - * @param container the container in which to store this - * launch configuration, or <code>null</code> if this - * configuration is to be stored locally - */ - public void setContainer(IContainer container); - - /** - * Sets the attributes of this launch configuration to be the ones contained - * in the given map. The values must be an instance of one of the following - * classes: <code>String</code>, <code>Integer</code>, or - * <code>Boolean</code>, <code>List</code>, <code>Map</code>. Attributes - * previously set on this launch configuration but not included in the given - * map are considered to be removals. Setting the given map to be - * <code>null</code> is equivalent to removing all attributes. - * - * @param attributes a map of attribute names to attribute values. - * Attribute names are not allowed to be <code>null</code> - * @since 2.1 - */ - public void setAttributes(Map attributes); - - /** - * Sets the resources associated with this launch configuration, possibly <code>null</code>. - * Clients contributing launch configuration types are responsible for maintaining - * resource mappings. - * - * @param resources the resource to map to this launch configuration or <code>null</code> - * @since 3.2 - */ - public void setMappedResources(IResource[] resources); - - /** - * Set the launch modes for this configuration. - * Over-writes existing launch modes. - * <p> - * Setting launch modes on a configuration allows the configuration to - * be launched in a mixed mode - for example, debug and profile. - * </p> - * @param modes launch mode identifiers to set on this configuration - * or <code>null</code> to clear mode settings - * - * <p> - * <strong>EXPERIMENTAL</strong>. This method has been added as - * part of a work in progress. There is no guarantee that this API will - * remain unchanged during the 3.3 release cycle. Please do not use this API - * without consulting with the Platform/Debug team. - * </p> - * @since 3.3 - */ - public void setModes(Set modes); - - /** - * Adds the specified launch modes to this configuration's settings. - * <p> - * Setting launch modes on a configuration allows the configuration to - * be launched in a mixed mode - for example, debug and profile. - * </p> - * @param modes launch mode identifiers to append to the current set of - * launch modes set on this configuration - * - * <p> - * <strong>EXPERIMENTAL</strong>. This method has been added as - * part of a work in progress. There is no guarantee that this API will - * remain unchanged during the 3.3 release cycle. Please do not use this API - * without consulting with the Platform/Debug team. - * </p> - * @since 3.3 - */ - public void addModes(Set modes); - - /** - * Removes the specified launch modes from this configuration's settings. - * <p> - * Setting launch modes on a configuration allows the configuration to - * be launched in a mixed mode - for example, debug and profile. - * </p> - * @param modes launch mode identifiers to remove from the current set of - * launch modes set on this configuration - * - * <p> - * <strong>EXPERIMENTAL</strong>. This method has been added as - * part of a work in progress. There is no guarantee that this API will - * remain unchanged during the 3.3 release cycle. Please do not use this API - * without consulting with the Platform/Debug team. - * </p> - * @since 3.3 - */ - public void removeModes(Set modes); -} |