org.eclipse.osgi.baseadaptor.hooks
Interface ClassLoadingStatsHook

All Known Implementing Classes:

EclipseLazyStarter, StatsManager, WeavingHookConfigurator

public interface ClassLoadingStatsHook

A ClassLoadingStatsHook hooks into the ClasspathManager class. This class allows a hook to record statistics about classloading.

Since:

3.2

See Also:

ClasspathManager, HookRegistry.getClassLoadingStatsHooks(), HookRegistry.addClassLoadingStatsHook(ClassLoadingStatsHook)

Method Summary

void	postFindLocalClass(String name, Class<?> clazz, ClasspathManager manager) Gets called by a classpath manager during ClasspathManager.findLocalClass(String) after searching the local classloader for a class.
void	postFindLocalResource(String name, URL resource, ClasspathManager manager) Gets called by a classpath manager during ClasspathManager.findLocalResource(String) after searching the local classloader for a resource.
void	preFindLocalClass(String name, ClasspathManager manager) Gets called by a classpath manager during ClasspathManager.findLocalClass(String) before searching the local classloader for a class.
void	preFindLocalResource(String name, ClasspathManager manager) Gets called by a classpath manager during ClasspathManager.findLocalResource(String) before searching the local classloader for a resource.
void	recordClassDefine(String name, Class<?> clazz, byte[] classbytes, ClasspathEntry classpathEntry, BundleEntry entry, ClasspathManager manager) Gets called by a classpath manager after an attempt is made to define a class.

Method Detail

preFindLocalClass

void preFindLocalClass(String name,
                       ClasspathManager manager)
                       throws ClassNotFoundException

Gets called by a classpath manager during ClasspathManager.findLocalClass(String) before searching the local classloader for a class. A classpath manager will call this method for each configured class loading stat hook.

Parameters:

name - the name of the requested class

manager - the classpath manager used to find and load the requested class

Throws:

ClassNotFoundException - to prevent the requested class from loading

postFindLocalClass

void postFindLocalClass(String name,
                        Class<?> clazz,
                        ClasspathManager manager)
                        throws ClassNotFoundException

Gets called by a classpath manager during ClasspathManager.findLocalClass(String) after searching the local classloader for a class. A classpath manager will call this method for each configured class loading stat hook.

Parameters:

name - the name of the requested class

clazz - the loaded class or null if not found

manager - the classpath manager used to find and load the requested class

Throws:

ClassNotFoundException

preFindLocalResource

void preFindLocalResource(String name,
                          ClasspathManager manager)

Gets called by a classpath manager during ClasspathManager.findLocalResource(String) before searching the local classloader for a resource. A classpath manager will call this method for each configured class loading stat hook.

Parameters:

name - the name of the requested resource

manager - the classpath manager used to find the requested resource

postFindLocalResource

void postFindLocalResource(String name,
                           URL resource,
                           ClasspathManager manager)

Gets called by a classpath manager during ClasspathManager.findLocalResource(String) after searching the local classloader for a resource. A classpath manager will call this method for each configured class loading stat hook.

Parameters:

name - the name of the requested resource

resource - the URL to the requested resource or null if not found

manager - the classpath manager used to find the requested resource

recordClassDefine

void recordClassDefine(String name,
                       Class<?> clazz,
                       byte[] classbytes,
                       ClasspathEntry classpathEntry,
                       BundleEntry entry,
                       ClasspathManager manager)

Gets called by a classpath manager after an attempt is made to define a class. This method allows a class loading stat hook to record data about a class definition.

Parameters:

name - the name of the class that got defined

clazz - the class object that got defined or null if an error occurred while defining a class

classbytes - the class bytes used to define the class

classpathEntry - the ClasspathEntry where the class bytes got read from

entry - the BundleEntyr source of the class bytes

manager - the classpath manager used to define the class