com.github.robtimus.filesystems.ftp

Class FTPSEnvironment

java.lang.Object

com.github.robtimus.filesystems.ftp.FTPEnvironment

com.github.robtimus.filesystems.ftp.FTPSEnvironment

All Implemented Interfaces:

Cloneable, Map<String,Object>

public class FTPSEnvironment
extends FTPEnvironment

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

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
FTPSEnvironment() Creates a new FTPS environment.
FTPSEnvironment(Map<String,Object> map) Creates a new FTPS environment.

Method Summary

Modifier and Type	Method and Description
FTPSEnvironment	clone()
FTPSEnvironment	withAbsoluteFilePathSupport(boolean supportAbsoluteFilePaths) Deprecated. Use withFTPFileStrategyFactory(FTPFileStrategyFactory) instead. A value of true should be replaced with FTPFileStrategyFactory.AUTO_DETECT, a value of false with FTPFileStrategyFactory.NON_UNIX.
FTPSEnvironment	withActiveExternalIPAddress(String ipAddress) Stores the external IP address in active mode.
FTPSEnvironment	withActivePortRange(int minPort, int maxPort) Stores the client side port range in active mode.
FTPSEnvironment	withActualTotalSpaceCalculation(boolean calculateActualTotalSpace) Deprecated. FileStore.getTotalSpace() does not need to traverse the file system, because that would calculate the total used space, not the total space.
FTPSEnvironment	withAuthCommand(String command) Stores the AUTH command to use.
FTPSEnvironment	withAutodetectEncoding(boolean autodetect) Stores whether or not automatic server encoding detection should be enabled.
FTPSEnvironment	withBufferSize(int bufferSize) Stores the buffer size to use.
FTPSEnvironment	withCharset(Charset charset) Stores the charset to use.
FTPSEnvironment	withClientConfig(FTPClientConfig clientConfig) Stores the FTP client config to use.
FTPSEnvironment	withClientConnectionCount(int count) Stores the number of client connections to use.
FTPSEnvironment	withClientConnectionWaitTimeout(long timeout) Stores the wait timeout to use for retrieving client connection from the connection pool.
FTPSEnvironment	withClientConnectionWaitTimeout(long duration, TimeUnit unit) Stores the wait timeout to use for retrieving client connections from the connection pool.
FTPSEnvironment	withConnectionMode(ConnectionMode connectionMode) Stores the connection mode to use.
FTPSEnvironment	withConnectTimeout(int timeout) Stores the connection timeout to use.
FTPSEnvironment	withControlEncoding(String encoding) Stores the character encoding to be used by the FTP control connection.
FTPSEnvironment	withControlKeepAliveReplyTimeout(int timeout) Stores how long to wait for control keep-alive message replies.
FTPSEnvironment	withControlKeepAliveTimeout(long timeout) Stores the time to wait between sending control connection keep-alive messages when processing file upload or download.
FTPSEnvironment	withCredentials(String username, char[] password) Stores the credentials to use.
FTPSEnvironment	withCredentials(String username, char[] password, String account) Stores the credentials to use.
FTPSEnvironment	withDataTimeout(int timeout) Stores the timeout in milliseconds to use when reading from data connections.
FTPSEnvironment	withDefaultDirectory(String pathname) Stores the default directory to use.
FTPSEnvironment	withEnabledCipherSuites(String... cipherSuites) Stores the names of the cipher suites which could be enabled for use on connections.
FTPSEnvironment	withEnabledProtocols(String... protocolVersions) Stores which particular protocol versions are enabled for use on connections.
FTPSEnvironment	withEnabledSessionCreation(boolean established) Stores whether or not new SSL sessions may be established by sockets.
FTPSEnvironment	withEndpointCheckingEnabled(boolean enabled) Stores whether or not endpoint identification using the HTTPS algorithm should be enabled.
FTPSEnvironment	withFileSystemExceptionFactory(FileSystemExceptionFactory factory) Stores the file system exception factory to use.
FTPSEnvironment	withFTPFileStrategyFactory(FTPFileStrategyFactory factory) Stores the FTP file strategy factory to use.
FTPSEnvironment	withHostnameVerifier(HostnameVerifier hostnameVerifier) Stores the hostname verifier to use.
FTPSEnvironment	withKeepAlive(boolean keepAlive) Stores whether or not SO_KEEPALIVE should be enabled.
FTPSEnvironment	withKeyManager(KeyManager keyManager) Stores the key manager to use.
FTPSEnvironment	withLocalAddress(InetAddress localAddr, int localPort) Stores the local address to use.
FTPSEnvironment	withNeedClientAuth(boolean needClientAuth) Stores whether or not sockets will require client authentication.
FTPSEnvironment	withParserFactory(FTPFileEntryParserFactory parserFactory) Stores the factory used for parser creation.
FTPSEnvironment	withPassiveLocalIPAddress(String ipAddress) Stores the local IP address to use in passive mode.
FTPSEnvironment	withPassiveNatWorkaround(boolean enabled) Deprecated. Use withPassiveNatWorkaroundStrategy(FTPClient.HostnameResolver) instead.
FTPSEnvironment	withPassiveNatWorkaroundStrategy(FTPClient.HostnameResolver resolver) Stores the workaround strategy to replace the PASV mode reply addresses.
FTPSEnvironment	withProtocol(String protocol) Stores the protocol to use.
FTPSEnvironment	withProxy(Proxy proxy) Stores the proxy to use.
FTPSEnvironment	withReceiveBufferSize(int size) Stores the socket receive buffer size to use.
FTPSEnvironment	withReceiveDataSocketBufferSize(int bufferSize) Stores the value to use for the data socket SO_RCVBUF option.
FTPSEnvironment	withRemoteVerificationEnabled(boolean enabled) Stores whether or not verification that the remote host taking part of a data connection is the same as the host to which the control connection is attached should be enabled.
FTPSEnvironment	withReportActiveExternalIPAddress(String ipAddress) Stores the external IP address to report in EPRT/PORT commands in active mode.
FTPSEnvironment	withSecurityMode(SecurityMode securityMode) Stores the security mode to use.
FTPSEnvironment	withSendBufferSize(int size) Stores the socket send buffer size to use.
FTPSEnvironment	withSendDataSocketBufferSize(int bufferSizr) Stores the value to use for the data socket SO_SNDBUF option.
FTPSEnvironment	withServerSocketFactory(ServerSocketFactory factory) Stores the server socket factory to use.
FTPSEnvironment	withSocketFactory(SocketFactory factory) Stores the socket factory to use.
FTPSEnvironment	withSoLinger(boolean on, int linger) Stores whether or not SO_LINGER should be enabled, and if so, the linger time.
FTPSEnvironment	withSoTimeout(int timeout) Stores the socket timeout.
FTPSEnvironment	withSSLContext(SSLContext sslContext) Stores the SSL context to use.
FTPSEnvironment	withStrictlyMultilineParsing(boolean strictMultilineParsing) Stores whether or not strict multiline parsing should be enabled, as per RFC 959, section 4.2.
FTPSEnvironment	withTcpNoDelay(boolean on) Stores whether or not the Nagle's algorithm (TCP_NODELAY) should be enabled.
FTPSEnvironment	withTrustManager(TrustManager trustManager) Stores the trust manager to use.
FTPSEnvironment	withUseClientMode(boolean useClientMode) Stores whether or not sockets are set to use client mode in their first handshake.
FTPSEnvironment	withUseEPSVwithIPv4(boolean selected) Stores whether or not to use EPSV with IPv4.
FTPSEnvironment	withWantClientAuth(boolean wantClientAuth) Stores whether or not sockets will request client authentication.

