toxTree.core

Class Introspection

java.lang.Object

toxTree.core.Introspection

public class Introspection
extends Object

A singleton class with static method to provide some sort of introspection :) Used in decision tree editor to provide a list of available decision trees, available rules, available categories.
This is done by searching for classes implementing IDecisionMethod, IDecisionRule, and IDecisionCategory in all .jar files in a user defined directory.

Author:

Nina Jeliazkova nina@acad.bg Modified 2005-10-18

Field Summary

Fields

Modifier and Type	Field and Description
protected static String[]	defaultLocation
protected static ToxTreeClassLoader	loader
protected static Logger	logger
static String	TOXTREE_HOME

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Introspection()

Method Summary

Modifier and Type	Method and Description
static void	addDirectory(String dirName)
static void	configureURLLoader(ClassLoader classLoader) Adds URLS of jars in default directories to the class loader.
static void	configureURLLoader(File directory) Adds URLS of jars in specified directory to the class loader.
static void	configureURLLoader(File[] jars) Adds URLS of jars specified in File[] to the class loader.
static Object	createObject(String className) Creates object given the class name
static File[]	enumerateJars(File directory)
static ToxTreePackageEntries	getAvailableCategoryTypes(ClassLoader classLoader) Returns a list with available categories
static ToxTreePackageEntries	getAvailableRuleTypes(ClassLoader classLoader) Returns a list with available rule names.
static ToxTreePackageEntries	getAvailableTreeTypes(ClassLoader classLoader) Returns a list with available decision trees.
static ToxTreePackageEntries	getAvailableTypes(ClassLoader classLoader, String interfacename) This method is the core of ToxTreeApp extension mechanism.
static String[]	getDefaultDirectories()
static ClassLoader	getLoader()
static String	getToxTreeRoot()
static ToxTreePackageEntries	implementInterface(ClassLoader classLoader, File directory, String interfaceName) Finds classes implementing an interface in all .jar files in a user defined directory.
static Class	implementsInterface(Class clazz, String interfaceName) Verifies if a class implements an interface
static Class	implementsInterface(String className, String interfaceName) Verifies if a class implements an interface
static void	listBaseTypes(Class cls, String prefix) this is just a test for the concept of introspection
static Object	loadCreateObject(String className)
static IDecisionMethodsList	loadForest(InputStream stream)
static IDecisionMethodsList	loadForestXML(InputStream stream)
static IDecisionMethod	loadRules(InputStream stream, String newTitle) Loads a decision tree from an InputStream Uses Java serialization mechanism
static IDecisionMethod	loadRulesXML(InputStream stream, String newTitle)
static void	saveRulesXML(IDecisionMethod method, OutputStream out)
static void	setLoader(ClassLoader classLoader)

Methods inherited from class java.lang.Object

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

Field Detail

TOXTREE_HOME

public static final String TOXTREE_HOME

See Also:

Constant Field Values

defaultLocation

protected static String[] defaultLocation

logger

protected static transient Logger logger

loader

protected static ToxTreeClassLoader loader

Constructor Detail

Introspection

protected Introspection()

Method Detail

addDirectory

public static void addDirectory(String dirName)

getDefaultDirectories

public static String[] getDefaultDirectories()

listBaseTypes

public static void listBaseTypes(Class cls,
                                 String prefix)

this is just a test for the concept of introspection

implementsInterface

public static Class implementsInterface(String className,
                                        String interfaceName)
                                 throws IntrospectionException

Verifies if a class implements an interface

Parameters:

className - - the name of the class to be verified

interfaceName - - the name of the interface to be searched for

Returns:

Class

Throws:

IntrospectionException

implementsInterface

public static Class implementsInterface(Class clazz,
                                        String interfaceName)

Verifies if a class implements an interface

Parameters:

clazz - - the class to be verified

interfaceName - - the name of the interface to be searched for

Returns:

Class

enumerateJars

public static File[] enumerateJars(File directory)
                            throws IntrospectionException

