ANT。覆盖属性。在单个目标中的可选执行

Question

我要发布一个问题，我已经看到其他地方的变体，但是我没有看到我提出的答案。我会随后发布我的答案。

为了使用宏模块化我的构建脚本，我想在同一个宏中同时包含updatetask和我想执行的任务（如果它不是最新的）。
如何做到这一点 - 使用脚本标记是好的 - 如果唯一传入的唯一属性是包含反斜杠的路径，并且我需要在不同的调用中将不同的值传递给脚本标记。我需要避免涉及反斜杠时可能发生的任何字符串文字问题。使用独特的属性，我需要解决ant不变属性行为，并解决通常使用2个目标来处理最新处理决策的蚂蚁模式，并需要解决字符串文字中反斜杠的JavaScript处理问题。

Answer 1

注意我正在使用ant 1.7。通过Ant 1.8中的本地范围，还有一些其他选项，以便不变性不是一个很大的挑战，但其中一些其他技巧仍然有帮助。

首先，关于根据宏中的uptodate结果选择执行任务的问题 - 这意味着您不需要2个目标。 为此，请使用条件标签。如果第一个条件失败，<或>标记将使其仅执行第二个条件。 <scriptcondition>标签允许使用JavaScript执行其他蚂蚁任务。下面是一个例子（@标签表示macrodef属性）：

<condition property="whatever" value="false"> 
    <or> 
    <uptodate> 
     <srcfiles dir="@{srcdir}" includes="@{srcincludes}" excludes="@{srcexcludes}"/> 
     <mapper><chainedmapper> 
     <flattenmapper/><!-- use any mappers you need to match source to target files--> 
     <globmapper from="*.jxw" to="@{targetdir}\*W.java"/> 
     </chainedmapper></mapper> 
    </uptodate> 
    <!-- w/ java 1.6 or later, you get a rhino javascript interpreter included w/ java--> 
    <scriptcondition language="javascript" value="true"> 
     self.setValue(true); 
     echo = project.createTask("echo"); 
     myArg1="@{myArg1}"; 
     myArg2="@{myArg2}"; 
     // need to create a reference from a classpath refid 
     myReference = new org.apache.tools.ant.types.Reference(project,"@{my.classpath.id.string}"); 
     // get a handle to the ant java task, which we will use to execute a java program 
     javaTask = project.createTask("java"); 
     javaTask.setFork(true); 
     javaTask.setFailonerror(true); 
     javaTask.setClassname("com.mycompany.mypackage.MySpecialClass"); 
     javaTask.setClasspathRef(myReference); 
     javaTask.createArg().setValue(myArg1); 
     javaTask.createArg().setValue(myArg2); 

     //output the command line to standard out, for reference 
     echo.setMessage(javaTask.getCommandLine()); 
     echo.perform(); 
     javaTask.perform(); 
    </scriptcondition> 
    </or> 
</condition> 

现在，如果你像我一样，你可能需要做一些处理与是你macrodef投入和产生可以参考一些派生值的属性在你的macrodef脚本中。如果您正在处理的是简单涉及属性和字符串的连接，那么您可以在块中这样做，如果您指定了属性，则应指定第二组属性，并使用包含连接步骤的默认设置。但是，如果您需要执行某些不能插入属性默认值的操作，则需要将其放入属性中。因为属性是不可变的，所以你需要采取一些额外的步骤来给你的属性赋予唯一的名字。 tstamp派上用场，帮助解决这个问题。通常，传递给您的宏的参数的某些组合将是唯一的，但是如果这种独特的组合包含反斜杠，则需要使用tstamp标签派生次要唯一标识符，以便在JavaScript中不会遇到反斜杠问题你想使用这些派生属性。以下是如何创建您可以在脚本中轻松引用的独特属性。

<macrodef name="public.macro.example"> 
    <attribute name="srcpath"/> 
    <sequential> 
     <tstamp prefix="@{srcpath}"><format pattern="ddhhmmssSSS" property="time"/></tstamp> 
     <private.macro.example srcpath="@{srcpath}" propertyPrefix="prop${@{srcpath}.time}"/> 
    </sequential> 
</macrodef> 

<macrodef name="private.macro.example"> 
    <attribute name="srcpath"/> 
    <attribute name="prefix"/> 
    <sequential> 
    <pathconvert property="@{prefix}.src"/> 
    <!-- now you can do special things with ${@{prefix}.src}, even in javascript --> 
    <script language="javascript"> 
     self.setValue(true); 
     echo = project.createTask("echo"); 
     myPrefix="@{prefix}"; 
     mySpecialPropertyKey=myPrefix+".src"; 
     //if your special property contains backslashes or other special js characters 
     // you need to use project.getProperty instead of a string literal to get the value 
     mySpecialPropertyVal=project.getProperty(mySpecialPropertyKey); 
     // do something with this derived value in javascript 
     echo.setMessage("my special property = "+mySpecialPropertyVal); 
     echo.perform(); 
    </script> 
    </sequential> 
</macrodef> 

我想出了上面的解决方案之前，我想出了溶液用新值覆盖蚂蚁财产黑客攻击的风格。虽然您可能会发现这适用于覆盖属性，因为我正在直接调用ant类，但在未来的ant版本中可能不会有相同的风险。因为这看起来更像是一种黑客行为，所以我的意图是尽可能使用上面列出的macrodef方法，而不是这种方法。请注意，此特定变体不支持反斜杠字符，因为这些属性是直接在JavaScript字符串文字中引用的。我最初使用这个简单的变体来创建我独特的前缀，这就避免了需要采用两个macrodef方法来解决财产不可变性问题。然而，您可以使用project.getProperty命令来调整此宏定义以使用第二个macrodef和唯一前缀以将“@ {value}”赋值给JavaScript。

<macrodef name="public.canova.setproperty"> 
    <attribute name="name"/> 
    <attribute name="value"/> 
    <sequential> 
    <script language="javascript"> 
     project.setUserProperty("@{name}","@{value}"); 
    </script> 
    <sequential> 
</macrodef> 

乍一看，一些本可能看起来有点复杂，但如果你做你macrodef工作的权利，并建立组件风格的宏（即不要把面条代码在宏），您的Ant脚本应实际上变得更短，更容易理解并且更容易维护，并且日志将更容易遵循。提示 - 只有在必要时才使用javascript，当您使用它时，最好在宏内使用它，以便将其封装并远离蚂蚁脚本的主要“逻辑”，从而有助于自我记录和可读性你的主要'逻辑'。当事情不明显时使用注释。