| career | drupal | java | mac | mysql | perl | scala | uml | unix  

Ant example source code file (

This example Ant source code file ( is included in the "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Java - Ant tags/keywords

basetest, batchtest, enumeration, enumeration, io, iterator, junittest, junittest, project, resource, resources, resources, string, string, util, vector

The source code

 *  Licensed to the Apache Software Foundation (ASF) under one or more
 *  contributor license agreements.  See the NOTICE file distributed with
 *  this work for additional information regarding copyright ownership.
 *  The ASF licenses this file to You under the Apache License, Version 2.0
 *  (the "License"); you may not use this file except in compliance with
 *  the License.  You may obtain a copy of the License at
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.


import java.util.Enumeration;
import java.util.Iterator;
import java.util.Vector;

 * <p> Create then run JUnitTest's based on the list of files
 *     given by the fileset attribute.
 * <p> Every .java or .class file in the fileset is
 * assumed to be a testcase.
 * A <code>JUnitTest is created for each of these named classes with
 * basic setup inherited from the parent <code>BatchTest.
 * @see JUnitTest
public final class BatchTest extends BaseTest {

    /** the reference to the project */
    private Project project;

    /** the list of filesets containing the testcase filename rules */
    private Resources resources = new Resources();

     * create a new batchtest instance
     * @param project     the project it depends on.
    public BatchTest(Project project) {
        this.project = project;

     * Add a new fileset instance to this batchtest. Whatever the fileset is,
     * only filename that are <tt>.java or .class will be
     * considered as 'candidates'.
     * @param     fs the new fileset containing the rules to get the testcases.
    public void addFileSet(FileSet fs) {

        // this one is here because the changes to support ResourceCollections
        // have broken Magic's JUnitTestTask.
        // The task adds a FileSet to a BatchTest instance using the
        // Java API and without telling the FileSet about its project
        // instance.  The original code would pass in project on the
        // call to getDirectoryScanner - which is now hidden deep into
        // Resources.iterator() and not reachable.
        if (fs.getProject() == null) {

     * Add a new ResourceCollection instance to this
     * batchtest. Whatever the collection is, only names that are
     * <tt>.java or .class will be considered as
     * 'candidates'.
     * @param rc the new ResourceCollection containing the rules to
     * get the testcases.
     * @since Ant 1.7
    public void add(ResourceCollection rc) {

     * Return all <tt>JUnitTest instances obtain by applying the fileset rules.
     * @return  an enumeration of all elements of this batchtest that are
     * a <tt>JUnitTest instance.
    public Enumeration elements() {
        JUnitTest[] tests = createAllJUnitTest();
        return Enumerations.fromArray(tests);

     * Convenient method to merge the <tt>JUnitTests of this batchtest
     * to a <tt>Vector.
     * @param v the vector to which should be added all individual tests of this
     * batch test.
    void addTestsTo(Vector v) {
        JUnitTest[] tests = createAllJUnitTest();
        v.ensureCapacity(v.size() + tests.length);
        for (int i = 0; i < tests.length; i++) {

     * Create all <tt>JUnitTests based on the filesets. Each instance
     * is configured to match this instance properties.
     * @return the array of all <tt>JUnitTests that belongs to this batch.
    private JUnitTest[] createAllJUnitTest() {
        String[] filenames = getFilenames();
        JUnitTest[] tests = new JUnitTest[filenames.length];
        for (int i = 0; i < tests.length; i++) {
            String classname = javaToClass(filenames[i]);
            tests[i] = createJUnitTest(classname);
        return tests;

     * Iterate over all filesets and return the filename of all files
     * that end with <tt>.java or .class. This is to avoid
     * wrapping a <tt>JUnitTest over an xml file for example. A Testcase
     * is obviously a java file (compiled or not).
     * @return an array of filenames without their extension. As they should
     * normally be taken from their root, filenames should match their fully
     * qualified class name (If it is not the case it will fail when running the test).
     * For the class <tt>org/apache/Whatever.class it will return org/apache/Whatever.
    private String[] getFilenames() {
        Vector v = new Vector();
        Iterator iter = resources.iterator();
        while (iter.hasNext()) {
            Resource r = (Resource);
            if (r.isExists()) {
                String pathname = r.getName();
                if (pathname.endsWith(".java")) {
                    v.addElement(pathname.substring(0, pathname.length() - ".java".length()));
                } else if (pathname.endsWith(".class")) {
                    v.addElement(pathname.substring(0, pathname.length() - ".class".length()));

        String[] files = new String[v.size()];
        return files;

     * Convenient method to convert a pathname without extension to a
     * fully qualified classname. For example <tt>org/apache/Whatever will
     * be converted to <tt>org.apache.Whatever
     * @param filename the filename to "convert" to a classname.
     * @return the classname matching the filename.
    public static String javaToClass(String filename) {
        return filename.replace(File.separatorChar, '.').replace('/', '.')
            .replace('\\', '.');

     * Create a <tt>JUnitTest that has the same property as this
     * <tt>BatchTest instance.
     * @param classname the name of the class that should be run as a
     * <tt>JUnitTest. It must be a fully qualified name.
     * @return the <tt>JUnitTest over the given classname.
    private JUnitTest createJUnitTest(String classname) {
        JUnitTest test = new JUnitTest();
        Enumeration list = this.formatters.elements();
        while (list.hasMoreElements()) {
            test.addFormatter((FormatterElement) list.nextElement());
        return test;


Other Ant examples (source code examples)

Here is a short list of links related to this Ant source code file:

... this post is sponsored by my books ...

#1 New Release!

FP Best Seller


new blog posts


Copyright 1998-2021 Alvin Alexander,
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.