Throws:

IntrospectionException

configureURLLoader

public static void configureURLLoader(ClassLoader classLoader)

Adds URLS of jars in default directories to the class loader. Calls configureURLLoader(File directory) for each of defaultLocation directories.

Parameters:

classLoader -

configureURLLoader

public static void configureURLLoader(File directory)
                               throws IntrospectionException

Adds URLS of jars in specified directory to the class loader.

Parameters:

directory -

Throws:

IntrospectionException

configureURLLoader

public static void configureURLLoader(File[] jars)
                               throws IntrospectionException

Adds URLS of jars specified in File[] to the class loader.

Parameters:

jars -

Throws:

IntrospectionException

implementInterface

public static ToxTreePackageEntries implementInterface(ClassLoader classLoader,
                                                       File directory,
                                                       String interfaceName)
                                                throws IntrospectionException

Finds classes implementing an interface in all .jar files in a user defined directory.

Parameters:

directory - - the directory with jar files to be searched for

interfaceName - - the name of the interface to be searched for

Returns:

ToxTreePackageEntries of String , each item is a class name

Throws:

IntrospectionException

getAvailableRuleTypes

public static ToxTreePackageEntries getAvailableRuleTypes(ClassLoader classLoader)

Returns a list with available rule names. Uses getAvailableTypes(ClassLoader, String)

Returns:

an ArrayList of class names that implement IDecisionRule

getAvailableTreeTypes

public static ToxTreePackageEntries getAvailableTreeTypes(ClassLoader classLoader)

Returns a list with available decision trees. Uses getAvailableTypes(ClassLoader, String)

Returns:

an ArrayList of class names that implement IDecisionMethod

getAvailableTypes

public static ToxTreePackageEntries getAvailableTypes(ClassLoader classLoader,
                                                      String interfacename)

This method is the core of ToxTreeApp extension mechanism. Looks for classes that implement interface given by interfacename parameter. Returns a list with class names. Jar files within the following directories are analyzed:

• The directory from where the application was started (current directory "."). This is usually the directory where toxTree.jar resides.
• The directory "dist" below the current directory.
• The directory "ext" below the current directory.

Parameters:

classLoader -

interfacename - the

Returns:

a list with available class names , implementing the interface ArrayList

getAvailableCategoryTypes

public static ToxTreePackageEntries getAvailableCategoryTypes(ClassLoader classLoader)

Returns a list with available categories

Returns:

an ArrayList of class names that implement IDecisionCategory

createObject

public static Object createObject(String className)

Creates object given the class name

Parameters:

className -

Returns:

Object

loadCreateObject

public static Object loadCreateObject(String className)
                               throws InstantiationException,
                                      IllegalAccessException,
                                      ClassNotFoundException

Throws:

InstantiationException

IllegalAccessException

ClassNotFoundException

getLoader

public static ClassLoader getLoader()

setLoader

public static void setLoader(ClassLoader classLoader)

loadRules

public static IDecisionMethod loadRules(InputStream stream,
                                        String newTitle)
                                 throws IntrospectionException

Loads a decision tree from an InputStream Uses Java serialization mechanism

Parameters:

stream -

newTitle -

Returns:

a decision tree IDecisionMethod

Throws:

IntrospectionException

loadForest

public static IDecisionMethodsList loadForest(InputStream stream)
                                       throws IntrospectionException

Throws:

IntrospectionException

saveRulesXML

public static void saveRulesXML(IDecisionMethod method,
                                OutputStream out)
                         throws IntrospectionException

Throws:

IntrospectionException

loadRulesXML

public static IDecisionMethod loadRulesXML(InputStream stream,
                                           String newTitle)
                                    throws IntrospectionException

Throws:

IntrospectionException

loadForestXML

public static IDecisionMethodsList loadForestXML(InputStream stream)
                                          throws IntrospectionException

Throws:

IntrospectionException

getToxTreeRoot

public static String getToxTreeRoot()