com.github.robtimus.filesystems.sftp

Class SFTPEnvironment

java.lang.Object

com.github.robtimus.filesystems.sftp.SFTPEnvironment

All Implemented Interfaces:

Cloneable, Map<String,Object>

public class SFTPEnvironment
extends Object
implements Map<String,Object>, Cloneable

A utility class to set up environments that can be used in the FileSystemProvider.newFileSystem(URI, Map) and FileSystemProvider.newFileSystem(Path, Map) methods of SFTPFileSystemProvider.

Author:

Rob Spoor

Nested Class Summary

Nested classes/interfaces inherited from interface java.util.Map

Map.Entry<K,V>

Constructor Summary

Constructors

Constructor and Description
SFTPEnvironment() Creates a new SFTP environment.
SFTPEnvironment(Map<String,Object> map) Creates a new SFTP environment.

Method Summary

Modifier and Type	Method and Description
void	clear()
SFTPEnvironment	clone()
boolean	containsKey(Object key)
boolean	containsValue(Object value)
Set<Map.Entry<String,Object>>	entrySet()
boolean	equals(Object o)
Object	get(Object key)
int	hashCode()
boolean	isEmpty()
Set<String>	keySet()
Object	put(String key, Object value)
void	putAll(Map<? extends String,? extends Object> m)
Object	remove(Object key)
int	size()
String	toString()
Collection<Object>	values()
SFTPEnvironment	withAgentForwarding(boolean agentForwarding) Stores whether or not agent forwarding should be enabled.
SFTPEnvironment	withClientConnectionCount(int count) Stores the number of client connections to use.
SFTPEnvironment	withClientConnectionWaitTimeout(long timeout) Stores the wait timeout to use for retrieving client connection from the connection pool.
SFTPEnvironment	withClientConnectionWaitTimeout(long duration, TimeUnit unit) Stores the wait timeout to use for retrieving client connections from the connection pool.
SFTPEnvironment	withClientVersion(String version) Stores the client version to use.
SFTPEnvironment	withConfig(Properties config) Stores configuration options to use.
SFTPEnvironment	withConfig(String key, String value) Stores a configuration option to use.
SFTPEnvironment	withConnectTimeout(int timeout) Stores the connection timeout to use.
SFTPEnvironment	withDefaultDirectory(String pathname) Stores the default directory to use.
SFTPEnvironment	withFilenameEncoding(String encoding) Stores the filename encoding to use.
SFTPEnvironment	withFileSystemExceptionFactory(FileSystemExceptionFactory factory) Stores the file system exception factory to use.
SFTPEnvironment	withHostKeyAlias(String alias) Stores the host key alias to use.
SFTPEnvironment	withHostKeyRepository(HostKeyRepository repository) Stores the host key repository to use.
SFTPEnvironment	withIdentities(Collection<Identity> identities) Stores several identity to use.
SFTPEnvironment	withIdentities(Identity... identities) Stores several identity to use.
SFTPEnvironment	withIdentity(Identity identity) Stores an identity to use.
SFTPEnvironment	withIdentityRepository(IdentityRepository repository) Stores the identity repository to use.
SFTPEnvironment	withKnownHosts(File knownHosts) Stores the known hosts file to use.
SFTPEnvironment	withPassword(char[] password) Stores the password to use.
SFTPEnvironment	withProxy(Proxy proxy) Stores the proxy to use.
SFTPEnvironment	withServerAliveCountMax(int count) Stores the maximum number of server alive messages that can be sent without any reply before disconnecting.
SFTPEnvironment	withServerAliveInterval(int interval) Stores the server alive interval to use.
SFTPEnvironment	withSocketFactory(SocketFactory factory) Stores the socket factory to use.
SFTPEnvironment	withTimeout(int timeout) Stores the timeout.
SFTPEnvironment	withUserInfo(UserInfo userInfo) Stores the user info to use.
SFTPEnvironment	withUsername(String username) Stores the username to use.

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Map

compute, computeIfAbsent, computeIfPresent, forEach, getOrDefault, merge, putIfAbsent, remove, replace, replace, replaceAll

Constructor Detail

SFTPEnvironment

public SFTPEnvironment()

