Package org.apache.tools.ant.types

Class FilterSet

java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.types.DataType
org.apache.tools.ant.types.FilterSet
All Implemented Interfaces:
java.lang.Cloneable
public class FilterSet
extends DataType
implements java.lang.Cloneable
A set of filters to be applied to something. A filter set may have begintoken and endtokens defined.

  • Field Details

  • Constructor Details

    • FilterSet

      public FilterSet()
      Default constructor.

    • FilterSet

      protected FilterSet​(FilterSet filterset)
      Create a Filterset from another filterset.
      Parameters:
      filterset - the filterset upon which this filterset will be based.

  • Method Details

    • getFilters

      protected java.util.Vector<FilterSet.Filter> getFilters()
      Get the filters in the filter set.
      Returns:
      a Vector of Filter instances.

    • getRef

      protected FilterSet getRef()
      Get the referenced filter set.
      Returns:
      the filterset from the reference.

    • getFilterHash

      public java.util.Hashtable<java.lang.String,​java.lang.String> getFilterHash()
      Gets the filter hash of the FilterSet.
      Returns:
      The hash of the tokens and values for quick lookup.

    • setFiltersfile

      public void setFiltersfile​(java.io.File filtersFile) throws BuildException
      Set the file containing the filters for this filterset.
      Parameters:
      filtersFile - sets the filter file from which to read filters for this filter set.
      Throws:
      BuildException - if there is an error.

    • setBeginToken

      public void setBeginToken​(java.lang.String startOfToken)
      Set the string used to id the beginning of a token.
      Parameters:
      startOfToken - The new Begintoken value.

    • getBeginToken

      public java.lang.String getBeginToken()
      Get the begin token for this filterset.
      Returns:
      the filter set's begin token for filtering.

    • setEndToken

      public void setEndToken​(java.lang.String endOfToken)
      Set the string used to id the end of a token.
      Parameters:
      endOfToken - The new Endtoken value.

    • getEndToken

      public java.lang.String getEndToken()
      Get the end token for this filterset.
      Returns:
      the filter set's end token for replacement delimiting.

    • setRecurse

      public void setRecurse​(boolean recurse)
      Set whether recursive token expansion is enabled.
      Parameters:
      recurse - boolean whether to recurse.

    • isRecurse

      public boolean isRecurse()
      Get whether recursive token expansion is enabled.
      Returns:
      boolean whether enabled.

    • readFiltersFromFile

      public void readFiltersFromFile​(java.io.File filtersFile) throws BuildException
      Read the filters from the given file.
      Parameters:
      filtersFile - the file from which filters are read.
      Throws:
      BuildException - when the file cannot be read.

    • replaceTokens

      public java.lang.String replaceTokens​(java.lang.String line)
      Does replacement on the given string with token matching. This uses the defined begintoken and endtoken values which default to @ for both. This resets the passedTokens and calls iReplaceTokens to do the actual replacements.
      Parameters:
      line - The line in which to process embedded tokens.
      Returns:
      The input string after token replacement.

    • addFilter

      public void addFilter​(FilterSet.Filter filter)
      Add a new filter.
      Parameters:
      filter - the filter to be added.

    • createFiltersfile

      public FilterSet.FiltersFile createFiltersfile()
      Create a new FiltersFile.
      Returns:
      The filtersfile that was created.

    • addFilter

      public void addFilter​(java.lang.String token, java.lang.String value)
      Add a new filter made from the given token and value.
      Parameters:
      token - The token for the new filter.
      value - The value for the new filter.

    • addConfiguredFilterSet

      public void addConfiguredFilterSet​(FilterSet filterSet)
      Add a Filterset to this filter set.
      Parameters:
      filterSet - the filterset to be added to this filterset

    • addConfiguredPropertySet

      public void addConfiguredPropertySet​(PropertySet propertySet)
      Adds the properties provided by the specified PropertySet to this filterset.
      Parameters:
      propertySet - the propertyset to be added to this propertyset

    • hasFilters

      public boolean hasFilters()
      Test to see if this filter set has filters.
      Returns:
      Return true if there are filters in this set.

    • clone

      public java.lang.Object clone() throws BuildException
      Clone the filterset.
      Overrides:
      clone in class DataType
      Returns:
      a deep clone of this filterset.
      Throws:
      BuildException - if the clone cannot be performed.

    • setOnMissingFiltersFile

      public void setOnMissingFiltersFile​(FilterSet.OnMissing onMissingFiltersFile)
      Set the behavior WRT missing filtersfiles.
      Parameters:
      onMissingFiltersFile - the OnMissing describing the behavior.

    • getOnMissingFiltersFile

      public FilterSet.OnMissing getOnMissingFiltersFile()
      Get the onMissingFiltersFile setting.
      Returns:
      the OnMissing instance.