org.springframework.core

Interface SmartClassLoader

public interface SmartClassLoader

Interface to be implemented by a reloading-aware ClassLoader (e.g. a Groovy-based ClassLoader). Detected for example by Spring's CGLIB proxy factory for making a caching decision.

If a ClassLoader does not implement this interface, then all of the classes obtained from it should be considered as not reloadable (i.e. cacheable).

Since:

2.5.1

Author:

Juergen Hoeller

Method Summary

Modifier and Type	Method and Description
default boolean	isClassReloadable(Class<?> clazz) Determine whether the given class is reloadable (in this ClassLoader).
default Class<?>	publicDefineClass(String name, byte[] b, ProtectionDomain protectionDomain) Define a custom class (typically a CGLIB proxy class) in this class loader.

Method Detail

isClassReloadable

default boolean isClassReloadable(Class<?> clazz)

Determine whether the given class is reloadable (in this ClassLoader).

Typically used to check whether the result may be cached (for this ClassLoader) or whether it should be reobtained every time. The default implementation always returns false.

Parameters:

clazz - the class to check (usually loaded from this ClassLoader)

Returns:

whether the class should be expected to appear in a reloaded version (with a different Class object) later on

publicDefineClass

default Class<?> publicDefineClass(String name,
                                   byte[] b,
                                   @Nullable
                                   ProtectionDomain protectionDomain)

Define a custom class (typically a CGLIB proxy class) in this class loader.

This is a public equivalent of the protected defineClass(String, byte[], int, int, ProtectionDomain) method in ClassLoader which is traditionally invoked via reflection. A concrete implementation in a custom class loader should simply delegate to that protected method in order to make classloader-specific definitions publicly available without "illegal access" warnings on JDK 9+: return defineClass(name, b, 0, b.length, protectionDomain). Note that the JDK 9+ Lookup#defineClass method does not support a custom target class loader for the new definition; it rather always defines the class in the same class loader as the lookup's context class.

Parameters:

name - the name of the class

b - the bytes defining the class

protectionDomain - the protection domain for the class, if any

Returns:

the newly created class

Throws:

LinkageError - in case of a bad class definition

SecurityException - in case of an invalid definition attempt

UnsupportedOperationException - in case of a custom definition attempt not being possible (thrown by the default implementation in this interface)

Since:

5.3.4

See Also:

ClassLoader.defineClass(String, byte[], int, int, ProtectionDomain), java.lang.invoke.MethodHandles.Lookup#defineClass(byte[])