com.sshtools.ssh.components

Class ComponentFactory

java.lang.Object

com.sshtools.ssh.components.ComponentFactory

All Implemented Interfaces:

Cloneable

public class ComponentFactory
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<Object>	order
protected Hashtable<String,Class<?>>	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(Class<?> type) Create a component factory with the base class supplied.

Method Summary

Modifier and Type	Method and Description
void	add(String name, Class<?> 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()
boolean	contains(String name) Determine whether the factory supports a given component type.
protected Object	createInstance(String name, Class<?> cls) Override this method to create an instance of the component.
String	createNewOrdering(int[] ordering)
Object	getInstance(String name) Get a new instance of a supported component.
String	list(String preferred) List the types of components supported by this factory.
void	lockComponents()
void	remove(String name) Remove a supported component
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<?>> 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<Object> order

Constructor Detail

ComponentFactory

public ComponentFactory(Class<?> type)

Create a component factory with the base class supplied.

Parameters:

type -

Throws:

ClassNotFoundException - Thrown if the class cannot be resolved.

Method Detail

changePositionofAlgorithm

public String changePositionofAlgorithm(String name,
                                        int position)
                                 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)

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<?> 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 Object createInstance(String name,
                                Class<?> 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()

lockComponents

public void lockComponents()