antliscence/proposal/anteater/source/main/org/apache/ant/Ant.java

// -------------------------------------------------------------------------------
// Copyright (c)2000 Apache Software Foundation
// -------------------------------------------------------------------------------

package org.apache.ant;

import java.io.*;
import java.util.*;
import java.util.zip.*;

/**
 * Central class of Ant. This is the core 'kernel' of ant. Interfaces into
 * ant talk to Ant through this class.
 *
 * @author James Duncan Davidson (duncan@apache.org)
 */
public class Ant {
    
    // -----------------------------------------------------------------
    // PRIVATE DATA MEMBERS
    // -----------------------------------------------------------------
    
    /**
     *
     */
    private File buildfile;
    
    /**
     * The front end running this.
     */
    private AntFrontEnd frontEnd;
    
    /**
     * Manager of tasks.
     */
    private TaskManager taskManager = new TaskManager();

    /**
     *
     */
    private Project project;
    
    // -----------------------------------------------------------------
    // CONSTRUCTORS
    // -----------------------------------------------------------------
    
    /**
     * Constructs a new Ant instance.
     */
    public Ant(AntFrontEnd frontEnd) {
        this.frontEnd = frontEnd;
        setUpTaskPath();
    }
    
    // -----------------------------------------------------------------
    // PUBLIC METHODS
    // ----------------------------------------------------------------- 
    
    /**
     * Sets additional path nodes onto the task lookup path. 
     */   
    public void addTaskPathNode(File node) {
        taskManager.addTaskPathNode(node);
    }
    
    /**
     * Builds a target.
     */
    public void buildTarget(String targetName) throws AntException {
        
        // notify FrontEnd that we are starting a build on a project
        frontEnd.notifyProjectStart(project);
        
        Target target = project.getTarget(targetName);
        
        frontEnd.notifyTargetStart(target);
        
        // XXX don't forget to execute dependancies first!
        
        Enumeration enum = target.getTasks().elements();
        while (enum.hasMoreElements()) {
            Task task = (Task)enum.nextElement();
            frontEnd.notifyTaskStart(task);
            AbstractTask aTask = taskManager.getTaskInstance(task.getType());
            try {
                aTask.setProject(project);
                aTask.setAttributes(task.getAttributes());
                boolean b = aTask.execute();
                if (!b) {
                    throw new AntException("STOP: Task " + task + 
                                            " did not succeed");
                }
            } catch (Exception e) {
                // XXX yes yes yes, this shouldn't be a catch all...
                throw new AntException("ERR: " + e);
            }
            frontEnd.notifyTaskEnd(task);
        }
        
        // notify frontEnd that we are done
        frontEnd.notifyTargetEnd(target);
        frontEnd.notifyProjectEnd(project);
    }
    
    /**
     *
     */
    public Project getProject() {
        return project;
    }
    
    /**
     * Sets the buildfile to be used. This action triggers a parse of
     * the build file and assembles a Project object from it.
     */
    public void setBuildfile(File file) throws AntException {
        buildfile = file;
        ProjectBuilder builder = new ProjectBuilder();
        project = builder.buildFromFile(file); 
        project.setAnt(this);
        System.out.println("Loaded Project: " + project.getName());
        
        // XXX remove the dump after comfort level is reached
        
        System.out.println("Dump of Project:");
        Enumeration enum = project.getTargets();
        while (enum.hasMoreElements()) {
            Target target = (Target)enum.nextElement();
            System.out.println("    Target: " + target.getName());
            Enumeration enum2 = target.getTasks().elements();
            while (enum2.hasMoreElements()) {
                Task task = (Task)enum2.nextElement();
                System.out.println("        Task: " + task.getType());
                Enumeration enum3 = task.getAttributeNames();
                while (enum3.hasMoreElements()) {
                    String atName = (String)enum3.nextElement();
                    String atValue = task.getAttribute(atName);
                    System.out.println("            Att: " + atName + " = " + 
                                       atValue);
                }
            }
        }
    }
    
    // -----------------------------------------------------------------
    // PRIVATE METHODS
    // ----------------------------------------------------------------- 
    
    /**
     * Sets up the taskpath based on the currently running operating
     * system. In general, the ordering of the taskpath is: user directory,
     * system directory, and then installation. This allows users or
     * system admins to override or add tasks.
     */
    private void setUpTaskPath() {
        
        // 1st, add user's home dir.
        
        File f;
        
        String userHome = System.getProperty("user.home");
        
        // generic unix
        f = new File(userHome + ".ant", "tasks");
        if (f.exists() && f.isDirectory()) {
            taskManager.addTaskPathNode(f);
        }
        
        // macos x
        f = new File(userHome + "/Library/Ant", "Tasks");
        if (f.exists() && f.isDirectory()) {
            taskManager.addTaskPathNode(f);
        }
        
        // windows -- todo
        
        // 2nd, add system local dir.
        
        // generic unix
        f = new File("/usr/local/ant/tasks");
        if (f.exists() && f.isDirectory()) {
            taskManager.addTaskPathNode(f);
        }
        
        // macos x
        f = new File("/Library/Ant/Tasks");
        if (f.exists() && f.isDirectory()) {
            taskManager.addTaskPathNode(f);
        }
        
        // windows -- todo
        
        // 3rd, add installation local dir.
        
        //System.out.println("BASE: " + this.getClass().getResource("/"));
        
        // XXX ---- not really sure how the best way of getting this info is...
        // hafta think about it.
    }

}