org.apache.commons.modeler.util
Class IntrospectionUtils

java.lang.Object
  |
  +--org.apache.commons.modeler.util.IntrospectionUtils

public final class IntrospectionUtils

extends Object

Utils for introspection and reflection Source: jakarta-tomcat-connector/util

Inner Class Summary

static interface	IntrospectionUtils.AttributeHolder
static interface	IntrospectionUtils.PropertySource

Field Summary

static String

PATH_SEPARATOR

Constructor Summary

IntrospectionUtils()

Method Summary

static void	addJarsFromClassPath(Vector jars, String cp) add elements from the classpath cp to a Vector jars as file URLs (We use Vector for JDK 1.1 compat).
static void	addToClassPath(Vector cpV, String dir) Add all the jar files in a dir to the classpath, represented as a Vector of URLs.
static void	addToolsJar(Vector v)
static void	callMain(Class c, String[] args)
static Object	callMethod0(Object target, String methodN)
static Object	callMethod1(Object target, String methodN, Object param1, String typeParam1, ClassLoader cl)
static Object	callMethodN(Object target, String methodN, Object[] params, Class[] typeParams)
static String	capitalize(String name) Reverse of Introspector.decapitalize
static String	classPathAdd(URL[] urls, String cp) Adds classpath entries from a vector of URL's to the "tc_path_add" System property.
static void	clear()
static void	displayClassPath(String msg, URL[] cp) Debug method, display the classpath
static void	execute(Object proxy, String method) Execute a no-param method.
static String[]	findBooleanSetters(Class c)
static Method	findMethod(Class c, String name, Class[] params)
static Method[]	findMethods(Class c)
static String[]	findVoidSetters(Class c)
static Object	getAttribute(Object proxy, String n) Call void getAttribute( String )
static URL[]	getClassPath(String dir, String cpath, String cpathProp, boolean addTools) Construct a URL classpath from files in a directory, a cpath property, and tools.jar.
static URL[]	getClassPath(Vector v) Return a URL[] that can be used to construct a class loader
static String[]	getFilesByExt(String ld, String ext) Return all files with a given extension in a dir
static Object	getProperty(Object o, String name)
static URL	getURL(String base, String file) Construct a file url from a file, using a base dir
static ClassLoader	getURLClassLoader(URL[] urls, ClassLoader parent) Construct a URLClassLoader.
static String	guessInstall(String installSysProp, String homeSysProp, String jarName)
static String	guessInstall(String installSysProp, String homeSysProp, String jarName, String classFile) Guess a product install/home by analyzing the class path.
static boolean	hasHook(Object obj, String methodN) Test if the object implements a particular method
static boolean	processArgs(Object proxy, String[] args)
static boolean	processArgs(Object proxy, String[] args, String[] args0, String[] args1, Hashtable aliases)
static String	replaceProperties(String value, Hashtable staticProp, IntrospectionUtils.PropertySource[] dynamicProp) Replace ${NAME} with the property value
static String	replaceProperties(String value, Object getter) Deprecated. Use the explicit method
static void	setAttribute(Object proxy, String n, Object v) Call void setAttribute( String ,Object )
static void	setProperty(Object o, String name)
static void	setProperty(Object o, String name, String value) Find a method with the right name If found, call the method ( if param is int or boolean we'll convert value to the right type before) - that means you can have setDebug(1).
static String	unCapitalize(String name)

Methods inherited from class java.lang.Object

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

Field Detail

PATH_SEPARATOR

public static String PATH_SEPARATOR

Constructor Detail

IntrospectionUtils

public IntrospectionUtils()

Method Detail

execute

public static void execute(Object proxy,
                           String method)
                    throws Exception

Execute a no-param method.

setAttribute

public static void setAttribute(Object proxy,
                                String n,
                                Object v)
                         throws Exception

Call void setAttribute( String ,Object )

getAttribute

public static Object getAttribute(Object proxy,
                                  String n)
                           throws Exception

Call void getAttribute( String )

getURLClassLoader

public static ClassLoader getURLClassLoader(URL[] urls,
                                            ClassLoader parent)

Construct a URLClassLoader. Will compile and work in JDK1.1 too.

guessInstall

public static String guessInstall(String installSysProp,
                                  String homeSysProp,
                                  String jarName)

guessInstall

public static String guessInstall(String installSysProp,
                                  String homeSysProp,
                                  String jarName,
                                  String classFile)

Guess a product install/home by analyzing the class path. It works for product using the pattern: lib/executable.jar or if executable.jar is included in classpath by a shell script. ( java -jar also works ) Insures both "install" and "home" System properties are set. If either or both System properties are unset, "install" and "home" will be set to the same value. This value will be the other System property that is set, or the guessed value if neither is set.

displayClassPath

public static void displayClassPath(String msg,
                                    URL[] cp)

Debug method, display the classpath

classPathAdd

public static String classPathAdd(URL[] urls,
                                  String cp)

Adds classpath entries from a vector of URL's to the "tc_path_add" System property. This System property lists the classpath entries common to web applications. This System property is currently used by Jasper when its JSP servlet compiles the Java file for a JSP.

setProperty

public static void setProperty(Object o,
                               String name,
                               String value)

Find a method with the right name If found, call the method ( if param is int or boolean we'll convert value to the right type before) - that means you can have setDebug(1).

getProperty

public static Object getProperty(Object o,
                                 String name)

setProperty

public static void setProperty(Object o,
                               String name)

replaceProperties

public static String replaceProperties(String value,
                                       Object getter)

Deprecated. Use the explicit method

Replace ${NAME} with the property value

replaceProperties

public static String replaceProperties(String value,
                                       Hashtable staticProp,
                                       IntrospectionUtils.PropertySource[] dynamicProp)

Replace ${NAME} with the property value

capitalize

public static String capitalize(String name)

Reverse of Introspector.decapitalize

unCapitalize

public static String unCapitalize(String name)

addToClassPath

public static void addToClassPath(Vector cpV,
                                  String dir)

Add all the jar files in a dir to the classpath, represented as a Vector of URLs.

addToolsJar

public static void addToolsJar(Vector v)

getFilesByExt

public static String[] getFilesByExt(String ld,
                                     String ext)

Return all files with a given extension in a dir

getURL

public static URL getURL(String base,
                         String file)

Construct a file url from a file, using a base dir

addJarsFromClassPath

public static void addJarsFromClassPath(Vector jars,
                                        String cp)
                                 throws IOException,
                                        MalformedURLException

add elements from the classpath cp to a Vector jars as file URLs (We use Vector for JDK 1.1 compat).

Parameters:

jars - A vector of URLs

cp - a String classpath of directory or jar file elements separated by path.separator delimiters.

getClassPath

public static URL[] getClassPath(Vector v)

Return a URL[] that can be used to construct a class loader

getClassPath

public static URL[] getClassPath(String dir,
                                 String cpath,
                                 String cpathProp,
                                 boolean addTools)
                          throws IOException,
                                 MalformedURLException

Construct a URL classpath from files in a directory, a cpath property, and tools.jar.

processArgs

public static boolean processArgs(Object proxy,
                                  String[] args)
                           throws Exception

processArgs

public static boolean processArgs(Object proxy,
                                  String[] args,
                                  String[] args0,
                                  String[] args1,
                                  Hashtable aliases)
                           throws Exception

findVoidSetters

public static String[] findVoidSetters(Class c)

findBooleanSetters

public static String[] findBooleanSetters(Class c)

clear

public static void clear()

findMethods

public static Method[] findMethods(Class c)

findMethod

public static Method findMethod(Class c,
                                String name,
                                Class[] params)

hasHook

public static boolean hasHook(Object obj,
                              String methodN)

Test if the object implements a particular method

callMain

public static void callMain(Class c,
                            String[] args)
                     throws Exception

callMethod1

public static Object callMethod1(Object target,
                                 String methodN,
                                 Object param1,
                                 String typeParam1,
                                 ClassLoader cl)
                          throws Exception

callMethod0

public static Object callMethod0(Object target,
                                 String methodN)
                          throws Exception

callMethodN

public static Object callMethodN(Object target,
                                 String methodN,
                                 Object[] params,
                                 Class[] typeParams)
                          throws Exception