org.apache.sshd.common.mac

Enum BuiltinMacs

java.lang.Object

java.lang.Enum<BuiltinMacs>

org.apache.sshd.common.mac.BuiltinMacs

All Implemented Interfaces:

Serializable, Comparable<BuiltinMacs>, BuiltinFactory<Mac>, Factory<Mac>, MacFactory, NamedFactory<Mac>, NamedResource, OptionalFeature

public enum BuiltinMacs
extends Enum<BuiltinMacs>
implements MacFactory

Provides easy access to the currently implemented macs

Author:

Apache MINA SSHD Project

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BuiltinMacs.Constants
static class	BuiltinMacs.ParseResult

Nested classes/interfaces inherited from interface org.apache.sshd.common.BuiltinFactory

BuiltinFactory.Utils

Enum Constant Summary

Enum Constants

Enum Constant and Description
hmacmd5
hmacmd596
hmacsha1
hmacsha196
hmacsha256
hmacsha512

Field Summary

Fields

Modifier and Type	Field and Description
static Set<BuiltinMacs>	VALUES

Fields inherited from interface org.apache.sshd.common.NamedResource

BY_NAME_COMPARATOR, NAME_EXTRACTOR

Method Summary

Modifier and Type	Method and Description
static BuiltinMacs	fromFactory(NamedFactory<Digest> factory)
static BuiltinMacs	fromFactoryName(String name)
static BuiltinMacs	fromString(String s)
String	getName()
static SortedSet<MacFactory>	getRegisteredExtensions()
boolean	isSupported()
static BuiltinMacs.ParseResult	parseMacsList(Collection<String> macs)
static BuiltinMacs.ParseResult	parseMacsList(String... macs)
static BuiltinMacs.ParseResult	parseMacsList(String macs)
static void	registerExtension(MacFactory extension) Registered a NamedFactory to be available besides the built-in ones when parsing configuration
static MacFactory	resolveFactory(String name)
String	toString()
static MacFactory	unregisterExtension(String name) Unregisters specified extension
static BuiltinMacs	valueOf(String name) Returns the enum constant of this type with the specified name.
static BuiltinMacs[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.apache.sshd.common.Factory

create

Enum Constant Detail

hmacmd5

public static final BuiltinMacs hmacmd5

hmacmd596

public static final BuiltinMacs hmacmd596

hmacsha1

public static final BuiltinMacs hmacsha1

hmacsha196

public static final BuiltinMacs hmacsha196

hmacsha256

public static final BuiltinMacs hmacsha256

hmacsha512

public static final BuiltinMacs hmacsha512

Field Detail

VALUES

public static final Set<BuiltinMacs> VALUES

Method Detail

values

public static BuiltinMacs[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (BuiltinMacs c : BuiltinMacs.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static BuiltinMacs valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null

getName

public final String getName()

Specified by:

getName in interface NamedResource

Returns:

The resource name

isSupported

public final boolean isSupported()

Specified by:

isSupported in interface OptionalFeature

toString

public final String toString()

Overrides:

toString in class Enum<BuiltinMacs>

registerExtension

public static void registerExtension(MacFactory extension)

Registered a NamedFactory to be available besides the built-in ones when parsing configuration

Parameters:

extension - The factory to register

Throws:

IllegalArgumentException - if factory instance is null, or overrides a built-in one or overrides another registered factory with the same name (case insensitive).

getRegisteredExtensions

public static SortedSet<MacFactory> getRegisteredExtensions()

Returns:

A SortedSet of the currently registered extensions, sorted according to the factory name (case insensitive)

unregisterExtension

public static MacFactory unregisterExtension(String name)

Unregisters specified extension

Parameters:

name - The factory name - ignored if null/empty

Returns:

The registered extension - null if not found

fromString

public static BuiltinMacs fromString(String s)

Parameters:

s - The Enum's name - ignored if null/empty

Returns:

The matching BuiltinMacs whose Enum.name() matches (case insensitive) the provided argument - null if no match

fromFactory

public static BuiltinMacs fromFactory(NamedFactory<Digest> factory)

Parameters:

factory - The NamedFactory for the Mac - ignored if null

Returns:

The matching BuiltinMacs whose factory name matches (case insensitive) the digest factory name

See Also:

fromFactoryName(String)

fromFactoryName

public static BuiltinMacs fromFactoryName(String name)

Parameters:

name - The factory name - ignored if null/empty

Returns:

The matching BuiltinMacs whose factory name matches (case insensitive) the provided name - null if no match

parseMacsList

public static BuiltinMacs.ParseResult parseMacsList(String macs)

Parameters:

macs - A comma-separated list of MACs' names - ignored if null/empty

Returns:

A BuiltinMacs.ParseResult containing the successfully parsed factories and the unknown ones. Note: it is up to caller to ensure that the lists do not contain duplicates

parseMacsList

public static BuiltinMacs.ParseResult parseMacsList(String... macs)

parseMacsList

public static BuiltinMacs.ParseResult parseMacsList(Collection<String> macs)

resolveFactory

public static MacFactory resolveFactory(String name)

Parameters:

name - The factory name

Returns:

The factory or null if it is neither a built-in one or a registered extension