Creates a new SFTP environment.

SFTPEnvironment

public SFTPEnvironment(Map<String,Object> map)

Creates a new SFTP environment.

Parameters:

map - The map to wrap.

Method Detail

withUsername

public SFTPEnvironment withUsername(String username)

Stores the username to use.

Parameters:

username - The username to use.

Returns:

This object.

withConnectTimeout

public SFTPEnvironment withConnectTimeout(int timeout)

Stores the connection timeout to use.

Parameters:

timeout - The connection timeout in milliseconds.

Returns:

This object.

withProxy

public SFTPEnvironment withProxy(Proxy proxy)

Stores the proxy to use.

Parameters:

proxy - The proxy to use.

Returns:

This object.

withUserInfo

public SFTPEnvironment withUserInfo(UserInfo userInfo)

Stores the user info to use.

Parameters:

userInfo - The user info to use.

Returns:

This object.

withPassword

public SFTPEnvironment withPassword(char[] password)

Stores the password to use.

Parameters:

password - The password to use.

Returns:

This object.

Since:

1.1

withConfig

public SFTPEnvironment withConfig(Properties config)

Stores configuration options to use. This method will add not clear any previously set options, but only add new ones.

Parameters:

config - The configuration options to use.

Returns:

This object.

Throws:

NullPointerException - if the given properties object is null.

See Also:

withConfig(String, String)

withConfig

public SFTPEnvironment withConfig(String key,
                                  String value)

Stores a configuration option to use. This method will add not clear any previously set options, but only add new ones.

Parameters:

key - The configuration key.

value - The configuration value.

Returns:

This object.

Throws:

NullPointerException - if the given key or value is null.

See Also:

withConfig(Properties)

withSocketFactory

public SFTPEnvironment withSocketFactory(SocketFactory factory)

Stores the socket factory to use.

Parameters:

factory - The socket factory to use.

Returns:

This object.

withTimeout

public SFTPEnvironment withTimeout(int timeout)

Stores the timeout.

Parameters:

timeout - The timeout in milliseconds.

Returns:

This object.

See Also:

Socket.setSoTimeout(int)

withClientVersion

public SFTPEnvironment withClientVersion(String version)

Stores the client version to use.

Parameters:

version - The client version.

Returns:

This object.

withHostKeyAlias

public SFTPEnvironment withHostKeyAlias(String alias)

Stores the host key alias to use.

Parameters:

alias - The host key alias.

Returns:

This object.

withServerAliveInterval

public SFTPEnvironment withServerAliveInterval(int interval)

Stores the server alive interval to use.

Parameters:

interval - The server alive interval in milliseconds.

Returns:

This object.

withServerAliveCountMax

public SFTPEnvironment withServerAliveCountMax(int count)

Stores the maximum number of server alive messages that can be sent without any reply before disconnecting.

Parameters:

count - The maximum number of server alive messages.

Returns:

This object.

withIdentityRepository

public SFTPEnvironment withIdentityRepository(IdentityRepository repository)

Stores the identity repository to use.

Parameters:

repository - The identity repository to use.

Returns:

This object.

withIdentity

public SFTPEnvironment withIdentity(Identity identity)

Stores an identity to use. This method will add not clear any previously set identities, but only add new ones.

Parameters:

identity - The identity to use.

Returns:

This object.

Throws:

NullPointerException - If the given identity is null.

Since:

1.2

See Also:

withIdentities(Identity...), withIdentities(Collection)

withIdentities

public SFTPEnvironment withIdentities(Identity... identities)

Stores several identity to use. This method will add not clear any previously set identities, but only add new ones.

Parameters:

identities - The identities to use.

Returns:

This object.

Throws:

NullPointerException - If any of the given identity is null.

Since:

1.2

See Also:

withIdentity(Identity), withIdentities(Collection)

withIdentities

public SFTPEnvironment withIdentities(Collection<Identity> identities)

Stores several identity to use. This method will add not clear any previously set identities, but only add new ones.

Parameters:

identities - The identities to use.

Returns:

This object.

Throws:

NullPointerException - If any of the given identity is null.

Since:

1.2

See Also:

withIdentity(Identity), withIdentities(Identity...)

withHostKeyRepository

