content: /*******************************************************************************
   * Copyright (c) 2007, 2008 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.wst.jsdt.internal.corext.refactoring.structure;
  
  import java.util.List;
  
  import org.eclipse.wst.jsdt.core.dom.Expression;
  import org.eclipse.wst.jsdt.core.dom.FunctionDeclaration;
  import org.eclipse.wst.jsdt.core.dom.Type;
  import org.eclipse.wst.jsdt.internal.corext.refactoring.ParameterInfo;
  
  public interface IDefaultValueAdvisor {
  
  	/**
  	 * Creates a default expression for an added parameter for a given method invocation.
  	 * 
  	 * @param invocationArguments arguments of the method invocation
  	 * @param addedInfo the added ParamterInfo object
  	 * @param parameterInfos all ParameterInfo objects, including the added ParameterInfo
  	 * @param enclosingMethod the Method that encloses the invocation. Can be null if there is no enclosing method
  	 * @param isRecursive true if called from a recursive invocation
  	 * @param cuRewrite the CompilationUnitRewrite to use for rewrite, imports etc..
  	 * @return a new Expression to be used as argument for the new parameter
  	 */
  	Expression createDefaultExpression(List/*<Expression>*/ invocationArguments, ParameterInfo addedInfo, List/*<ParameterInfo>*/ parameterInfos, FunctionDeclaration enclosingMethod, boolean isRecursive, CompilationUnitRewrite cuRewrite);
  
  	/**
  	 * Create a type for the added parameter.
  	 * 
  	 * @param newTypeName the fully qualified name of the type
  	 * @param startPosition the position where the type is defined in a compilation unit
  	 * @param cuRewrite the CompilationUnitRewrite to use for rewrite, imports etc..
  	 * @return the new type to be used in default expressions
  	 */
  	Type createType(String newTypeName, int startPosition, CompilationUnitRewrite cuRewrite);
  
  }
  