Modify code according suggestion from code review meeting.

[mirror_edk2.git] / Tools / Source / FrameworkTasks / org / tianocore / framework / tasks / MakeDeps.java

/** @file\r
This file is to wrap MakeDeps.exe tool as ANT task, which is used to generate\r
dependency files for source code.\r
\r
Copyright (c) 2006, Intel Corporation\r
All rights reserved. This program and the accompanying materials\r
are licensed and made available under the terms and conditions of the BSD License\r
which accompanies this distribution.  The full text of the license may be found at\r
http://opensource.org/licenses/bsd-license.php\r
\r
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
\r
**/\r
package org.tianocore.framework.tasks;\r
\r
import java.io.File;\r
import java.io.FileReader;\r
import java.io.FileWriter;\r
import java.io.IOException;\r
import java.io.LineNumberReader;\r
import java.util.ArrayList;\r
import java.util.HashSet;\r
import java.util.Iterator;\r
import java.util.List;\r
import java.util.Set;\r
import java.util.StringTokenizer;\r
\r
import org.apache.tools.ant.BuildException;\r
import org.apache.tools.ant.Project;\r
import org.apache.tools.ant.Task;\r
import org.apache.tools.ant.taskdefs.Execute;\r
import org.apache.tools.ant.taskdefs.LogStreamHandler;\r
import org.apache.tools.ant.types.Commandline;\r
import org.apache.tools.ant.types.Path;\r
\r
import org.tianocore.common.logger.EdkLog;\r
\r
/**\r
 Class MakeDeps is used to wrap MakeDeps.exe as an ANT task.\r
 **/\r