public SFTPEnvironment withHostKeyRepository(HostKeyRepository repository)

Stores the host key repository to use.

Parameters:

repository - The host key repository to use.

Returns:

This object.

withKnownHosts

public SFTPEnvironment withKnownHosts(File knownHosts)

Stores the known hosts file to use. Note that the known hosts file is ignored if a HostKeyRepository is set with a non-null value.

Parameters:

knownHosts - The known hosts file to use.

Returns:

This object.

Throws:

NullPointerException - If the given file is null.

Since:

1.2

See Also:

withHostKeyRepository(HostKeyRepository)

withAgentForwarding

public SFTPEnvironment withAgentForwarding(boolean agentForwarding)

Stores whether or not agent forwarding should be enabled.

Parameters:

agentForwarding - true to enable strict agent forwarding, or false to disable it.

Returns:

This object.

withFilenameEncoding

public SFTPEnvironment withFilenameEncoding(String encoding)

Stores the filename encoding to use.

Parameters:

encoding - The filename encoding to use.

Returns:

This object.

withDefaultDirectory

public SFTPEnvironment withDefaultDirectory(String pathname)

Stores the default directory to use. If it exists, this will be the directory that relative paths are resolved to.

Parameters:

pathname - The default directory to use.

Returns:

This object.

withClientConnectionCount

public SFTPEnvironment withClientConnectionCount(int count)

Stores the number of client connections to use. This value influences the number of concurrent threads that can access an SFTP file system.

Parameters:

count - The number of client connection to use.

Returns:

This object.

withClientConnectionWaitTimeout

public SFTPEnvironment withClientConnectionWaitTimeout(long timeout)

Stores the wait timeout to use for retrieving client connection from the connection pool.

If the timeout is not larger than 0, the SFTP file system waits indefinitely until a client connection becomes available.

Parameters:

timeout - The timeout in milliseconds.

Returns:

This object.

Since:

1.3

See Also:

withClientConnectionWaitTimeout(long, TimeUnit)

withClientConnectionWaitTimeout

public SFTPEnvironment withClientConnectionWaitTimeout(long duration,
                                                       TimeUnit unit)

Stores the wait timeout to use for retrieving client connections from the connection pool.

If the timeout is not larger than 0, the SFTP file system waits indefinitely until a client connection becomes available.

Parameters:

duration - The timeout duration.

unit - The timeout unit.

Returns:

This object.

Throws:

NullPointerException - If the timeout unit is null.

Since:

1.3

See Also:

withClientConnectionWaitTimeout(long)

withFileSystemExceptionFactory

public SFTPEnvironment withFileSystemExceptionFactory(FileSystemExceptionFactory factory)

Stores the file system exception factory to use.

Parameters:

factory - The file system exception factory to use.

Returns:

This object.

size

public int size()

Specified by:

size in interface Map<String,Object>

isEmpty

public boolean isEmpty()

Specified by:

isEmpty in interface Map<String,Object>

containsKey

public boolean containsKey(Object key)

Specified by:

containsKey in interface Map<String,Object>

containsValue

public boolean containsValue(Object value)

Specified by:

containsValue in interface Map<String,Object>

get

public Object get(Object key)

Specified by:

get in interface Map<String,Object>

put

public Object put(String key,
                  Object value)

Specified by:

put in interface Map<String,Object>

remove

public Object remove(Object key)

Specified by:

remove in interface Map<String,Object>

putAll

public void putAll(Map<? extends String,? extends Object> m)

Specified by:

putAll in interface Map<String,Object>

clear

public void clear()

Specified by:

clear in interface Map<String,Object>

keySet

public Set<String> keySet()

Specified by:

keySet in interface Map<String,Object>

values

public Collection<Object> values()

Specified by:

values in interface Map<String,Object>

entrySet

public Set<Map.Entry<String,Object>> entrySet()

Specified by:

entrySet in interface Map<String,Object>

equals

public boolean equals(Object o)

Specified by:

equals in interface Map<String,Object>

Overrides:

equals in class Object

hashCode

public int hashCode()

Specified by:

hashCode in interface Map<String,Object>

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

clone

public SFTPEnvironment clone()

Overrides:

clone in class Object