testelement.java

MoMEUnit是一个单元测试的J2ME的应用程序xUnit架构实例。这是来自JUnit框架

package org.momeunit.ant.taskdefs;

import momeunit.framework.Test;

import org.apache.tools.ant.Task;
import org.apache.tools.ant.types.FileSet;

/**
 * Interface that every nested tag, that describes test should implement.
 * Contains if/unless functionality.
 * 
 * @author Sergio Morozov
 * @version 1.1.2
 */
public interface TestElement
{
  /**
   * Default pattern. Allowes all classes to be putted in list of tests.
   * 
   * @since 1.1
   */
  public static final String DEFAULT_PATTERN = "**.*";

  /**
   * Returns pattern used to refine list of tests.
   * 
   * @return the pattern used to refine list of tests.
   * @since 1.1
   */
  public String getPattern();

  /**
   * Sets pattern used to refine list of tests.
   * 
   * @param patten
   *          pattern used to refine list of tests.
   * @since 1.1
   */
  public void setPattern(String patten);

  /**
   * Returns the type of files this test tag designates.
   * 
   * @return the type of files this test tag designates.
   * @since 1.1
   */
  public String getType();

  /**
   * Returns fileset that designates classes to be scanned for inclusion in
   * tests list.
   * 
   * @return the fileset that designates classes to be scanned.
   * @since 1.1
   */
  public FileSet getFileSet();

  /**
   * Is this test tag allowed.
   * 
   * @param task
   *          owning task.
   * @return <code>true</code> if this test tag is allowed, <code>false</code>
   *         otherwise.
   * @since 1.1
   */
  public boolean shouldUse(Task task);

  /**
   * Should classes designated by this test tag be tested for {@link Test}
   * interface implementation.
   * 
   * @return <code>true</code> if classes designated by this test tag should
   *         be tested for {@link Test} interface implementation,
   *         <code>false</code> otherwise.
   * @since 1.1
   */
  public boolean isOnlyTests();

  /**
   * Sets classes designated by this test tag to be tested for {@link Test}
   * interface implementation.
   * 
   * @param onlyTests
   *          <code>true</code> if classes designated by this test tag should
   *          be tested for {@link Test} interface implementation,
   *          <code>false</code> otherwise.
   * @since 1.1
   */
  public void setOnlyTests(boolean onlyTests);

  /**
   * Checks whether this test tag designates class files.
   * 
   * @return <code>true</code> if this test tag designates class files,
   *         <code>false</code> otherwise.
   * @since 1.1.2
   */
  public boolean containsClasses();
}