org.gradle.openapi.external

Class ExternalUtility

java.lang.Object

org.gradle.openapi.external.ExternalUtility

public class ExternalUtility
extends Object

Utility functions required by the OpenAPI

Author:

mhunsicker

Constructor Summary

Constructors

Constructor and Description
ExternalUtility()

Method Summary

Methods

Modifier and Type	Method and Description
static String	dumpConstructors(Class classInQuestion)
static String	dumpMethods(Class classInQuestion)
static ClassLoader	getGradleClassloader(ClassLoader parentClassLoader, File gradleHomeDirectory, boolean showDebugInfo) Call this to get a classloader that has loaded gradle.
static File	getGradleJar(File gradleHomeDirectory) This locates the gradle jar.
static Object	invokeStaticMethod(Class classToInvoke, String methodName, Class[] argumentsClasses, Object... argumentValues) This wraps up invoking a static method into a single call.
static Class	loadGradleClass(String classToLoad, ClassLoader parentClassLoader, File gradleHomeDirectory, boolean showDebugInfo) This attempts to load the a class from the specified gradle home directory.

Methods inherited from class java.lang.Object

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

Constructor Detail

ExternalUtility

public ExternalUtility()

Method Detail

getGradleClassloader

public static ClassLoader getGradleClassloader(ClassLoader parentClassLoader,
                               File gradleHomeDirectory,
                               boolean showDebugInfo)
                                        throws Exception

Call this to get a classloader that has loaded gradle.

Parameters:

parentClassLoader - Your classloader. Probably the classloader of whatever class is calling this.

gradleHomeDirectory - the root directory of a gradle installation

showDebugInfo - true to show some additional information that may be helpful diagnosing problems is this fails

Returns:

a classloader that has loaded gradle and all of its dependencies.

Throws:

Exception

getGradleJar

public static File getGradleJar(File gradleHomeDirectory)

This locates the gradle jar. We do NOT want the gradle-wrapper jar.

Parameters:

gradleHomeDirectory - the root directory of a gradle installation. We're expecting this to have a child directory named 'lib'.

Returns:

the gradle jar file. Null if we didn't find it.

dumpConstructors

public static String dumpConstructors(Class classInQuestion)

dumpMethods

public static String dumpMethods(Class classInQuestion)

loadGradleClass

public static Class loadGradleClass(String classToLoad,
                    ClassLoader parentClassLoader,
                    File gradleHomeDirectory,
                    boolean showDebugInfo)
                             throws Exception

This attempts to load the a class from the specified gradle home directory.

Parameters:

classToLoad - the full path to the class to load

parentClassLoader - Your classloader. Probably the classloader of whatever class is calling this.

gradleHomeDirectory - the root directory of a gradle installation

showDebugInfo - true to show some additional information that may be helpful diagnosing problems is this fails

Throws:

Exception

invokeStaticMethod

public static Object invokeStaticMethod(Class classToInvoke,
                        String methodName,
                        Class[] argumentsClasses,
                        Object... argumentValues)
                                 throws Exception

This wraps up invoking a static method into a single call.

Parameters:

classToInvoke - the class that has the method

methodName - the name of the method to invoke

argumentsClasses - the classes of the arguments (we can't determine this from the argumentValues because they can be of class A, but implement class B and B is be the argument type of the method in question

argumentValues - the values of the arguments.

Returns:

the return value of invoking the method.

Throws:

Exception