The methods to get variables do not instantiate ArrayList each time, only one is...
[phpeclipse.git] / net.sourceforge.phpeclipse / src / net / sourceforge / phpdt / internal / compiler / ast / MethodDeclaration.java
index 5c3a64e..6934c07 100644 (file)
@@ -2,15 +2,20 @@ package net.sourceforge.phpdt.internal.compiler.ast;
 
 import net.sourceforge.phpdt.internal.compiler.parser.OutlineableWithChildren;
 import net.sourceforge.phpdt.internal.compiler.parser.Outlineable;
+import net.sourceforge.phpdt.internal.compiler.ast.declarations.VariableUsage;
 import net.sourceforge.phpdt.internal.ui.PHPUiImages;
+import net.sourceforge.phpeclipse.PHPeclipsePlugin;
 import org.eclipse.jface.resource.ImageDescriptor;
 import org.eclipse.jface.text.Position;
+import org.eclipse.core.runtime.CoreException;
 
 import java.util.Hashtable;
 import java.util.Enumeration;
 import java.util.ArrayList;
 import java.util.List;
 
+import test.PHPParserSuperclass;
+
 /**
  * A Method declaration.
  * @author Matthieu Casanova
@@ -18,7 +23,7 @@ import java.util.List;
 public class MethodDeclaration extends Statement implements OutlineableWithChildren {
 
   /** The name of the method. */
-  public char[] name;
+  public String name;
   public Hashtable arguments;
 
 
@@ -38,17 +43,21 @@ public class MethodDeclaration extends Statement implements OutlineableWithChild
 
   private Position position;
 
