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

annotate dwtx/core/commands/CommandManager.d @ 200:eb3414669eb0 default tip

fix for dmd 1.041 and tango 0.99.8

author	Frank Benoit <benoit@tionex.de>
date	Sat, 28 Mar 2009 03:09:57 +0100
parents	04b47443bb01
children

rev	line source
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1 /*******************************************************************************
90 7ffeace6c47f Update 3.4M7 to 3.4 Frank Benoit <benoit@tionex.de> parents: 70 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.CommandManager;
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 dwtx.core.commands.common.HandleObjectManager;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	16 import dwtx.core.commands.common.NotDefinedException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	17 import dwtx.core.runtime.ListenerList;
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.ICategoryListener;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	20 import dwtx.core.commands.ICommandListener;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	21 import dwtx.core.commands.IExecutionListener;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	22 import dwtx.core.commands.IExecutionListenerWithChecks;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	23 import dwtx.core.commands.IParameterTypeListener;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	24 import dwtx.core.commands.ICommandManagerListener;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	25 import dwtx.core.commands.CommandEvent;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	26 import dwtx.core.commands.CommandManagerEvent;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	27 import dwtx.core.commands.Command;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	28 import dwtx.core.commands.Category;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	29 import dwtx.core.commands.CategoryEvent;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	30 import dwtx.core.commands.IHandler;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	31 import dwtx.core.commands.ParameterType;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	32 import dwtx.core.commands.IParameter;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	33 import dwtx.core.commands.Parameterization;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	34 import dwtx.core.commands.ParameterizedCommand;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	35 import dwtx.core.commands.ParameterTypeEvent;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	36 import dwtx.core.commands.SerializationException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	37
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	38 import dwtx.core.commands.NotEnabledException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	39 import dwtx.core.commands.NotHandledException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	40 import dwtx.core.commands.ExecutionException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	41 import dwtx.core.commands.ExecutionEvent;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	42
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	43 import dwt.dwthelper.utils;
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	44 import dwtx.dwtxhelper.Collection;
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	45 static import tango.text.Text;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	46 alias tango.text.Text.Text!(char) StringBuffer;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	47
40 da5ad8eedf5d debug prints, dwt.dwthelper restructure, ... Frank Benoit <benoit@tionex.de> parents: 3 diff changeset	48 import dwt.dwthelper.WeakHashMap;
da5ad8eedf5d debug prints, dwt.dwthelper restructure, ... Frank Benoit <benoit@tionex.de> parents: 3 diff changeset	49
3 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 central repository for commands -- both in the defined and undefined
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	53 * states. Commands can be created and retrieved using this manager. It is
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	54 * possible to listen to changes in the collection of commands by attaching a
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	55 * listener to the manager.
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 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	58 * @see CommandManager#getCommand(String)
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	59 * @since 3.1
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	60 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	61 public final class CommandManager : HandleObjectManager,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	62 ICategoryListener, ICommandListener, IParameterTypeListener {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	63
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	64 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	65 * A listener that forwards incoming execution events to execution listeners
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	66 * on this manager. The execution events will come from any command on this
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	67 * manager.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	68 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	69 * @since 3.1
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	70 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	71 private final class ExecutionListener :
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	72 IExecutionListenerWithChecks {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	73
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	74 public void notDefined(String commandId, NotDefinedException exception) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	75 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	76 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	77 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	78 Object object = listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	79 if ( auto listener = cast(IExecutionListenerWithChecks)object ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	80 listener.notDefined(commandId, exception);
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 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	84 }
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 void notEnabled(String commandId, NotEnabledException exception) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	87 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	88 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	89 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	90 Object object = listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	91 if ( auto listener = cast(IExecutionListenerWithChecks)object ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	92 listener.notEnabled(commandId, exception);
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 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	96 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	97
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	98 public final void notHandled(String commandId,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	99 NotHandledException exception) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	100 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	101 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	102 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	103 Object object = listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	104 if ( auto listener = cast(IExecutionListener)object ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	105 listener.notHandled(commandId, exception);
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 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	109 }
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 public final void postExecuteFailure(String commandId,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	112 ExecutionException exception) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	113 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	114 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	115 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	116 Object object = listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	117 if ( auto listener = cast(IExecutionListener)object ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	118 listener.postExecuteFailure(commandId, exception);
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 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	121 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	122 }
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 public final void postExecuteSuccess(String commandId,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	125 Object returnValue) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	126 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	127 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	128 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	129 Object object = listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	130 if ( auto listener = cast(IExecutionListener)object ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	131 listener.postExecuteSuccess(commandId, returnValue);
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 }
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	137 public final void preExecute(String commandId,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	138 ExecutionEvent event) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	139 if (executionListeners !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	140 Object[] listeners = executionListeners.getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	141 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	142 Object object = listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	143 if ( auto listener = cast(IExecutionListener)object ) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	144 listener.preExecute(commandId, event);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	145 }
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 }
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 }
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 * The identifier of the category in which all auto-generated commands will
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	153 * appear. This value must never be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	154 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	155 * @since 3.2
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 public static const String AUTOGENERATED_CATEGORY_ID = "dwtx.core.commands.categories.autogenerated"; //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	158
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	159 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	160 * The escape character to use for serialization and deserialization of
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	161 * parameterized commands.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	162 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	163 static const char ESCAPE_CHAR = '%';
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 * The character that separates a parameter id from its value.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	167 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	168 static const char ID_VALUE_CHAR = '=';
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	169
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	170 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	171 * The character that indicates the end of a list of parameters.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	172 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	173 static const char PARAMETER_END_CHAR = ')';
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	174
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 * The character that separators parameters from each other.
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 static const char PARAMETER_SEPARATOR_CHAR = ',';
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 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	181 * The character that indicates the start of a list of parameters.
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 static const char PARAMETER_START_CHAR = '(';
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	184
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	185 this(){
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	186 categoriesById = new HashMap();
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	187 definedCategoryIds = new HashSet();
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	188 definedParameterTypeIds = new HashSet();
40 da5ad8eedf5d debug prints, dwt.dwthelper restructure, ... Frank Benoit <benoit@tionex.de> parents: 3 diff changeset	189 helpContextIdsByHandler = new WeakHashMap();
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	190 parameterTypesById = new HashMap();
3 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 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	194 * Unescapes special characters in the command id, parameter ids and
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	195 * parameter values for {@link #deserialize(String)}. The special characters
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	196 * {@link #PARAMETER_START_CHAR}, {@link #PARAMETER_END_CHAR},
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	197 * {@link #ID_VALUE_CHAR}, {@link #PARAMETER_SEPARATOR_CHAR} and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	198 * {@link #ESCAPE_CHAR} are escaped by prepending an {@link #ESCAPE_CHAR}
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	199 * character.
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	200 * <p>
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	201 * See also ParameterizedCommand.escape(String)
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	202 * </p>
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	203 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	204 * @param escapedText
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	205 * a <code>String</code> that may contain escaped special
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	206 * characters for command serialization.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	207 * @return a <code>String</code> representing <code>escapedText</code>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	208 * with any escaped characters replaced by their literal values
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	209 * @throws SerializationException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	210 * if <code>escapedText</code> contains an invalid escape
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	211 * sequence
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	212 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	213 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	214 private static final String unescape(String escapedText) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	215
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	216 // defer initialization of a StringBuffer until we know we need one
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	217 StringBuffer buffer;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	218
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	219 for (int i = 0; i < escapedText.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	220
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	221 char c = escapedText.charAt(i);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	222 if (c !is ESCAPE_CHAR) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	223 // normal unescaped character
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	224 if (buffer !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	225 buffer.append(c);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	226 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	227 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	228 if (buffer is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	229 buffer = new StringBuffer(escapedText.substring(0, i));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	230 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	231
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	232 if (++i < escapedText.length) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	233 c = escapedText.charAt(i);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	234 switch (c) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	235 case PARAMETER_START_CHAR:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	236 case PARAMETER_END_CHAR:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	237 case ID_VALUE_CHAR:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	238 case PARAMETER_SEPARATOR_CHAR:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	239 case ESCAPE_CHAR:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	240 buffer.append(c);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	241 break;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	242 default:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	243 throw new SerializationException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	244 "Invalid character '" ~ c ~ "' in escape sequence"); //$NON-NLS-1$ //$NON-NLS-2$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	245 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	246 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	247 throw new SerializationException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	248 "Unexpected termination of escape sequence"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	249 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	250 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	251
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	254 if (buffer is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	255 return escapedText;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	256 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	257
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	258 return buffer.toString();
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 * The map of category identifiers (<code>String</code>) to categories (
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	263 * <code>Category</code>). This collection may be empty, but it is never
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	264 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	265 */
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	266 private const Map categoriesById;
3 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 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	269 * The set of identifiers for those categories that are defined. This value
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	270 * may be empty, but it is never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	271 */
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	272 private const Set definedCategoryIds;
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	273
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	274 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	275 * The set of identifiers for those command parameter types that are
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	276 * defined. This value may be empty, but it is never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	277 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	278 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	279 */
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	280 private const Set definedParameterTypeIds;
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	281
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	282 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	283 * The execution listener for this command manager. This just forwards
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	284 * events from commands controlled by this manager to listeners on this
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	285 * manager.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	286 */
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	287 private IExecutionListenerWithChecks executionListener = null;
3 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 * The collection of execution listeners. This collection is
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	291 * <code>null</code> if there are no listeners.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	292 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	293 private ListenerList executionListeners = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	294
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	295 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	296 * The help context identifiers ({@link String}) for a handler ({@link IHandler}).
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	297 * This map may be empty, but it is never <code>null</code>. Entries are
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	298 * removed if all strong references to the handler are removed.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	299 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	300 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	301 */
40 da5ad8eedf5d debug prints, dwt.dwthelper restructure, ... Frank Benoit <benoit@tionex.de> parents: 3 diff changeset	302 private const WeakHashMap helpContextIdsByHandler;
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	303
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	304 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	305 * The map of parameter type identifiers (<code>String</code>) to
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	306 * parameter types ( <code>ParameterType</code>). This collection may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	307 * empty, but it is never <code>null</code>.
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 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	310 */
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	311 private const Map parameterTypesById;
3 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 * Adds a listener to this command manager. The listener will be notified
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	315 * when the set of defined commands changes. This can be used to track the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	316 * global appearance and disappearance of commands.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	317 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	318 * @param listener
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	319 * The listener to attach; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	320 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	321 public final void addCommandManagerListener(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	322 ICommandManagerListener listener) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	323 addListenerObject(cast(Object)listener);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	324 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	325
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	326 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	327 * Adds an execution listener to this manager. This listener will be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	328 * notified if any of the commands controlled by this manager execute. This
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	329 * can be used to support macros and instrumentation of commands.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	330 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	331 * @param listener
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	332 * The listener to attach; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	333 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	334 public final void addExecutionListener(IExecutionListener listener) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	335 if (listener is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	336 throw new NullPointerException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	337 "Cannot add a null execution listener"); //$NON-NLS-1$
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	340 if (executionListeners is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	341 executionListeners = new ListenerList(ListenerList.IDENTITY);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	342
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	343 // Add an execution listener to every command.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	344 executionListener = new ExecutionListener();
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	345 Iterator commandItr = handleObjectsById.values().iterator();
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	346 while (commandItr.hasNext()) {
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	347 Command command = cast(Command) commandItr.next();
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	348 command.addExecutionListener(executionListener);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	349 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	350
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	351 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	352
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	353 executionListeners.add(cast(Object)listener);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	354 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	355
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	356 /*
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	357 * (non-Javadoc)
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	358 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	359 * @see dwtx.core.commands.ICategoryListener#categoryChanged(dwtx.core.commands.CategoryEvent)
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	360 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	361 public final void categoryChanged(CategoryEvent categoryEvent) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	362 if (categoryEvent.isDefinedChanged()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	363 Category category = categoryEvent.getCategory();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	364 String categoryId = category.getId();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	365 bool categoryIdAdded = category.isDefined();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	366 if (categoryIdAdded) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	367 definedCategoryIds.add(categoryId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	368 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	369 definedCategoryIds.remove(categoryId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	370 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	371 if (isListenerAttached()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	372 fireCommandManagerChanged(new CommandManagerEvent(this, null,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	373 false, false, categoryId, categoryIdAdded, true));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	374 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	375 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	376 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	377
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	378 /*
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	379 * (non-Javadoc)
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 * @see dwtx.commands.ICommandListener#commandChanged(dwtx.commands.CommandEvent)
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	382 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	383 public final void commandChanged(CommandEvent commandEvent) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	384 if (commandEvent.isDefinedChanged()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	385 Command command = commandEvent.getCommand();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	386 String commandId = command.getId();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	387 bool commandIdAdded = command.isDefined();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	388 if (commandIdAdded) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	389 definedHandleObjects.add(command);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	390 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	391 definedHandleObjects.remove(command);
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 if (isListenerAttached()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	394 fireCommandManagerChanged(new CommandManagerEvent(this,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	395 commandId, commandIdAdded, true, null, false, false));
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 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	398 }
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 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	401 * Sets the name and description of the category for uncategorized commands.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	402 * This is the category that will be returned if
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	403 * {@link #getCategory(String)} is called with <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	404 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	405 * @param name
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	406 * The name of the category for uncategorized commands; must not
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	407 * be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	408 * @param description
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	409 * The description of the category for uncategorized commands;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	410 * may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	411 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	412 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	413 public final void defineUncategorizedCategory(String name,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	414 String description) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	415 Category category = getCategory(AUTOGENERATED_CATEGORY_ID);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	416 category.define(name, description);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	417 }
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 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	420 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	421 * Returns a {@link ParameterizedCommand} with a command and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	422 * parameterizations as specified in the provided
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	423 * <code>serializedParameterizedCommand</code> string. The
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	424 * <code>serializedParameterizedCommand</code> must use the format
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	425 * returned by {@link ParameterizedCommand#serialize()} and described in the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	426 * Javadoc for that method.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	427 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	428 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	429 * If a parameter id encoded in the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	430 * <code>serializedParameterizedCommand</code> does not exist in the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	431 * encoded command, that parameter id and value are ignored. A given
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	432 * parameter id should not be used more than once in
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	433 * <code>serializedParameterizedCommand</code>. This will not result in
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	434 * an exception, but in this case the value of the parameter when the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	435 * command is executed is unspecified.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	436 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	437 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	438 * This method will never return <code>null</code>, however it may throw
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	439 * an exception if there is a problem processing the serialization string or
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	440 * the encoded command is undefined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	441 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	442 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	443 * @param serializedParameterizedCommand
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	444 * a string representing a command id and parameter ids and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	445 * values; must not be <code>null</code>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	446 * @return a {@link ParameterizedCommand} with the command and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	447 * parameterizations encoded in the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	448 * <code>serializedParameterizedCommand</code>; never
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	449 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	450 * @throws NotDefinedException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	451 * if the command indicated in
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	452 * <code>serializedParameterizedCommand</code> is not defined
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	453 * @throws SerializationException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	454 * if there is an error deserializing
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	455 * <code>serializedParameterizedCommand</code>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	456 * @see ParameterizedCommand#serialize()
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	457 * @since 3.2
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 public final ParameterizedCommand deserialize(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	460 String serializedParameterizedCommand) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	461
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	462 int lparenPosition = unescapedIndexOf(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	463 serializedParameterizedCommand, PARAMETER_START_CHAR);
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 String commandIdEscaped;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	466 String serializedParameters;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	467 if (lparenPosition is -1) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	468 commandIdEscaped = serializedParameterizedCommand;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	469 serializedParameters = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	470 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	471 commandIdEscaped = serializedParameterizedCommand.substring(0,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	472 lparenPosition);
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 if (serializedParameterizedCommand
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	475 .charAt(serializedParameterizedCommand.length - 1) !is PARAMETER_END_CHAR) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	476 throw new SerializationException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	477 "Parentheses must be balanced in serialized ParameterizedCommand"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	478 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	479
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	480 serializedParameters = serializedParameterizedCommand.substring(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	481 lparenPosition + 1, // skip PARAMETER_START_CHAR
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	482 serializedParameterizedCommand.length - 1); // skip
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	483 // PARAMETER_END_CHAR
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	484 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	485
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	486 String commandId = unescape(commandIdEscaped);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	487 Command command = getCommand(commandId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	488 IParameter[] parameters = command.getParameters();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	489 Parameterization[] parameterizations = getParameterizations(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	490 serializedParameters, parameters);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	491
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	492 return new ParameterizedCommand(command, parameterizations);
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	495 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	496 * Notifies all of the listeners to this manager that the set of defined
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	497 * command identifiers has changed.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	498 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	499 * @param event
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	500 * The event to send to all of the listeners; must not be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	501 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	502 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	503 private final void fireCommandManagerChanged(CommandManagerEvent event) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	504 if (event is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	505 throw new NullPointerException();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	506 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	507
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	508 Object[] listeners = getListeners();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	509 for (int i = 0; i < listeners.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	510 ICommandManagerListener listener = cast(ICommandManagerListener) listeners[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	511 listener.commandManagerChanged(event);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	512 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	513 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	514
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	515 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	516 * Returns all of the commands known by this manager -- defined and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	517 * undefined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	518 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	519 * @return All of the commands; may be empty, but never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	520 * @since 3.2
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 public final Command[] getAllCommands() {
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	523 return arraycast!(Command)( handleObjectsById.values().toArray());
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	524 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	525
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 * Gets the category with the given identifier. If no such category
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	528 * currently exists, then the category will be created (but be undefined).
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	529 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	530 * @param categoryId
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	531 * The identifier to find; must not be <code>null</code>. If
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	532 * the category is <code>null</code>, then a category suitable
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	533 * for uncategorized items is defined and returned.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	534 * @return The category with the given identifier; this value will never be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	535 * <code>null</code>, but it might be undefined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	536 * @see Category
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	537 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	538 public final Category getCategory(String categoryId) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	539 if (categoryId is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	540 return getCategory(AUTOGENERATED_CATEGORY_ID);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	541 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	542
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	543 checkId(categoryId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	544
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	545 Category category = cast(Category) categoriesById.get(categoryId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	546 if (category is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	547 category = new Category(categoryId);
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	548 categoriesById.put(categoryId, category);
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	549 category.addCategoryListener(this);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	550 }
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 return category;
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 * Gets the command with the given identifier. If no such command currently
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	557 * exists, then the command will be created (but will be undefined).
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	558 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	559 * @param commandId
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	560 * The identifier to find; must not be <code>null</code> and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	561 * must not be zero-length.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	562 * @return The command with the given identifier; this value will never be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	563 * <code>null</code>, but it might be undefined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	564 * @see Command
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	565 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	566 public final Command getCommand(String commandId) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	567 checkId(commandId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	568
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	569 Command command = cast(Command) handleObjectsById.get(commandId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	570 if (command is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	571 command = new Command(commandId);
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	572 handleObjectsById.put(commandId, command);
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	573 command.addCommandListener(this);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	574
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	575 if (executionListener !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	576 command.addExecutionListener(executionListener);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	577 }
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 return command;
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 * Returns the categories that are defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	585 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	586 * @return The defined categories; this value may be empty, but it is never
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	587 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	588 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	589 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	590 public final Category[] getDefinedCategories() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	591 Category[] categories = new Category[definedCategoryIds.size()];
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	592 Iterator categoryIdItr = definedCategoryIds.iterator();
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	593 int i = 0;
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	594 while (categoryIdItr.hasNext()) {
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	595 String categoryId = stringcast( categoryIdItr.next());
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	596 categories[i++] = getCategory(categoryId);
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 return categories;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	599 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	600
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	601 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	602 * Returns the set of identifiers for those category that are defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	603 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	604 * @return The set of defined category identifiers; this value may be empty,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	605 * but it is never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	606 */
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	607 public final Set getDefinedCategoryIds() {
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	608 return Collections.unmodifiableSet(definedCategoryIds);
3 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 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	612 * Returns the set of identifiers for those commands that are defined.
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 * @return The set of defined command identifiers; this value may be empty,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	615 * but it is never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	616 */
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	617 public final Set getDefinedCommandIds() {
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	618 return getDefinedHandleObjectIds();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	619 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	620
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	621 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	622 * Returns the commands that are defined.
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 * @return The defined commands; this value may be empty, but it is never
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	625 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	626 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	627 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	628 public final Command[] getDefinedCommands() {
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	629 return arraycast!(Command)( definedHandleObjects
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	630 .toArray());
3 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 * Returns the set of identifiers for those parameter types that are
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	635 * defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	636 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	637 * @return The set of defined command parameter type identifiers; this value
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	638 * may be empty, but it is never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	639 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	640 */
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	641 public final Set getDefinedParameterTypeIds() {
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	642 return Collections.unmodifiableSet(definedParameterTypeIds);
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	643 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	644
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	645 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	646 * Returns the command parameter types that are defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	647 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	648 * @return The defined command parameter types; this value may be empty, but
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	649 * it is never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	650 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	651 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	652 public final ParameterType[] getDefinedParameterTypes() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	653 ParameterType[] parameterTypes = new ParameterType[definedParameterTypeIds
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	654 .size()];
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	655 Iterator iterator = definedParameterTypeIds.iterator();
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	656 int i = 0;
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	657 while (iterator.hasNext()) {
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	658 String parameterTypeId = stringcast( iterator.next());
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	659 parameterTypes[i++] = getParameterType(parameterTypeId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	660 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	661 return parameterTypes;
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	664 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	665 * Gets the help context identifier for a particular command. The command's
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	666 * handler is first checked for a help context identifier. If the handler
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	667 * does not have a help context identifier, then the help context identifier
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	668 * for the command is returned. If neither has a help context identifier,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	669 * then <code>null</code> is returned.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	670 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	671 * @param command
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	672 * The command for which the help context should be retrieved;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	673 * must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	674 * @return The help context identifier to use for the given command; may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	675 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	676 * @throws NotDefinedException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	677 * If the given command is not defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	678 * @since 3.2
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 public final String getHelpContextId(Command command) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	681 // Check if the command is defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	682 if (!command.isDefined()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	683 throw new NotDefinedException("The command is not defined. " //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	684 ~ command.getId());
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	685 }
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 // Check the handler.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	688 IHandler handler = command.getHandler();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	689 if (handler !is null) {
40 da5ad8eedf5d debug prints, dwt.dwthelper restructure, ... Frank Benoit <benoit@tionex.de> parents: 3 diff changeset	690 String helpContextId = stringcast( helpContextIdsByHandler.get( cast(Object) handler) );
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	691 if (helpContextId !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	692 return helpContextId;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	693 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	694 }
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 // Simply return whatever the command has as a help context identifier.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	697 return command.getHelpContextId();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	698 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	699
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	700 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	701 * Returns an array of parameterizations for the provided command by
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	702 * deriving the parameter ids and values from the provided
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	703 * <code>serializedParameters</code> string.
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 * @param serializedParameters
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	706 * a String encoding parameter ids and values; must not be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	707 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	708 * @param parameters
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	709 * array of parameters of the command being deserialized; may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	710 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	711 * @return an array of parameterizations; may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	712 * @throws SerializationException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	713 * if there is an error deserializing the parameters
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	714 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	715 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	716 private final Parameterization[] getParameterizations(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	717 String serializedParameters, IParameter[] parameters) {
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 if (serializedParameters is null
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	720 \|\| (serializedParameters.length is 0)) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	721 return null;
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 if ((parameters is null) \|\| (parameters.length is 0)) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	725 return null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	726 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	727
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	728 ArrayList paramList = new ArrayList();
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	729
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	730 int commaPosition; // split off each param by looking for ','
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	731 do {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	732 commaPosition = unescapedIndexOf(serializedParameters, ',');
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 String idEqualsValue;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	735 if (commaPosition is -1) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	736 // no more parameters after this
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	737 idEqualsValue = serializedParameters;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	738 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	739 // take the first parameter...
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	740 idEqualsValue = serializedParameters
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	741 .substring(0, commaPosition);
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 // ... and put the rest back into serializedParameters
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	744 serializedParameters = serializedParameters
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	745 .substring(commaPosition + 1);
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	748 int equalsPosition = unescapedIndexOf(idEqualsValue, '=');
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 String parameterId;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	751 String parameterValue;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	752 if (equalsPosition is -1) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	753 // missing values are null
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	754 parameterId = unescape(idEqualsValue);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	755 parameterValue = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	756 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	757 parameterId = unescape(idEqualsValue.substring(0,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	758 equalsPosition));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	759 parameterValue = unescape(idEqualsValue
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	760 .substring(equalsPosition + 1));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	761 }
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 for (int i = 0; i < parameters.length; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	764 IParameter parameter = parameters[i];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	765 if (parameter.getId().equals(parameterId)) {
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	766 paramList.add(new Parameterization(parameter,
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	767 parameterValue));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	768 break;
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 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	771
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	772 } while (commaPosition !is -1);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	773
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	774 return arraycast!(Parameterization)( paramList
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	775 .toArray());
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	776 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	777
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 * Gets the command {@link ParameterType} with the given identifier. If no
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	780 * such command parameter type currently exists, then the command parameter
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	781 * type will be created (but will be undefined).
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 * @param parameterTypeId
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	784 * The identifier to find; must not be <code>null</code> and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	785 * must not be zero-length.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	786 * @return The {@link ParameterType} with the given identifier; this value
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	787 * will never be <code>null</code>, but it might be undefined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	788 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	789 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	790 public final ParameterType getParameterType(String parameterTypeId) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	791 checkId(parameterTypeId);
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 ParameterType parameterType = cast(ParameterType) parameterTypesById
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	794 .get(parameterTypeId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	795 if (parameterType is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	796 parameterType = new ParameterType(parameterTypeId);
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	797 parameterTypesById.put(parameterTypeId, parameterType);
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	798 parameterType.addListener(this);
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	801 return parameterType;
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 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	805 * {@inheritDoc}
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	806 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	807 * @since 3.2
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 public final void parameterTypeChanged(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	810 ParameterTypeEvent parameterTypeEvent) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	811 if (parameterTypeEvent.isDefinedChanged()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	812 ParameterType parameterType = parameterTypeEvent
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	813 .getParameterType();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	814 String parameterTypeId = parameterType.getId();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	815 bool parameterTypeIdAdded = parameterType.isDefined();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	816 if (parameterTypeIdAdded) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	817 definedParameterTypeIds.add(parameterTypeId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	818 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	819 definedParameterTypeIds.remove(parameterTypeId);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	820 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	821
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	822 fireCommandManagerChanged(new CommandManagerEvent(this,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	823 parameterTypeId, parameterTypeIdAdded, true));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	824 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	825 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	826
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	827 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	828 * Removes a listener from this command manager.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	829 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	830 * @param listener
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	831 * 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	832 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	833 public final void removeCommandManagerListener(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	834 ICommandManagerListener listener) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	835 removeListenerObject(cast(Object)listener);
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	838 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	839 * Removes an execution listener from this command manager.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	840 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	841 * @param listener
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	842 * 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	843 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	844 public final void removeExecutionListener(IExecutionListener listener) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	845 if (listener is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	846 throw new NullPointerException("Cannot remove a null listener"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	847 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	848
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	849 if (executionListeners is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	850 return;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	851 }
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 executionListeners.remove(cast(Object)listener);
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 if (executionListeners.isEmpty()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	856 executionListeners = null;
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 // Remove the execution listener to every command.
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	859 Iterator commandItr = handleObjectsById.values().iterator();
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	860 while (commandItr.hasNext()) {
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	861 Command command = cast(Command) commandItr.next();
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	862 command.removeExecutionListener(executionListener);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	863 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	864 executionListener = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	865
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	866 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	867 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	868
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	869 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	870 * Block updates all of the handlers for all of the commands. If the handler
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	871 * is <code>null</code> or the command id does not exist in the map, then
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	872 * the command becomes unhandled. Otherwise, the handler is set to the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	873 * corresponding value in the map.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	874 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	875 * @param handlersByCommandId
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	876 * A map of command identifiers (<code>String</code>) to
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	877 * handlers (<code>IHandler</code>). This map may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	878 * <code>null</code> if all handlers should be cleared.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	879 * Similarly, if the map is empty, then all commands will become
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	880 * unhandled.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	881 */
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	882 public final void setHandlersByCommandId(Map handlersByCommandId) {
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	883 // Make that all the reference commands are created.
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	884 Iterator commandIdItr = handlersByCommandId.keySet().iterator();
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	885 while (commandIdItr.hasNext()) {
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	886 getCommand(stringcast(commandIdItr.next()));
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	887 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	888
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	889 // Now, set-up the handlers on all of the existing commands.
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	890 Iterator commandItr = handleObjectsById.values().iterator();
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	891 while (commandItr.hasNext()) {
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	892 Command command = cast(Command) commandItr.next();
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	893 String commandId = command.getId();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	894 Object value = handlersByCommandId.get(commandId);
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	895 if ( cast(IHandler)value ) {
04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	896 command.setHandler(cast(IHandler) value);
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	897 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	898 command.setHandler(null);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	899 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	900 }
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	903 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	904 * Sets the help context identifier to associate with a particular handler.
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 * @param handler
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	907 * The handler with which to register a help context identifier;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	908 * must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	909 * @param helpContextId
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	910 * The help context identifier to register; may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	911 * <code>null</code> if the help context identifier should be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	912 * removed.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	913 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	914 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	915 public final void setHelpContextId(IHandler handler,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	916 String helpContextId) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	917 if (handler is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	918 throw new NullPointerException("The handler cannot be null"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	919 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	920 if (helpContextId is null) {
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	921 helpContextIdsByHandler.remove(cast(Object) handler);
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	922 } else {
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	923 helpContextIdsByHandler.put(cast(Object) handler, stringcast(helpContextId));
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	924 }
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 * Searches for the index of a <code>char</code> in a <code>String</code>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	929 * but disregards characters prefixed with the {@link #ESCAPE_CHAR} escape
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	930 * character. This is used by {@link #deserialize(String)} and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	931 * {@link #getParameterizations(String, IParameter[])} to parse the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	932 * serialized parameterized command string.
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 * @param escapedText
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	935 * the string to search for the index of <code>ch</code> in
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	936 * @param ch
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	937 * a character to search for in <code>escapedText</code>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	938 * @return the index of the first unescaped occurrence of the character in
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	939 * <code>escapedText</code>, or <code>-1</code> if the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	940 * character does not occur unescaped.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	941 * @see String#indexOf(int)
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	942 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	943 private final int unescapedIndexOf(String escapedText, char ch) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	944
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	945 int pos = escapedText.indexOf(ch);
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 // first char can't be escaped
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	948 if (pos is 0) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	949 return pos;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	950 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	951
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	952 while (pos !is -1) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	953 // look back for the escape character
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	954 if (escapedText.charAt(pos - 1) !is ESCAPE_CHAR) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	955 return pos;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	956 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	957
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	958 // scan for the next instance of ch
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	959 pos = escapedText.indexOf(ch, pos + 1);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	960 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	961
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	962 return pos;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	963
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	964 }
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	965 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	966 * Fires the <code>notEnabled</code> event for
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	967 * <code>executionListeners</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	968 * <p>
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	969 * <b>Note:</b> This supports bridging actions to the command framework,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	970 * and should not be used outside the framework.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	971 * </p>
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	972 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	973 * @param commandId
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	974 * The command id of the command about to execute, never
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	975 * <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	976 * @param exception
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	977 * The exception, never <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	978 * @since 3.4
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	979 */
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	980 public void fireNotEnabled(String commandId, NotEnabledException exception) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	981 if (executionListener !is null) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	982 executionListener.notEnabled(commandId, exception);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	983 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	984 }
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	985
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	986 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	987 * Fires the <code>notDefined</code> event for
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	988 * <code>executionListeners</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	989 * <p>
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	990 * <b>Note:</b> This supports bridging actions to the command framework,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	991 * and should not be used outside the framework.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	992 * </p>
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	993 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	994 * @param commandId
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	995 * The command id of the command about to execute, never
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	996 * <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	997 * @param exception
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	998 * The exception, never <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	999 * @since 3.4
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1000 */
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1001 public void fireNotDefined(String commandId, NotDefinedException exception) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1002 if (executionListener !is null) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1003 executionListener.notDefined(commandId, exception);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1004 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1005 }
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	1006
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1007 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1008 * Fires the <code>preExecute</code> event for
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1009 * <code>executionListeners</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1010 * <p>
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1011 * <b>Note:</b> This supports bridging actions to the command framework,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1012 * and should not be used outside the framework.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1013 * </p>
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	1014 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1015 * @param commandId
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1016 * The command id of the command about to execute, never
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1017 * <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1018 * @param event
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1019 * The event that triggered the command, may be <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1020 * @since 3.4
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1021 */
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1022 public void firePreExecute(String commandId, ExecutionEvent event) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1023 if (executionListener !is null) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1024 executionListener.preExecute(commandId, event);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1025 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1026 }
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	1027
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1028 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1029 * Fires the <code>postExecuteSuccess</code> event for
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1030 * <code>executionListeners</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1031 * <p>
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1032 * <b>Note:</b> This supports bridging actions to the command framework,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1033 * and should not be used outside the framework.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1034 * </p>
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	1035 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1036 * @param commandId
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1037 * The command id of the command executed, never
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1038 * <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1039 * @param returnValue
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1040 * The value returned from the command, may be <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1041 * @since 3.4
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1042 */
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1043 public void firePostExecuteSuccess(String commandId, Object returnValue) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1044 if (executionListener !is null) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1045 executionListener.postExecuteSuccess(commandId, returnValue);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1046 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1047 }
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	1048
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1049 /**
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1050 * Fires the <code>postExecuteFailure</code> event for
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1051 * <code>executionListeners</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1052 * <p>
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1053 * <b>Note:</b> This supports bridging actions to the command framework,
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1054 * and should not be used outside the framework.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1055 * </p>
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	1056 *
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1057 * @param commandId
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1058 * The command id of the command executed, never
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1059 * <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1060 * @param exception
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1061 * The exception, never <code>null</code>.
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1062 * @since 3.4
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1063 */
104 04b47443bb01 Reworked the collection uses to make use of a wrapper collection that is compatible to the Java Collections. Frank Benoit <benoit@tionex.de> parents: 90 diff changeset	1064 public void firePostExecuteFailure(String commandId,
70 46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1065 ExecutionException exception) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1066 if (executionListener !is null) {
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1067 executionListener.postExecuteFailure(commandId, exception);
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1068 }
46a6e0e6ccd4 Merge with d-fied sources of 3.4M7 Frank Benoit <benoit@tionex.de> parents: 40 diff changeset	1069 }
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1070 }

Mercurial > projects > dwt-addons

annotate dwtx/core/commands/CommandManager.d @ 200:eb3414669eb0 default tip