Interface DirectoryProperty

All Superinterfaces:
FileSystemLocationProperty<Directory>, HasConfigurableValue, Property<Directory>, Provider<Directory>

@Incubating public interface DirectoryProperty extends FileSystemLocationProperty<Directory>
Represents some configurable directory location, whose value is mutable.

You can create a DirectoryProperty using ObjectFactory.directoryProperty().

Note: This interface is not intended for implementation by build script or plugin authors.

Since:
4.3
  • Method Details

    • getAsFileTree

      FileTree getAsFileTree()
      Returns a FileTree that allows the files and directories contained in this directory to be queried.
    • value

      Sets the value of the property the given value, replacing whatever value the property already had.

      This is the same as Property.set(Object) but returns this property to allow method chaining.

      Specified by:
      value in interface Property<Directory>
      Parameters:
      value - The value, can be null.
      Returns:
      this
    • value

      DirectoryProperty value(Provider<? extends Directory> provider)
      Sets the property to have the same value of the given provider, replacing whatever value the property already had. This property will track the value of the provider and query its value each time the value of the property is queried. When the provider has no value, this property will also have no value.

      This is the same as Property.set(Provider) but returns this property to allow method chaining.

      Specified by:
      value in interface Property<Directory>
      Parameters:
      provider - The provider whose value to use.
      Returns:
      this
    • convention

      DirectoryProperty convention(Directory value)
      Specifies the value to use as the convention for this property. The convention is used when no value has been set for this property.
      Specified by:
      convention in interface Property<Directory>
      Parameters:
      value - The value.
      Returns:
      this
    • convention

      DirectoryProperty convention(Provider<? extends Directory> valueProvider)
      Specifies the provider of the value to use as the convention for this property. The convention is used when no value has been set for this property.
      Specified by:
      convention in interface Property<Directory>
      Parameters:
      valueProvider - The provider of the value.
      Returns:
      this
    • dir

      Returns a Directory whose value is the given path resolved relative to the value of this directory.
      Parameters:
      path - The path. Can be absolute.
      Returns:
      The directory.
    • dir

      Provider<Directory> dir(Provider<? extends CharSequence> path)
      Returns a Directory whose value is the given path resolved relative to the value of this directory.
      Parameters:
      path - The path. Can have a value that is an absolute path.
      Returns:
      The directory.
    • file

      Returns a RegularFile whose value is the given path resolved relative to the value of this directory.
      Parameters:
      path - The path. Can be absolute.
      Returns:
      The file.
    • file

      Provider<RegularFile> file(Provider<? extends CharSequence> path)
      Returns a RegularFile whose value is the given path resolved relative to the value of this directory.
      Parameters:
      path - The path. Can have a value that is an absolute path.
      Returns:
      The file.