Package: org.gradle.api.file

## [Java] Interface FileCopyDetails

- org.gradle.api.file.FileTreeElement

- All Superinterfaces:
    ContentFilterable, FileTreeElement

  Provides details about a file or directory about to be copied, and allows some aspects of the destination file to be modified.

  Using this interface, you can change the destination path of the file, filter the content of the file, or exclude the file from the result entirely.

  Access to the source file itself after any filters have been added is not a supported operation.

- - ### Methods Summary

    Methods
    Type | Name and description
    --- | ---
    `void` | `exclude()` Excludes this file from the copy.
    `DuplicatesStrategy` | `getDuplicatesStrategy()` The strategy to use if there is already a file at this file's destination.
    `String` | `getName()` Returns the base name of this file at the copy destination.
    `String` | `getPath()` Returns the path of this file, relative to the root of the copy destination.
    `RelativePath` | `getRelativePath()` Returns the path of this file, relative to the root of the copy destination.
    `RelativePath` | `getRelativeSourcePath()` Returns the path of this file, relative to the root of the containing file tree.
    `String` | `getSourceName()` Returns the base name of this file at the copy source.
    `String` | `getSourcePath()` Returns the path of this file, relative to the root of the containing file tree.
    `void` | `setDuplicatesStrategy(DuplicatesStrategy strategy)` The strategy to use if there is already a file at this file's destination.
    `void` | `setMode(int mode)` Sets the Unix permissions of this file.
    `void` | `setName(String name)` Sets the destination name of this file.
    `void` | `setPath(String path)` Sets the destination path of this file.
    `void` | `setRelativePath(RelativePath path)` Sets the destination path of this file.

  - ### Inherited Methods Summary

    Inherited Methods
    Methods inherited from class | Name
    --- | ---
    `interface ContentFilterable` | `expand, filter, filter, filter`
    `interface FileTreeElement` | `copyTo, copyTo, getFile, getLastModified, getMode, getName, getPath, getRelativePath, getSize, isDirectory, open`

- - ### Method Detail

    - #### public void exclude()

      Excludes this file from the copy.

    - #### @Incubating public DuplicatesStrategy getDuplicatesStrategy()

      The strategy to use if there is already a file at this file's destination.

      The value can be set with a case insensitive string of the enum value (e.g. `'exclude'` for DuplicatesStrategy.EXCLUDE).

      Returns:
        the strategy to use for this file.
      See Also:
        DuplicatesStrategy

    - #### public String getName()

      Returns the base name of this file at the copy destination.

      Returns:
        The destination name. Never returns null.

    - #### public String getPath()

      Returns the path of this file, relative to the root of the copy destination.

      Always uses '/' as the hierarchy separator, regardless of platform file separator. Same as calling `getRelativePath().getPathString()`.

      Returns:
        The path, relative to the root of the copy destination. Never returns null.

    - #### public RelativePath getRelativePath()

      Returns the path of this file, relative to the root of the copy destination.

      Returns:
        The path, relative to the root of the copy destination. Never returns null.

    - #### public RelativePath getRelativeSourcePath()

      Returns the path of this file, relative to the root of the containing file tree.

      Returns:
        The path, relative to the root of the containing file tree. Never returns null.

    - #### public String getSourceName()

      Returns the base name of this file at the copy source.

      Returns:
        The source name. Never returns null.

    - #### public String getSourcePath()

      Returns the path of this file, relative to the root of the containing file tree.

      Always uses '/' as the hierarchy separator, regardless of platform file separator. Same as calling `getRelativeSourcePath().getPathString()`.

      Returns:
        The path, relative to the root of the containing file tree. Never returns null.

    - #### @Incubating public void setDuplicatesStrategy(DuplicatesStrategy strategy)

      The strategy to use if there is already a file at this file's destination.

    - #### public void setMode(int mode)

      Sets the Unix permissions of this file.

      Parameters:
        `mode` - the Unix permissions, e.g. `0644`.

    - #### public void setName(String name)

      Sets the destination name of this file.

      Parameters:
        `name` - The destination name of this file.

    - #### public void setPath(String path)

      Sets the destination path of this file.

      Parameters:
        `path` - The path of this file.

    - #### public void setRelativePath(RelativePath path)

      Sets the destination path of this file.

      Parameters:
        `path` - the new path for this file.