Location (Apache Twill common library 0.6.0-incubating API)

```
public interface Location
```
This interface defines the location and operations of a resource on the filesystem.
Location is agnostic to the type of file system the resource is on.

Field Summary

Fields
Modifier and Type Field and Description

static String TEMP_FILE_SUFFIX
Suffix added to every temp file name generated with getTempFile(String).

Fields
Modifier and Type	Field and Description
`static String`	`TEMP_FILE_SUFFIX` Suffix added to every temp file name generated with `getTempFile(String)`.

Method Summary

Methods
Modifier and Type	Method and Description
`Location`	`append(String child)` Appends the child to the current `Location`.
`boolean`	`createNew()` Atomically creates a new, empty file named by this abstract pathname if and only if a file with this name does not yet exist.
`boolean`	`delete()` Deletes the file or directory denoted by this abstract pathname.
`boolean`	`delete(boolean recursive)` Deletes the file or directory denoted by this abstract pathname.
`boolean`	`exists()` Checks if the this location exists.
`InputStream`	`getInputStream()`
`LocationFactory`	`getLocationFactory()` Returns the location factory used to create this instance.
`String`	`getName()`
`OutputStream`	`getOutputStream()`
`OutputStream`	`getOutputStream(String permission)` Creates an `OutputStream` for this location with the given permission.
`Location`	`getTempFile(String suffix)` Returns unique location for temporary file to be placed near this location.
`boolean`	`isDirectory()` Checks if this location represents a directory.
`long`	`lastModified()`
`long`	`length()`
`List<Location>`	`list()` List the locations under this location.
`boolean`	`mkdirs()` Creates the directory named by this abstract pathname, including any necessary but nonexistent parent directories.
`Location`	`renameTo(Location destination)` Moves the file or directory denoted by this abstract pathname.
`URI`	`toURI()`

- Field Detail
  - TEMP_FILE_SUFFIX
```
static final String TEMP_FILE_SUFFIX
```
    Suffix added to every temp file name generated with getTempFile(String).
    
    See Also:
    Constant Field Values
- Method Detail
  - exists
```
boolean exists()
               throws IOException
```
    Checks if the this location exists.
    
    Returns:
    true if found; false otherwise.
    
    Throws:
    
    IOException
  - getName
```
String getName()
```
    Returns:
    Returns the name of the file or directory denoteed by this abstract pathname.
  - createNew
```
boolean createNew()
                  throws IOException
```
    Atomically creates a new, empty file named by this abstract pathname if and only if a file with this name does not yet exist.
    
    Returns:
    true if the file is successfully create, false otherwise.
    
    Throws:
    
    IOException
  - getInputStream
```
InputStream getInputStream()
                           throws IOException
```
    Returns:
    An InputStream for this location.
    
    Throws:
    
    IOException
  - getOutputStream
```
OutputStream getOutputStream()
                             throws IOException
```
    Returns:
    An OutputStream for this location.
    
    Throws:
    
    IOException
  - getOutputStream
```
OutputStream getOutputStream(String permission)
                             throws IOException
```
    Creates an OutputStream for this location with the given permission. The actual permission supported depends on implementation.
    
    Parameters:
    permission - A POSIX permission string.
    
    Returns:
    An OutputStream for writing to this location.
    
    Throws:
    
    IOException - If failed to create the OutputStream.
  - append
```
Location append(String child)
                throws IOException
```
    Appends the child to the current Location.
    Returns a new instance of Location.
    
    Parameters:
    child - to be appended to this location.
    
    Returns:
    A new instance of Location
    
    Throws:
    
    IOException
  - getTempFile
```
Location getTempFile(String suffix)
                     throws IOException
```
    Returns unique location for temporary file to be placed near this location. Allows all temp files to follow same pattern for easier management of them.
    
    Parameters:
    suffix - part of the file name to include in the temp file name
    
    Returns:
    location of the temp file
    
    Throws:
    
    IOException
  - toURI
```
URI toURI()
```
    Returns:
    A URI for this location.
  - delete
```
boolean delete()
               throws IOException
```
    Deletes the file or directory denoted by this abstract pathname. If this pathname denotes a directory, then the directory must be empty in order to be deleted.
    
    Returns:
    true if and only if the file or directory is successfully delete; false otherwise.
    
    Throws:
    
    IOException
  - delete
```
boolean delete(boolean recursive)
               throws IOException
```
    Deletes the file or directory denoted by this abstract pathname. If this pathname denotes a directory and recursive is true, then content of the directory will be deleted recursively, otherwise the directory must be empty in order to be deleted. Note that when calling this method with recursive = true for a directory, any failure during deletion will have some entries inside the directory being deleted while some are not.
    
    Parameters:
    recursive - Indicate if recursively delete a directory. Ignored if the pathname represents a file.
    
    Returns:
    true if and only if the file or directory is successfully delete; false otherwise.
    
    Throws:
    
    IOException
  - renameTo
```
@Nullable
Location renameTo(Location destination)
                  throws IOException
```
    Moves the file or directory denoted by this abstract pathname.
    
    Parameters:
    destination - destination location
    
    Returns:
    new location if and only if the file or directory is successfully moved; null otherwise.
    
    Throws:
    
    IOException
  - mkdirs
```
boolean mkdirs()
               throws IOException
```
    Creates the directory named by this abstract pathname, including any necessary but nonexistent parent directories.
    
    Returns:
    true if and only if the renaming succeeded; false otherwise
    
    Throws:
    
    IOException
  - length
```
long length()
            throws IOException
```
    Returns:
    Length of file.
    
    Throws:
    
    IOException
  - lastModified
```
long lastModified()
                  throws IOException
```
    Returns:
    Last modified time of file.
    
    Throws:
    
    IOException
  - isDirectory
```
boolean isDirectory()
                    throws IOException
```
    Checks if this location represents a directory.
    
    Returns:
    true if it is a directory, false otherwise.
    
    Throws:
    
    IOException
  - list
```
List<Location> list()
                    throws IOException
```
    List the locations under this location.
    
    Returns:
    Immutable List of locations under this location. An empty list is returned if this location is not a directory.
    
    Throws:
    
    IOException
  - getLocationFactory
```
LocationFactory getLocationFactory()
```
    Returns the location factory used to create this instance.
    
    Returns:
    The LocationFactory instance for creating this instance.

Interface Location

Field Summary

Method Summary

Field Detail

TEMP_FILE_SUFFIX

Method Detail

exists

getName

createNew

getInputStream

getOutputStream

getOutputStream

append

getTempFile

toURI

delete

delete

renameTo

mkdirs

length

lastModified

isDirectory

list

getLocationFactory