Methods inherited from class com.github.robtimus.filesystems.ftp.FTPEnvironment

clear, containsKey, containsValue, entrySet, equals, get, hashCode, isEmpty, keySet, put, putAll, remove, size, toString, values

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

FTPSEnvironment

public FTPSEnvironment()

Creates a new FTPS environment.

FTPSEnvironment

public FTPSEnvironment(Map<String,Object> map)

Creates a new FTPS environment.

Parameters:

map - The map to wrap.

Method Detail

withLocalAddress

public FTPSEnvironment withLocalAddress(InetAddress localAddr,
                                        int localPort)

Description copied from class: FTPEnvironment

Stores the local address to use.

Overrides:

withLocalAddress in class FTPEnvironment

Parameters:

localAddr - The local address to use.

localPort - The local port to use.

Returns:

This object.

See Also:

Socket.bind(SocketAddress), InetSocketAddress.InetSocketAddress(InetAddress, int)

withCredentials

public FTPSEnvironment withCredentials(String username,
                                       char[] password)

Description copied from class: FTPEnvironment

Stores the credentials to use.

Overrides:

withCredentials in class FTPEnvironment

Parameters:

username - The username to use.

password - The password to use.

Returns:

This object.

withCredentials

public FTPSEnvironment withCredentials(String username,
                                       char[] password,
                                       String account)

