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.model.IExternalToolConstants; import net.sourceforge.phpdt.externaltools.model.ToolUtil; //import net.sourceforge.phpeclipse.externaltools.ExternalToolsPlugin; 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 = ExternalToolsPlugin.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) { // ExternalToolsPlugin.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 * null 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 null 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; // } }