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

author	Frank Benoit <benoit@tionex.de>
date	Wed, 26 Mar 2008 00:57:19 +0100
parents
children	ea8ff534f622

rev	line source
3 6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	1 /*******************************************************************************
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	2 * Copyright (c) 2005, 2007 IBM Corporation and others.
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	14 module dwtx.core.commands.ParameterizedCommand;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	15
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	16 // import java.util.ArrayList;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	17 // import java.util.Collection;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	18 // import java.util.Collections;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	19 // import java.util.HashMap;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	20 // import java.util.Iterator;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	21 // import java.util.List;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	22 // import java.util.Map;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	23
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	24 import tango.util.collection.model.Seq;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	25 import tango.util.collection.model.Map;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	26 import tango.util.collection.model.Set;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	27 import tango.util.collection.ArraySeq;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	28 import tango.util.collection.HashSet;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	29 import tango.util.collection.HashMap;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	30
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	31 import dwtx.core.commands.Command;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	32 import dwtx.core.commands.CommandManager;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	33 import dwtx.core.commands.IParameter;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	34 import dwtx.core.commands.IParameterValues;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	35 import dwtx.core.commands.Parameterization;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	36 import dwtx.core.commands.ParameterValuesException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	37 import dwtx.core.commands.ExecutionEvent;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	38 import dwtx.core.commands.common.NotDefinedException;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	39 import dwtx.core.internal.commands.util.Util;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	40
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	41 import dwt.dwthelper.utils;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	42 import tango.text.convert.Format;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	43
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	44 static import tango.text.Text;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	45 alias tango.text.Text.Text!(char) StringBuffer;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	46
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	47 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	48 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	49 * A command that has had one or more of its parameters specified. This class
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	50 * serves as a utility class for developers that need to manipulate commands
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	51 * with parameters. It handles the behaviour of generating a parameter map and a
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	52 * human-readable name.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	53 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	54 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	55 * @since 3.1
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	56 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	57 public final class ParameterizedCommand : Comparable {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	58 private static const Map!(String,String) EMPTY_MAP;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	59 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	60 * The constant integer hash code value meaning the hash code has not yet
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	61 * been computed.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	62 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	63 private static const int HASH_CODE_NOT_COMPUTED = -1;
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 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	66 * A factor for computing the hash code for all parameterized commands.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	67 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	68 private static const int HASH_FACTOR = 89;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	69
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 * The seed for the hash code for all parameterized commands.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	72 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	73 private static const int HASH_INITIAL;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	74
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	75 static this(){
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	76 HASH_INITIAL = dwt.dwthelper.utils.toHash(ParameterizedCommand.classinfo.name );
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	77 EMPTY_MAP = new HashMap!(String,String);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	78 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	79 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	80 * The index of the parameter id in the parameter values.
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 * @deprecated no longer used
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 public static const int INDEX_PARAMETER_ID = 0;
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 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	87 * The index of the human-readable name of the parameter itself, in the
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	88 * parameter values.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	89 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	90 * @deprecated no longer used
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	91 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	92 public static const int INDEX_PARAMETER_NAME = 1;
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 * The index of the human-readable name of the value of the parameter for
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	96 * this command.
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 * @deprecated no longer used
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	99 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	100 public static const int INDEX_PARAMETER_VALUE_NAME = 2;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	101
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	102 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	103 * The index of the value of the parameter that the command can understand.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	104 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	105 * @deprecated no longer used
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 public static const int INDEX_PARAMETER_VALUE_VALUE = 3;
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 * Escapes special characters in the command id, parameter ids and parameter
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	111 * values for {@link #serialize()}. The special characters
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	112 * {@link CommandManager#PARAMETER_START_CHAR},
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	113 * {@link CommandManager#PARAMETER_END_CHAR},
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	114 * {@link CommandManager#ID_VALUE_CHAR},
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	115 * {@link CommandManager#PARAMETER_SEPARATOR_CHAR} and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	116 * {@link CommandManager#ESCAPE_CHAR} are escaped by prepending a
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	117 * {@link CommandManager#ESCAPE_CHAR} character.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	118 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	119 * @param rawText
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	120 * a <code>String</code> to escape special characters in for
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	121 * serialization.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	122 * @return a <code>String</code> representing <code>rawText</code> with
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	123 * special serialization characters escaped
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	124 * @see CommandManager#unescape(String)
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	125 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	126 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	127 private static final String escape(String rawText) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	128
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	129 // 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	130 StringBuffer buffer;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	131
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	132 for (int i = 0; i < rawText.length; i++) {
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 char c = rawText.charAt(i);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	135 switch (c) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	136 case CommandManager.PARAMETER_START_CHAR:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	137 case CommandManager.PARAMETER_END_CHAR:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	138 case CommandManager.ID_VALUE_CHAR:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	139 case CommandManager.PARAMETER_SEPARATOR_CHAR:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	140 case CommandManager.ESCAPE_CHAR:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	141 if (buffer is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	142 buffer = new StringBuffer(rawText.substring(0, i));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	143 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	144 buffer.append(CommandManager.ESCAPE_CHAR);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	145 buffer.append(c);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	146 break;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	147 default:
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	148 if (buffer !is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	149 buffer.append(c);
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 break;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	152 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	153
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	156 if (buffer is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	157 return rawText;
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 return buffer.toString();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	160 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	161
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 * Generates every possible combination of parameter values for the given
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	164 * parameters. Parameters values that cannot be initialized are just
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	165 * ignored. Optional parameters are considered.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	166 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	167 * @param startIndex
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	168 * The index in the <code>parameters</code> that we should
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	169 * process. This must be a valid index.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	170 * @param parameters
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	171 * The parameters in to process; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	172 * @return A collection (<code>Collection</code>) of combinations (<code>List</code>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	173 * of <code>Parameterization</code>).
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 private static final Seq!(Object) expandParameters(int startIndex,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	176 IParameter[] parameters) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	177 int nextIndex = startIndex + 1;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	178 bool noMoreParameters = (nextIndex >= parameters.length);
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 IParameter parameter = parameters[startIndex];
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	181 auto parameterizations = new ArraySeq!(Object);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	182 if (parameter.isOptional()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	183 parameterizations.append( cast(Object) null);
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	186 IParameterValues values = null;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	187 try {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	188 values = parameter.getValues();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	189 } catch (ParameterValuesException e) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	190 if (noMoreParameters) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	191 return parameterizations;
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 // Make recursive call
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	195 return expandParameters(nextIndex, parameters);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	196 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	197
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	198 // Iterator parameterValueItr = parameterValues.entrySet()
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	199 // .iterator();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	200 auto parameterValues = values.getParameterValues();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	201 auto set = new HashSet!(String);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	202 foreach( k,v; parameterValues ){
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	203 set.add( v );
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	204 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	205
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	206
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	207 //while (parameterValueItr.hasNext()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	208 foreach( v; set ){
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	209 //Map.Entry entry = (Map.Entry) parameterValueItr.next();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	210 Parameterization parameterization = new Parameterization(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	211 parameter, v);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	212 parameterizations.append(parameterization);
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	215 // Check if another iteration will produce any more names.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	216 int parameterizationCount = parameterizations.size();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	217 if (noMoreParameters) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	218 // This is it, so just return the current parameterizations.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	219 for (int i = 0; i < parameterizationCount; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	220 Parameterization parameterization = cast(Parameterization) parameterizations
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	221 .get(i);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	222 auto combination = new ArraySeq!(Object);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	223 combination.append(parameterization);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	224 parameterizations.replaceAt(i, combination);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	225 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	226 return parameterizations;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	227 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	228
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	229 // Make recursive call
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	230 auto suffixes = expandParameters(nextIndex, parameters);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	231 suffixes.removeAll(cast(Object)null);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	232 if (suffixes.drained()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	233 // This is it, so just return the current parameterizations.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	234 for (int i = 0; i < parameterizationCount; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	235 Parameterization parameterization = cast(Parameterization) parameterizations
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	236 .get(i);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	237 auto combination = new ArraySeq!(Object);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	238 combination.append(parameterization);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	239 parameterizations.replaceAt(i, combination);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	240 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	241 return parameterizations;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	242 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	243 auto returnValue = new ArraySeq!(Object);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	244 // Iterator suffixItr = suffixes.iterator();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	245 // while (suffixItr.hasNext()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	246 foreach( v; suffixes ){
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	247 // final List combination = (List) suffixItr.next();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	248 auto combination = cast(Seq!(Object)) v;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	249 int combinationSize = combination.size();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	250 for (int i = 0; i < parameterizationCount; i++) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	251 Parameterization parameterization = cast(Parameterization) parameterizations
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	252 .get(i);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	253 auto newCombination = new ArraySeq!(Object);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	254 newCombination.capacity(combinationSize + 1);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	255 newCombination.append(parameterization);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	256 foreach( c; combination ){
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	257 newCombination.append(c);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	258 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	259 returnValue.append(newCombination);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	260 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	261 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	262
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	263 return returnValue;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	264 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	265
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	266 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	267 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	268 * Generates all the possible combinations of command parameterizations for
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	269 * the given command. If the command has no parameters, then this is simply
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	270 * a parameterized version of that command. If a parameter is optional, both
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	271 * the included and not included cases are considered.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	272 * </p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	273 * <p>
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	274 * If one of the parameters cannot be loaded due to a
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	275 * <code>ParameterValuesException</code>, then it is simply ignored.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	276 * </p>
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 * @param command
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	279 * The command for which the parameter combinations should be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	280 * generated; must not be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	281 * @return A collection of <code>ParameterizedCommand</code> instances
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	282 * representing all of the possible combinations. This value is
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	283 * never empty and it is never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	284 * @throws NotDefinedException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	285 * If the command is not defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	286 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	287 public static final Seq!(Object) generateCombinations(Command command) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	288 IParameter[] parameters = command.getParameters();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	289 if (parameters is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	290 auto res = new ArraySeq!(Object);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	291 res.append( new ParameterizedCommand(command, null) );
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	292 return res;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	293 }
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 auto expansion = expandParameters(0, parameters);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	296 auto combinations = new ArraySeq!(Object);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	297 combinations.capacity(expansion.size());
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	298 foreach( v; expansion ){
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	299 // Iterator expansionItr = expansion.iterator();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	300 // while (expansionItr.hasNext()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	301 auto combination = cast(Seq!(Object)) v;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	302 if (combination is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	303 combinations.append(new ParameterizedCommand(command, null));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	304 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	305 combination.removeAll(cast(Object)null);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	306 if (combination.drained()) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	307 combinations.append(new ParameterizedCommand(command, null));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	308 } else {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	309 Parameterization[] parameterizations = cast(Parameterization[]) combination
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	310 .toArray();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	311 combinations.append(new ParameterizedCommand(command,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	312 parameterizations));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	313 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	314 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	315 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	316
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	317 return combinations;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	318 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	319
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 * The base command which is being parameterized. This value is never
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	322 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	323 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	324 private const Command command;
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 * The hash code for this object. This value is computed lazily, and marked
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	328 * as invalid when one of the values on which it is based changes.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	329 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	330 private /+transient+/ int hashCode = HASH_CODE_NOT_COMPUTED;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	331
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	332 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	333 * This is an array of parameterization defined for this command. This value
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	334 * may be <code>null</code> if the command has no parameters.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	335 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	336 private const Parameterization[] parameterizations;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	337
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	338 private String name;
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 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	341 * Constructs a new instance of <code>ParameterizedCommand</code> with
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	342 * specific values for zero or more of its parameters.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	343 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	344 * @param command
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	345 * The command that is parameterized; must not be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	346 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	347 * @param parameterizations
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	348 * An array of parameterizations binding parameters to values for
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	349 * the command. This value may be <code>null</code>. This
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	350 * argument is not copied; if you need to make changes to it
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	351 * after constructing this parameterized command, then make a
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	352 * copy yourself.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	353 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	354 public this(Command command,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	355 Parameterization[] parameterizations) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	356 if (command is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	357 throw new NullPointerException(
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	358 "A parameterized command cannot have a null command"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	359 }
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 this.command = command;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	362 this.parameterizations = (parameterizations is null \|\| parameterizations.length is 0) ? null
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	363 : parameterizations;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	364 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	365
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	366 /*
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	367 * (non-Javadoc)
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	368 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	369 * @see java.lang.Comparable#compareTo(java.lang.Object)
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 public final int compareTo(Object object) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	372 ParameterizedCommand command = cast(ParameterizedCommand) object;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	373 bool thisDefined = this.command.isDefined();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	374 bool otherDefined = command.command.isDefined();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	375 if (!thisDefined \|\| !otherDefined) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	376 return Util.compare(thisDefined, otherDefined);
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 try {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	380 int compareTo = getName() < command.getName();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	381 if (compareTo is 0) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	382 return getId() < command.getId();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	383 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	384 return compareTo;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	385 } catch (NotDefinedException e) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	386 throw new Exception (
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	387 "Concurrent modification of a command's defined state"); //$NON-NLS-1$
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	388 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	389 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	390
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	391 /*
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	392 * (non-Javadoc)
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	393 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	394 * @see java.lang.Object#equals(java.lang.Object)
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	395 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	396 public final bool equals(Object object) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	397 if (this is object) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	398 return true;
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 if (!(cast(ParameterizedCommand)object)) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	402 return false;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	403 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	404
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	405 ParameterizedCommand command = cast(ParameterizedCommand) object;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	406 if (!Util.equals(this.command, command.command)) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	407 return false;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	408 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	409
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	410 return Util.equals(this.parameterizations, command.parameterizations);
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	411 }
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 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	414 * Executes this command with its parameters. This method will succeed
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	415 * regardless of whether the command is enabled or defined. It is
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	416 * preferrable to use {@link #executeWithChecks(Object, Object)}.
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 * @param trigger
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	419 * The object that triggered the execution; may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	420 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	421 * @param applicationContext
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	422 * The state of the application at the time the execution was
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	423 * triggered; may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	424 * @return The result of the execution; may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	425 * @throws ExecutionException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	426 * If the handler has problems executing this command.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	427 * @throws NotHandledException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	428 * If there is no handler.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	429 * @deprecated Please use {@link #executeWithChecks(Object, Object)}
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	430 * instead.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	431 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	432 public final Object execute(Object trigger,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	433 Object applicationContext) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	434 return command.execute(new ExecutionEvent(command, getParameterMap(),
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	435 trigger, applicationContext));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	436 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	437
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	438 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	439 * Executes this command with its parameters. This does extra checking to
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	440 * see if the command is enabled and defined. If it is not both enabled and
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	441 * defined, then the execution listeners will be notified and an exception
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	442 * thrown.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	443 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	444 * @param trigger
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	445 * The object that triggered the execution; may be
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	446 * <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	447 * @param applicationContext
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	448 * The state of the application at the time the execution was
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	449 * triggered; may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	450 * @return The result of the execution; may be <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	451 * @throws ExecutionException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	452 * If the handler has problems executing this command.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	453 * @throws NotDefinedException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	454 * If the command you are trying to execute is not defined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	455 * @throws NotEnabledException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	456 * If the command you are trying to execute is not enabled.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	457 * @throws NotHandledException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	458 * If there is no handler.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	459 * @since 3.2
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	460 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	461 public final Object executeWithChecks(Object trigger,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	462 Object applicationContext) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	463 return command.executeWithChecks(new ExecutionEvent(command,
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	464 getParameterMap(), trigger, applicationContext));
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	465 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	466
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	467 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	468 * Returns the base command. It is possible for more than one parameterized
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	469 * command to have the same identifier.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	470 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	471 * @return The command; never <code>null</code>, but may be undefined.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	472 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	473 public final Command getCommand() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	474 return command;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	475 }
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	476
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	477 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	478 * Returns the command's base identifier. It is possible for more than one
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	479 * parameterized command to have the same identifier.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	480 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	481 * @return The command id; never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	482 */
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	483 public final String getId() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	484 return command.getId();
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
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	487 /**
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	488 * Returns a human-readable representation of this command with all of its
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	489 * parameterizations.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	490 *
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	491 * @return The human-readable representation of this parameterized command;
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	492 * never <code>null</code>.
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	493 * @throws NotDefinedException
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	494 * If the underlying command is not defined.
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 public final String getName() {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	497 if (name is null) {
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	498 StringBuffer nameBuffer = new StringBuffer();
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	499 nameBuffer.append(command.getName());
6518c18a01f7 eclipse.core package without osgi dependencies Frank Benoit <benoit@tionex.de> parents: diff changeset	500 if (parameterizations !is null) {

3

6518c18a01f7 eclipse.core package without osgi dependencies