Description copied from class: FTPEnvironment

Stores the credentials to use.

Overrides:

withCredentials in class FTPEnvironment

Parameters:

username - The username to use.

password - The password to use.

account - The account to use.

Returns:

This object.

withSoTimeout

public FTPSEnvironment withSoTimeout(int timeout)

Description copied from class: FTPEnvironment

Stores the socket timeout.

Overrides:

withSoTimeout in class FTPEnvironment

Parameters:

timeout - The socket timeout in milliseconds.

Returns:

This object.

See Also:

Socket.setSoTimeout(int)

withSendBufferSize

public FTPSEnvironment withSendBufferSize(int size)

Description copied from class: FTPEnvironment

Stores the socket send buffer size to use.

Overrides:

withSendBufferSize in class FTPEnvironment

Parameters:

size - The size of the buffer in bytes.

Returns:

This object.

See Also:

Socket.setSendBufferSize(int)

withReceiveBufferSize

public FTPSEnvironment withReceiveBufferSize(int size)

Description copied from class: FTPEnvironment

Stores the socket receive buffer size to use.

Overrides:

withReceiveBufferSize in class FTPEnvironment

Parameters:

size - The size of the buffer in bytes.

Returns:

This object.

See Also:

Socket.setReceiveBufferSize(int)

withTcpNoDelay

public FTPSEnvironment withTcpNoDelay(boolean on)

Description copied from class: FTPEnvironment

Stores whether or not the Nagle's algorithm (TCP_NODELAY) should be enabled.

Overrides:

withTcpNoDelay in class FTPEnvironment

Parameters:

on - true if Nagle's algorithm should be enabled, or false otherwise.

Returns:

This object.

See Also:

Socket.setTcpNoDelay(boolean)

withKeepAlive

public FTPSEnvironment withKeepAlive(boolean keepAlive)

Description copied from class: FTPEnvironment

Stores whether or not SO_KEEPALIVE should be enabled.

Overrides:

withKeepAlive in class FTPEnvironment

Parameters:

keepAlive - true if keep-alive should be enabled, or false otherwise.

Returns:

This object.

See Also:

Socket.setKeepAlive(boolean)

withSoLinger

public FTPSEnvironment withSoLinger(boolean on,
                                    int linger)

Description copied from class: FTPEnvironment

Stores whether or not SO_LINGER should be enabled, and if so, the linger time.

Overrides:

withSoLinger in class FTPEnvironment

Parameters:

on - true if SO_LINGER should be enabled, or false otherwise.

linger - The linger time in seconds, if on is true.

Returns:

This object.

See Also:

Socket.setSoLinger(boolean, int)

withSocketFactory

public FTPSEnvironment withSocketFactory(SocketFactory factory)

Description copied from class: FTPEnvironment

Stores the socket factory to use.

Overrides:

withSocketFactory in class FTPEnvironment

Parameters:

factory - The socket factory to use.

Returns:

This object.

withServerSocketFactory

public FTPSEnvironment withServerSocketFactory(ServerSocketFactory factory)

Description copied from class: FTPEnvironment

Stores the server socket factory to use.

Overrides:

withServerSocketFactory in class FTPEnvironment

Parameters:

factory - The server socket factory to use.

Returns:

This object.

withConnectTimeout

public FTPSEnvironment withConnectTimeout(int timeout)

Description copied from class: FTPEnvironment

Stores the connection timeout to use.

Overrides:

withConnectTimeout in class FTPEnvironment

Parameters:

timeout - The connection timeout in milliseconds.

Returns:

This object.

See Also:

Socket.connect(SocketAddress, int)

withProxy

