SFTPv3Client

Create a SFTP v3 client.

Create a SFTP v3 client.

Have the server canonicalize any given path name to an absolute path. This is useful for converting path names containing ".." components or relative pathnames without a leading slash into absolute paths.

Close this SFTP session. NEVER forget to call this method to free up resources - even if you got an exception from one of the other methods. Sometimes these other methods may throw an exception, saying that the underlying channel is closed (this can happen, e.g., if the other server sent a close message.) However, as long as you have not called the close() method, you are likely wasting resources.

Close a file.

Create a file and open it for reading and writing. Same as createFile(fileName, null).

Create a file and open it for reading and writing. You can specify the default attributes of the file (the server may or may not respect your wishes).

reate a file (truncate it if it already exists) and open it for reading and writing. You can specify the default attributes of the file (the server may or may not respect your wishes).

Create a file (truncate it if it already exists) and open it for reading and writing. Same as createFileTruncate(fileName, null).

Create a symbolic link on the server. Creates a link "src" that points to "target".

Modify the attributes of a file. Used for operations such as changing the ownership, permissions or access times, as well as for truncating a file.

Retrieve the file attributes of an open file.

The currently used charset for filename encoding/decoding.

Returns the negotiated SFTP protocol version between the client and the server.

List the contents of a directory.

Retrieve the file attributes of a file. This method does NOT follow symbolic links on the server.

Create a new directory.

Move a file or directory.

Open a file for reading.

Open a file for reading and writing.

Read bytes from a file. No more than 32768 bytes may be read at once. Be aware that the semantics of read() are different than for Java streams.

• The server will read as many bytes as it can from the file (up to len), and return them.
• If EOF is encountered before reading any data, -1 is returned.
• If an error occurs, an exception is thrown
.
• For normal disk files, it is guaranteed that the server will return the specified number of bytes, or up to end of file. For, e.g., device files this may return fewer bytes than requested.

Read the target of a symbolic link.

Remove a file.

Remove an empty directory.

Set the charset used to convert between Java Unicode Strings and byte encodings used by the server for paths and file names. Unfortunately, the SFTP v3 draft says NOTHING about such conversions (well, with the exception of error messages which have to be in UTF-8). Newer drafts specify to use UTF-8 for file names (if I remember correctly). However, a quick test using OpenSSH serving a EXT-3 filesystem has shown that UTF-8 seems to be a bad choice for SFTP v3 (tested with filenames containing german umlauts). "windows-1252" seems to work better for Europe. Luckily, "windows-1252" is the platform default in my case =).

If you don't set anything, then the platform default will be used (this is the default behavior).

Modify the attributes of a file. Used for operations such as changing the ownership, permissions or access times, as well as for truncating a file.

Retrieve the file attributes of a file. This method follows symbolic links on the server.

Write bytes to a file. If len > 32768, then the write operation will be split into multiple writes.