Где описывается свойство / задача <first>?

Question

Методом проб и ошибок я получил приведенный ниже пример ANT. Похоже, что <first> - это что-то, выполняемое перед вызовом любой цели. Например, $ {foundSrcFiles} может использоваться в (любой) цели с отображением найденных файлов. Просто я нигде не нашел этого документа. Кто-нибудь ссылку на описание ???

<project basedir="./example4" default="fourthTarget">
    <property name="dir.src">src</property>
    <first id="foundAnyJavaFile">
        <!-- but things you can do here are limited. -->
        <!-- property name="dir.classes"> doesn't e.g. work... -->
        <fileset dir="${dir.src}" includes="**/*.java"/>
    </first>
    <property name="foundSrcFiles" refid="foundAnyJavaFile"/>
    ...
</project>

Answer 1

first - это тип коллекции ресурсов в Ant. Он берет другую вложенную коллекцию ресурсов и выбирает первые X-ресурсы, которые он содержит. Когда X не указан с атрибутом count, он просто берет единственный первый ресурс.

Это не имеет никакого отношения к порядку, в котором все выполняется в вашем скрипте сборки. Любые задачи, которые существуют за пределами целей (т. Е. На уровне проекта root), будут выполняться последовательно перед вызовом каких-либо целей. В опубликованном примере сначала будет определено свойство "dir.sr c", затем коллекция ресурсов first будет определена с помощью id "foundAnyJavaFile", и, наконец, свойство "foundSrcFiles" будет определено с помощью ссылка "foundAnyJavaFile".

Эта коллекция ресурсов задокументирована здесь: https://ant.apache.org/manual/Types/resources.html#first