public FTPSEnvironment withProxy(Proxy proxy)

Description copied from class: FTPEnvironment

Stores the proxy to use.

Overrides:

withProxy in class FTPEnvironment

Parameters:

proxy - The proxy to use.

Returns:

This object.

withCharset

public FTPSEnvironment withCharset(Charset charset)

Description copied from class: FTPEnvironment

Stores the charset to use.

Overrides:

withCharset in class FTPEnvironment

Parameters:

charset - The charset to use.

Returns:

This object.

withControlEncoding

public FTPSEnvironment withControlEncoding(String encoding)

Description copied from class: FTPEnvironment

Stores the character encoding to be used by the FTP control connection. Some FTP servers require that commands be issued in a non-ASCII encoding like UTF-8 so that filenames with multi-byte character representations (e.g, Big 8) can be specified.

Overrides:

withControlEncoding in class FTPEnvironment

Parameters:

encoding - The character encoding to use.

Returns:

This object.

withStrictlyMultilineParsing

public FTPSEnvironment withStrictlyMultilineParsing(boolean strictMultilineParsing)

Description copied from class: FTPEnvironment

Stores whether or not strict multiline parsing should be enabled, as per RFC 959, section 4.2.

Overrides:

withStrictlyMultilineParsing in class FTPEnvironment

Parameters:

strictMultilineParsing - true to enable strict multiline parsing, or false to disable it.

Returns:

This object.

withDataTimeout

public FTPSEnvironment withDataTimeout(int timeout)

Description copied from class: FTPEnvironment

Stores the timeout in milliseconds to use when reading from data connections.

Overrides:

withDataTimeout in class FTPEnvironment

Parameters:

timeout - The timeout in milliseconds that is used when opening data connection sockets.

Returns:

This object.

withParserFactory

public FTPSEnvironment withParserFactory(FTPFileEntryParserFactory parserFactory)

Description copied from class: FTPEnvironment

Stores the factory used for parser creation.

Overrides:

withParserFactory in class FTPEnvironment

Parameters:

parserFactory - The factory object used to create FTPFileEntryParsers

Returns:

This object.

withRemoteVerificationEnabled

public FTPSEnvironment withRemoteVerificationEnabled(boolean enabled)

Description copied from class: FTPEnvironment

Stores whether or not verification that the remote host taking part of a data connection is the same as the host to which the control connection is attached should be enabled.

Overrides:

withRemoteVerificationEnabled in class FTPEnvironment

Parameters:

enabled - true to enable verification, or false to disable verification.

Returns:

This object.

withDefaultDirectory

public FTPSEnvironment withDefaultDirectory(String pathname)

Description copied from class: FTPEnvironment

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

Overrides:

withDefaultDirectory in class FTPEnvironment

Parameters:

pathname - The default directory to use.

Returns:

This object.

withConnectionMode

public FTPSEnvironment withConnectionMode(ConnectionMode connectionMode)

Description copied from class: FTPEnvironment

Stores the connection mode to use. If the connection mode is not set, it will default to ConnectionMode.ACTIVE.

Overrides:

withConnectionMode in class FTPEnvironment

Parameters:

connectionMode - The connection mode to use.

Returns:

This object.

withActivePortRange

public FTPSEnvironment withActivePortRange(int minPort,
                                           int maxPort)

Description copied from class: FTPEnvironment

Stores the client side port range in active mode.

Overrides:

withActivePortRange in class FTPEnvironment

Parameters:

minPort - The lowest available port (inclusive).

maxPort - The highest available port (inclusive).

Returns:

This object.

withActiveExternalIPAddress

public FTPSEnvironment withActiveExternalIPAddress(String ipAddress)

Description copied from class: FTPEnvironment

Stores the external IP address in active mode. Useful when there are multiple network cards.

Overrides:

withActiveExternalIPAddress in class FTPEnvironment

Parameters:

ipAddress - The external IP address of this machine.

Returns:

This object.

withPassiveLocalIPAddress

public FTPSEnvironment withPassiveLocalIPAddress(String ipAddress)

Description copied from class: FTPEnvironment

Stores the local IP address to use in passive mode. Useful when there are multiple network cards.

Overrides:

withPassiveLocalIPAddress in class FTPEnvironment

Parameters:

