com.maverick.ssh.components

Class ComponentFactory<T>

java.lang.Object

com.maverick.ssh.components.ComponentFactory<T>

All Implemented Interfaces:

Cloneable

public class ComponentFactory<T>
extends Object
implements Cloneable

A utility class used to store the available transport components and provide delimited listing as required in the key exchange initialization process.

Author:

Lee David Painter

Field Summary

Fields

Modifier and Type	Field and Description
protected Vector<String>	order
protected Hashtable<String,Class<? extends T>>	supported The supported components stored in a Hashtable with a String key as the component name such as "3des-cbc" and a Class value storing the implementation class.

Constructor Summary

Constructors

Constructor and Description
ComponentFactory(ComponentManager componentManager)
ComponentFactory(ComponentManager componentManager, String configurationDirective)

Method Summary

Modifier and Type	Method and Description
void	add(String name, Class<? extends T> cls) Add a new component type to the factory.
String	changePositionofAlgorithm(String name, int position)
void	clear() Clear all of the entries in this component factory.
Object	clone()
void	configureSecurityLevel(SecurityLevel securityLevel)
void	configureSecurityLevel(SecurityLevel securityLevel, boolean locked)
boolean	contains(String name) Determine whether the factory supports a given component type.
protected T	createInstance(String name, Class<? extends T> cls) Override this method to create an instance of the component.
String	createNewOrdering(int[] ordering)
String	filter(String list, String... ignores)
Object	getInstance(String name) Get a new instance of a supported component.
SecurityLevel	getMaximumSecurity()
SecurityLevel	getMinimumSecurity()
SecurityLevel	getSecurityLevel()
SecurityLevel	getSecurityLevel(String algorithm)
boolean	hasComponents()
String	list()
String	list(String preferred) List the types of components supported by this factory.
String	list(String preferred, String... ignores) List the types of components supported by this factory.
String	listInclusive(String preference, Set<String> includes)
void	lockComponents()
Collection<String>	names()
Collection<String>	order()
String	order(String[] ordering)
void	remove(String name) Remove a supported component
void	removeAllBut(String names)
String	selectStrongestComponent(String[] remoteAlgs)
String[]	toArray()

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

supported

protected Hashtable<String,Class<? extends T>> supported

The supported components stored in a Hashtable with a String key as the component name such as "3des-cbc" and a Class value storing the implementation class.

order

protected Vector<String> order

Constructor Detail

ComponentFactory

public ComponentFactory(ComponentManager componentManager,
                        String configurationDirective)

ComponentFactory

public ComponentFactory(ComponentManager componentManager)

Method Detail

getSecurityLevel

public SecurityLevel getSecurityLevel()

changePositionofAlgorithm

public String changePositionofAlgorithm(String name,
                                        int position)
                                 throws SshException

Throws:

SshException

names

public Collection<String> names()

order

public String order(String[] ordering)
             throws SshException

Throws:

SshException

createNewOrdering

public String createNewOrdering(int[] ordering)
                         throws SshException

Throws:

SshException

contains

public boolean contains(String name)

Determine whether the factory supports a given component type.

Parameters:

name -

Returns:

true if the component is supported otherwise false

list

public String list(String preferred,
                   String... ignores)

List the types of components supported by this factory. Returns the list as a comma delimited string with the preferred value as the first entry in the list. If the preferred value is "" then the list is returned unordered.

Parameters:

preferred - The preferred component type.

ignores - Any items you want to exclude from the returned list.

Returns:

A comma delimited String of component types; for example "3des-cbc,blowfish-cbc"

list

public String list(String preferred)

List the types of components supported by this factory. Returns the list as a comma delimited string with the preferred value as the first entry in the list. If the preferred value is "" then the list is returned unordered.

Parameters:

preferred - The preferred component type.

Returns:

A comma delimited String of component types; for example "3des-cbc,blowfish-cbc"

add

public void add(String name,
                Class<? extends T> cls)

Add a new component type to the factory. This method throws an exception if the class cannot be resolved. The name of the component IS NOT verified to allow component implementations to be overridden.

Parameters:

name -

cls -

Throws:

ClassNotFoundException

getInstance

public Object getInstance(String name)
                   throws SshException

Get a new instance of a supported component.

Parameters:

name - The name of the component; for example "3des-cbc"

Returns:

the newly instantiated object

Throws:

ClassNotFoundException

SshException

createInstance

protected T createInstance(String name,
                           Class<? extends T> cls)
                    throws Throwable

Override this method to create an instance of the component.

Parameters:

cls -

Returns:

the newly instantiated object

Throws:

Throwable

remove

public void remove(String name)

Remove a supported component

Parameters:

name -

clear

public void clear()

Clear all of the entries in this component factory.

clone

public Object clone()

Overrides:

clone in class Object

toArray

public String[] toArray()

removeAllBut

public void removeAllBut(String names)

lockComponents

public void lockComponents()

configureSecurityLevel

public void configureSecurityLevel(SecurityLevel securityLevel)
                            throws SshException

Throws:

SshException

configureSecurityLevel

public void configureSecurityLevel(SecurityLevel securityLevel,
                                   boolean locked)
                            throws SshException

Throws:

SshException

selectStrongestComponent

public String selectStrongestComponent(String[] remoteAlgs)
                                throws SshException

Throws:

SshException

hasComponents

public boolean hasComponents()

order

public Collection<String> order()

list

public String list()

getSecurityLevel

public SecurityLevel getSecurityLevel(String algorithm)

getMaximumSecurity

public SecurityLevel getMaximumSecurity()

getMinimumSecurity

public SecurityLevel getMinimumSecurity()

filter

public String filter(String list,
                     String... ignores)

listInclusive

public String listInclusive(String preference,
                            Set<String> includes)