Groovy Documentation

org.gradle.api.file
[Java] Interface FileTreeElement


public interface FileTreeElement

Information about a file in a FileTree.


Method Summary
void copyTo(OutputStream outstr)

Copies the content of this file to an output stream.

boolean copyTo(File target)

Copies this file to the given target file.

File getFile()

Returns the file being visited.

long getLastModified()

Returns the last modified time of this file.

int getMode()

Returns the Unix permissions of this file, e.g.

String getName()

Returns the base name of this file.

String getPath()

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

RelativePath getRelativePath()

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

long getSize()

Returns the size of this file.

boolean isDirectory()

Returns true if this element is a directory, or false if this element is a regular file.

InputStream open()

Opens this file as an input stream.

 

Method Detail

copyTo

public void copyTo(OutputStream outstr)
Copies the content of this file to an output stream. Generally, calling this method is more performant than calling new FileInputStream(getFile()).
Parameters:
outstr - The output stream to write to. The caller is responsible for closing this stream.


copyTo

public boolean copyTo(File target)
Copies this file to the given target file. Does not copy the file if the target is already a copy of this file.
Parameters:
target - the target file.
Returns:
true if this file was copied, false if it was up-to-date


getFile

public File getFile()
Returns the file being visited.
Returns:
The file. Never returns null.


getLastModified

public long getLastModified()
Returns the last modified time of this file. Generally, calling this method is more performant than calling getFile().lastModified()
Returns:
The last modified time.


getMode

public int getMode()
Returns the Unix permissions of this file, e.g. 0644.
Returns:
The Unix file permissions.


getName

public String getName()
Returns the base name of this file.
Returns:
The name. Never returns null.


getPath

public String getPath()
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 getRelativePath().getPathString().
Returns:
The path. Never returns null.


getRelativePath

public RelativePath getRelativePath()
Returns the path of this file, relative to the root of the containing file tree.
Returns:
The path. Never returns null.


getSize

public long getSize()
Returns the size of this file. Generally, calling this method is more performant than calling getFile().length().
Returns:
The size, in bytes.


isDirectory

public boolean isDirectory()
Returns true if this element is a directory, or false if this element is a regular file.
Returns:
true if this element is a directory.


open

public InputStream open()
Opens this file as an input stream. Generally, calling this method is more performant than calling new FileInputStream(getFile()).
Returns:
The input stream. Never returns null. The caller is responsible for closing this stream.


 

Gradle API 1.12