public class FileSystem extends Object
A (potential) blocking and non blocking version of each operation is provided.
The non blocking versions take a handler which is called when the operation completes or an error occurs.
The blocking versions are named xxxBlocking and return the results, or throw exceptions directly.
In many cases, depending on the operating system and file system some of the potentially blocking operations
can return quickly, which is why we provide them, but it's highly recommended that you test how long they take to
return in your particular application before using them on an event loop.
Please consult the documentation for more information on file system support.
NOTE: This class has been automatically generated from theoriginal non RX-ified interface using Vert.x codegen.| Modifier and Type | Field and Description |
|---|---|
static TypeArg<FileSystem> |
__TYPE_ARG |
| Constructor and Description |
|---|
FileSystem(io.vertx.core.file.FileSystem delegate) |
| Modifier and Type | Method and Description |
|---|---|
CompletionStage<Void> |
chmod(String path,
String perms)
Change the permissions on the file represented by
path to perms, asynchronously. |
FileSystem |
chmodBlocking(String path,
String perms)
Blocking version of
#chmod(String, String, Handler) |
CompletionStage<Void> |
chmodRecursive(String path,
String perms,
String dirPerms)
Change the permissions on the file represented by
path to perms, asynchronously. |
FileSystem |
chmodRecursiveBlocking(String path,
String perms,
String dirPerms)
Blocking version of
chmodRecursive(java.lang.String, java.lang.String, java.lang.String) |
CompletionStage<Void> |
chown(String path,
String user,
String group)
Change the ownership on the file represented by
path to user and {code group}, asynchronously. |
FileSystem |
chownBlocking(String path,
String user,
String group)
Blocking version of
|
CompletionStage<Void> |
copy(String from,
String to)
Copy a file from the path
from to path to, asynchronously. |
CompletionStage<Void> |
copy(String from,
String to,
io.vertx.core.file.CopyOptions options)
Copy a file from the path
from to path to, asynchronously. |
FileSystem |
copyBlocking(String from,
String to)
Blocking version of
copy(java.lang.String, java.lang.String) |
CompletionStage<Void> |
copyRecursive(String from,
String to,
boolean recursive)
Copy a file from the path
from to path to, asynchronously. |
FileSystem |
copyRecursiveBlocking(String from,
String to,
boolean recursive)
Blocking version of
copyRecursive(java.lang.String, java.lang.String, boolean) |
CompletionStage<Void> |
createFile(String path)
Creates an empty file with the specified
path, asynchronously. |
CompletionStage<Void> |
createFile(String path,
String perms)
Creates an empty file with the specified
path and permissions perms, asynchronously. |
FileSystem |
createFileBlocking(String path)
Blocking version of
createFile(java.lang.String) |
FileSystem |
createFileBlocking(String path,
String perms)
Blocking version of
createFile(java.lang.String) |
CompletionStage<String> |
createTempDirectory(String prefix)
Creates a new directory in the default temporary-file directory, using the given
prefix to generate its name, asynchronously.
|
CompletionStage<String> |
createTempDirectory(String prefix,
String perms)
Creates a new directory in the default temporary-file directory, using the given
prefix to generate its name, asynchronously.
|
CompletionStage<String> |
createTempDirectory(String dir,
String prefix,
String perms)
Creates a new directory in the directory provided by the path
path, using the given
prefix to generate its name, asynchronously. |
String |
createTempDirectoryBlocking(String prefix)
Blocking version of
createTempDirectory(java.lang.String) |
String |
createTempDirectoryBlocking(String prefix,
String perms)
Blocking version of
createTempDirectory(java.lang.String) |
String |
createTempDirectoryBlocking(String dir,
String prefix,
String perms)
Blocking version of
createTempDirectory(java.lang.String) |
CompletionStage<String> |
createTempFile(String prefix,
String suffix)
Creates a new file in the default temporary-file directory, using the given
prefix and suffix to generate its name, asynchronously.
|
CompletionStage<String> |
createTempFile(String prefix,
String suffix,
String perms)
Creates a new file in the directory provided by the path
dir, using the given
prefix and suffix to generate its name, asynchronously. |
CompletionStage<String> |
createTempFile(String dir,
String prefix,
String suffix,
String perms)
Creates a new file in the directory provided by the path
dir, using the given
prefix and suffix to generate its name, asynchronously. |
String |
createTempFileBlocking(String prefix,
String suffix)
Blocking version of
createTempFile(java.lang.String, java.lang.String) |
String |
createTempFileBlocking(String prefix,
String suffix,
String perms)
Blocking version of
createTempFile(java.lang.String, java.lang.String) |
String |
createTempFileBlocking(String dir,
String prefix,
String suffix,
String perms)
Blocking version of
createTempFile(java.lang.String, java.lang.String) |
CompletionStage<Void> |
delete(String path)
Deletes the file represented by the specified
path, asynchronously. |
FileSystem |
deleteBlocking(String path)
Blocking version of
delete(java.lang.String) |
CompletionStage<Void> |
deleteRecursive(String path,
boolean recursive)
Deletes the file represented by the specified
path, asynchronously. |
FileSystem |
deleteRecursiveBlocking(String path,
boolean recursive)
Blocking version of
deleteRecursive(java.lang.String, boolean) |
boolean |
equals(Object o) |
CompletionStage<Boolean> |
exists(String path)
Determines whether the file as specified by the path
path exists, asynchronously. |
boolean |
existsBlocking(String path)
Blocking version of
exists(java.lang.String) |
CompletionStage<FileSystemProps> |
fsProps(String path)
Returns properties of the file-system being used by the specified
path, asynchronously. |
FileSystemProps |
fsPropsBlocking(String path)
Blocking version of
fsProps(java.lang.String) |
io.vertx.core.file.FileSystem |
getDelegate() |
int |
hashCode() |
CompletionStage<Void> |
link(String link,
String existing)
Create a hard link on the file system from
link to existing, asynchronously. |
FileSystem |
linkBlocking(String link,
String existing)
Blocking version of
link(java.lang.String, java.lang.String) |
CompletionStage<FileProps> |
lprops(String path)
Obtain properties for the link represented by
path, asynchronously. |
FileProps |
lpropsBlocking(String path)
Blocking version of
lprops(java.lang.String) |
CompletionStage<Void> |
mkdir(String path)
Create the directory represented by
path, asynchronously. |
CompletionStage<Void> |
mkdir(String path,
String perms)
Create the directory represented by
path, asynchronously. |
FileSystem |
mkdirBlocking(String path)
Blocking version of
mkdir(java.lang.String) |
FileSystem |
mkdirBlocking(String path,
String perms)
Blocking version of
mkdir(java.lang.String) |
CompletionStage<Void> |
mkdirs(String path)
Create the directory represented by
path and any non existent parents, asynchronously. |
CompletionStage<Void> |
mkdirs(String path,
String perms)
Create the directory represented by
path and any non existent parents, asynchronously. |
FileSystem |
mkdirsBlocking(String path)
Blocking version of
mkdirs(java.lang.String) |
FileSystem |
mkdirsBlocking(String path,
String perms)
Blocking version of
mkdirs(java.lang.String) |
CompletionStage<Void> |
move(String from,
String to)
Move a file from the path
from to path to, asynchronously. |
CompletionStage<Void> |
move(String from,
String to,
io.vertx.core.file.CopyOptions options)
Move a file from the path
from to path to, asynchronously. |
FileSystem |
moveBlocking(String from,
String to)
Blocking version of
move(java.lang.String, java.lang.String) |
static FileSystem |
newInstance(io.vertx.core.file.FileSystem arg) |
CompletionStage<AsyncFile> |
open(String path,
io.vertx.core.file.OpenOptions options)
Open the file represented by
path, asynchronously. |
AsyncFile |
openBlocking(String path,
io.vertx.core.file.OpenOptions options)
Blocking version of
open(java.lang.String, io.vertx.core.file.OpenOptions) |
CompletionStage<FileProps> |
props(String path)
Obtain properties for the file represented by
path, asynchronously. |
FileProps |
propsBlocking(String path)
Blocking version of
props(java.lang.String) |
CompletionStage<List<String>> |
readDir(String path)
Read the contents of the directory specified by
path, asynchronously. |
CompletionStage<List<String>> |
readDir(String path,
String filter)
Read the contents of the directory specified by
path, asynchronously. |
List<String> |
readDirBlocking(String path)
Blocking version of
readDir(java.lang.String) |
List<String> |
readDirBlocking(String path,
String filter)
Blocking version of
readDir(java.lang.String) |
CompletionStage<Buffer> |
readFile(String path)
Reads the entire file as represented by the path
path as a , asynchronously. |
Buffer |
readFileBlocking(String path)
Blocking version of
readFile(java.lang.String) |
CompletionStage<String> |
readSymlink(String link)
Returns the path representing the file that the symbolic link specified by
link points to, asynchronously. |
String |
readSymlinkBlocking(String link)
Blocking version of
readSymlink(java.lang.String) |
CompletionStage<Void> |
symlink(String link,
String existing)
Create a symbolic link on the file system from
link to existing, asynchronously. |
FileSystem |
symlinkBlocking(String link,
String existing)
Blocking version of
link(java.lang.String, java.lang.String) |
String |
toString() |
CompletionStage<Void> |
truncate(String path,
long len)
Truncate the file represented by
path to length len in bytes, asynchronously. |
FileSystem |
truncateBlocking(String path,
long len)
Blocking version of
truncate(java.lang.String, long) |
CompletionStage<Void> |
unlink(String link)
Unlinks the link on the file system represented by the path
link, asynchronously. |
FileSystem |
unlinkBlocking(String link)
Blocking version of
unlink(java.lang.String) |
CompletionStage<Void> |
writeFile(String path,
Buffer data)
Creates the file, and writes the specified
Buffer data to the file represented by the path path,
asynchronously. |
FileSystem |
writeFileBlocking(String path,
Buffer data)
Blocking version of
writeFile(java.lang.String, io.vertx.axle.core.buffer.Buffer) |
public static final TypeArg<FileSystem> __TYPE_ARG
public io.vertx.core.file.FileSystem getDelegate()
public CompletionStage<Void> copy(String from, String to)
from to path to, asynchronously.
The copy will fail if the destination already exists.
from - the path to copy fromto - the path to copy topublic CompletionStage<Void> copy(String from, String to, io.vertx.core.file.CopyOptions options)
from to path to, asynchronously.from - the path to copy fromto - the path to copy tooptions - options describing how the file should be copiedpublic FileSystem copyBlocking(String from, String to)
copy(java.lang.String, java.lang.String)from - to - public CompletionStage<Void> copyRecursive(String from, String to, boolean recursive)
from to path to, asynchronously.
If recursive is true and from represents a directory, then the directory and its contents
will be copied recursively to the destination to.
The copy will fail if the destination if the destination already exists.
from - the path to copy fromto - the path to copy torecursive - public FileSystem copyRecursiveBlocking(String from, String to, boolean recursive)
copyRecursive(java.lang.String, java.lang.String, boolean)from - to - recursive - public CompletionStage<Void> move(String from, String to)
from to path to, asynchronously.
The move will fail if the destination already exists.
from - the path to copy fromto - the path to copy topublic CompletionStage<Void> move(String from, String to, io.vertx.core.file.CopyOptions options)
from to path to, asynchronously.from - the path to copy fromto - the path to copy tooptions - options describing how the file should be copiedpublic FileSystem moveBlocking(String from, String to)
move(java.lang.String, java.lang.String)from - to - public CompletionStage<Void> truncate(String path, long len)
path to length len in bytes, asynchronously.
The operation will fail if the file does not exist or len is less than zero.
path - the path to the filelen - the length to truncate it topublic FileSystem truncateBlocking(String path, long len)
truncate(java.lang.String, long)path - len - public CompletionStage<Void> chmod(String path, String perms)
path to perms, asynchronously.
The permission String takes the form rwxr-x--- as specified here.
path - the path to the fileperms - the permissions stringpublic FileSystem chmodBlocking(String path, String perms)
#chmod(String, String, Handler)path - perms - public CompletionStage<Void> chmodRecursive(String path, String perms, String dirPerms)
path to perms, asynchronously.The permission String takes the form rwxr-x--- as specified in {here}.
If the file is directory then all contents will also have their permissions changed recursively. Any directory permissions will
be set to dirPerms, whilst any normal file permissions will be set to perms.
path - the path to the fileperms - the permissions stringdirPerms - the directory permissionspublic FileSystem chmodRecursiveBlocking(String path, String perms, String dirPerms)
chmodRecursive(java.lang.String, java.lang.String, java.lang.String)path - perms - dirPerms - public CompletionStage<Void> chown(String path, String user, String group)
path to user and {code group}, asynchronously.path - the path to the fileuser - the user name, null will not change the user namegroup - the user group, null will not change the user group namepublic FileSystem chownBlocking(String path, String user, String group)
path - user - group - public CompletionStage<FileProps> props(String path)
path, asynchronously.
If the file is a link, the link will be followed.
path - the path to the filepublic FileProps propsBlocking(String path)
props(java.lang.String)path - public CompletionStage<FileProps> lprops(String path)
path, asynchronously.
The link will not be followed.
path - the path to the filepublic FileProps lpropsBlocking(String path)
lprops(java.lang.String)path - public CompletionStage<Void> link(String link, String existing)
link to existing, asynchronously.link - the linkexisting - the link destinationpublic FileSystem linkBlocking(String link, String existing)
link(java.lang.String, java.lang.String)link - existing - public CompletionStage<Void> symlink(String link, String existing)
link to existing, asynchronously.link - the linkexisting - the link destinationpublic FileSystem symlinkBlocking(String link, String existing)
link(java.lang.String, java.lang.String)link - existing - public CompletionStage<Void> unlink(String link)
link, asynchronously.link - the linkpublic FileSystem unlinkBlocking(String link)
unlink(java.lang.String)link - public CompletionStage<String> readSymlink(String link)
link points to, asynchronously.link - the linkpublic String readSymlinkBlocking(String link)
readSymlink(java.lang.String)link - public CompletionStage<Void> delete(String path)
path, asynchronously.path - path to the filepublic FileSystem deleteBlocking(String path)
delete(java.lang.String)path - public CompletionStage<Void> deleteRecursive(String path, boolean recursive)
path, asynchronously.
If the path represents a directory and recursive = true then the directory and its contents will be
deleted recursively.
path - path to the filerecursive - delete recursively?public FileSystem deleteRecursiveBlocking(String path, boolean recursive)
deleteRecursive(java.lang.String, boolean)path - recursive - public CompletionStage<Void> mkdir(String path)
path, asynchronously.
The operation will fail if the directory already exists.
path - path to the filepublic FileSystem mkdirBlocking(String path)
mkdir(java.lang.String)path - public CompletionStage<Void> mkdir(String path, String perms)
path, asynchronously.
The new directory will be created with permissions as specified by perms.
The permission String takes the form rwxr-x--- as specified in here.
The operation will fail if the directory already exists.
path - path to the fileperms - the permissions stringpublic FileSystem mkdirBlocking(String path, String perms)
mkdir(java.lang.String)path - perms - public CompletionStage<Void> mkdirs(String path)
path and any non existent parents, asynchronously.
The operation will fail if the path already exists but is not a directory.
path - path to the filepublic FileSystem mkdirsBlocking(String path)
mkdirs(java.lang.String)path - public CompletionStage<Void> mkdirs(String path, String perms)
path and any non existent parents, asynchronously.
The new directory will be created with permissions as specified by perms.
The permission String takes the form rwxr-x--- as specified in here.
The operation will fail if the path already exists but is not a directory.
path - path to the fileperms - the permissions stringpublic FileSystem mkdirsBlocking(String path, String perms)
mkdirs(java.lang.String)path - perms - public CompletionStage<List<String>> readDir(String path)
path, asynchronously.
The result is an array of String representing the paths of the files inside the directory.
path - path to the filepublic List<String> readDirBlocking(String path)
readDir(java.lang.String)path - public CompletionStage<List<String>> readDir(String path, String filter)
path, asynchronously.
The parameter filter is a regular expression. If filter is specified then only the paths that
match @{filter}will be returned.
The result is an array of String representing the paths of the files inside the directory.
path - path to the directoryfilter - the filter expressionpublic List<String> readDirBlocking(String path, String filter)
readDir(java.lang.String)path - filter - public CompletionStage<Buffer> readFile(String path)
path as a , asynchronously.
Do not use this method to read very large files or you risk running out of available RAM.
path - path to the filepublic Buffer readFileBlocking(String path)
readFile(java.lang.String)path - public CompletionStage<Void> writeFile(String path, Buffer data)
Buffer data to the file represented by the path path,
asynchronously.path - path to the filedata - public FileSystem writeFileBlocking(String path, Buffer data)
writeFile(java.lang.String, io.vertx.axle.core.buffer.Buffer)path - data - public CompletionStage<AsyncFile> open(String path, io.vertx.core.file.OpenOptions options)
path, asynchronously.
The file is opened for both reading and writing. If the file does not already exist it will be created.
path - path to the fileoptions - options describing how the file should be openedpublic AsyncFile openBlocking(String path, io.vertx.core.file.OpenOptions options)
open(java.lang.String, io.vertx.core.file.OpenOptions)path - options - public CompletionStage<Void> createFile(String path)
path, asynchronously.path - path to the filepublic FileSystem createFileBlocking(String path)
createFile(java.lang.String)path - public CompletionStage<Void> createFile(String path, String perms)
path and permissions perms, asynchronously.path - path to the fileperms - the permissions stringpublic FileSystem createFileBlocking(String path, String perms)
createFile(java.lang.String)path - perms - public CompletionStage<Boolean> exists(String path)
path exists, asynchronously.path - path to the filepublic boolean existsBlocking(String path)
exists(java.lang.String)path - public CompletionStage<FileSystemProps> fsProps(String path)
path, asynchronously.path - path to anywhere on the filesystempublic FileSystemProps fsPropsBlocking(String path)
fsProps(java.lang.String)path - public CompletionStage<String> createTempDirectory(String prefix)
As with the File.createTempFile methods, this method is only
part of a temporary-file facility.A Runtime,
or the File mechanism may be used to delete the directory automatically.
prefix - the prefix string to be used in generating the directory's name; may be nullpublic String createTempDirectoryBlocking(String prefix)
createTempDirectory(java.lang.String)prefix - public CompletionStage<String> createTempDirectory(String prefix, String perms)
The new directory will be created with permissions as specified by perms.
As with the File.createTempFile methods, this method is only
part of a temporary-file facility.A Runtime,
or the File mechanism may be used to delete the directory automatically.
prefix - the prefix string to be used in generating the directory's name; may be nullperms - the permissions stringpublic String createTempDirectoryBlocking(String prefix, String perms)
createTempDirectory(java.lang.String)prefix - perms - public CompletionStage<String> createTempDirectory(String dir, String prefix, String perms)
path, using the given
prefix to generate its name, asynchronously.
The new directory will be created with permissions as specified by perms.
As with the File.createTempFile methods, this method is only
part of a temporary-file facility.A Runtime,
or the File mechanism may be used to delete the directory automatically.
dir - the path to directory in which to create the directoryprefix - the prefix string to be used in generating the directory's name; may be nullperms - the permissions stringpublic String createTempDirectoryBlocking(String dir, String prefix, String perms)
createTempDirectory(java.lang.String)dir - prefix - perms - public CompletionStage<String> createTempFile(String prefix, String suffix)
As with the File.createTempFile methods, this method is only
part of a temporary-file facility.A Runtime,
or the File mechanism may be used to delete the directory automatically.
prefix - the prefix string to be used in generating the directory's name; may be nullsuffix - the suffix string to be used in generating the file's name; may be null, in which case ".tmp" is usedpublic String createTempFileBlocking(String prefix, String suffix)
createTempFile(java.lang.String, java.lang.String)prefix - suffix - public CompletionStage<String> createTempFile(String prefix, String suffix, String perms)
dir, using the given
prefix and suffix to generate its name, asynchronously.
As with the File.createTempFile methods, this method is only
part of a temporary-file facility.A Runtime,
or the File mechanism may be used to delete the directory automatically.
prefix - the prefix string to be used in generating the directory's name; may be nullsuffix - the suffix string to be used in generating the file's name; may be null, in which case ".tmp" is usedperms - public String createTempFileBlocking(String prefix, String suffix, String perms)
createTempFile(java.lang.String, java.lang.String)prefix - suffix - perms - public CompletionStage<String> createTempFile(String dir, String prefix, String suffix, String perms)
dir, using the given
prefix and suffix to generate its name, asynchronously.
The new directory will be created with permissions as specified by perms.
As with the File.createTempFile methods, this method is only
part of a temporary-file facility.A Runtime,
or the File mechanism may be used to delete the directory automatically.
dir - the path to directory in which to create the directoryprefix - the prefix string to be used in generating the directory's name; may be nullsuffix - the suffix string to be used in generating the file's name; may be null, in which case ".tmp" is usedperms - the permissions stringpublic String createTempFileBlocking(String dir, String prefix, String suffix, String perms)
createTempFile(java.lang.String, java.lang.String)dir - prefix - suffix - perms - public static FileSystem newInstance(io.vertx.core.file.FileSystem arg)
Copyright © 2019 SmallRye. All rights reserved.