org.elastos.hive

Interface Files

public interface Files

Method Summary

Modifier and Type	Method and Description
java.util.concurrent.CompletableFuture<java.lang.Boolean>	copy(java.lang.String source, java.lang.String target) Copies a file or a folder (recursively).
java.util.concurrent.CompletableFuture<java.lang.Boolean>	delete(java.lang.String path) Deletes a file, or a folder.
<T> java.util.concurrent.CompletableFuture<T>	download(java.lang.String path, java.lang.Class<T> resultType) Initiates a download sequence by returning a Reader or InputStream object that can be used to read the downloaded file in chunks.
java.util.concurrent.CompletableFuture<java.lang.String>	hash(java.lang.String path) Returns the SHA256 hash of the given file.
java.util.concurrent.CompletableFuture<java.util.List<FileInfo>>	list(java.lang.String path) Returns the list of all files in a given folder.
java.util.concurrent.CompletableFuture<java.lang.Boolean>	move(java.lang.String source, java.lang.String target) Moves (or renames) a file or folder.
java.util.concurrent.CompletableFuture<FileInfo>	stat(java.lang.String path) Information about the target file or folder.
<T> java.util.concurrent.CompletableFuture<T>	upload(java.lang.String path, java.lang.Class<T> resultType) Initiates an upload sequence by returning a Write or OutputStream object that can be used to write small file chunks.

Method Detail

upload

<T> java.util.concurrent.CompletableFuture<T> upload(java.lang.String path,
                                                     java.lang.Class<T> resultType)

Initiates an upload sequence by returning a Write or OutputStream object that can be used to write small file chunks. After writing, flush() must be called to actually send the data remotely.

Type Parameters:

T - Write, OutputStream

Parameters:

path - the path for the remote file

resultType - Write or OutputStream class

Returns:

the new CompletionStage, the result is the Writer or OutputStream interface for upload the file content if success; null otherwise

download

<T> java.util.concurrent.CompletableFuture<T> download(java.lang.String path,
                                                       java.lang.Class<T> resultType)

Initiates a download sequence by returning a Reader or InputStream object that can be used to read the downloaded file in chunks.

Parameters:

path - the path for the remote file

resultType - Reader or InputStream class

Returns:

the new CompletionStage, the result is the Reader or InputStream interface for read the file content if success; null otherwise

delete

java.util.concurrent.CompletableFuture<java.lang.Boolean> delete(java.lang.String path)

Deletes a file, or a folder. In case the given path is a folder, deletion is recursive.

Parameters:

path - the path for the remote file or folder

Returns:

the new CompletionStage, the result is true if the file or folder successfully deleted; false otherwise

move

java.util.concurrent.CompletableFuture<java.lang.Boolean> move(java.lang.String source,
                                                               java.lang.String target)

Moves (or renames) a file or folder.

Parameters:

source - the path to the file or folder to move

target - the path to the target file or folder

Returns:

The future object that would hold the result of moving operation. When the result value is true, it means the file or folder has been moved to target path in success. Otherwise, it will return result with false.

copy

java.util.concurrent.CompletableFuture<java.lang.Boolean> copy(java.lang.String source,
                                                               java.lang.String target)

Copies a file or a folder (recursively).

Parameters:

source - the path for the remote source file or folder

target - the path for the remote destination file or folder

Returns:

the new CompletionStage, the result is true if the file or folder successfully copied; false otherwise

hash

java.util.concurrent.CompletableFuture<java.lang.String> hash(java.lang.String path)

Returns the SHA256 hash of the given file.

Parameters:

path - path for the remote file

Returns:

the new CompletionStage, the result is the base64 hash string if the hash successfully calculated; null otherwise

list

java.util.concurrent.CompletableFuture<java.util.List<FileInfo>> list(java.lang.String path)

Returns the list of all files in a given folder.

Parameters:

path - the path for the remote folder

Returns:

the new CompletionStage, the result is List if success; null otherwise

stat

java.util.concurrent.CompletableFuture<FileInfo> stat(java.lang.String path)

Information about the target file or folder.

Parameters:

path - the path for the remote file or folder

Returns:

the new CompletionStage, the result is FileInfo if success; null otherwise