Package org.apache.sshd.sftp.client
Interface SftpVersionSelector
- All Known Implementing Classes:
SftpVersionSelector.NamedVersionSelector
- Functional Interface:
- This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
-
Nested Class Summary
Nested ClassesModifier and TypeInterfaceDescriptionstatic class
Wraps aSftpVersionSelector
and assigns it a name. -
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final SftpVersionSelector.NamedVersionSelector
AnSftpVersionSelector
that returns the current versionstatic final SftpVersionSelector.NamedVersionSelector
AnSftpVersionSelector
that returns the maximum available versionstatic final SftpVersionSelector.NamedVersionSelector
AnSftpVersionSelector
that returns the minimum available version -
Method Summary
Modifier and TypeMethodDescriptionfixedVersionSelector
(int version) Creates a selector the always returns the requested (fixed version) regardless of what the current or reported available versions are.preferredVersionSelector
(int... preferred) Selects a version in order of preference - if none of the preferred versions is listed as available then an exception is thrown when theselectVersion(ClientSession, boolean, int, List)
method is invokedpreferredVersionSelector
(Iterable<? extends Number> preferred) Selects a version in order of preference - if none of the preferred versions is listed as available then an exception is thrown when theselectVersion(ClientSession, boolean, int, List)
method is invokedresolveVersionSelector
(String selector) Parses the input string to see if it matches one of the "known" selectors names (case insensitive).int
selectVersion
(ClientSession session, boolean initial, int current, List<Integer> available)
-
Field Details
-
CURRENT
AnSftpVersionSelector
that returns the current version -
MAXIMUM
AnSftpVersionSelector
that returns the maximum available version -
MINIMUM
AnSftpVersionSelector
that returns the minimum available version
-
-
Method Details
-
selectVersion
- Parameters:
session
- TheClientSession
through which the SFTP connection is madeinitial
- Iftrue
then this is the initial version sent viaSSH_FXP_INIT
otherwise it is a re-negotiation.current
- The current version negotiated with the serveravailable
- Extra versions available - may be empty and/or contain only the current one- Returns:
- The new requested version - if same as current, then nothing is done
-
fixedVersionSelector
Creates a selector the always returns the requested (fixed version) regardless of what the current or reported available versions are. If the requested version is not reported as available then an exception will be eventually thrown by the client during re-negotiation phase.- Parameters:
version
- The requested version- Returns:
- The
SftpVersionSelector.NamedVersionSelector
wrapping the requested version
-
preferredVersionSelector
Selects a version in order of preference - if none of the preferred versions is listed as available then an exception is thrown when theselectVersion(ClientSession, boolean, int, List)
method is invoked- Parameters:
preferred
- The preferred versions in decreasing order of preference (i.e., most preferred is 1st) - may not benull
/empty- Returns:
- A
SftpVersionSelector.NamedVersionSelector
that attempts to select the most preferred version that is also listed as available.
-
preferredVersionSelector
static SftpVersionSelector.NamedVersionSelector preferredVersionSelector(Iterable<? extends Number> preferred) Selects a version in order of preference - if none of the preferred versions is listed as available then an exception is thrown when theselectVersion(ClientSession, boolean, int, List)
method is invoked- Parameters:
preferred
- The preferred versions in decreasing order of preference (i.e., most preferred is 1st)- Returns:
- A
SftpVersionSelector.NamedVersionSelector
that attempts to select the most preferred version that is also listed as available.
-
resolveVersionSelector
Parses the input string to see if it matches one of the "known" selectors names (case insensitive). If not, then checks if it is a single number and uses it as afixed
version. Otherwise, assumes a comma separated list of versions in preferred order.- Parameters:
selector
- The selector value - ifnull
/empty then returnsCURRENT
- Returns:
- Parsed
SftpVersionSelector.NamedVersionSelector
-