projects/dwt-addons: dwtx/core/commands/Command.d annotate

annotate dwtx/core/commands/Command.d @ 90:7ffeace6c47f

Update 3.4M7 to 3.4

author	Frank Benoit <benoit@tionex.de>
date	Sun, 06 Jul 2008 23:30:07 +0200
parents	4878bef4a38e
children

rev	line source
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1 /*******************************************************************************
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	2 * Copyright (c) 2004, 2008 IBM Corporation and others.
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	3 * All rights reserved. This program and the accompanying materials
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	4 * are made available under the terms of the Eclipse Public License v1.0
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	5 * which accompanies this distribution, and is available at
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	6 * http://www.eclipse.org/legal/epl-v10.html
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	7 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	8 * Contributors:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	9 * IBM Corporation - initial API and implementation
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	10 * Port to the D programming language:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	11 * Frank Benoit <benoit@tionex.de>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	12 *******************************************************************************/
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	13 module dwtx.core.commands.Command;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	14
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	15 // import java.io.BufferedWriter;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	16 // import java.io.IOException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	17 // import java.io.StringWriter;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	18
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	19 import dwtx.core.commands.common.NotDefinedException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	20 import dwtx.core.commands.util.Tracing;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	21 import dwtx.core.internal.commands.util.Util;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	22 import dwtx.core.runtime.ISafeRunnable;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	23 import dwtx.core.runtime.ListenerList;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	24 import dwtx.core.runtime.SafeRunner;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	25
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	26 import dwtx.core.commands.IParameter;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	27 import dwtx.core.commands.IHandlerListener;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	28 import dwtx.core.commands.NotEnabledException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	29 import dwtx.core.commands.NotHandledException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	30 import dwtx.core.commands.ExecutionException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	31 import dwtx.core.commands.CommandEvent;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	32 import dwtx.core.commands.State;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	33 import dwtx.core.commands.Category;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	34 import dwtx.core.commands.NamedHandleObjectWithState;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	35 import dwtx.core.commands.ExecutionEvent;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	36 import dwtx.core.commands.ParameterType;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	37 import dwtx.core.commands.IExecutionListener;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	38 import dwtx.core.commands.ICommandListener;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	39 import dwtx.core.commands.IHandler;
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	40 import dwtx.core.commands.IHandler2;
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	41 import dwtx.core.commands.IObjectWithState;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	42 import dwtx.core.commands.IExecutionListenerWithChecks;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	43 import dwtx.core.commands.ITypedParameter;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	44 import dwtx.core.commands.HandlerEvent;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	45
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	46 import dwt.dwthelper.utils;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	47 import tango.text.convert.Format;
90 7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	48 import tango.io.Stdout;
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	49
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	50 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	51 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	52 * A command is an abstract representation for some semantic behaviour. It is
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	53 * not the actual implementation of this behaviour, nor is it the visual
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	54 * appearance of this behaviour in the user interface. Instead, it is a bridge
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	55 * between the two.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	56 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	57 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	58 * The concept of a command is based on the command design pattern. The notable
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	59 * difference is how the command delegates responsibility for execution. Rather
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	60 * than allowing concrete subclasses, it uses a handler mechanism (see the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	61 * <code>handlers</code> extension point). This provides another level of
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	62 * indirection.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	63 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	64 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	65 * A command will exist in two states: defined and undefined. A command is
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	66 * defined if it is declared in the XML of a resolved plug-in. If the plug-in is
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	67 * unloaded or the command is simply not declared, then it is undefined. Trying
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	68 * to reference an undefined command will succeed, but trying to access any of
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	69 * its functionality will fail with a <code>NotDefinedException</code>. If
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	70 * you need to know when a command changes from defined to undefined (or vice
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	71 * versa), then attach a command listener.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	72 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	73 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	74 * Commands are mutable and will change as their definition changes.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	75 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	76 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	77 * @since 3.1
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	78 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	79 public final class Command : NamedHandleObjectWithState,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	80 Comparable {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	81
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	82 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	83 * This flag can be set to <code>true</code> if commands should print
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	84 * information to <code>System.out</code> when executing.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	85 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	86 public static bool DEBUG_COMMAND_EXECUTION = false;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	87
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	88 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	89 * This flag can be set to <code>true</code> if commands should print
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	90 * information to <code>System.out</code> when changing handlers.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	91 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	92 public static bool DEBUG_HANDLERS = false;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	93
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	94 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	95 * This flag can be set to a particular command identifier if only that
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	96 * command should print information to <code>System.out</code> when
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	97 * changing handlers.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	98 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	99 public static String DEBUG_HANDLERS_COMMAND_ID = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	100
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	101 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	102 * The category to which this command belongs. This value should not be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	103 * <code>null</code> unless the command is undefined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	104 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	105 private Category category = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	106
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	107 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	108 * A collection of objects listening to the execution of this command. This
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	109 * collection is <code>null</code> if there are no listeners.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	110 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	111 private /+transient+/ ListenerList executionListeners = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	112
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	113 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	114 * The handler currently associated with this command. This value may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	115 * <code>null</code> if there is no handler currently.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	116 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	117 private /+transient+/ IHandler handler = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	118
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	119 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	120 * The help context identifier for this command. This can be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	121 * <code>null</code> if there is no help currently associated with the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	122 * command.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	123 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	124 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	125 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	126 private String helpContextId;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	127
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	128 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	129 * The ordered array of parameters understood by this command. This value
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	130 * may be <code>null</code> if there are no parameters, or if the command
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	131 * is undefined. It may also be empty.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	132 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	133 private IParameter[] parameters = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	134
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	135 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	136 * The type of the return value of this command. This value may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	137 * <code>null</code> if the command does not declare a return type.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	138 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	139 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	140 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	141 private ParameterType returnType = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	142
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	143 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	144 * Our command will listen to the active handler for enablement changes so
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	145 * that they can be fired from the command itself.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	146 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	147 * @since 3.3
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	148 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	149 private IHandlerListener handlerListener;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	150
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	151 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	152 * Constructs a new instance of <code>Command</code> based on the given
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	153 * identifier. When a command is first constructed, it is undefined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	154 * Commands should only be constructed by the <code>CommandManager</code>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	155 * to ensure that the identifier remains unique.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	156 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	157 * @param id
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	158 * The identifier for the command. This value must not be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	159 * <code>null</code>, and must be unique amongst all commands.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	160 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	161 this(String id) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	162 super(id);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	163 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	164
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	165 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	166 * Adds a listener to this command that will be notified when this command's
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	167 * state changes.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	168 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	169 * @param commandListener
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	170 * The listener to be added; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	171 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	172 public final void addCommandListener(ICommandListener commandListener) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	173 if (commandListener is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	174 throw new NullPointerException("Cannot add a null command listener"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	175 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	176 addListenerObject(cast(Object)commandListener);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	177 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	178
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	179 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	180 * Adds a listener to this command that will be notified when this command
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	181 * is about to execute.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	182 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	183 * @param executionListener
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	184 * The listener to be added; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	185 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	186 public final void addExecutionListener(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	187 IExecutionListener executionListener) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	188 if (executionListener is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	189 throw new NullPointerException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	190 "Cannot add a null execution listener"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	191 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	192
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	193 if (executionListeners is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	194 executionListeners = new ListenerList(ListenerList.IDENTITY);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	195 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	196
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	197 executionListeners.add(cast(Object)executionListener);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	198 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	199
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	200 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	201 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	202 * Adds a state to this command. This will add this state to the active
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	203 * handler, if the active handler is an instance of {@link IObjectWithState}.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	204 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	205 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	206 * A single instance of {@link State} cannot be registered with multiple
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	207 * commands. Each command requires its own unique instance.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	208 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	209 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	210 * @param id
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	211 * The identifier of the state to add; must not be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	212 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	213 * @param state
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	214 * The state to add; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	215 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	216 */
43 ea8ff534f622 Fix override and super aliases Frank Benoit <benoit@tionex.de> parents: 39 diff changeset	217 public override void addState(String id, State state) {
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	218 super.addState(id, state);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	219 state.setId(id);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	220 if ( auto h = cast(IObjectWithState)handler) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	221 h.addState(id, state);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	222 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	223 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	224
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	225 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	226 * Compares this command with another command by comparing each of its
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	227 * non-transient attributes.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	228 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	229 * @param object
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	230 * The object with which to compare; must be an instance of
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	231 * <code>Command</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	232 * @return A negative integer, zero or a postivie integer, if the object is
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	233 * greater than, equal to or less than this command.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	234 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	235 public final int compareTo(Object object) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	236 Command castedObject = cast(Command) object;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	237 int compareTo = Util.compare(category, castedObject.category);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	238 if (compareTo is 0) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	239 compareTo = Util.compare(defined, castedObject.defined);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	240 if (compareTo is 0) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	241 compareTo = Util.compare(description, castedObject.description);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	242 if (compareTo is 0) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	243 compareTo = Util.compare(cast(Object)handler, cast(Object)castedObject.handler);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	244 if (compareTo is 0) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	245 compareTo = Util.compare(id, castedObject.id);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	246 if (compareTo is 0) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	247 compareTo = Util.compare(name, castedObject.name);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	248 if (compareTo is 0) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	249 Object[] left, right;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	250 foreach( p; parameters ){
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	251 left ~= cast(Object)p;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	252 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	253 foreach( p; castedObject.parameters ){
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	254 right ~= cast(Object)p;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	255 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	256 compareTo = Util.compare(left,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	257 right);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	258 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	259 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	260 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	261 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	262 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	263 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	264 return compareTo;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	265 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	266
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	267 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	268 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	269 * Defines this command by giving it a name, and possibly a description as
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	270 * well. The defined property automatically becomes <code>true</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	271 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	272 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	273 * Notification is sent to all listeners that something has changed.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	274 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	275 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	276 * @param name
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	277 * The name of this command; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	278 * @param description
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	279 * The description for this command; may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	280 * @param category
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	281 * The category for this command; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	282 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	283 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	284 public final void define(String name, String description,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	285 Category category) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	286 define(name, description, category, null);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	287 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	288
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	289 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	290 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	291 * Defines this command by giving it a name, and possibly a description as
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	292 * well. The defined property automatically becomes <code>true</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	293 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	294 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	295 * Notification is sent to all listeners that something has changed.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	296 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	297 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	298 * @param name
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	299 * The name of this command; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	300 * @param description
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	301 * The description for this command; may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	302 * @param category
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	303 * The category for this command; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	304 * @param parameters
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	305 * The parameters understood by this command. This value may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	306 * either <code>null</code> or empty if the command does not
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	307 * accept parameters.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	308 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	309 public final void define(String name, String description,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	310 Category category, IParameter[] parameters) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	311 define(name, description, category, parameters, null);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	312 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	313
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	314 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	315 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	316 * Defines this command by giving it a name, and possibly a description as
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	317 * well. The defined property automatically becomes <code>true</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	318 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	319 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	320 * Notification is sent to all listeners that something has changed.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	321 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	322 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	323 * @param name
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	324 * The name of this command; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	325 * @param description
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	326 * The description for this command; may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	327 * @param category
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	328 * The category for this command; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	329 * @param parameters
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	330 * The parameters understood by this command. This value may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	331 * either <code>null</code> or empty if the command does not
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	332 * accept parameters.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	333 * @param returnType
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	334 * The type of value returned by this command. This value may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	335 * <code>null</code> if the command does not declare a return
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	336 * type.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	337 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	338 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	339 public final void define(String name, String description,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	340 Category category, IParameter[] parameters,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	341 ParameterType returnType) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	342 define(name, description, category, parameters, returnType, null);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	343 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	344
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	345 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	346 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	347 * Defines this command by giving it a name, and possibly a description as
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	348 * well. The defined property automatically becomes <code>true</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	349 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	350 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	351 * Notification is sent to all listeners that something has changed.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	352 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	353 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	354 * @param name
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	355 * The name of this command; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	356 * @param description
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	357 * The description for this command; may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	358 * @param category
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	359 * The category for this command; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	360 * @param parameters
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	361 * The parameters understood by this command. This value may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	362 * either <code>null</code> or empty if the command does not
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	363 * accept parameters.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	364 * @param returnType
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	365 * The type of value returned by this command. This value may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	366 * <code>null</code> if the command does not declare a return
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	367 * type.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	368 * @param helpContextId
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	369 * The identifier of the help context to associate with this
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	370 * command; may be <code>null</code> if this command does not
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	371 * have any help associated with it.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	372 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	373 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	374 public final void define(String name, String description,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	375 Category category, IParameter[] parameters,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	376 ParameterType returnType, String helpContextId) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	377 if (name is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	378 throw new NullPointerException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	379 "The name of a command cannot be null"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	380 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	381
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	382 if (category is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	383 throw new NullPointerException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	384 "The category of a command cannot be null"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	385 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	386
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	387 bool definedChanged = !this.defined;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	388 this.defined = true;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	389
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	390 bool nameChanged = !Util.equals(this.name, name);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	391 this.name = name;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	392
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	393 bool descriptionChanged = !Util.equals(this.description,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	394 description);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	395 this.description = description;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	396
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	397 bool categoryChanged = !Util.equals(this.category, category);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	398 this.category = category;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	399
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	400 Object[] pLeft, pRight;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	401 foreach( p; this.parameters ){
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	402 pLeft ~= cast(Object)p;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	403 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	404 foreach( p; parameters ){
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	405 pRight ~= cast(Object)p;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	406 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	407 bool parametersChanged = !Util.equals(pLeft,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	408 pRight);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	409 this.parameters = parameters;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	410
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	411 bool returnTypeChanged = !Util.equals(this.returnType,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	412 returnType);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	413 this.returnType = returnType;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	414
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	415 bool helpContextIdChanged = !Util.equals(this.helpContextId,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	416 helpContextId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	417 this.helpContextId = helpContextId;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	418
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	419 fireCommandChanged(new CommandEvent(this, categoryChanged,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	420 definedChanged, descriptionChanged, false, nameChanged,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	421 parametersChanged, returnTypeChanged, helpContextIdChanged));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	422 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	423
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	424 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	425 * Executes this command by delegating to the current handler, if any. If
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	426 * the debugging flag is set, then this method prints information about
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	427 * which handler is selected for performing this command. This method will
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	428 * succeed regardless of whether the command is enabled or defined. It is
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	429 * generally preferred to call {@link #executeWithChecks(ExecutionEvent)}.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	430 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	431 * @param event
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	432 * An event containing all the information about the current
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	433 * state of the application; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	434 * @return The result of the execution; may be <code>null</code>. This
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	435 * result will be available to the client executing the command, and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	436 * execution listeners.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	437 * @throws ExecutionException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	438 * If the handler has problems executing this command.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	439 * @throws NotHandledException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	440 * If there is no handler.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	441 * @deprecated Please use {@link #executeWithChecks(ExecutionEvent)}
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	442 * instead.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	443 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	444 public final Object execute(ExecutionEvent event) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	445 firePreExecute(event);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	446 IHandler handler = this.handler;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	447
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	448 // Perform the execution, if there is a handler.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	449 if ((handler !is null) && (handler.isHandled())) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	450 try {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	451 Object returnValue = handler.execute(event);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	452 firePostExecuteSuccess(returnValue);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	453 return returnValue;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	454 } catch (ExecutionException e) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	455 firePostExecuteFailure(e);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	456 throw e;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	457 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	458 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	459
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	460 NotHandledException e = new NotHandledException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	461 "There is no handler to execute. " ~ getId()); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	462 fireNotHandled(e);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	463 throw e;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	464 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	465
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	466 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	467 * Executes this command by delegating to the current handler, if any. If
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	468 * the debugging flag is set, then this method prints information about
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	469 * which handler is selected for performing this command. This does checks
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	470 * to see if the command is enabled and defined. If it is not both enabled
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	471 * and defined, then the execution listeners will be notified and an
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	472 * exception thrown.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	473 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	474 * @param event
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	475 * An event containing all the information about the current
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	476 * state of the application; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	477 * @return The result of the execution; may be <code>null</code>. This
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	478 * result will be available to the client executing the command, and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	479 * execution listeners.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	480 * @throws ExecutionException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	481 * If the handler has problems executing this command.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	482 * @throws NotDefinedException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	483 * If the command you are trying to execute is not defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	484 * @throws NotEnabledException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	485 * If the command you are trying to execute is not enabled.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	486 * @throws NotHandledException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	487 * If there is no handler.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	488 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	489 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	490 public final Object executeWithChecks(ExecutionEvent event) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	491 firePreExecute(event);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	492 IHandler handler = this.handler;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	493
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	494 if (!isDefined()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	495 NotDefinedException exception = new NotDefinedException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	496 "Trying to execute a command that is not defined. " //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	497 ~ getId());
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	498 fireNotDefined(exception);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	499 throw exception;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	500 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	501
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	502 // Perform the execution, if there is a handler.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	503 if ((handler !is null) && (handler.isHandled())) {
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	504 setEnabled(event.getApplicationContext());
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	505 if (!isEnabled()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	506 NotEnabledException exception = new NotEnabledException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	507 "Trying to execute the disabled command " ~ getId()); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	508 fireNotEnabled(exception);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	509 throw exception;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	510 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	511
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	512 try {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	513 Object returnValue = handler.execute(event);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	514 firePostExecuteSuccess(returnValue);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	515 return returnValue;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	516 } catch (ExecutionException e) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	517 firePostExecuteFailure(e);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	518 throw e;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	519 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	520 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	521
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	522 NotHandledException e = new NotHandledException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	523 "There is no handler to execute for command " ~ getId()); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	524 fireNotHandled(e);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	525 throw e;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	526 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	527
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	528 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	529 * Notifies the listeners for this command that it has changed in some way.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	530 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	531 * @param commandEvent
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	532 * The event to send to all of the listener; must not be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	533 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	534 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	535 private final void fireCommandChanged(CommandEvent commandEvent) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	536 if (commandEvent is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	537 throw new NullPointerException("Cannot fire a null event"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	538 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	539
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	540 Object[] listeners = getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	541 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	542 ICommandListener listener = cast(ICommandListener) listeners[i];
39 644f1334b451 fix anon classes Frank Benoit <benoit@tionex.de> parents: 3 diff changeset	543 SafeRunner.run(new class(listener) ISafeRunnable {
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	544 ICommandListener listener_;
39 644f1334b451 fix anon classes Frank Benoit <benoit@tionex.de> parents: 3 diff changeset	545 this(ICommandListener a){ this.listener_ = a; }
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	546 public void handleException(Exception exception) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	547 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	548
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	549 public void run() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	550 listener_.commandChanged(commandEvent);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	551 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	552 });
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	553 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	554 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	555
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	556 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	557 * Notifies the execution listeners for this command that an attempt to
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	558 * execute has failed because the command is not defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	559 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	560 * @param e
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	561 * The exception that is about to be thrown; never
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	562 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	563 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	564 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	565 private final void fireNotDefined(NotDefinedException e) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	566 // Debugging output
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	567 if (DEBUG_COMMAND_EXECUTION) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	568 Tracing.printTrace("COMMANDS", "execute" ~ Tracing.SEPARATOR //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	569 ~ "not defined: id=" ~ getId() ~ "; exception=" ~ e.toString ); //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	570 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	571
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	572 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	573 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	574 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	575 Object object = listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	576 if ( auto listener = cast(IExecutionListenerWithChecks)object ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	577 listener.notDefined(getId(), e);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	578 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	579 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	580 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	581 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	582
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	583 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	584 * Notifies the execution listeners for this command that an attempt to
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	585 * execute has failed because there is no handler.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	586 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	587 * @param e
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	588 * The exception that is about to be thrown; never
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	589 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	590 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	591 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	592 private final void fireNotEnabled(NotEnabledException e) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	593 // Debugging output
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	594 if (DEBUG_COMMAND_EXECUTION) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	595 Tracing.printTrace("COMMANDS", "execute" ~ Tracing.SEPARATOR //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	596 ~ "not enabled: id=" ~ getId() ~ "; exception=" ~ e.toString ); //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	597 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	598
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	599 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	600 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	601 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	602 Object object = listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	603 if ( auto listener = cast(IExecutionListenerWithChecks)object ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	604 listener.notEnabled(getId(), e);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	605 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	606 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	607 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	608 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	609
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	610 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	611 * Notifies the execution listeners for this command that an attempt to
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	612 * execute has failed because there is no handler.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	613 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	614 * @param e
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	615 * The exception that is about to be thrown; never
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	616 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	617 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	618 private final void fireNotHandled(NotHandledException e) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	619 // Debugging output
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	620 if (DEBUG_COMMAND_EXECUTION) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	621 Tracing.printTrace("COMMANDS", "execute" ~ Tracing.SEPARATOR //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	622 ~ "not handled: id=" ~ getId() ~ "; exception=" ~ e.toString ); //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	623 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	624
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	625 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	626 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	627 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	628 IExecutionListener listener = cast(IExecutionListener) listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	629 listener.notHandled(getId(), e);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	630 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	631 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	632 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	633
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	634 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	635 * Notifies the execution listeners for this command that an attempt to
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	636 * execute has failed during the execution.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	637 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	638 * @param e
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	639 * The exception that has been thrown; never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	640 * After this method completes, the exception will be thrown
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	641 * again.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	642 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	643 private final void firePostExecuteFailure(ExecutionException e) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	644 // Debugging output
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	645 if (DEBUG_COMMAND_EXECUTION) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	646 Tracing.printTrace("COMMANDS", "execute" ~ Tracing.SEPARATOR //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	647 ~ "failure: id=" ~ getId() ~ "; exception=" ~ e.toString ); //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	648 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	649
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	650 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	651 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	652 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	653 IExecutionListener listener = cast(IExecutionListener) listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	654 listener.postExecuteFailure(getId(), e);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	655 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	656 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	657 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	658
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	659 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	660 * Notifies the execution listeners for this command that an execution has
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	661 * completed successfully.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	662 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	663 * @param returnValue
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	664 * The return value from the command; may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	665 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	666 private final void firePostExecuteSuccess(Object returnValue) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	667 // Debugging output
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	668 if (DEBUG_COMMAND_EXECUTION) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	669 Tracing.printTrace("COMMANDS", "execute" ~ Tracing.SEPARATOR //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	670 ~ "success: id=" ~ getId() ~ "; returnValue=" //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	671 ~ returnValue.toString );
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	672 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	673
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	674 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	675 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	676 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	677 IExecutionListener listener = cast(IExecutionListener) listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	678 listener.postExecuteSuccess(getId(), returnValue);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	679 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	680 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	681 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	682
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	683 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	684 * Notifies the execution listeners for this command that an attempt to
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	685 * execute is about to start.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	686 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	687 * @param event
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	688 * The execution event that will be used; never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	689 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	690 private final void firePreExecute(ExecutionEvent event) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	691 // Debugging output
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	692 if (DEBUG_COMMAND_EXECUTION) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	693 Tracing.printTrace("COMMANDS", "execute" ~ Tracing.SEPARATOR //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	694 ~ "starting: id=" ~ getId() ~ "; event=" ~ event.toString ); //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	695 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	696
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	697 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	698 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	699 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	700 IExecutionListener listener = cast(IExecutionListener) listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	701 listener.preExecute(getId(), event);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	702 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	703 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	704 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	705
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	706 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	707 * Returns the category for this command.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	708 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	709 * @return The category for this command; never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	710 * @throws NotDefinedException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	711 * If the handle is not currently defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	712 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	713 public final Category getCategory() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	714 if (!isDefined()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	715 throw new NotDefinedException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	716 "Cannot get the category from an undefined command. " //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	717 ~ id);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	718 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	719
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	720 return category;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	721 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	722
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	723 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	724 * Returns the current handler for this command. This is used by the command
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	725 * manager for determining the appropriate help context identifiers and by
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	726 * the command service to allow handlers to update elements.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	727 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	728 * This value can change at any time and should never be cached.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	729 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	730 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	731 * @return The current handler for this command; may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	732 * @since 3.3
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	733 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	734 public final IHandler getHandler() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	735 return handler;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	736 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	737
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	738 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	739 * Returns the help context identifier associated with this command. This
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	740 * method should not be called by clients. Clients should use
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	741 * {@link CommandManager#getHelpContextId(Command)} instead.
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	742 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	743 * @return The help context identifier for this command; may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	744 * <code>null</code> if there is none.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	745 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	746 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	747 final String getHelpContextId() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	748 return helpContextId;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	749 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	750
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	751 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	752 * Returns the parameter with the provided id or <code>null</code> if this
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	753 * command does not have a parameter with the id.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	754 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	755 * @param parameterId
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	756 * The id of the parameter to retrieve.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	757 * @return The parameter with the provided id or <code>null</code> if this
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	758 * command does not have a parameter with the id.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	759 * @throws NotDefinedException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	760 * If the handle is not currently defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	761 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	762 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	763 public final IParameter getParameter(String parameterId) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	764 if (!isDefined()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	765 throw new NotDefinedException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	766 "Cannot get a parameter from an undefined command. " //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	767 ~ id);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	768 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	769
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	770 if (parameters is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	771 return null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	772 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	773
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	774 for (int i = 0; i < parameters.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	775 IParameter parameter = parameters[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	776 if (parameter.getId().equals(parameterId)) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	777 return parameter;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	778 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	779 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	780
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	781 return null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	782 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	783
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	784 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	785 * Returns the parameters for this command. This call triggers provides a
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	786 * copy of the array, so excessive calls to this method should be avoided.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	787 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	788 * @return The parameters for this command. This value might be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	789 * <code>null</code>, if the command has no parameters.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	790 * @throws NotDefinedException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	791 * If the handle is not currently defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	792 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	793 public final IParameter[] getParameters() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	794 if (!isDefined()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	795 throw new NotDefinedException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	796 "Cannot get the parameters from an undefined command. " //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	797 ~ id);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	798 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	799
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	800 if ((parameters is null) \|\| (parameters.length is 0)) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	801 return null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	802 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	803
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	804 IParameter[] returnValue = new IParameter[parameters.length];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	805 SimpleType!(IParameter).arraycopy(parameters, 0, returnValue, 0, parameters.length);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	806 return returnValue;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	807 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	808
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	809 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	810 * Returns the {@link ParameterType} for the parameter with the provided id
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	811 * or <code>null</code> if this command does not have a parameter type
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	812 * with the id.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	813 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	814 * @param parameterId
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	815 * The id of the parameter to retrieve the {@link ParameterType}
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	816 * of.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	817 * @return The {@link ParameterType} for the parameter with the provided id
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	818 * or <code>null</code> if this command does not have a parameter
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	819 * type with the provided id.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	820 * @throws NotDefinedException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	821 * If the handle is not currently defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	822 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	823 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	824 public final ParameterType getParameterType(String parameterId) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	825 IParameter parameter = getParameter(parameterId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	826 if ( auto parameterWithType = cast(ITypedParameter)parameter ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	827 return parameterWithType.getParameterType();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	828 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	829 return null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	830 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	831
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	832 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	833 * Returns the {@link ParameterType} for the return value of this command or
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	834 * <code>null</code> if this command does not declare a return value
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	835 * parameter type.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	836 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	837 * @return The {@link ParameterType} for the return value of this command or
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	838 * <code>null</code> if this command does not declare a return
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	839 * value parameter type.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	840 * @throws NotDefinedException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	841 * If the handle is not currently defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	842 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	843 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	844 public final ParameterType getReturnType() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	845 if (!isDefined()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	846 throw new NotDefinedException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	847 "Cannot get the return type of an undefined command. " //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	848 ~ id);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	849 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	850
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	851 return returnType;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	852 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	853
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	854 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	855 * Returns whether this command has a handler, and whether this handler is
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	856 * also handled and enabled.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	857 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	858 * @return <code>true</code> if the command is handled; <code>false</code>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	859 * otherwise.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	860 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	861 public final bool isEnabled() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	862 if (handler is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	863 return false;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	864 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	865
90 7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	866 try {
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	867 return handler.isEnabled();
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	868 } catch (Exception e) {
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	869 if (DEBUG_HANDLERS) {
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	870 // since this has the ability to generate megs of logs, only
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	871 // provide information if tracing
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	872 Tracing.printTrace("HANDLERS", "Handler " ~ (cast(Object)handler).toString() ~ " for " //$NON-NLS-1$//$NON-NLS-2$ //$NON-NLS-3$
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	873 ~ id ~ " threw unexpected exception"); //$NON-NLS-1$
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	874 ExceptionPrintStackTrace( e, Stdout );
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	875 }
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	876 }
7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 71 diff changeset	877 return false;
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	878 }
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	879
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	880 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	881 * Called be the framework to allow the handler to update its enabled state.
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	882 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	883 * @param evaluationContext
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	884 * the state to evaluate against. May be <code>null</code>
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	885 * which indicates that the handler can query whatever model that
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	886 * is necessary. This context must not be cached.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	887 * @since 3.4
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	888 */
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	889 public void setEnabled(Object evaluationContext) {
71 4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	890 if (null !is cast(IHandler2)handler ) {
4878bef4a38e Some fixing Frank Benoit <benoit@tionex.de> parents: 70 diff changeset	891 (cast(IHandler2) handler).setEnabled(evaluationContext);
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	892 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	893 }
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	894
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	895 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	896 * Returns whether this command has a handler, and whether this handler is
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	897 * also handled.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	898 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	899 * @return <code>true</code> if the command is handled; <code>false</code>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	900 * otherwise.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	901 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	902 public final bool isHandled() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	903 if (handler is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	904 return false;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	905 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	906
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	907 return handler.isHandled();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	908 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	909
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	910 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	911 * Removes a listener from this command.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	912 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	913 * @param commandListener
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	914 * The listener to be removed; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	915 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	916 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	917 public final void removeCommandListener(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	918 ICommandListener commandListener) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	919 if (commandListener is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	920 throw new NullPointerException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	921 "Cannot remove a null command listener"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	922 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	923
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	924 removeListenerObject(cast(Object)commandListener);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	925 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	926
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	927 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	928 * Removes a listener from this command.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	929 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	930 * @param executionListener
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	931 * The listener to be removed; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	932 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	933 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	934 public final void removeExecutionListener(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	935 IExecutionListener executionListener) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	936 if (executionListener is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	937 throw new NullPointerException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	938 "Cannot remove a null execution listener"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	939 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	940
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	941 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	942 executionListeners.remove(cast(Object)executionListener);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	943 if (executionListeners.isEmpty()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	944 executionListeners = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	945 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	946 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	947 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	948
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	949 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	950 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	951 * Removes a state from this command. This will remove the state from the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	952 * active handler, if the active handler is an instance of
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	953 * {@link IObjectWithState}.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	954 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	955 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	956 * @param stateId
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	957 * The identifier of the state to remove; must not be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	958 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	959 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	960 */
43 ea8ff534f622 Fix override and super aliases Frank Benoit <benoit@tionex.de> parents: 39 diff changeset	961 public override void removeState(String stateId) {
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	962 if ( auto h = cast(IObjectWithState)handler ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	963 h.removeState(stateId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	964 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	965 super.removeState(stateId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	966 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	967
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	968 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	969 * Changes the handler for this command. This will remove all the state from
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	970 * the currently active handler (if any), and add it to <code>handler</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	971 * If debugging is turned on, then this will also print information about
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	972 * the change to <code>System.out</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	973 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	974 * @param handler
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	975 * The new handler; may be <code>null</code> if none.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	976 * @return <code>true</code> if the handler changed; <code>false</code>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	977 * otherwise.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	978 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	979 public final bool setHandler(IHandler handler) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	980 if (Util.equals(cast(Object)handler, cast(Object)this.handler)) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	981 return false;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	982 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	983
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	984 // Swap the state around.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	985 String[] stateIds = getStateIds();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	986 if (stateIds !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	987 for (int i = 0; i < stateIds.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	988 String stateId = stateIds[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	989 if ( auto h = cast(IObjectWithState)this.handler ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	990 h.removeState(stateId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	991 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	992 if ( auto h = cast(IObjectWithState)handler ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	993 State stateToAdd = getState(stateId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	994 h.addState(stateId, stateToAdd);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	995 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	996 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	997 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	998
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	999 bool enabled = isEnabled();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1000 if (this.handler !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1001 this.handler.removeHandlerListener(getHandlerListener());
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1002 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1003
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1004 // Update the handler, and flush the string representation.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1005 this.handler = handler;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1006 if (this.handler !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1007 this.handler.addHandlerListener(getHandlerListener());
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1008 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1009 string = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1010
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1011 // Debugging output
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1012 if ((DEBUG_HANDLERS)
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1013 && ((DEBUG_HANDLERS_COMMAND_ID is null) \|\| (DEBUG_HANDLERS_COMMAND_ID
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1014 .equals(id)))) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1015 StringBuffer buffer = new StringBuffer("Command('"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1016 buffer.append(id);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1017 buffer.append("') has changed to "); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1018 if (handler is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1019 buffer.append("no handler"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1020 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1021 buffer.append('\'');
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1022 buffer.append(( cast(Object)handler).toString);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1023 buffer.append("' as its handler"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1024 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1025 Tracing.printTrace("HANDLERS", buffer.toString()); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1026 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1027
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1028 // Send notification
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1029 fireCommandChanged(new CommandEvent(this, false, false, false, true,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1030 false, false, false, false, enabled !is isEnabled()));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1031
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1032 return true;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1033 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1034
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1035 /**
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 43 diff changeset	1036 * @return the handler listener
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1037 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1038 private IHandlerListener getHandlerListener() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1039 if (handlerListener is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1040 handlerListener = new class IHandlerListener {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1041 public void handlerChanged(HandlerEvent handlerEvent) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1042 bool enabledChanged = handlerEvent.isEnabledChanged();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1043 bool handledChanged = handlerEvent.isHandledChanged();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1044 fireCommandChanged(new CommandEvent(this.outer, false,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1045 false, false, handledChanged, false, false, false,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1046 false, enabledChanged));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1047 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1048 };
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1049 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1050 return handlerListener;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1051 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1052
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1053 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1054 * The string representation of this command -- for debugging purposes only.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1055 * This string should not be shown to an end user.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1056 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1057 * @return The string representation; never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1058 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1059 public override final String toString() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1060 if (string is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1061 String parms;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1062 foreach( p; parameters ){
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1063 parms ~= "{"~(cast(Object)p).toString~"}";
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1064 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1065 string = Format("Command({},{},\n\t\t{},\n\t\t{},\n\t\t{},\n\t\t{},{},{})",
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1066 id,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1067 name is null ? "":name,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1068 description is null?"":description,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1069 category is null?"":category.toString(),
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1070 handler is null?"": (cast(Object)handler).toString(),
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1071 parms,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1072 returnType is null?"":returnType.toString(),
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1073 defined
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1074 );
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1075 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1076 return string;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1077 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1078
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1079 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1080 * Makes this command become undefined. This has the side effect of changing
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1081 * the name and description to <code>null</code>. This also removes all
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1082 * state and disposes of it. Notification is sent to all listeners.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1083 */
43 ea8ff534f622 Fix override and super aliases Frank Benoit <benoit@tionex.de> parents: 39 diff changeset	1084 public override final void undefine() {
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1085 bool enabledChanged = isEnabled();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1086
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1087 string = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1088
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1089 bool definedChanged = defined;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1090 defined = false;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1091
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1092 bool nameChanged = name !is null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1093 name = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1094
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1095 bool descriptionChanged = description !is null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1096 description = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1097
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1098 bool categoryChanged = category !is null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1099 category = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1100
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1101 bool parametersChanged = parameters !is null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1102 parameters = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1103
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1104 bool returnTypeChanged = returnType !is null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1105 returnType = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1106
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1107 String[] stateIds = getStateIds();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1108 if (stateIds !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1109 if ( auto handlerWithState = cast(IObjectWithState)handler ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1110 for (int i = 0; i < stateIds.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1111 String stateId = stateIds[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1112 handlerWithState.removeState(stateId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1113
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1114 State state = getState(stateId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1115 removeState(stateId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1116 state.dispose();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1117 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1118 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1119 for (int i = 0; i < stateIds.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1120 String stateId = stateIds[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1121 State state = getState(stateId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1122 removeState(stateId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1123 state.dispose();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1124 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1125 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1126 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1127
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1128 fireCommandChanged(new CommandEvent(this, categoryChanged,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1129 definedChanged, descriptionChanged, false, nameChanged,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1130 parametersChanged, returnTypeChanged, false, enabledChanged));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1131 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1132 }

Mercurial > projects > dwt-addons

annotate dwtx/core/commands/Command.d @ 90:7ffeace6c47f