io.quarkus.deployment.recording

Class BytecodeRecorderImpl

java.lang.Object

io.quarkus.deployment.recording.BytecodeRecorderImpl

All Implemented Interfaces:

RecorderContext

public class BytecodeRecorderImpl
extends Object
implements RecorderContext

A class that can be used to record invocations to bytecode so they can be replayed later. This is done through the use of class templates and recording proxies.

A class template is simple a stateless class with a no arg constructor. This template will contain the runtime logic used to bootstrap the various frameworks.

A recording proxy is a proxy of a template that records all invocations on the template, and then writes out a sequence of java bytecode that performs the same invocations.

There are some limitations on what can be recorded. Only the following objects are allowed as parameters to recording proxies:

- primitives - String - Class (see classProxy(String) to handle classes that are not loadable at generation time) - Objects with a no-arg constructor and getter/setters for all properties - Any arbitrary object via the registerSubstitution(Class, Class, Class) mechanism - arrays, lists and maps of the above

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static interface	BytecodeRecorderImpl.BytecodeInstruction
(package private) static class	BytecodeRecorderImpl.NewInstance
(package private) static class	BytecodeRecorderImpl.NonDefaultConstructorHolder
static interface	BytecodeRecorderImpl.ReturnedProxy
(package private) static class	BytecodeRecorderImpl.StoredMethodCall
(package private) static class	BytecodeRecorderImpl.SubstitutionHolder

Constructor Summary

Constructors

Constructor and Description
BytecodeRecorderImpl(boolean staticInit, String buildStepName, String methodName)
BytecodeRecorderImpl(ClassLoader classLoader, boolean staticInit, String className)

Method Summary

Modifier and Type	Method and Description
(package private) static io.quarkus.gizmo.ResultHandle	arrayValue(org.jboss.jandex.AnnotationValue value, io.quarkus.gizmo.BytecodeCreator valueMethod, org.jboss.jandex.MethodInfo method, org.jboss.jandex.ClassInfo annotationClass)
Class<?>	classProxy(String name) Creates a Class instance that can be passed to a recording proxy as a substitute for a class that is not loadable at processing time.
(package private) static String	componentType(org.jboss.jandex.MethodInfo method)
String	getClassName()
<T> T	getRecordingProxy(Class<T> theClass)
boolean	isEmpty()
(package private) static io.quarkus.gizmo.ResultHandle	loadValue(io.quarkus.gizmo.BytecodeCreator valueMethod, org.jboss.jandex.AnnotationValue value, org.jboss.jandex.ClassInfo annotationClass, org.jboss.jandex.MethodInfo method)
<T> RuntimeValue<T>	newInstance(String name) Creates a RuntimeValue object that represents an object created via the default constructor.
<T> void	registerNonDefaultConstructor(Constructor<T> constructor, Function<T,List<Object>> parameters) Registers a way to construct an object via a non-default constructor.
void	registerObjectLoader(ObjectLoader loader) Register an object loader.
<F,T> void	registerSubstitution(Class<F> from, Class<T> to, Class<? extends ObjectSubstitution<F,T>> substitution) Registers a substitution to allow objects that are not serialisable to bytecode to be substituted for an object that is.
void	writeBytecode(ClassOutput classOutput)

Methods inherited from class java.lang.Object

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

Constructor Detail

BytecodeRecorderImpl

public BytecodeRecorderImpl(ClassLoader classLoader,
                            boolean staticInit,
                            String className)

BytecodeRecorderImpl

public BytecodeRecorderImpl(boolean staticInit,
                            String buildStepName,
                            String methodName)

Method Detail

isEmpty

public boolean isEmpty()

registerSubstitution

public <F,T> void registerSubstitution(Class<F> from,
                                       Class<T> to,
                                       Class<? extends ObjectSubstitution<F,T>> substitution)

Description copied from interface: RecorderContext

Registers a substitution to allow objects that are not serialisable to bytecode to be substituted for an object that is.

Specified by:

registerSubstitution in interface RecorderContext

Parameters:

from - The class of the non serializable object

to - The class to serialize to

substitution - The subclass of ObjectSubstitution that performs the substitution

registerNonDefaultConstructor

public <T> void registerNonDefaultConstructor(Constructor<T> constructor,
                                              Function<T,List<Object>> parameters)

Description copied from interface: RecorderContext

Registers a way to construct an object via a non-default constructor. Each object may only have at most one non-default constructor registered

Specified by:

registerNonDefaultConstructor in interface RecorderContext

Type Parameters:

T - The type of the object

Parameters:

constructor - The constructor

parameters - A function that maps the object to a list of constructor parameters

registerObjectLoader

public void registerObjectLoader(ObjectLoader loader)

Description copied from interface: RecorderContext

Register an object loader.

Specified by:

registerObjectLoader in interface RecorderContext

Parameters:

loader - the object loader (must not be null)

getRecordingProxy

public <T> T getRecordingProxy(Class<T> theClass)

classProxy

public Class<?> classProxy(String name)

Description copied from interface: RecorderContext

Creates a Class instance that can be passed to a recording proxy as a substitute for a class that is not loadable at processing time. At runtime the actual class will be passed into the invoked method.

Specified by:

classProxy in interface RecorderContext

Parameters:

name - The class name

Returns:

A Class instance that can be passed to a recording proxy

newInstance

public <T> RuntimeValue<T> newInstance(String name)

Description copied from interface: RecorderContext

Creates a RuntimeValue object that represents an object created via the default constructor.

This object can be passed into templates, but must not be used directly at deployment time

Specified by:

newInstance in interface RecorderContext

Type Parameters:

T - The type of the class

Parameters:

name - The name of the class

Returns:

The class instance proxy

getClassName

public String getClassName()

writeBytecode

public void writeBytecode(ClassOutput classOutput)

loadValue

static io.quarkus.gizmo.ResultHandle loadValue(io.quarkus.gizmo.BytecodeCreator valueMethod,
                                               org.jboss.jandex.AnnotationValue value,
                                               org.jboss.jandex.ClassInfo annotationClass,
                                               org.jboss.jandex.MethodInfo method)

arrayValue

static io.quarkus.gizmo.ResultHandle arrayValue(org.jboss.jandex.AnnotationValue value,
                                                io.quarkus.gizmo.BytecodeCreator valueMethod,
                                                org.jboss.jandex.MethodInfo method,
                                                org.jboss.jandex.ClassInfo annotationClass)

componentType

static String componentType(org.jboss.jandex.MethodInfo method)