ipAddress - The local IP address of this machine.

Returns:

This object.

withReportActiveExternalIPAddress

public FTPSEnvironment withReportActiveExternalIPAddress(String ipAddress)

Description copied from class: FTPEnvironment

Stores the external IP address to report in EPRT/PORT commands in active mode. Useful when there are multiple network cards.

Overrides:

withReportActiveExternalIPAddress in class FTPEnvironment

Parameters:

ipAddress - The external IP address of this machine.

Returns:

This object.

withBufferSize

public FTPSEnvironment withBufferSize(int bufferSize)

Description copied from class: FTPEnvironment

Stores the buffer size to use.

Overrides:

withBufferSize in class FTPEnvironment

Parameters:

bufferSize - The buffer size to use.

Returns:

This object.

withSendDataSocketBufferSize

public FTPSEnvironment withSendDataSocketBufferSize(int bufferSizr)

Description copied from class: FTPEnvironment

Stores the value to use for the data socket SO_SNDBUF option.

Overrides:

withSendDataSocketBufferSize in class FTPEnvironment

Parameters:

bufferSizr - The size of the buffer.

Returns:

This object.

withReceiveDataSocketBufferSize

public FTPSEnvironment withReceiveDataSocketBufferSize(int bufferSize)

Description copied from class: FTPEnvironment

Stores the value to use for the data socket SO_RCVBUF option.

Overrides:

withReceiveDataSocketBufferSize in class FTPEnvironment

Parameters:

bufferSize - The size of the buffer.

Returns:

This object.

withClientConfig

public FTPSEnvironment withClientConfig(FTPClientConfig clientConfig)

Description copied from class: FTPEnvironment

Stores the FTP client config to use.

Overrides:

withClientConfig in class FTPEnvironment

Parameters:

clientConfig - The client config to use.

Returns:

This object.

withUseEPSVwithIPv4

public FTPSEnvironment withUseEPSVwithIPv4(boolean selected)

Description copied from class: FTPEnvironment

Stores whether or not to use EPSV with IPv4. Might be worth enabling in some circumstances.

For example, when using IPv4 with NAT it may work with some rare configurations. E.g. if FTP server has a static PASV address (external network) and the client is coming from another internal network. In that case the data connection after PASV command would fail, while EPSV would make the client succeed by taking just the port.

Overrides:

withUseEPSVwithIPv4 in class FTPEnvironment

Parameters:

selected - The flag to use.

Returns:

This object.

withControlKeepAliveTimeout

public FTPSEnvironment withControlKeepAliveTimeout(long timeout)

Description copied from class: FTPEnvironment

Stores the time to wait between sending control connection keep-alive messages when processing file upload or download.

Overrides:

withControlKeepAliveTimeout in class FTPEnvironment

Parameters:

timeout - The keep-alive timeout to use, in milliseconds.

Returns:

This object.

withControlKeepAliveReplyTimeout

public FTPSEnvironment withControlKeepAliveReplyTimeout(int timeout)

Description copied from class: FTPEnvironment

Stores how long to wait for control keep-alive message replies.

Overrides:

withControlKeepAliveReplyTimeout in class FTPEnvironment

Parameters:

timeout - The keep-alive reply timeout to use, in milliseconds.

Returns:

This object.

withPassiveNatWorkaround

@Deprecated
public FTPSEnvironment withPassiveNatWorkaround(boolean enabled)

Deprecated. Use withPassiveNatWorkaroundStrategy(FTPClient.HostnameResolver) instead.

Stores whether or not to enable the passive mode NAT workaround. If enabled, a site-local PASV mode reply address will be replaced with the remote host address to which the PASV mode request was sent (unless that is also a site local address). This gets around the problem that some NAT boxes may change the reply. The default is true, i.e. site-local replies are replaced.

Overrides:

withPassiveNatWorkaround in class FTPEnvironment

Parameters:

enabled - true to enable replacing internal IP's in passive mode, or false otherwise.

Returns:

This object.

withPassiveNatWorkaroundStrategy

public FTPSEnvironment withPassiveNatWorkaroundStrategy(FTPClient.HostnameResolver resolver)

Stores the workaround strategy to replace the PASV mode reply addresses. This gets around the problem that some NAT boxes may change the reply. The default implementation is FTPClient.NatServerResolverImpl, i.e. site-local replies are replaced.