-  public MethodDeclaration(Object parent,
-                           char[] name,
-                           Hashtable arguments,
-                           boolean reference,
-                           int sourceStart,
-                           int sourceEnd) {
+  public MethodDeclaration(final Object parent,
+                           final String name,
+                           final Hashtable arguments,
+                           final boolean reference,
+                           final int sourceStart,
+                           final int sourceEnd,
+                           final int bodyStart,
+                           final int bodyEnd) {
     super(sourceStart, sourceEnd);
     this.name = name;
     this.arguments = arguments;
     this.parent = parent;
     this.reference = reference;
+    this.bodyStart = bodyStart;
+    this.bodyEnd = bodyEnd;
     position = new Position(sourceStart, sourceEnd);
   }
 
@@ -57,8 +66,8 @@ public class MethodDeclaration extends Statement implements OutlineableWithChild
    * @param tab the number of tabs
    * @return the String containing the method
    */
-  public String toString(int tab) {
-    StringBuffer buff = new StringBuffer(tabString(tab));
+  public String toString(final int tab) {
+    final StringBuffer buff = new StringBuffer(tabString(tab));
     buff.append(toStringHeader());
     buff.append(toStringStatements(tab + 1));
     return buff.toString();
@@ -73,8 +82,8 @@ public class MethodDeclaration extends Statement implements OutlineableWithChild
    * @param tab the number of tabs
    * @return the String containing the statements
    */
-  public String toStringStatements(int tab) {
-    StringBuffer buff = new StringBuffer(" {"); //$NON-NLS-1$
+  public String toStringStatements(final int tab) {
+    final StringBuffer buff = new StringBuffer(" {"); //$NON-NLS-1$
     if (statements != null) {
       for (int i = 0; i < statements.length; i++) {
         buff.append("\n").append(statements[i].toString(tab)); //$NON-NLS-1$
@@ -95,7 +104,7 @@ public class MethodDeclaration extends Statement implements OutlineableWithChild
     return PHPUiImages.DESC_FUN;
   }
 
-  public void setParent(Object parent) {
+  public void setParent(final Object parent) {
     this.parent = parent;
   }
 
@@ -103,11 +112,11 @@ public class MethodDeclaration extends Statement implements OutlineableWithChild
     return parent;
   }
 
-  public boolean add(Outlineable o) {
+  public boolean add(final Outlineable o) {
     return children.add(o);
   }
 
-  public Outlineable get(int index) {
+  public Outlineable get(final int index) {
     return (Outlineable) children.get(index);
   }
 
@@ -116,17 +125,17 @@ public class MethodDeclaration extends Statement implements OutlineableWithChild
   }
 
   public String toString() {
-    StringBuffer buff = new StringBuffer();
+    final StringBuffer buff = new StringBuffer();
     if (reference) {
       buff.append("&");//$NON-NLS-1$
     }
     buff.append(name).append("(");//$NON-NLS-1$
 
     if (arguments != null) {
-      Enumeration values = arguments.elements();
+      final Enumeration values = arguments.elements();
       int i = 0;
       while (values.hasMoreElements()) {
-        VariableDeclaration o = (VariableDeclaration) values.nextElement();
+        final VariableDeclaration o = (VariableDeclaration) values.nextElement();
         buff.append(o.toStringExpression());
         if (i != (arguments.size() - 1)) {
           buff.append(", "); //$NON-NLS-1$
@@ -145,4 +154,157 @@ public class MethodDeclaration extends Statement implements OutlineableWithChild
   public List getList() {
     return children;
   }
+
+  /** no outside variables. */
+  public void getOutsideVariable(final List list) {
+  }
+
+  public void getModifiedVariable(final List list) {
+  }
+
+  public void getUsedVariable(final List list) {
+  }
+
+  /**
+   * Get global variables (not parameters).
+   */
+  public void getGlobalVariable(final List list) {
+    if (statements != null) {
+      for (int i = 0; i < statements.length; i++) {
+        statements[i].getOutsideVariable(list);
+      }
+    }
+  }
+
+  private void getParameters(final List list) {
+    if (arguments != null) {
+      final Enumeration vars = arguments.elements();
+      while (vars.hasMoreElements()) {
+        final VariableDeclaration variable = (VariableDeclaration) vars.nextElement();
+        list.add(new VariableUsage(variable.name(), variable.sourceStart));
+      }
+    }
+  }
+
+  /**
+   * get the modified variables.
+   */
+  private void getAssignedVariableInCode(final List list) {
+    if (statements != null) {
+      for (int i = 0; i < statements.length; i++) {
+        statements[i].getModifiedVariable(list);
+      }
+    }
+  }
+
+  /**
+   * Get the variables used.
+   */
+  private void getUsedVariableInCode(final List list) {
+    if (statements != null) {
+      for (int i = 0; i < statements.length; i++) {
+        statements[i].getUsedVariable(list);
+      }
+    }
+  }
+
+  private boolean isVariableDeclaredBefore(final List list, final VariableUsage var) {
+    final String name = var.getName();
+    final int pos = var.getStartOffset();
+    for (int i = 0; i < list.size(); i++) {
+      final VariableUsage variableUsage = (VariableUsage) list.get(i);
+      if (variableUsage.getName().equals(name) && variableUsage.getStartOffset() < pos) {
+        return true;
+      }
+    }
+    return false;
+  }
+
+  /** This method will analyze the code. */
+  public void analyzeCode() {
+    if (statements != null) {
+      for (int i = 0; i < statements.length; i++) {
+        statements[i].analyzeCode();
+
+      }
+    }
+
+    final List globalsVars = new ArrayList();
+    getGlobalVariable(globalsVars);
+    final List modifiedVars = new ArrayList();
+    getAssignedVariableInCode(modifiedVars);
+    final List parameters = new ArrayList();
+    getParameters(parameters);
+
+    final List declaredVars = new ArrayList(globalsVars.size() + modifiedVars.size());
+    declaredVars.addAll(globalsVars);
+    declaredVars.addAll(modifiedVars);
+    declaredVars.addAll(parameters);
+
+    final List usedVars = new ArrayList();
+    getUsedVariableInCode(usedVars);
+    final List readOrWriteVars = new ArrayList(modifiedVars.size() + usedVars.size());
+    readOrWriteVars.addAll(modifiedVars);
+    readOrWriteVars.addAll(usedVars);
+
+    //look for used variables that were not declared before
+    findUnusedParameters(readOrWriteVars, parameters);
+    findUnknownUsedVars(usedVars, declaredVars);
+  }
+
+  /**
+   * This method will add a warning on all unused parameters.
+   * @param vars the used variable list
+   * @param parameters the declared variable list
+   */
+  private void findUnusedParameters(final List vars, final List parameters) {
+    for (int i = 0; i < parameters.size(); i++) {
+      final VariableUsage param = ((VariableUsage) parameters.get(i));
+      if (!isVariableInList(param.getName(), vars)) {
+        try {
+          PHPParserSuperclass.setMarker(
+                  "warning, the parameter " + param.getName() + " seems to be never used in your method",
+                  param.getStartOffset(),
+                  param.getStartOffset() + param.getName().length(),
+                  PHPParserSuperclass.WARNING,
+                  "");
+        } catch (CoreException e) {
+          PHPeclipsePlugin.log(e);
+        }
+      }
+    }
+  }
+
+  private boolean isVariableInList(final String name, final List list) {
+    for (int i = 0; i < list.size(); i++) {
+      if (((VariableUsage) list.get(i)).getName().equals(name)) {
+        return true;
+      }
+    }
+    return false;
+  }
+
+  /**
+   * This method will add a warning on all used variables in a method that aren't declared before.
+   * @param usedVars the used variable list
+   * @param declaredVars the declared variable list
+   */
+  private void findUnknownUsedVars(final List usedVars, final List declaredVars) {
+    for (int i = 0; i < usedVars.size(); i++) {
+      final VariableUsage variableUsage = (VariableUsage) usedVars.get(i);
+      if (variableUsage.getName().equals("this")) continue; // this is a special variable
+      if (!isVariableDeclaredBefore(declaredVars, variableUsage)) {
+        try {
+          PHPParserSuperclass.setMarker(
+                  "warning, usage of a variable that seems to be unassigned yet : " + variableUsage.getName(),
+                  variableUsage.getStartOffset(),
+                  variableUsage.getStartOffset() + variableUsage.getName().length(),
+                  PHPParserSuperclass.WARNING,
+                  "");
+        } catch (CoreException e) {
+          PHPeclipsePlugin.log(e);
+        }
+      }
+    }
+  }
 }