public class MakeDeps extends Task {\r
\r
    //\r
    // private members, use set/get to access them\r
    //\r
    private static final String cmdName = "MakeDeps";\r
    private String              includePath = null;\r
    private String              depsFile = null;\r
    private String              subDir = null;\r
    private boolean             quietMode = true;\r
    private boolean             ignoreError = true;\r
    private String              extraDeps = "";\r
    private List<IncludePath>   includePathList = new ArrayList<IncludePath>();\r
    private List<Input>         inputFileList = new ArrayList<Input>();\r
\r
    public MakeDeps() {\r
\r
    }\r
\r
    /**\r
     The Standard execute method for ANT task. It will check if it's necessary\r
     to generate the dependency list file. If no file is found or the dependency\r
     is changed, it will compose the command line and call MakeDeps.exe to\r
     generate the dependency list file.\r
\r
     @throws    BuildException\r
     **/\r
    public void execute() throws BuildException {\r
        ///\r
        /// check if the dependency list file is uptodate or not\r
        ///\r
        if (isUptodate()) {\r
            return;\r
        }\r
\r
        Project prj  = this.getOwningTarget().getProject();\r
        String  toolPath = prj.getProperty("env.FRAMEWORK_TOOLS_PATH");\r
        FrameworkLogger logger = new FrameworkLogger(prj, "makedeps");\r
        EdkLog.setLogLevel(prj.getProperty("env.LOGLEVEL"));\r
        EdkLog.setLogger(logger);\r
\r
        ///\r
        /// compose full tool path\r
        ///\r
        if (toolPath == null || toolPath.length() == 0) {\r
            toolPath = "./" + cmdName;\r
        } else {\r
            if (toolPath.endsWith("/") || toolPath.endsWith("\\")) {\r
                toolPath = toolPath + cmdName;\r
            } else {\r
                toolPath = toolPath + "/" + cmdName;\r
            }\r
        }\r
\r
        ///\r
        /// compose tool arguments\r
        ///\r
        StringBuffer args = new StringBuffer(4096);\r
        if (ignoreError) {\r
            args.append(" -ignorenotfound");\r
        }\r
        if (quietMode) {\r
            args.append(" -q");\r
        }\r
        if (subDir != null && subDir.length() > 0) {\r
            args.append(" -s ");\r
            args.append(subDir);\r
        }\r
\r
        ///\r
        /// if there's no source files, we can do nothing about dependency\r
        ///\r
        if (inputFileList.size() == 0) {\r
            throw new BuildException("No source files specified to scan");\r
        }\r
\r
        ///\r
        /// compose source file arguments\r
        ///\r
        Iterator iterator = inputFileList.iterator();\r
        while (iterator.hasNext()) {\r
            Input inputFile = (Input)iterator.next();\r
            String inputFileString = cleanupPathName(inputFile.getFile());\r
            args.append(" -f ");\r
            args.append(inputFileString);\r
        }\r
\r
        ///\r
        /// compose search pathes argument\r
        ///\r
        StringBuffer includePathArg = new StringBuffer(4096);\r
        if (includePath != null && includePath.length() > 0) {\r
            StringTokenizer pathTokens = new StringTokenizer(includePath, ";");\r
            while (pathTokens.hasMoreTokens()) {\r
                String tmpPath = pathTokens.nextToken().trim();\r
                if (tmpPath.length() == 0) {\r
                    continue;\r
                }\r
\r
                includePathArg.append(" -i ");\r
                includePathArg.append(cleanupPathName(tmpPath));\r
            }\r
        }\r
        iterator = includePathList.iterator();\r
        while (iterator.hasNext()) {\r
            IncludePath path = (IncludePath)iterator.next();\r
            includePathArg.append(cleanupPathName(path.getPath()));\r
        }\r
        args.append(includePathArg);\r
\r
        ///\r
        /// We don't need a real target. So just a "dummy" is given\r
        ///\r
        args.append(" -target dummy");\r
        args.append(" -o ");\r
        args.append(cleanupPathName(depsFile));\r
\r
        ///\r
        /// prepare to execute the tool\r
        ///\r
        Commandline cmd = new Commandline();\r
        cmd.setExecutable(toolPath);\r
        cmd.createArgument().setLine(args.toString());\r
\r
        LogStreamHandler streamHandler = new LogStreamHandler(this, Project.MSG_INFO, Project.MSG_WARN);\r
        Execute runner = new Execute(streamHandler, null);\r
\r
        runner.setAntRun(prj);\r
        runner.setCommandline(cmd.getCommandline());\r
\r
        EdkLog.log(EdkLog.EDK_VERBOSE, Commandline.toString(cmd.getCommandline()));\r
\r
        int result = 0;\r
        try {\r
            result = runner.execute();\r
        } catch (IOException e) {\r
            throw new BuildException(e.getMessage());\r
        }\r
\r
        if (result != 0) {\r
            EdkLog.log(EdkLog.EDK_INFO, "MakeDeps failed!");\r
            return;\r
        }\r
    }\r
\r
    ///\r
    /// Remove any duplicated path separator or inconsistent path separator\r
    ///\r
    private String cleanupPathName(String path) {\r
        String separator = "\\" + File.separator;\r
        String duplicateSeparator = separator + "{2}";\r
        path = Path.translateFile(path);\r
        path = path.replaceAll(duplicateSeparator, separator);\r
        return path;\r
    }\r
\r
    /**\r
     Set method for "DepsFile" attribute\r
\r
     @param     name    The name of dependency list file\r
     **/\r
    public void setDepsFile(String name) {\r
        depsFile = cleanupPathName(name);\r
    }\r
\r
    /**\r
     Get method for "DepsFile" attribute\r
\r
     @returns   The name of dependency list file\r
     **/\r
    public String getDepsFile() {\r
        return depsFile;\r
    }\r
\r
    /**\r
     Set method for "IgnoreError" attribute\r
\r
     @param     ignore    flag to control error handling (true/false)\r
     **/\r
    public void setIgnoreError(boolean ignore) {\r
        ignoreError = ignore;\r
    }\r
\r
    /**\r
     Get method for "IgnoreError" attribute\r
\r
     @returns   The value of current IgnoreError flag\r
     **/\r
    public boolean getIgnoreError() {\r
        return ignoreError;\r
    }\r
\r
    /**\r
     Set method for "QuietMode" attribute\r
\r
     @param     quiet   flag to control the output information (true/false)\r
     **/\r
    public void setQuietMode(boolean quiet) {\r
        quietMode = quiet;\r
    }\r
\r
    /**\r
     Get method for "QuietMode" attribute\r
\r
     @returns   value of current QuietMode flag\r
     **/\r
    public boolean getQuietMode() {\r
        return quietMode;\r
    }\r
\r
    /**\r
     Set method for "SubDir" attribute\r
\r
     @param     dir     The name of sub-directory in which source files will be scanned\r
     **/\r
    public void setSubDir(String dir) {\r
        subDir = dir;\r
    }\r
\r
    /**\r
     Get method for "SubDir" attribute\r
\r
     @returns   The name of sub-directory\r
     **/\r
    public String getSubDir() {\r
        return subDir;\r
    }\r
\r
    /**\r
     Set method for "IncludePath" attribute\r
\r
     @param     path    The name of include path\r
     **/\r
    public void setIncludePath(String path) {\r
        includePath = cleanupPathName(path);\r
    }\r
\r
    /**\r
     Get method for "IncludePath" attribute\r
\r
     @returns   The name of include path\r
     **/\r
    public String getIncludePath() {\r
        return includePath;\r
    }\r
\r
    /**\r
     Set method for "ExtraDeps" attribute\r
\r
     @param     deps    The name of dependency file specified separately\r
     **/\r
    public void setExtraDeps(String deps) {\r
        extraDeps = deps;\r
    }\r
\r
    /**\r
     Get method for "ExtraDeps" attribute\r
\r
     @returns   The name of dependency file specified separately\r
     **/\r
    public String getExtraDeps () {\r
        return extraDeps;\r
    }\r
\r
    /**\r
     Add method for "IncludePath" nested element\r
\r
     @param     path    The IncludePath object from nested IncludePath type of element\r
     **/\r
    public void addIncludepath(IncludePath path) {\r
        includePathList.add(path);\r
    }\r
\r
    /**\r
     Add method for "Input" nested element\r
\r
     @param     input   The Input object from nested Input type of element\r
     **/\r
    public void addInput(Input inputFile) {\r
        inputFileList.add(inputFile);\r
    }\r
\r
    /**\r
     Check if the dependency list file should be (re-)generated or not.\r
\r
     @returns   true    The dependency list file is uptodate. No re-generation is needed.\r
     @returns   false   The dependency list file is outofdate. Re-generation is needed.\r
     **/\r
    private boolean isUptodate() {\r
        File df = new File(depsFile);\r
        if (!df.exists()) {\r
            return false;\r
        }\r
\r
        ///\r
        /// If the source file(s) is newer than dependency list file, we need to\r
        /// re-generate the dependency list file\r
        ///\r
        long depsFileTimeStamp = df.lastModified();\r
        Iterator iterator = inputFileList.iterator();\r
        while (iterator.hasNext()) {\r
            Input inputFile = (Input)iterator.next();\r
            File sf = new File(inputFile.getFile());\r
            if (sf.lastModified() > depsFileTimeStamp) {\r
                return false;\r
            }\r
        }\r
\r
        ///\r
        /// If the source files haven't been changed since last time the dependency\r
        /// list file was generated, we need to check each file in the file list to\r
        /// see if any of them is changed or not. If anyone of them is newer than\r
        /// the dependency list file, MakeDeps.exe is needed to run again.\r
        ///\r
        LineNumberReader    lineReader = null;\r
        FileReader          fileReader = null;\r
        boolean             ret = true;\r
        try {\r
            fileReader = new FileReader(df);\r
            lineReader = new LineNumberReader(fileReader);\r
\r
            String line = null;\r
            while ((line = lineReader.readLine()) != null) {\r
                File sourceFile = new File(line);\r
                //\r
                // If a file cannot be found (moved or removed) or newer, regenerate the dep file\r
                // \r
                if ((!sourceFile.exists()) || (sourceFile.lastModified() > depsFileTimeStamp)) {\r
                    ret = false;\r
                    break;\r
                }\r
            }\r
            lineReader.close();\r
            fileReader.close();\r
        } catch (IOException e) {\r
            log (e.getMessage());\r
        }\r
\r
        return ret;\r
    }\r
}\r
\r