Overrides:

withPassiveNatWorkaroundStrategy in class FTPEnvironment

Parameters:

resolver - The workaround strategy to replace internal IP's in passive mode, or null to disable the workaround (i.e. use PASV mode reply address.)

Returns:

This object.

Since:

1.1

withAutodetectEncoding

public FTPSEnvironment withAutodetectEncoding(boolean autodetect)

Description copied from class: FTPEnvironment

Stores whether or not automatic server encoding detection should be enabled. Note that only UTF-8 is supported.

Overrides:

withAutodetectEncoding in class FTPEnvironment

Parameters:

autodetect - true to enable automatic server encoding detection, or false to disable it.

Returns:

This object.

withClientConnectionCount

public FTPSEnvironment withClientConnectionCount(int count)

Description copied from class: FTPEnvironment

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

Overrides:

withClientConnectionCount in class FTPEnvironment

Parameters:

count - The number of client connection to use.

Returns:

This object.

withClientConnectionWaitTimeout

public FTPSEnvironment withClientConnectionWaitTimeout(long timeout)

Description copied from class: FTPEnvironment

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

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

Overrides:

withClientConnectionWaitTimeout in class FTPEnvironment

Parameters:

timeout - The timeout in milliseconds.

Returns:

This object.

See Also:

FTPEnvironment.withClientConnectionWaitTimeout(long, TimeUnit)

withClientConnectionWaitTimeout

public FTPSEnvironment withClientConnectionWaitTimeout(long duration,
                                                       TimeUnit unit)

Description copied from class: FTPEnvironment

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

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

Overrides:

withClientConnectionWaitTimeout in class FTPEnvironment

Parameters:

duration - The timeout duration.

unit - The timeout unit.

Returns:

This object.

See Also:

FTPEnvironment.withClientConnectionWaitTimeout(long)

withFileSystemExceptionFactory

public FTPSEnvironment withFileSystemExceptionFactory(FileSystemExceptionFactory factory)

Description copied from class: FTPEnvironment

Stores the file system exception factory to use.

Overrides:

withFileSystemExceptionFactory in class FTPEnvironment

Parameters:

factory - The file system exception factory to use.

Returns:

This object.

withFTPFileStrategyFactory

public FTPSEnvironment withFTPFileStrategyFactory(FTPFileStrategyFactory factory)

Description copied from class: FTPEnvironment

Stores the FTP file strategy factory to use.

Overrides:

withFTPFileStrategyFactory in class FTPEnvironment

Parameters:

factory - The FTP file strategy factory to use.

Returns:

This object.

withAbsoluteFilePathSupport

@Deprecated
public FTPSEnvironment withAbsoluteFilePathSupport(boolean supportAbsoluteFilePaths)

Deprecated. Use withFTPFileStrategyFactory(FTPFileStrategyFactory) instead. A value of true should be replaced with FTPFileStrategyFactory.AUTO_DETECT, a value of false with FTPFileStrategyFactory.NON_UNIX.

Description copied from class: FTPEnvironment

Stores whether or not FTP servers support absolute paths to list files. If set to false, getting information about a file will list its parent directory. If set to true, the server settings will determine how files are listed.

This setting should be set to false for servers that do not support LIST commands of absolute files.

Overrides:

withAbsoluteFilePathSupport in class FTPEnvironment

Parameters:

supportAbsoluteFilePaths - false if FTP servers do not support absolute paths to list files, or true to use the server settings.

Returns:

This object.

withActualTotalSpaceCalculation

@Deprecated
public FTPSEnvironment withActualTotalSpaceCalculation(boolean calculateActualTotalSpace)

Deprecated. FileStore.getTotalSpace() does not need to traverse the file system, because that would calculate the total used space, not the total space.

Description copied from class: FTPEnvironment

Stores whether or not FileStore.getTotalSpace() should calculate the actual total space by traversing the file system. If not explicitly set to true, the method will return Long.MAX_VALUE instead.

Overrides:

withActualTotalSpaceCalculation in class FTPEnvironment

Parameters:

calculateActualTotalSpace - true if FileStore.getTotalSpace() should calculate the actual total space by traversing the file system, or false otherwise.

