Package org.gradle.api.file

Interface ContentFilterable

    • Method Detail

      • filter

        ContentFilterable filter​(java.util.Map<java.lang.String,​?> properties,
                         java.lang.Class<? extends java.io.FilterReader> filterType)

        Adds a content filter to be used during the copy. Multiple calls to filter, add additional filters to the filter chain. Each filter should implement java.io.FilterReader. Include org.apache.tools.ant.filters.* for access to all the standard Ant filters.

        Filter properties may be specified using groovy map syntax.

        Examples: 

            filter(HeadFilter, lines:25, skip:2)
    filter(ReplaceTokens, tokens:[copyright:'2009', version:'2.3.1'])
        Parameters:
        properties - map of filter properties
        filterType - Class of filter to add
        Returns:
        this

      • filter

        ContentFilterable filter​(java.lang.Class<? extends java.io.FilterReader> filterType)

        Adds a content filter to be used during the copy. Multiple calls to filter, add additional filters to the filter chain. Each filter should implement java.io.FilterReader. Include org.apache.tools.ant.filters.* for access to all the standard Ant filters.

        Examples: 

            filter(StripJavaComments)
    filter(com.mycompany.project.CustomFilter)
        Parameters:
        filterType - Class of filter to add
        Returns:
        this

      • filter

        ContentFilterable filter​(Closure closure)
        Adds a content filter based on the provided closure. The Closure will be called with each line (stripped of line endings) and should return a String to replace the line or null to remove the line. If every line is removed, the result will be an empty file, not an absent one.
        Parameters:
        closure - to implement line based filtering
        Returns:
        this

      • filter

        ContentFilterable filter​(Transformer<@Nullable java.lang.String,​java.lang.String> transformer)
        Adds a content filter based on the provided transformer. The Closure will be called with each line (stripped of line endings) and should return a String to replace the line or null to remove the line. If every line is removed, the result will be an empty file, not an absent one.
        Parameters:
        transformer - to implement line based filtering
        Returns:
        this

      • expand

        ContentFilterable expand​(java.util.Map<java.lang.String,​?> properties)

        Expands property references in each file as it is copied. More specifically, each file is transformed using Groovy's SimpleTemplateEngine. This means you can use simple property references, such as $property or ${property} in the file. You can also include arbitrary Groovy code in the file, such as ${version ?: 'unknown'} or ${classpath*.name.join(' ')}

        Note that all escape sequences (\n, \t, \\, etc) are converted to the symbols they represent, so, for example, \n becomes newline. If this is undesirable then expand(Map, Action) should be used to disable this behavior.

        Parameters:
        properties - reference-to-value map for substitution
        Returns:
        this

      • expand

        ContentFilterable expand​(java.util.Map<java.lang.String,​?> properties,
                         Action<? super ExpandDetails> action)

        Expands property references in each file as it is copied. More specifically, each file is transformed using Groovy's SimpleTemplateEngine. This means you can use simple property references, such as $property or ${property} in the file. You can also include arbitrary Groovy code in the file, such as ${version ?: 'unknown'} or ${classpath*.name.join(' ')}. The template engine can be configured with the provided action.

        Note that by default all escape sequences (\n, \t, \\, etc) are converted to the symbols they represent, so, for example, \n becomes newline. This behavior is controlled by ExpandDetails.getEscapeBackslash() property. It should be set to true to disable escape sequences conversion: 

          expand(one: '1', two: 2) {
      escapeBackslash = true
  }
        Parameters:
        properties - reference-to-value map for substitution
        action - action to perform additional configuration of the underlying template engine
        Returns:
        this
        Since:
        7.2