com.oracle.truffle.espresso.hotswap

Class EspressoHotSwap

java.lang.Object

com.oracle.truffle.espresso.hotswap.EspressoHotSwap

public final class EspressoHotSwap
extends Object

Provides access to the enhanced HotSwap capabilities of Espresso. Every method allows registration of HotSwap actions that will be fired on relevant class redefinition changes. Note: This class will not register anything unless running Java on truffle.

Since:

21.2

Method Summary

Modifier and Type	Method and Description
static boolean	registerClassInitHotSwap(Class<?> klass, boolean onChange, HotSwapAction action) Registration of a HotSwap action that is fired if the klass or any subclass thereof has a changed static initializer.
static boolean	registerHotSwapAction(Class<?> klass, HotSwapAction action) Registration of a HotSwap action that will be fired in case the klass changes.
static boolean	registerMetaInfServicesListener(Class<?> serviceType, ClassLoader loader, HotSwapAction action) Registration of a HotSwap action that will be fired if changes are detected to the declared META-INF/services for serviceType.
static boolean	registerPlugin(HotSwapPlugin plugin) Registration of a HotSwap plugin for which all generic actions are fired during HotSwap.
static boolean	registerPostHotSwapAction(HotSwapAction action) Registration of a generic post HotSwap action that will be fired after class redefinition completed.
static boolean	registerResourceListener(ClassLoader loader, String resource, HotSwapAction action) Registration of a HotSwap action that will be fired if changes are detected to the specified resource.

Methods inherited from class java.lang.Object

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

Method Detail

registerPlugin

public static boolean registerPlugin(HotSwapPlugin plugin)

Registration of a HotSwap plugin for which all generic actions are fired during HotSwap. One example of such action is the HotSwapPlugin.postHotSwap(Class[]) that is fired for a registered plugin. Note: The Plugin API is expected to change to allow plugins to receive finer-grained changes.

Parameters:

plugin - the plugin to register

Returns:

true if registration was successful

Since:

21.2

registerPostHotSwapAction

public static boolean registerPostHotSwapAction(HotSwapAction action)

Registration of a generic post HotSwap action that will be fired after class redefinition completed.

Parameters:

action - the action to fire

Returns:

true if registration was successful

Since:

21.2

registerHotSwapAction

public static boolean registerHotSwapAction(Class<?> klass,
                                            HotSwapAction action)

Registration of a HotSwap action that will be fired in case the klass changes.

Parameters:

action - the action to fire

Returns:

true if registration was successful

Since:

21.2

registerClassInitHotSwap

public static boolean registerClassInitHotSwap(Class<?> klass,
                                               boolean onChange,
                                               HotSwapAction action)

Registration of a HotSwap action that is fired if the klass or any subclass thereof has a changed static initializer. Use onChange to control if the action should only fire when the static initializer actually changed.

Parameters:

klass - the class instance

onChange - if action should be fired only when the static initializer changes

action - the action to fire

Returns:

true if registration was successful

Since:

21.2

registerResourceListener

public static boolean registerResourceListener(ClassLoader loader,
                                               String resource,
                                               HotSwapAction action)
                                        throws IOException

Registration of a HotSwap action that will be fired if changes are detected to the specified resource.

Parameters:

loader - the class loader to lookup the service type

resource - the resource to register a change listener on

action - the action to fire

Returns:

true if registration was successful

Throws:

IOException

Since:

21.3

registerMetaInfServicesListener

public static boolean registerMetaInfServicesListener(Class<?> serviceType,
                                                      ClassLoader loader,
                                                      HotSwapAction action)
                                               throws IOException

Registration of a HotSwap action that will be fired if changes are detected to the declared META-INF/services for serviceType.

Parameters:

serviceType - the class instance of the service type

loader - the class loader to lookup the service type

action - the action to fire

Returns:

true if registration was successful

Throws:

IOException

Since:

21.2