package org.testng;


import org.testng.internal.ConstructorOrMethod;
import org.testng.xml.XmlTest;

import java.lang.reflect.Method;
import java.util.List;
import java.util.Map;
import java.util.concurrent.Callable;

Describes a TestNG annotated method and the instance on which it will be invoked.
This interface is not meant to be implemented by users.
/**
 * Describes a TestNG annotated method and the instance on which it will be invoked.
 *
 * This interface is not meant to be implemented by users.
 */
public interface ITestNGMethod extends Cloneable {

  
Returns:
The real class on which this method was declared
(can be different from getMethod().getDeclaringClass() if
the test method was defined in a superclass)./**
   * @return The real class on which this method was declared
   * (can be different from getMethod().getDeclaringClass() if
   * the test method was defined in a superclass).
   */
  Class getRealClass();

  ITestClass getTestClass();

  
Sets the test class having this method. This is not necessarily the declaring class.
Params:
cls – The test class having this method./**
   * Sets the test class having this method. This is not necessarily the declaring class.
   *
   * @param cls The test class having this method.
   */
  void setTestClass(ITestClass cls);

  
Returns:
the corresponding Java test method.
Deprecated:
This method is deprecated and can now return null. Use
getConstructorOrMethod() instead./**
   * @return the corresponding Java test method.
   * @deprecated This method is deprecated and can now return null. Use
   * getConstructorOrMethod() instead.
   */
  @Deprecated
  Method getMethod();

  
Returns the method name. This is needed for serialization because
methods are not Serializable.
Returns:
the method name./**
   * Returns the method name. This is needed for serialization because
   * methods are not Serializable.
   * @return the method name.
   */
  String getMethodName();

  
Returns:
All the instances the methods will be invoked upon.
This will typically be an array of one object in the absence
of an @Factory annotation.
Deprecated:
Use getInstance()./**
   * @return All the instances the methods will be invoked upon.
   * This will typically be an array of one object in the absence
   * of an @Factory annotation.
   *
   * @deprecated Use getInstance().
   */
  @Deprecated
  Object[] getInstances();

  Object getInstance();

  
Needed for serialization.
/**
   * Needed for serialization.
   */
  long[] getInstanceHashCodes();

  
Returns:
The groups this method belongs to, possibly added to the groups
declared on the class./**
   * @return The groups this method belongs to, possibly added to the groups
   * declared on the class.
   */
  String[] getGroups();

  
Returns:
The groups this method depends on, possibly added to the groups
declared on the class./**
   * @return The groups this method depends on, possibly added to the groups
   * declared on the class.
   */
  String[] getGroupsDependedUpon();

  
If a group was not found.
/**
   * If a group was not found.
   */
  String getMissingGroup();
  void setMissingGroup(String group);

  
Before and After groups
/**
   * Before and After groups
   */
  String[] getBeforeGroups();
  String[] getAfterGroups();

  
Returns:
The methods  this method depends on, possibly added to the methods
declared on the class./**
   * @return The methods  this method depends on, possibly added to the methods
   * declared on the class.
   */
  String[] getMethodsDependedUpon();
  void addMethodDependedUpon(String methodName);

  
Returns:
true if this method was annotated with @Test/**
   * @return true if this method was annotated with @Test
   */
  boolean isTest();

  
Returns:
true if this method was annotated with @Configuration
and beforeTestMethod = true/**
   * @return true if this method was annotated with @Configuration
   * and beforeTestMethod = true
   */
  boolean isBeforeMethodConfiguration();

  
Returns:
true if this method was annotated with @Configuration
and beforeTestMethod = false/**
   * @return true if this method was annotated with @Configuration
   * and beforeTestMethod = false
   */
  boolean isAfterMethodConfiguration();

  
Returns:
true if this method was annotated with @Configuration
and beforeClassMethod = true/**
   * @return true if this method was annotated with @Configuration
   * and beforeClassMethod = true
   */
  boolean isBeforeClassConfiguration();

  
Returns:
true if this method was annotated with @Configuration
and beforeClassMethod = false/**
   * @return true if this method was annotated with @Configuration
   * and beforeClassMethod = false
   */
  boolean isAfterClassConfiguration();

  
Returns:
true if this method was annotated with @Configuration
and beforeSuite = true/**
   * @return true if this method was annotated with @Configuration
   * and beforeSuite = true
   */
  boolean isBeforeSuiteConfiguration();

  
Returns:
true if this method was annotated with @Configuration
and afterSuite = true/**
   * @return true if this method was annotated with @Configuration
   * and afterSuite = true
   */
  boolean isAfterSuiteConfiguration();

  
Returns:
true if this method is a @BeforeTest (@Configuration beforeTest=true)/**
   * @return <tt>true</tt> if this method is a @BeforeTest (@Configuration beforeTest=true)
   */
  boolean isBeforeTestConfiguration();

  
Returns:
true if this method is an @AfterTest (@Configuration afterTest=true)/**
   * @return <tt>true</tt> if this method is an @AfterTest (@Configuration afterTest=true)
   */
  boolean isAfterTestConfiguration();

