Class ResourceList

  • All Implemented Interfaces:
    java.lang.Cloneable, java.lang.Iterable<Resource>, ResourceCollection

    public class ResourceList
    extends DataType
    implements ResourceCollection
    Reads a resource as text document and creates a resource for each line.
    Since:
    Ant 1.8.0
    • Constructor Detail

      • ResourceList

        public ResourceList()
    • Method Detail

      • add

        public void add​(ResourceCollection rc)
        Adds a source.
        Parameters:
        rc - ResourceCollection
      • addFilterChain

        public final void addFilterChain​(FilterChain filter)
        Adds a FilterChain.
        Parameters:
        filter - FilterChain
      • setBasedir

        public final void setBasedir​(java.io.File baseDir)
        Basedir to use for file resources read from nested resources - this allows the resources contained inside this collection to be considered relative to a certain base directory.
        Parameters:
        baseDir - the basedir
        Since:
        Ant 1.10.4
      • setPreserveDuplicates

        public final void setPreserveDuplicates​(boolean preserveDuplicates)
        Makes this resourcelist return all resources as many times as they are specified. Otherwise resourcelist will only return each resource, in the order they first appear.
        Parameters:
        preserveDuplicates - boolean
        Since:
        Ant 1.10.10
      • iterator

        public final java.util.Iterator<Resource> iterator()
        Fulfill the ResourceCollection contract. The Iterator returned will throw ConcurrentModificationExceptions if ResourceCollections are added to this container while the Iterator is in use.
        Specified by:
        iterator in interface java.lang.Iterable<Resource>
        Returns:
        a "fail-fast" Iterator.
      • size

        public int size()
        Fulfill the ResourceCollection contract.
        Specified by:
        size in interface ResourceCollection
        Returns:
        number of elements as int.
      • isFilesystemOnly

        public boolean isFilesystemOnly()
        Fulfill the ResourceCollection contract.
        Specified by:
        isFilesystemOnly in interface ResourceCollection
        Returns:
        whether this is a filesystem-only resource collection.
      • dieOnCircularReference

        protected void dieOnCircularReference​(java.util.Stack<java.lang.Object> stk,
                                              Project p)
                                       throws BuildException
        Overrides the version of DataType to recurse on all DataType child elements that may have been added.
        Overrides:
        dieOnCircularReference in class DataType
        Parameters:
        stk - the stack of data types to use (recursively).
        p - the project to use to dereference the references.
        Throws:
        BuildException - on error.