org.eclipse.jdt.ui/core extension/org/eclipse/jdt/internal/corext/util/CodeFormatterUtil.java - jdt/eclipse.jdt.ui - Git at Google

 /*******************************************************************************
  * Copyright (c) 2000, 2006 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
  * http://www.eclipse.org/legal/epl-v10.html
  *
  * Contributors:
  *     IBM Corporation - initial API and implementation
  *******************************************************************************/
 package org.eclipse.jdt.internal.corext.util;

 import java.util.Map;

 import org.eclipse.text.edits.DeleteEdit;
 import org.eclipse.text.edits.InsertEdit;
 import org.eclipse.text.edits.MultiTextEdit;
 import org.eclipse.text.edits.ReplaceEdit;
 import org.eclipse.text.edits.TextEdit;

 import org.eclipse.core.runtime.Assert;

 import org.eclipse.jface.text.BadLocationException;
 import org.eclipse.jface.text.BadPositionCategoryException;
 import org.eclipse.jface.text.DefaultPositionUpdater;
 import org.eclipse.jface.text.Document;
 import org.eclipse.jface.text.Position;

 import org.eclipse.jdt.core.IJavaProject;
 import org.eclipse.jdt.core.JavaCore;
 import org.eclipse.jdt.core.ToolFactory;
 import org.eclipse.jdt.core.formatter.CodeFormatter;
 import org.eclipse.jdt.core.formatter.DefaultCodeFormatterConstants;

 import org.eclipse.jdt.core.dom.ASTNode;
 import org.eclipse.jdt.core.dom.BodyDeclaration;
 import org.eclipse.jdt.core.dom.Expression;
 import org.eclipse.jdt.core.dom.Statement;

 import org.eclipse.jdt.internal.ui.JavaPlugin;

 public class CodeFormatterUtil {

 	/**
 	 * Creates a string that represents the given number of indentation units.
 	 * The returned string can contain tabs and/or spaces depending on the core
 	 * formatter preferences.
 	 *
 	 * @param indentationUnits the number of indentation units to generate
 	 * @param project the project from which to get the formatter settings,
 	 *        <code>null</code> if the workspace default should be used
 	 * @return the indent string
 	 */
 	public static String createIndentString(int indentationUnits, IJavaProject project) {
 		Map options= project != null ? project.getOptions(true) : JavaCore.getOptions();
 		return ToolFactory.createCodeFormatter(options).createIndentationString(indentationUnits);
 	}

 	/**
 	 * Gets the current tab width.
 	 *
 	 * @param project The project where the source is used, used for project
 	 *        specific options or <code>null</code> if the project is unknown
 	 *        and the workspace default should be used
 	 * @return The tab width
 	 */
 	public static int getTabWidth(IJavaProject project) {
 		/*
 		 * If the tab-char is SPACE, FORMATTER_INDENTATION_SIZE is not used
 		 * by the core formatter.
 		 * We piggy back the visual tab length setting in that preference in
 		 * that case.
 		 */
 		String key;
 		if (JavaCore.SPACE.equals(getCoreOption(project, DefaultCodeFormatterConstants.FORMATTER_TAB_CHAR)))
 			key= DefaultCodeFormatterConstants.FORMATTER_INDENTATION_SIZE;
 		else
 			key= DefaultCodeFormatterConstants.FORMATTER_TAB_SIZE;

 		return getCoreOption(project, key, 4);
 	}

 	/**
 	 * Returns the current indent width.
 	 *
 	 * @param project the project where the source is used or <code>null</code>
 	 *        if the project is unknown and the workspace default should be used
 	 * @return the indent width
 	 * @since 3.1
 	 */
 	public static int getIndentWidth(IJavaProject project) {
 		String key;
 		if (DefaultCodeFormatterConstants.MIXED.equals(getCoreOption(project, DefaultCodeFormatterConstants.FORMATTER_TAB_CHAR)))
 			key= DefaultCodeFormatterConstants.FORMATTER_INDENTATION_SIZE;
 		else
 			key= DefaultCodeFormatterConstants.FORMATTER_TAB_SIZE;

 		return getCoreOption(project, key, 4);
 	}

 	/**
 	 * Returns the possibly <code>project</code>-specific core preference
 	 * defined under <code>key</code>.
 	 *
 	 * @param project the project to get the preference from, or
 	 *        <code>null</code> to get the global preference
 	 * @param key the key of the preference
 	 * @return the value of the preference
 	 * @since 3.1
 	 */
 	private static String getCoreOption(IJavaProject project, String key) {
 		if (project == null)
 			return JavaCore.getOption(key);
 		return project.getOption(key, true);
 	}

 	/**
 	 * Returns the possibly <code>project</code>-specific core preference
 	 * defined under <code>key</code>, or <code>def</code> if the value is
 	 * not a integer.
 	 *
 	 * @param project the project to get the preference from, or
 	 *        <code>null</code> to get the global preference
 	 * @param key the key of the preference
 	 * @param def the default value
 	 * @return the value of the preference
 	 * @since 3.1
 	 */
 	private static int getCoreOption(IJavaProject project, String key, int def) {
 		try {
 			return Integer.parseInt(getCoreOption(project, key));
 		} catch (NumberFormatException e) {
 			return def;
 		}
 	}

 	// transition code

 	/**
 	 * Old API. Consider to use format2 (TextEdit)
 	 */
 	public static String format(int kind, String string, int indentationLevel, int[] positions, String lineSeparator, Map options) {
 		return format(kind, string, 0, string.length(), indentationLevel, positions, lineSeparator, options);
 	}

 	public static String format(int kind, String string, int indentationLevel, int[] positions, String lineSeparator, IJavaProject project) {
 		Map options= project != null ? project.getOptions(true) : null;
 		return format(kind, string, 0, string.length(), indentationLevel, positions, lineSeparator, options);
 	}


 	/**
 	 * Old API. Consider to use format2 (TextEdit)
 	 */
 	public static String format(int kind, String string, int offset, int length, int indentationLevel, int[] positions, String lineSeparator, Map options) {
 		TextEdit edit= format2(kind, string, offset, length, indentationLevel, lineSeparator, options);
 		if (edit == null) {
 			//JavaPlugin.logErrorMessage("formatter failed to format (no edit returned). Will use unformatted text instead. kind: " + kind + ", string: " + string); //$NON-NLS-1$ //$NON-NLS-2$
 			return string.substring(offset, offset + length);
 		}
 		String formatted= getOldAPICompatibleResult(string, edit, indentationLevel, positions, lineSeparator, options);
 		return formatted.substring(offset, formatted.length() - (string.length() - (offset + length)));
 	}

 	/**
 	 * Old API. Consider to use format2 (TextEdit)
 	 */
 	public static String format(ASTNode node, String string, int indentationLevel, int[] positions, String lineSeparator, Map options) {

 		TextEdit edit= format2(node, string, indentationLevel, lineSeparator, options);
 		if (edit == null) {
 			//JavaPlugin.logErrorMessage("formatter failed to format (no edit returned). Will use unformatted text instead. node: " + node.getNodeType() + ", string: " + string); //$NON-NLS-1$ //$NON-NLS-2$
 			return string;
 		}
 		return getOldAPICompatibleResult(string, edit, indentationLevel, positions, lineSeparator, options);
 	}

 	private static String getOldAPICompatibleResult(String string, TextEdit edit, int indentationLevel, int[] positions, String lineSeparator, Map options) {
 		Position[] p= null;

 		if (positions != null) {
 			p= new Position[positions.length];
 			for (int i= 0; i < positions.length; i++) {
 				p[i]= new Position(positions[i], 0);
 			}
 		}
 		String res= evaluateFormatterEdit(string, edit, p);

 		if (positions != null) {
 			for (int i= 0; i < positions.length; i++) {
 				Position curr= p[i];
 				positions[i]= curr.getOffset();
 			}
 		}
 		return res;
 	}

 	/**
 	 * Evaluates the edit on the given string.
 	 * @throws IllegalArgumentException If the positions are not inside the string, a
 	 *  IllegalArgumentException is thrown.
 	 */
 	public static String evaluateFormatterEdit(String string, TextEdit edit, Position[] positions) {
 		try {
 			Document doc= createDocument(string, positions);
 			edit.apply(doc, 0);
 			if (positions != null) {
 				for (int i= 0; i < positions.length; i++) {
 					Assert.isTrue(!positions[i].isDeleted, "Position got deleted"); //$NON-NLS-1$
 				}
 			}
 			return doc.get();
 		} catch (BadLocationException e) {
 			JavaPlugin.log(e); // bug in the formatter
 			Assert.isTrue(false, "Formatter created edits with wrong positions: " + e.getMessage()); //$NON-NLS-1$
 		}
 		return null;
 	}

 	/**
 	 * Creates edits that describe how to format the given string. Returns <code>null</code> if the code could not be formatted for the given kind.
 	 * @throws IllegalArgumentException If the offset and length are not inside the string, a
 	 *  IllegalArgumentException is thrown.
 	 */
 	public static TextEdit format2(int kind, String string, int offset, int length, int indentationLevel, String lineSeparator, Map options) {
 		if (offset < 0 || length < 0 || offset + length > string.length()) {
 			throw new IllegalArgumentException("offset or length outside of string. offset: " + offset + ", length: " + length + ", string size: " + string.length());   //$NON-NLS-1$//$NON-NLS-2$//$NON-NLS-3$
 		}
 		return ToolFactory.createCodeFormatter(options).format(kind, string, offset, length, indentationLevel, lineSeparator);
 	}

 	public static TextEdit format2(int kind, String string, int indentationLevel, String lineSeparator, Map options) {
 		return format2(kind, string, 0, string.length(), indentationLevel, lineSeparator, options);
 	}

 	/**
 	 * Creates edits that describe how to format the given string. Returns <code>null</code> if the code could not be formatted for the given kind.
 	 * @throws IllegalArgumentException If the offset and length are not inside the string, a
 	 *  IllegalArgumentException is thrown.
 	 */
 	public static TextEdit format2(ASTNode node, String str, int indentationLevel, String lineSeparator, Map options) {
 		int code;
 		String prefix= ""; //$NON-NLS-1$
 		String suffix= ""; //$NON-NLS-1$
 		if (node instanceof Statement) {
 			code= CodeFormatter.K_STATEMENTS;
 			if (node.getNodeType() == ASTNode.SWITCH_CASE) {
 				prefix= "switch(1) {"; //$NON-NLS-1$
 				suffix= "}"; //$NON-NLS-1$
 				code= CodeFormatter.K_STATEMENTS;
 			}
 		} else if (node instanceof Expression && node.getNodeType() != ASTNode.VARIABLE_DECLARATION_EXPRESSION) {
 			code= CodeFormatter.K_EXPRESSION;
 		} else if (node instanceof BodyDeclaration) {
 			code= CodeFormatter.K_CLASS_BODY_DECLARATIONS;
 		} else {
 			switch (node.getNodeType()) {
 				case ASTNode.ARRAY_TYPE:
 				case ASTNode.PARAMETERIZED_TYPE:
 				case ASTNode.PRIMITIVE_TYPE:
 				case ASTNode.QUALIFIED_TYPE:
 				case ASTNode.SIMPLE_TYPE:
 					suffix= " x;"; //$NON-NLS-1$
 					code= CodeFormatter.K_CLASS_BODY_DECLARATIONS;
 					break;
 				case ASTNode.WILDCARD_TYPE:
 					prefix= "A<"; //$NON-NLS-1$
 					suffix= "> x;"; //$NON-NLS-1$
 					code= CodeFormatter.K_CLASS_BODY_DECLARATIONS;
 					break;
 				case ASTNode.COMPILATION_UNIT:
 					code= CodeFormatter.K_COMPILATION_UNIT;
 					break;
 				case ASTNode.VARIABLE_DECLARATION_EXPRESSION:
 				case ASTNode.SINGLE_VARIABLE_DECLARATION:
 					suffix= ";"; //$NON-NLS-1$
 					code= CodeFormatter.K_STATEMENTS;
 					break;
 				case ASTNode.VARIABLE_DECLARATION_FRAGMENT:
 					prefix= "A "; //$NON-NLS-1$
 					suffix= ";"; //$NON-NLS-1$
 					code= CodeFormatter.K_STATEMENTS;
 					break;
 				case ASTNode.PACKAGE_DECLARATION:
 				case ASTNode.IMPORT_DECLARATION:
 					suffix= "\nclass A {}"; //$NON-NLS-1$
 					code= CodeFormatter.K_COMPILATION_UNIT;
 					break;
 				case ASTNode.JAVADOC:
 					suffix= "void foo();"; //$NON-NLS-1$
 					code= CodeFormatter.K_CLASS_BODY_DECLARATIONS;
 					break;
 				case ASTNode.CATCH_CLAUSE:
 					prefix= "try {}"; //$NON-NLS-1$
 					code= CodeFormatter.K_STATEMENTS;
 					break;
 				case ASTNode.ANONYMOUS_CLASS_DECLARATION:
 					prefix= "new A()"; //$NON-NLS-1$
 					suffix= ";"; //$NON-NLS-1$
 					code= CodeFormatter.K_STATEMENTS;
 					break;
 				case ASTNode.MEMBER_VALUE_PAIR:
 					prefix= "@Author("; //$NON-NLS-1$
 					suffix= ") class x {}"; //$NON-NLS-1$
 					code= CodeFormatter.K_COMPILATION_UNIT;
 					break;
 				case ASTNode.MODIFIER:
 					suffix= " class x {}"; //$NON-NLS-1$
 					code= CodeFormatter.K_COMPILATION_UNIT;
 					break;
 				case ASTNode.TYPE_PARAMETER:
 					prefix= "class X<"; //$NON-NLS-1$
 					suffix= "> {}"; //$NON-NLS-1$
 					code= CodeFormatter.K_COMPILATION_UNIT;
 					break;
 				case ASTNode.MEMBER_REF:
 				case ASTNode.METHOD_REF:
 				case ASTNode.METHOD_REF_PARAMETER:
 				case ASTNode.TAG_ELEMENT:
 				case ASTNode.TEXT_ELEMENT:
 					// Javadoc formatting not yet supported:
 				    return null;
 				default:
 					//Assert.isTrue(false, "Node type not covered: " + node.getClass().getName()); //$NON-NLS-1$
 					return null;
 			}
 		}

 		String concatStr= prefix + str + suffix;
 		TextEdit edit= ToolFactory.createCodeFormatter(options).format(code, concatStr, prefix.length(), str.length(), indentationLevel, lineSeparator);
 		if (prefix.length() > 0) {
 			edit= shifEdit(edit, prefix.length());
 		}
 		return edit;
 	}

 	private static TextEdit shifEdit(TextEdit oldEdit, int diff) {
 		TextEdit newEdit;
 		if (oldEdit instanceof ReplaceEdit) {
 			ReplaceEdit edit= (ReplaceEdit) oldEdit;
 			newEdit= new ReplaceEdit(edit.getOffset() - diff, edit.getLength(), edit.getText());
 		} else if (oldEdit instanceof InsertEdit) {
 			InsertEdit edit= (InsertEdit) oldEdit;
 			newEdit= new InsertEdit(edit.getOffset() - diff,  edit.getText());
 		} else if (oldEdit instanceof DeleteEdit) {
 			DeleteEdit edit= (DeleteEdit) oldEdit;
 			newEdit= new DeleteEdit(edit.getOffset() - diff,  edit.getLength());
 		} else if (oldEdit instanceof MultiTextEdit) {
 			newEdit= new MultiTextEdit();
 		} else {
 			return null; // not supported
 		}
 		TextEdit[] children= oldEdit.getChildren();
 		for (int i= 0; i < children.length; i++) {
 			TextEdit shifted= shifEdit(children[i], diff);
 			if (shifted != null) {
 				newEdit.addChild(shifted);
 			}
 		}
 		return newEdit;
 	}

 	private static Document createDocument(String string, Position[] positions) throws IllegalArgumentException {
 		Document doc= new Document(string);
 		try {
 			if (positions != null) {
 				final String POS_CATEGORY= "myCategory"; //$NON-NLS-1$

 				doc.addPositionCategory(POS_CATEGORY);
 				doc.addPositionUpdater(new DefaultPositionUpdater(POS_CATEGORY) {
 					protected boolean notDeleted() {
 						if (fOffset < fPosition.offset && (fPosition.offset + fPosition.length < fOffset + fLength)) {
 							fPosition.offset= fOffset + fLength; // deleted positions: set to end of remove
 							return false;
 						}
 						return true;
 					}
 				});
 				for (int i= 0; i < positions.length; i++) {
 					try {
 						doc.addPosition(POS_CATEGORY, positions[i]);
 					} catch (BadLocationException e) {
 						throw new IllegalArgumentException("Position outside of string. offset: " + positions[i].offset + ", length: " + positions[i].length + ", string size: " + string.length());   //$NON-NLS-1$//$NON-NLS-2$//$NON-NLS-3$
 					}
 				}
 			}
 		} catch (BadPositionCategoryException cannotHappen) {
 			// can not happen: category is correctly set up
 		}
 		return doc;
 	}

 }
	/*******************************************************************************
	* Copyright (c) 2000, 2006 IBM Corporation and others.
	* All rights reserved. This program and the accompanying materials
	* are made available under the terms of the Eclipse Public License v1.0
	* which accompanies this distribution, and is available at
	* http://www.eclipse.org/legal/epl-v10.html
	*
	* Contributors:
	* IBM Corporation - initial API and implementation
	*******************************************************************************/
	package org.eclipse.jdt.internal.corext.util;

	import java.util.Map;

	import org.eclipse.text.edits.DeleteEdit;
	import org.eclipse.text.edits.InsertEdit;
	import org.eclipse.text.edits.MultiTextEdit;
	import org.eclipse.text.edits.ReplaceEdit;
	import org.eclipse.text.edits.TextEdit;

	import org.eclipse.core.runtime.Assert;

	import org.eclipse.jface.text.BadLocationException;
	import org.eclipse.jface.text.BadPositionCategoryException;
	import org.eclipse.jface.text.DefaultPositionUpdater;
	import org.eclipse.jface.text.Document;
	import org.eclipse.jface.text.Position;

	import org.eclipse.jdt.core.IJavaProject;
	import org.eclipse.jdt.core.JavaCore;
	import org.eclipse.jdt.core.ToolFactory;
	import org.eclipse.jdt.core.formatter.CodeFormatter;
	import org.eclipse.jdt.core.formatter.DefaultCodeFormatterConstants;

	import org.eclipse.jdt.core.dom.ASTNode;
	import org.eclipse.jdt.core.dom.BodyDeclaration;
	import org.eclipse.jdt.core.dom.Expression;
	import org.eclipse.jdt.core.dom.Statement;

	import org.eclipse.jdt.internal.ui.JavaPlugin;

	public class CodeFormatterUtil {

	/**
	* Creates a string that represents the given number of indentation units.
	* The returned string can contain tabs and/or spaces depending on the core
	* formatter preferences.
	*
	* @param indentationUnits the number of indentation units to generate
	* @param project the project from which to get the formatter settings,
	* <code>null</code> if the workspace default should be used
	* @return the indent string
	*/
	public static String createIndentString(int indentationUnits, IJavaProject project) {
	Map options= project != null ? project.getOptions(true) : JavaCore.getOptions();
	return ToolFactory.createCodeFormatter(options).createIndentationString(indentationUnits);
	}

	/**
	* Gets the current tab width.
	*
	* @param project The project where the source is used, used for project
	* specific options or <code>null</code> if the project is unknown
	* and the workspace default should be used
	* @return The tab width
	*/
	public static int getTabWidth(IJavaProject project) {
	/*
	* If the tab-char is SPACE, FORMATTER_INDENTATION_SIZE is not used
	* by the core formatter.
	* We piggy back the visual tab length setting in that preference in
	* that case.
	*/
	String key;
	if (JavaCore.SPACE.equals(getCoreOption(project, DefaultCodeFormatterConstants.FORMATTER_TAB_CHAR)))
	key= DefaultCodeFormatterConstants.FORMATTER_INDENTATION_SIZE;
	else
	key= DefaultCodeFormatterConstants.FORMATTER_TAB_SIZE;

	return getCoreOption(project, key, 4);
	}

	/**
	* Returns the current indent width.
	*
	* @param project the project where the source is used or <code>null</code>
	* if the project is unknown and the workspace default should be used
	* @return the indent width
	* @since 3.1
	*/
	public static int getIndentWidth(IJavaProject project) {
	String key;
	if (DefaultCodeFormatterConstants.MIXED.equals(getCoreOption(project, DefaultCodeFormatterConstants.FORMATTER_TAB_CHAR)))
	key= DefaultCodeFormatterConstants.FORMATTER_INDENTATION_SIZE;
	else
	key= DefaultCodeFormatterConstants.FORMATTER_TAB_SIZE;

	return getCoreOption(project, key, 4);
	}

	/**
	* Returns the possibly <code>project</code>-specific core preference
	* defined under <code>key</code>.
	*
	* @param project the project to get the preference from, or
	* <code>null</code> to get the global preference
	* @param key the key of the preference
	* @return the value of the preference
	* @since 3.1
	*/
	private static String getCoreOption(IJavaProject project, String key) {
	if (project == null)
	return JavaCore.getOption(key);
	return project.getOption(key, true);
	}

	/**
	* Returns the possibly <code>project</code>-specific core preference
	* defined under <code>key</code>, or <code>def</code> if the value is
	* not a integer.
	*
	* @param project the project to get the preference from, or
	* <code>null</code> to get the global preference
	* @param key the key of the preference
	* @param def the default value
	* @return the value of the preference
	* @since 3.1
	*/
	private static int getCoreOption(IJavaProject project, String key, int def) {
	try {
	return Integer.parseInt(getCoreOption(project, key));
	} catch (NumberFormatException e) {
	return def;
	}
	}

	// transition code

	/**
	* Old API. Consider to use format2 (TextEdit)
	*/
	public static String format(int kind, String string, int indentationLevel, int[] positions, String lineSeparator, Map options) {
	return format(kind, string, 0, string.length(), indentationLevel, positions, lineSeparator, options);
	}

	public static String format(int kind, String string, int indentationLevel, int[] positions, String lineSeparator, IJavaProject project) {
	Map options= project != null ? project.getOptions(true) : null;
	return format(kind, string, 0, string.length(), indentationLevel, positions, lineSeparator, options);
	}


	/**
	* Old API. Consider to use format2 (TextEdit)
	*/
	public static String format(int kind, String string, int offset, int length, int indentationLevel, int[] positions, String lineSeparator, Map options) {
	TextEdit edit= format2(kind, string, offset, length, indentationLevel, lineSeparator, options);
	if (edit == null) {
	//JavaPlugin.logErrorMessage("formatter failed to format (no edit returned). Will use unformatted text instead. kind: " + kind + ", string: " + string); //$NON-NLS-1$ //$NON-NLS-2$
	return string.substring(offset, offset + length);
	}
	String formatted= getOldAPICompatibleResult(string, edit, indentationLevel, positions, lineSeparator, options);
	return formatted.substring(offset, formatted.length() - (string.length() - (offset + length)));
	}

	/**
	* Old API. Consider to use format2 (TextEdit)
	*/
	public static String format(ASTNode node, String string, int indentationLevel, int[] positions, String lineSeparator, Map options) {

	TextEdit edit= format2(node, string, indentationLevel, lineSeparator, options);
	if (edit == null) {
	//JavaPlugin.logErrorMessage("formatter failed to format (no edit returned). Will use unformatted text instead. node: " + node.getNodeType() + ", string: " + string); //$NON-NLS-1$ //$NON-NLS-2$
	return string;
	}
	return getOldAPICompatibleResult(string, edit, indentationLevel, positions, lineSeparator, options);
	}

	private static String getOldAPICompatibleResult(String string, TextEdit edit, int indentationLevel, int[] positions, String lineSeparator, Map options) {
	Position[] p= null;

	if (positions != null) {
	p= new Position[positions.length];
	for (int i= 0; i < positions.length; i++) {
	p[i]= new Position(positions[i], 0);
	}
	}
	String res= evaluateFormatterEdit(string, edit, p);

	if (positions != null) {
	for (int i= 0; i < positions.length; i++) {
	Position curr= p[i];
	positions[i]= curr.getOffset();
	}
	}
	return res;
	}

	/**
	* Evaluates the edit on the given string.
	* @throws IllegalArgumentException If the positions are not inside the string, a
	* IllegalArgumentException is thrown.
	*/
	public static String evaluateFormatterEdit(String string, TextEdit edit, Position[] positions) {
	try {
	Document doc= createDocument(string, positions);
	edit.apply(doc, 0);
	if (positions != null) {
	for (int i= 0; i < positions.length; i++) {
	Assert.isTrue(!positions[i].isDeleted, "Position got deleted"); //$NON-NLS-1$
	}
	}
	return doc.get();
	} catch (BadLocationException e) {
	JavaPlugin.log(e); // bug in the formatter
	Assert.isTrue(false, "Formatter created edits with wrong positions: " + e.getMessage()); //$NON-NLS-1$
	}
	return null;
	}

	/**
	* Creates edits that describe how to format the given string. Returns <code>null</code> if the code could not be formatted for the given kind.
	* @throws IllegalArgumentException If the offset and length are not inside the string, a
	* IllegalArgumentException is thrown.
	*/
	public static TextEdit format2(int kind, String string, int offset, int length, int indentationLevel, String lineSeparator, Map options) {
	if (offset < 0 \|\| length < 0 \|\| offset + length > string.length()) {
	throw new IllegalArgumentException("offset or length outside of string. offset: " + offset + ", length: " + length + ", string size: " + string.length()); //$NON-NLS-1$//$NON-NLS-2$//$NON-NLS-3$
	}
	return ToolFactory.createCodeFormatter(options).format(kind, string, offset, length, indentationLevel, lineSeparator);
	}

	public static TextEdit format2(int kind, String string, int indentationLevel, String lineSeparator, Map options) {
	return format2(kind, string, 0, string.length(), indentationLevel, lineSeparator, options);
	}

	/**
	* Creates edits that describe how to format the given string. Returns <code>null</code> if the code could not be formatted for the given kind.
	* @throws IllegalArgumentException If the offset and length are not inside the string, a
	* IllegalArgumentException is thrown.
	*/
	public static TextEdit format2(ASTNode node, String str, int indentationLevel, String lineSeparator, Map options) {
	int code;
	String prefix= ""; //$NON-NLS-1$
	String suffix= ""; //$NON-NLS-1$
	if (node instanceof Statement) {
	code= CodeFormatter.K_STATEMENTS;
	if (node.getNodeType() == ASTNode.SWITCH_CASE) {
	prefix= "switch(1) {"; //$NON-NLS-1$
	suffix= "}"; //$NON-NLS-1$
	code= CodeFormatter.K_STATEMENTS;
	}
	} else if (node instanceof Expression && node.getNodeType() != ASTNode.VARIABLE_DECLARATION_EXPRESSION) {
	code= CodeFormatter.K_EXPRESSION;
	} else if (node instanceof BodyDeclaration) {
	code= CodeFormatter.K_CLASS_BODY_DECLARATIONS;
	} else {
	switch (node.getNodeType()) {
	case ASTNode.ARRAY_TYPE:
	case ASTNode.PARAMETERIZED_TYPE:
	case ASTNode.PRIMITIVE_TYPE:
	case ASTNode.QUALIFIED_TYPE:
	case ASTNode.SIMPLE_TYPE:
	suffix= " x;"; //$NON-NLS-1$
	code= CodeFormatter.K_CLASS_BODY_DECLARATIONS;
	break;
	case ASTNode.WILDCARD_TYPE:
	prefix= "A<"; //$NON-NLS-1$
	suffix= "> x;"; //$NON-NLS-1$
	code= CodeFormatter.K_CLASS_BODY_DECLARATIONS;
	break;
	case ASTNode.COMPILATION_UNIT:
	code= CodeFormatter.K_COMPILATION_UNIT;
	break;
	case ASTNode.VARIABLE_DECLARATION_EXPRESSION:
	case ASTNode.SINGLE_VARIABLE_DECLARATION:
	suffix= ";"; //$NON-NLS-1$
	code= CodeFormatter.K_STATEMENTS;
	break;
	case ASTNode.VARIABLE_DECLARATION_FRAGMENT:
	prefix= "A "; //$NON-NLS-1$
	suffix= ";"; //$NON-NLS-1$
	code= CodeFormatter.K_STATEMENTS;
	break;
	case ASTNode.PACKAGE_DECLARATION:
	case ASTNode.IMPORT_DECLARATION:
	suffix= "\nclass A {}"; //$NON-NLS-1$
	code= CodeFormatter.K_COMPILATION_UNIT;
	break;
	case ASTNode.JAVADOC:
	suffix= "void foo();"; //$NON-NLS-1$
	code= CodeFormatter.K_CLASS_BODY_DECLARATIONS;
	break;
	case ASTNode.CATCH_CLAUSE:
	prefix= "try {}"; //$NON-NLS-1$
	code= CodeFormatter.K_STATEMENTS;
	break;
	case ASTNode.ANONYMOUS_CLASS_DECLARATION:
	prefix= "new A()"; //$NON-NLS-1$
	suffix= ";"; //$NON-NLS-1$
	code= CodeFormatter.K_STATEMENTS;
	break;
	case ASTNode.MEMBER_VALUE_PAIR:
	prefix= "@Author("; //$NON-NLS-1$
	suffix= ") class x {}"; //$NON-NLS-1$
	code= CodeFormatter.K_COMPILATION_UNIT;
	break;
	case ASTNode.MODIFIER:
	suffix= " class x {}"; //$NON-NLS-1$
	code= CodeFormatter.K_COMPILATION_UNIT;
	break;
	case ASTNode.TYPE_PARAMETER:
	prefix= "class X<"; //$NON-NLS-1$
	suffix= "> {}"; //$NON-NLS-1$
	code= CodeFormatter.K_COMPILATION_UNIT;
	break;
	case ASTNode.MEMBER_REF:
	case ASTNode.METHOD_REF:
	case ASTNode.METHOD_REF_PARAMETER:
	case ASTNode.TAG_ELEMENT:
	case ASTNode.TEXT_ELEMENT:
	// Javadoc formatting not yet supported:
	return null;
	default:
	//Assert.isTrue(false, "Node type not covered: " + node.getClass().getName()); //$NON-NLS-1$
	return null;
	}
	}

	String concatStr= prefix + str + suffix;
	TextEdit edit= ToolFactory.createCodeFormatter(options).format(code, concatStr, prefix.length(), str.length(), indentationLevel, lineSeparator);
	if (prefix.length() > 0) {
	edit= shifEdit(edit, prefix.length());
	}
	return edit;
	}

	private static TextEdit shifEdit(TextEdit oldEdit, int diff) {
	TextEdit newEdit;
	if (oldEdit instanceof ReplaceEdit) {
	ReplaceEdit edit= (ReplaceEdit) oldEdit;
	newEdit= new ReplaceEdit(edit.getOffset() - diff, edit.getLength(), edit.getText());
	} else if (oldEdit instanceof InsertEdit) {
	InsertEdit edit= (InsertEdit) oldEdit;
	newEdit= new InsertEdit(edit.getOffset() - diff, edit.getText());
	} else if (oldEdit instanceof DeleteEdit) {
	DeleteEdit edit= (DeleteEdit) oldEdit;
	newEdit= new DeleteEdit(edit.getOffset() - diff, edit.getLength());
	} else if (oldEdit instanceof MultiTextEdit) {
	newEdit= new MultiTextEdit();
	} else {
	return null; // not supported
	}
	TextEdit[] children= oldEdit.getChildren();
	for (int i= 0; i < children.length; i++) {
	TextEdit shifted= shifEdit(children[i], diff);
	if (shifted != null) {
	newEdit.addChild(shifted);
	}
	}
	return newEdit;
	}

	private static Document createDocument(String string, Position[] positions) throws IllegalArgumentException {
	Document doc= new Document(string);
	try {
	if (positions != null) {
	final String POS_CATEGORY= "myCategory"; //$NON-NLS-1$

	doc.addPositionCategory(POS_CATEGORY);
	doc.addPositionUpdater(new DefaultPositionUpdater(POS_CATEGORY) {
	protected boolean notDeleted() {
	if (fOffset < fPosition.offset && (fPosition.offset + fPosition.length < fOffset + fLength)) {
	fPosition.offset= fOffset + fLength; // deleted positions: set to end of remove
	return false;
	}
	return true;
	}
	});
	for (int i= 0; i < positions.length; i++) {
	try {
	doc.addPosition(POS_CATEGORY, positions[i]);
	} catch (BadLocationException e) {
	throw new IllegalArgumentException("Position outside of string. offset: " + positions[i].offset + ", length: " + positions[i].length + ", string size: " + string.length()); //$NON-NLS-1$//$NON-NLS-2$//$NON-NLS-3$
	}
	}
	}
	} catch (BadPositionCategoryException cannotHappen) {
	// can not happen: category is correctly set up
	}
	return doc;
	}

	}