Created a separated 'externaltools' plugin
[phpeclipse.git] / net.sourceforge.phpeclipse / src / net / sourceforge / phpdt / externaltools / internal / registry / ExternalToolMigration.java
diff --git a/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/externaltools/internal/registry/ExternalToolMigration.java b/net.sourceforge.phpeclipse/src/net/sourceforge/phpdt/externaltools/internal/registry/ExternalToolMigration.java
deleted file mode 100644 (file)
index 9205e17..0000000
+++ /dev/null
@@ -1,363 +0,0 @@
-package net.sourceforge.phpdt.externaltools.internal.registry;
-
-/**********************************************************************
-Copyright (c) 2002 IBM Corp. and others. All rights reserved.
-This file is made available under the terms of the Common Public License v1.0
-which accompanies this distribution, and is available at
-http://www.eclipse.org/legal/cpl-v10.html
-Contributors:
-**********************************************************************/
-
-import java.io.File;
-import java.io.FileInputStream;
-import java.io.FileNotFoundException;
-import java.io.IOException;
-import java.io.InputStreamReader;
-import java.util.ArrayList;
-import java.util.HashMap;
-import java.util.Map;
-import java.util.StringTokenizer;
-
-import net.sourceforge.phpdt.externaltools.internal.model.ExternalToolsPlugin;
-import net.sourceforge.phpdt.externaltools.model.IExternalToolConstants;
-import net.sourceforge.phpdt.externaltools.model.ToolUtil;
-import net.sourceforge.phpeclipse.PHPeclipsePlugin;
-
-import org.eclipse.core.runtime.CoreException;
-import org.eclipse.core.runtime.IPath;
-import org.eclipse.debug.core.DebugPlugin;
-import org.eclipse.debug.core.ILaunchConfigurationType;
-import org.eclipse.debug.core.ILaunchConfigurationWorkingCopy;
-import org.eclipse.debug.core.ILaunchManager;
-import org.eclipse.ui.IMemento;
-import org.eclipse.ui.WorkbenchException;
-import org.eclipse.ui.XMLMemento;
-
-/**
- * Responsible reading an old external tool format and creating
- * and migrating it to create a new external tool.
- */
-public final class ExternalToolMigration {
-       private static final String SEPERATOR = ";"; //$NON-NLS-1$      
-       private static final String STATE_FILE_NAME_OLD = "oldexternaltools.xml"; //$NON-NLS-1$
-       private static final String STATE_FILE_NAME = "externaltools.xml"; //$NON-NLS-1$
-       private static final String TAG_EXTERNALTOOLS = "externaltools"; //$NON-NLS-1$
-       private static final String TAG_TOOL = "tool"; //$NON-NLS-1$
-       private static final String TAG_ENTRY = "entry"; //$NON-NLS-1$
-       //private static final String TAG_KEY = "key"; //$NON-NLS-1$
-       private static final String TAG_VALUE = "value"; //$NON-NLS-1$
-
-       /*
-        * Ant tags
-        */
-       //public static final String RUN_TARGETS_ATTRIBUTE = IExternalToolConstants.TOOL_TYPE_ANT_BUILD + ".runTargets"; //$NON-NLS-1$;
-
-       /*
-        * 2.0 External Tool Tags
-        */
-       private static final String TAG_TOOL_TYPE = "!{tool_type}"; //$NON-NLS-1$
-       private static final String TAG_TOOL_NAME = "!{tool_name}"; //$NON-NLS-1$
-       private static final String TAG_TOOL_LOCATION = "!{tool_loc}"; //$NON-NLS-1$
-       private static final String TAG_TOOL_ARGUMENTS = "!{tool_args}"; //$NON-NLS-1$
-       private static final String TAG_TOOL_DIRECTORY = "!{tool_dir}"; //$NON-NLS-1$
-       private static final String TAG_TOOL_REFRESH = "!{tool_refresh}"; //$NON-NLS-1$
-       private static final String TAG_TOOL_SHOW_LOG = "!{tool_show_log}"; //$NON-NLS-1$
-       private static final String TAG_TOOL_BUILD_TYPES = "!{tool_build_types}"; //$NON-NLS-1$
-       private static final String TAG_TOOL_BLOCK = "!{tool_block}"; //$NON-NLS-1$
-
-       // Known kind of tools
-       private static final String TOOL_TYPE_PROGRAM = "net.sourceforge.phpdt.externaltools.type.program"; //$NON-NLS-1$
-       //private static final String TOOL_TYPE_ANT = "org.eclipse.ui.externaltools.type.ant"; //$NON-NLS-1$
-
-       /*
-        * 2.1 External Tool Keys
-        */
-       private static final String TAG_EXTERNAL_TOOL = "externalTool"; //$NON-NLS-1$
-       private static final String TAG_TYPE = "type"; //$NON-NLS-1$
-       private static final String TAG_NAME = "name"; //$NON-NLS-1$
-       private static final String TAG_LOCATION = "location"; //$NON-NLS-1$
-       private static final String TAG_WORK_DIR = "workDirectory"; //$NON-NLS-1$
-       private static final String TAG_CAPTURE_OUTPUT = "captureOutput"; //$NON-NLS-1$
-       private static final String TAG_SHOW_CONSOLE = "showConsole"; //$NON-NLS-1$
-       private static final String TAG_RUN_BKGRND = "runInBackground"; //$NON-NLS-1$
-       private static final String TAG_OPEN_PERSP = "openPerspective"; //$NON-NLS-1$
-       private static final String TAG_PROMPT_ARGS = "promptForArguments"; //$NON-NLS-1$
-       private static final String TAG_SHOW_MENU = "showInMenu"; //$NON-NLS-1$
-       private static final String TAG_SAVE_DIRTY = "saveDirtyEditors"; //$NON-NLS-1$
-       private static final String TAG_ARGS = "arguments"; //$NON-NLS-1$
-       private static final String TAG_REFRESH_SCOPE = "refreshScope"; //$NON-NLS-1$
-       private static final String TAG_REFRESH_RECURSIVE = "refreshRecursive"; //$NON-NLS-1$
-       private static final String TAG_RUN_BUILD_KINDS = "runForBuildKinds"; //$NON-NLS-1$
-       private static final String TAG_EXTRA_ATTR = "extraAttribute"; //$NON-NLS-1$
-       private static final String TAG_KEY = "key"; //$NON-NLS-1$
-       private static final String TAG_VERSION = "version"; //$NON-NLS-1$
-
-       private static final String BUILD_TYPE_SEPARATOR = ","; //$NON-NLS-1$
-       private static final String EXTRA_ATTR_SEPARATOR = "="; //$NON-NLS-1$
-
-       private static final String VERSION_21 = "2.1"; //$NON-NLS-1$;
-
-       private static final String TRUE = "true"; //$NON-NLS-1$
-       private static final String FALSE = "false"; //$NON-NLS-1$
-
-       /**
-        * Allows no instances.
-        */
-       private ExternalToolMigration() {
-               super();
-       }
-
-       /**
-        * Loads the external tools from storage and
-        * adds them to the registry.
-        */
-       /*package*/
-       // This method is not called. It is left here in case 
-       // we decide to do tool migration in the future
-       private static void readInOldTools() {
-               readIn20Tools();
-               readIn21Tools();
-       }
-
-       private static void readIn21Tools() {
-       }
-
-       public static void readIn20Tools() {
-               boolean migrationSuccessful = true;
-               IPath path = PHPeclipsePlugin.getDefault().getStateLocation();
-               File file = path.append(STATE_FILE_NAME).toFile();
-               if (!file.exists())
-                       return;
-
-               InputStreamReader reader = null;
-               try {
-                       FileInputStream input = new FileInputStream(file);
-                       reader = new InputStreamReader(input, "utf-8"); //$NON-NLS-1$
-                       XMLMemento memento = XMLMemento.createReadRoot(reader);
-
-                       // Get the external tool children element
-                       IMemento[] tools = memento.getChildren(TAG_TOOL);
-                       for (int i = 0; i < tools.length; i++) {
-                               HashMap args = new HashMap();
-                               IMemento[] entries = tools[i].getChildren(TAG_ENTRY);
-                               for (int j = 0; j < entries.length; j++) {
-                                       String key = entries[j].getString(TAG_KEY);
-                                       if (key != null) {
-                                               String value = entries[j].getTextData();
-                                               args.put(key, value);
-                                       }
-                               }
-                               ILaunchConfigurationWorkingCopy config = configFromArgumentMap(args);
-                               if (config != null) {
-                                       try {
-                                               config.doSave();
-                                       } catch (CoreException e) {
-                                               // TODO: Decide what to do when saving fails.
-                                       }
-                               }
-                       }
-               } catch (FileNotFoundException e) {
-                       // Silently ignore this...
-               } catch (IOException e) {
-                       ExternalToolsPlugin.getDefault().log("File I/O error with reading old external tools.", e); 
-                       migrationSuccessful = false;
-               } catch (WorkbenchException e) {
-      PHPeclipsePlugin.getDefault().getLog().log(e.getStatus());
-                       System.err.println("Error reading old external tools. See .log file for more details"); 
-                       migrationSuccessful = false;
-               } finally {
-                       if (reader != null) {
-                               try {
-                                       reader.close();
-                               } catch (IOException e) {
-                                       ExternalToolsPlugin.getDefault().log("Unable to close external tool old state reader.", e); 
-                               }
-                       }
-               }
-
-               if (migrationSuccessful) {
-                       if (!file.renameTo(path.append(STATE_FILE_NAME_OLD).toFile())) {
-                               ExternalToolsPlugin.getDefault().log("Unable to rename old external tool state file. Please rename externaltools.xml to oldexternaltools.xml manually.", null); 
-                               System.err.println("Unable to rename old external tool state file. Please rename externaltools.xml to oldexternaltools.xml manually."); 
-                       }
-               }
-       }
-
-       /**
-        * Returns a  launch configuration working copy from the argument map or
-        * <code>null</code> if the given map cannot be interpreted as a 2.0 or 2.1
-        * branch external tool. The returned working copy will be unsaved and its
-        * location will be set to the metadata area.
-        */
-       public static ILaunchConfigurationWorkingCopy configFromArgumentMap(Map args) {
-               String version = (String) args.get(TAG_VERSION);
-               if (VERSION_21.equals(version)) {
-                       return configFrom21ArgumentMap(args);
-               }
-               return configFrom20ArgumentMap(args);
-       }
-
-       public static ILaunchConfigurationWorkingCopy configFrom21ArgumentMap(Map commandArgs) {
-               String name = (String) commandArgs.get(TAG_NAME);
-               String type = (String) commandArgs.get(TAG_TYPE);
-               
-               ILaunchConfigurationWorkingCopy config = newConfig(type, name);
-               if (config == null) {
-                       return null;
-               }
-               
-               config.setAttribute(IExternalToolConstants.ATTR_LOCATION, (String) commandArgs.get(TAG_LOCATION));
-               config.setAttribute(IExternalToolConstants.ATTR_WORKING_DIRECTORY, (String) commandArgs.get(TAG_WORK_DIR));
-               config.setAttribute(IExternalToolConstants.ATTR_CAPTURE_OUTPUT, TRUE.equals((String) commandArgs.get(TAG_CAPTURE_OUTPUT)));
-               config.setAttribute(IExternalToolConstants.ATTR_SHOW_CONSOLE, TRUE.equals((String) commandArgs.get(TAG_SHOW_CONSOLE)));
-               config.setAttribute(IExternalToolConstants.ATTR_RUN_IN_BACKGROUND, TRUE.equals((String) commandArgs.get(TAG_RUN_BKGRND)));
-               config.setAttribute(IExternalToolConstants.ATTR_PROMPT_FOR_ARGUMENTS, TRUE.equals((String) commandArgs.get(TAG_PROMPT_ARGS)));
-               config.setAttribute(IExternalToolConstants.ATTR_REFRESH_SCOPE, (String) commandArgs.get(TAG_REFRESH_SCOPE));
-               config.setAttribute(IExternalToolConstants.ATTR_REFRESH_RECURSIVE, TRUE.equals((String) commandArgs.get(TAG_REFRESH_RECURSIVE)));
-
-               config.setAttribute(IExternalToolConstants.ATTR_RUN_BUILD_KINDS, (String) commandArgs.get(TAG_RUN_BUILD_KINDS));
-               
-               String args = (String) commandArgs.get(TAG_ARGS);
-               if (args != null) {
-                       config.setAttribute(IExternalToolConstants.ATTR_TOOL_ARGUMENTS, args);
-               }
-
-               String extraAttributes = (String) commandArgs.get(TAG_EXTRA_ATTR);
-               if (extraAttributes != null) {
-                       StringTokenizer tokenizer = new StringTokenizer(extraAttributes, EXTRA_ATTR_SEPARATOR);
-                       while (tokenizer.hasMoreTokens()) {
-                               String key = tokenizer.nextToken();
-                               if (!tokenizer.hasMoreTokens())
-                                       break;
-                               String value = tokenizer.nextToken();
-//                             if (key.equals(RUN_TARGETS_ATTRIBUTE)) {
-//                                     // 2.1 implementation only defined 1 "extra attribute"
-//                                     config.setAttribute(IExternalToolConstants.ATTR_ANT_TARGETS, value);
-//                             }
-                       }
-               }
-               return config;
-       }
-
-       /**
-        * Creates an external tool from the map.
-        */
-       public static ILaunchConfigurationWorkingCopy configFrom20ArgumentMap(Map args) {
-               // Update the type...
-               String type = (String) args.get(TAG_TOOL_TYPE);
-//             if (TOOL_TYPE_ANT.equals(type))
-//                     type = IExternalToolConstants.TOOL_TYPE_ANT_BUILD;
-//             else
-                       type = IExternalToolConstants.TOOL_TYPE_PROGRAM;
-
-               String name = (String) args.get(TAG_TOOL_NAME);
-               
-               ILaunchConfigurationWorkingCopy config = newConfig(type, name);
-               if (config == null) {
-                       return null;
-               }
-
-               // Update the location...
-               String location = (String) args.get(TAG_TOOL_LOCATION);
-               if (location != null) {
-                       ToolUtil.VariableDefinition varDef = ToolUtil.extractVariableTag(location, 0);
-                       if (IExternalToolConstants.VAR_WORKSPACE_LOC.equals(varDef.name)) {
-                               location = ToolUtil.buildVariableTag(IExternalToolConstants.VAR_RESOURCE_LOC, varDef.argument);
-                       }
-                       config.setAttribute(IExternalToolConstants.ATTR_LOCATION, location);
-               }
-
-               // Update the refresh scope...
-               String refresh = (String) args.get(TAG_TOOL_REFRESH);
-               if (refresh != null) {
-                       ToolUtil.VariableDefinition varDef = ToolUtil.extractVariableTag(refresh, 0);
-                       if ("none".equals(varDef.name)) { //$NON-NLS-1$
-                               refresh = null;
-                       }
-                       config.setAttribute(IExternalToolConstants.ATTR_REFRESH_SCOPE, refresh);
-               }
-
-               // Update the arguments
-               String arguments = (String) args.get(TAG_TOOL_ARGUMENTS);
-               String targetNames = null;
-               if (arguments != null) {
-                       int start = 0;
-                       ArrayList targets = new ArrayList();
-                       StringBuffer buffer = new StringBuffer();
-                       ToolUtil.VariableDefinition varDef = ToolUtil.extractVariableTag(arguments, start);
-                       while (varDef.end != -1) {
-                               if ("ant_target".equals(varDef.name) && varDef.argument != null) { //$NON-NLS-1$
-                                       targets.add(varDef.argument);
-                                       buffer.append(arguments.substring(start, varDef.start));
-                               } else {
-                                       buffer.append(arguments.substring(start, varDef.end));
-                               }
-                               start = varDef.end;
-                               varDef = ToolUtil.extractVariableTag(arguments, start);
-                       }
-                       buffer.append(arguments.substring(start, arguments.length()));
-                       arguments = buffer.toString();
-
-                       buffer.setLength(0);
-                       for (int i = 0; i < targets.size(); i++) {
-                               String target = (String) targets.get(i);
-                               if (target != null && target.length() > 0) {
-                                       buffer.append(target);
-                                       buffer.append(","); //$NON-NLS-1$
-                               }
-                       }
-                       targetNames = buffer.toString();
-               }
-               if (targetNames != null && targetNames.length() > 0) {
-                       config.setAttribute(IExternalToolConstants.ATTR_ANT_TARGETS, targetNames);
-               }
-
-               // Collect the rest of the information
-               config.setAttribute(IExternalToolConstants.ATTR_SHOW_CONSOLE, TRUE.equals((String) args.get(TAG_TOOL_SHOW_LOG)));
-               config.setAttribute(IExternalToolConstants.ATTR_CAPTURE_OUTPUT, TRUE.equals((String) args.get(TAG_TOOL_SHOW_LOG)));
-               config.setAttribute(IExternalToolConstants.ATTR_RUN_IN_BACKGROUND, FALSE.equals((String) args.get(TAG_TOOL_BLOCK)));
-               config.setAttribute(IExternalToolConstants.ATTR_RUN_BUILD_KINDS, (String) args.get(TAG_TOOL_BUILD_TYPES));
-               config.setAttribute(IExternalToolConstants.ATTR_TOOL_ARGUMENTS, arguments);
-               config.setAttribute(IExternalToolConstants.ATTR_WORKING_DIRECTORY, (String) args.get(TAG_TOOL_DIRECTORY));
-               return config;
-       }
-
-       /**
-        * Returns a new working copy with the given external tool name and external
-        * tool type or <code>null</code> if no config could be created.
-        */
-       private static ILaunchConfigurationWorkingCopy newConfig(String type, String name) {
-               if (type == null || name == null) {
-                       return null;
-               }
-               ILaunchManager manager = DebugPlugin.getDefault().getLaunchManager();
-               ILaunchConfigurationType configType;
-//             if (IExternalToolConstants.TOOL_TYPE_ANT_BUILD.equals(type)) {
-//                     configType = manager.getLaunchConfigurationType(IExternalToolConstants.ID_ANT_BUILDER_LAUNCH_CONFIGURATION_TYPE);
-//             } else 
-               if (IExternalToolConstants.TOOL_TYPE_PROGRAM.equals(type)) {
-                       configType = manager.getLaunchConfigurationType(IExternalToolConstants.ID_PROGRAM_BUILDER_LAUNCH_CONFIGURATION_TYPE);
-               } else {
-                       return null;
-               }
-               try {
-                       return configType.newInstance(null, name);
-               } catch (CoreException e) {
-                       return null;
-               }
-       }
-       
-       /**
-        * Returns the tool name extracted from the given command argument map.
-        * Extraction is attempted using 2.0 and 2.1 external tool formats.
-        */
-       public static String getNameFromCommandArgs(Map commandArgs) {
-               String name= (String) commandArgs.get(TAG_NAME);
-               if (name == null) {
-                       name= (String) commandArgs.get(TAG_TOOL_NAME);
-               }
-               return name;
-       }
-       
-}