  boolean isBeforeGroupsConfiguration();

  boolean isAfterGroupsConfiguration();

  
Returns:
The timeout in milliseconds./**
   * @return The timeout in milliseconds.
   */
  long getTimeOut();
  void setTimeOut(long timeOut);

  
Returns:
the number of times this method needs to be invoked./**
   * @return the number of times this method needs to be invoked.
   */
  int getInvocationCount();
  void setInvocationCount(int count);

  
Deprecated:
Will always return 0
Returns:
0/**
   * @deprecated Will always return 0
   * @return 0
   */
  @Deprecated
  int getTotalInvocationCount();

  
Returns:
the success percentage for this method (between 0 and 100)./**
   * @return the success percentage for this method (between 0 and 100).
   */
  int getSuccessPercentage();

  
Returns:
The id of the thread this method was run in./**
   * @return The id of the thread this method was run in.
   */
  String getId();

  void setId(String id);

  long getDate();

  void setDate(long date);

  
Returns if this ITestNGMethod can be invoked from within IClass.
/**
   * Returns if this ITestNGMethod can be invoked from within IClass.
   */
  boolean canRunFromClass(IClass testClass);

  
Returns:
true if this method is alwaysRun=true/**
   * @return true if this method is alwaysRun=true
   */
  boolean isAlwaysRun();

  
Returns:
the number of threads to be used when invoking the method on parallel/**
   * @return the number of threads to be used when invoking the method on parallel
   */
  int getThreadPoolSize();

  void setThreadPoolSize(int threadPoolSize);

  boolean getEnabled();

  String getDescription();
  void setDescription(String description);

  void incrementCurrentInvocationCount();
  int getCurrentInvocationCount();
  void setParameterInvocationCount(int n);
  int getParameterInvocationCount();
  void setMoreInvocationChecker(Callable<Boolean> moreInvocationChecker);
  boolean hasMoreInvocation();

  ITestNGMethod clone();

  IRetryAnalyzer getRetryAnalyzer();
  void setRetryAnalyzer(IRetryAnalyzer retryAnalyzer);

  boolean skipFailedInvocations();
  void setSkipFailedInvocations(boolean skip);

  
The time under which all invocationCount methods need to complete by.
/**
   * The time under which all invocationCount methods need to complete by.
   */
  long getInvocationTimeOut();

  boolean ignoreMissingDependencies();
  void setIgnoreMissingDependencies(boolean ignore);

  
Which invocation numbers of this method should be used (only applicable
if it uses a data provider). If this value is an empty list, use all the values
returned from the data provider.  These values are read from the XML file in
the  tag.
/**
   * Which invocation numbers of this method should be used (only applicable
   * if it uses a data provider). If this value is an empty list, use all the values
   * returned from the data provider.  These values are read from the XML file in
   * the <include invocationNumbers="..."> tag.
   */
  List<Integer> getInvocationNumbers();
  void setInvocationNumbers(List<Integer> numbers);

  
The list of invocation numbers that failed, which is only applicable for
methods that have a data provider.
/**
   * The list of invocation numbers that failed, which is only applicable for
   * methods that have a data provider.
   */
  void addFailedInvocationNumber(int number);
  List<Integer> getFailedInvocationNumbers();

  
The scheduling priority. Lower priorities get scheduled first.
/**
   * The scheduling priority. Lower priorities get scheduled first.
   */
  int getPriority();
  void setPriority(int priority);

  
Returns:
the XmlTest this method belongs to./**
   * @return the XmlTest this method belongs to.
   */
  XmlTest getXmlTest();

  ConstructorOrMethod getConstructorOrMethod();

  
Params:
test – 
Returns:
the parameters found in the include tag, if any/**
   * @return the parameters found in the include tag, if any
   * @param test
   */
  Map<String, String> findMethodParameters(XmlTest test);
  
  
getRealClass().getName() + "." +  getMethodName()
Returns:
qualified name for this method/**
   * getRealClass().getName() + "." +  getMethodName()
   * @return qualified name for this method
   */
  String getQualifiedName();
}