VirtualFile (Jenkins main module 1.651.3 API)

java.lang.Object
- jenkins.util.VirtualFile

All Implemented Interfaces:

Serializable, Comparable<VirtualFile>
```
public abstract class VirtualFile
extends Object
implements Comparable<VirtualFile>, Serializable
```
Abstraction over File, FilePath, or other items such as network resources or ZIP entries. Assumed to be read-only and makes very limited assumptions, just enough to display content and traverse directories.
To obtain a VirtualFile representation for an existing file, use forFile(File) or FilePath.toVirtualFile()
How are VirtualFile and FilePath different?

FilePath abstracts away Files on machines that are connected over Channel, whereas VirtualFile makes no assumption about where the actual files are, or whether there really exists Files somewhere. This makes VirtualFile more abstract.

Since:

1.532

See Also:

DirectoryBrowserSupport, FilePath, Serialized Form

Constructor Summary

Constructors
Constructor and Description

VirtualFile()

Constructors
Constructor and Description
`VirtualFile()`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`abstract boolean`	`canRead()` Checks whether this file can be read.
`abstract VirtualFile`	`child(String name)` Obtains a child file.
`int`	`compareTo(VirtualFile o)` Does case-insensitive comparison.
`boolean`	`equals(Object obj)` Compares according to `toURI()`.
`abstract boolean`	`exists()` Checks whether this file exists.
`static VirtualFile`	`forFile(File f)` Creates a virtual file wrapper for a local file.
`static VirtualFile`	`forFilePath(FilePath f)` Creates a virtual file wrapper for a remotable file.
`abstract String`	`getName()` Gets the base name, meaning just the last portion of the path name without any directories.
`abstract VirtualFile`	`getParent()` Gets the parent file.
`int`	`hashCode()` Hashes according to `toURI()`.
`abstract boolean`	`isDirectory()` Checks whether this file exists and is a directory.
`abstract boolean`	`isFile()` Checks whether this file exists and is a plain file.
`abstract long`	`lastModified()` Gets the file timestamp.
`abstract long`	`length()` Gets the file length.
`abstract VirtualFile[]`	`list()` Lists children of this directory.
`abstract String[]`	`list(String glob)` Lists recursive files of this directory with pattern matching.
`abstract InputStream`	`open()` Opens an input stream on the file so its contents can be read.
`<V> V`	`run(hudson.remoting.Callable<V,IOException> callable)` Does some calculations in batch.
`String`	`toString()` Displays `toURI()`.
`abstract URI`	`toURI()` Gets a URI.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - VirtualFile
```
public VirtualFile()
```
- Method Detail
  - getName
```
@Nonnull
public abstract String getName()
```
    Gets the base name, meaning just the last portion of the path name without any directories. For a “root directory” this may be the empty string.
    
    Returns:
    
    a simple name (no slashes)
  - toURI
```
public abstract URI toURI()
```
    Gets a URI. Should at least uniquely identify this virtual file within its root, but not necessarily globally.
    
    Returns:
    
    a URI (need not be absolute)
  - getParent
```
public abstract VirtualFile getParent()
```
    Gets the parent file. Need only operate within the originally given root.
    
    Returns:
    
    the parent
  - isDirectory
```
public abstract boolean isDirectory()
                             throws IOException
```
    Checks whether this file exists and is a directory.
    
    Returns:
    
    true if it is a directory, false if a file or nonexistent
    
    Throws:
    
    IOException - in case checking status failed
  - isFile
```
public abstract boolean isFile()
                        throws IOException
```
    Checks whether this file exists and is a plain file.
    
    Returns:
    
    true if it is a file, false if a directory or nonexistent
    
    Throws:
    
    IOException - in case checking status failed
  - exists
```
public abstract boolean exists()
                        throws IOException
```
    Checks whether this file exists.
    
    Returns:
    
    true if it is a plain file or directory, false if nonexistent
    
    Throws:
    
    IOException - in case checking status failed
  - list
```
@Nonnull
public abstract VirtualFile[] list()
                                     throws IOException
```
    Lists children of this directory.
    
    Returns:
    
    a list of children (files and subdirectories); empty for a file or nonexistent directory
    
    Throws:
    
    IOException - if this directory exists but listing was not possible for some other reason
  - list
```
@Nonnull
public abstract String[] list(String glob)
                                throws IOException
```
    Lists recursive files of this directory with pattern matching.
    
    Parameters:
    
    glob - an Ant-style glob
    
    Returns:
    
    a list of relative names of children (files directly inside or in subdirectories)
    
    Throws:
    
    IOException - if this is not a directory, or listing was not possible for some other reason
  - child
```
@Nonnull
public abstract VirtualFile child(@Nonnull
                                           String name)
```
    Obtains a child file.
    
    Parameters:
    
    name - a relative path, possibly including / (but not ..)
    
    Returns:
    
    a representation of that child, whether it actually exists or not
  - length
```
public abstract long length()
                     throws IOException
```
    Gets the file length.
    
    Returns:
    
    a length, or 0 if inapplicable (e.g. a directory)
    
    Throws:
    
    IOException - if checking the length failed
  - lastModified
```
public abstract long lastModified()
                           throws IOException
```
    Gets the file timestamp.
    
    Returns:
    
    a length, or 0 if inapplicable
    
    Throws:
    
    IOException - if checking the timestamp failed
  - canRead
```
public abstract boolean canRead()
                         throws IOException
```
    Checks whether this file can be read.
    
    Returns:
    
    true normally
    
    Throws:
    
    IOException - if checking status failed
  - open
```
public abstract InputStream open()
                          throws IOException
```
    Opens an input stream on the file so its contents can be read.
    
    Returns:
    
    an open stream
    
    Throws:
    
    IOException - if it could not be opened
  - compareTo
```
public final int compareTo(VirtualFile o)
```
    Does case-insensitive comparison.
    
    Specified by:
    
    compareTo in interface Comparable<VirtualFile>
  - equals
```
public final boolean equals(Object obj)
```
    Compares according to toURI().
    
    Overrides:
    
    equals in class Object
  - hashCode
```
public final int hashCode()
```
    Hashes according to toURI().
    
    Overrides:
    
    hashCode in class Object
  - toString
```
public final String toString()
```
    Displays toURI().
    
    Overrides:
    
    toString in class Object
  - run
```
public <V> V run(hudson.remoting.Callable<V,IOException> callable)
          throws IOException
```
    Does some calculations in batch. For a remote file, this can be much faster than doing the corresponding operations one by one as separate requests. The default implementation just calls the block directly.
    
    Type Parameters:
    
    V - a value type
    
    T - the exception type
    
    Parameters:
    
    callable - something to run all at once (only helpful if any mentioned files are on the same system)
    
    Returns:
    
    the callable result
    
    Throws:
    
    IOException - if remote communication failed
    
    Since:
    
    1.554
  - forFile
```
public static VirtualFile forFile(File f)
```
    Creates a virtual file wrapper for a local file.
    
    Parameters:
    
    f - a disk file (need not exist)
    
    Returns:
    
    a wrapper
  - forFilePath
```
public static VirtualFile forFilePath(FilePath f)
```
    Creates a virtual file wrapper for a remotable file.
    
    Parameters:
    
    f - a local or remote file (need not exist)
    
    Returns:
    
    a wrapper

Class VirtualFile

How are VirtualFile and FilePath different?

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

VirtualFile

Method Detail

getName

toURI

getParent

isDirectory

isFile

exists

list

list

child

length

lastModified

canRead

open

compareTo

equals

hashCode

toString

run

forFile

forFilePath