Class Resources

All Implemented Interfaces:
Cloneable, Iterable<Resource>, ResourceCollection, AppendableResourceCollection

public class Resources extends DataType implements AppendableResourceCollection
Generic ResourceCollection: Either stores nested ResourceCollections, making no attempt to remove duplicates, or references another ResourceCollection.
Since:
Ant 1.7
  • Field Details

    • NONE

      public static final ResourceCollection NONE
      static empty ResourceCollection
    • EMPTY_ITERATOR

      public static final Iterator<Resource> EMPTY_ITERATOR
      static empty Iterator
  • Constructor Details

    • Resources

      public Resources()
      Create a new Resources.
    • Resources

      public Resources(Project project)
      Create a new Resources.
      Parameters:
      project - Project
      Since:
      Ant 1.8
  • Method Details

    • setCache

      public void setCache(boolean b)
      Set whether to cache collections.
      Parameters:
      b - boolean cache flag.
      Since:
      Ant 1.8.0
    • add

      public void add(ResourceCollection c)
      Add a ResourceCollection.
      Specified by:
      add in interface AppendableResourceCollection
      Parameters:
      c - the ResourceCollection to add.
    • iterator

      public Iterator<Resource> iterator()
      Fulfill the ResourceCollection contract.
      Specified by:
      iterator in interface Iterable<Resource>
      Returns:
      an Iterator of Resources.
    • 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:
      true if all Resources represent files.
    • toString

      public String toString()
      Format this Resources as a String.
      Overrides:
      toString in class DataType
      Returns:
      a descriptive String.
    • dieOnCircularReference

      protected void dieOnCircularReference(Stack<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.
    • invalidateExistingIterators

      protected void invalidateExistingIterators()
      Allow subclasses to notify existing Iterators they have experienced concurrent modification.