Returns:

This object.

withSecurityMode

public FTPSEnvironment withSecurityMode(SecurityMode securityMode)

Stores the security mode to use. If the security mode is not set, it will default to SecurityMode.EXPLICIT.

Parameters:

securityMode - The security mode to use.

Returns:

This object.

withSSLContext

public FTPSEnvironment withSSLContext(SSLContext sslContext)

Stores the SSL context to use. If the SSL context is not set, the protocol will be used instead.

Parameters:

sslContext - The SSL context to use.

Returns:

This object.

withProtocol

public FTPSEnvironment withProtocol(String protocol)

Stores the protocol to use. If the protocol is not set, it will default to TLS. The protocol will be ignored if an SSLContext is stored.

Parameters:

protocol - The protocol to use.

Returns:

This object.

withAuthCommand

public FTPSEnvironment withAuthCommand(String command)

Stores the AUTH command to use.

Parameters:

command - The AUTH command to use.

Returns:

This object.

withKeyManager

public FTPSEnvironment withKeyManager(KeyManager keyManager)

Stores the key manager to use.

Parameters:

keyManager - The key manager to use.

Returns:

This object.

See Also:

SSLContext.init(KeyManager[], TrustManager[], SecureRandom)

withTrustManager

public FTPSEnvironment withTrustManager(TrustManager trustManager)

Stores the trust manager to use.

Parameters:

trustManager - The trust manager to use.

Returns:

This object.

See Also:

SSLContext.init(KeyManager[], TrustManager[], SecureRandom)

withHostnameVerifier

public FTPSEnvironment withHostnameVerifier(HostnameVerifier hostnameVerifier)

Stores the hostname verifier to use. The verifier is only used on client mode connections.

Parameters:

hostnameVerifier - The hostname verifier to use.

Returns:

This object.

withEndpointCheckingEnabled

public FTPSEnvironment withEndpointCheckingEnabled(boolean enabled)

Stores whether or not endpoint identification using the HTTPS algorithm should be enabled. The default behaviour is for this to be disabled. This check is only performed on client mode connections.

Parameters:

enabled - true if endpoint identification should be enabled, or false if it should be disabled.

Returns:

This object.

See Also:

SSLSocket.setSSLParameters(SSLParameters), SSLParameters.setEndpointIdentificationAlgorithm(String)

withEnabledSessionCreation

public FTPSEnvironment withEnabledSessionCreation(boolean established)

Stores whether or not new SSL sessions may be established by sockets.

Parameters:

established - The established socket flag.

Returns:

This object.

See Also:

SSLSocket.setEnableSessionCreation(boolean)

withNeedClientAuth

public FTPSEnvironment withNeedClientAuth(boolean needClientAuth)

Stores whether or not sockets will require client authentication.

Parameters:

needClientAuth - The need client authentication flag.

Returns:

This object.

See Also:

SSLSocket.setNeedClientAuth(boolean)

withWantClientAuth

public FTPSEnvironment withWantClientAuth(boolean wantClientAuth)

Stores whether or not sockets will request client authentication.

Parameters:

wantClientAuth - The want client authentication flag.

Returns:

This object.

See Also:

SSLSocket.setWantClientAuth(boolean)

withUseClientMode

public FTPSEnvironment withUseClientMode(boolean useClientMode)

Stores whether or not sockets are set to use client mode in their first handshake.

Parameters:

useClientMode - The use client mode flag.

Returns:

This object.

See Also:

SSLSocket.setUseClientMode(boolean)

withEnabledCipherSuites

public FTPSEnvironment withEnabledCipherSuites(String... cipherSuites)

Stores the names of the cipher suites which could be enabled for use on connections.

Parameters:

cipherSuites - The names of the cipher suites to use.

Returns:

This object.

See Also:

SSLSocket.setEnabledCipherSuites(String[])

withEnabledProtocols

public FTPSEnvironment withEnabledProtocols(String... protocolVersions)

Stores which particular protocol versions are enabled for use on connections.

Parameters:

protocolVersions - The protocol versions to use.

Returns:

This object.

See Also:

SSLSocket.setEnabledProtocols(String[])

clone

public FTPSEnvironment clone()

Overrides:

clone in class FTPEnvironment