io.micronaut.aot.core.codegen

Class DelegatingSourceGenerationContext

java.lang.Object

io.micronaut.aot.core.codegen.DelegatingSourceGenerationContext

All Implemented Interfaces:

AOTContext

public abstract class DelegatingSourceGenerationContext
extends java.lang.Object
implements AOTContext

Base class for source generation context which need to delegate to another one.

Constructor Summary

Constructors

Constructor and Description
DelegatingSourceGenerationContext(AOTContext delegate)

Method Summary

Modifier and Type	Method and Description
void	addDiagnostics(java.lang.String category, java.lang.String message) Adds a diagnostic message, which is going to be written in a log file.
<T> java.util.Optional<T>	get(java.lang.Class<T> type) Reads an entry from the context.
ApplicationContextAnalyzer	getAnalyzer() Returns the application context analyzer.
Configuration	getConfiguration() Returns the source generators configuration.
java.util.Map<java.lang.String,java.util.List<java.lang.String>>	getDiagnostics() Returns the diagnostics map.
java.lang.String	getPackageName() The package which should be used for generated classes.
Runtime	getRuntime() Returns the target runtime environment.
com.squareup.javapoet.JavaFile	javaFile(com.squareup.javapoet.TypeSpec typeSpec) Generates a java file spec.
<T> void	put(java.lang.Class<T> type, T value) Stores an entry in the context.
void	registerClassNeededAtCompileTime(java.lang.Class<?> clazz) Registers a class as needed at compile time (where compile time is the compile time of generated classes).
void	registerExcludedResource(java.lang.String path) Registers a resource path as excluded.
void	registerGeneratedResource(java.lang.String path, java.util.function.Consumer<? super java.io.File> consumer) Registers a new generated resource.
void	registerGeneratedSourceFile(com.squareup.javapoet.JavaFile javaFile) Registers a generated source file.
void	registerStaticInitializer(com.squareup.javapoet.MethodSpec staticInitializer) Registers a code block to be executed statically when the optimized binary is loaded.

Methods inherited from class java.lang.Object

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

Constructor Detail

DelegatingSourceGenerationContext

public DelegatingSourceGenerationContext(AOTContext delegate)

Method Detail

getPackageName

@NonNull
public java.lang.String getPackageName()

Description copied from interface: AOTContext

The package which should be used for generated classes.

Specified by:

getPackageName in interface AOTContext

Returns:

the package name

getConfiguration

@NonNull
public Configuration getConfiguration()

Description copied from interface: AOTContext

Returns the source generators configuration.

Specified by:

getConfiguration in interface AOTContext

Returns:

the configuration

getAnalyzer

@NonNull
public ApplicationContextAnalyzer getAnalyzer()

Description copied from interface: AOTContext

Returns the application context analyzer.

Specified by:

getAnalyzer in interface AOTContext

Returns:

the application context analyzer

registerGeneratedSourceFile

public void registerGeneratedSourceFile(@NonNull
                                        com.squareup.javapoet.JavaFile javaFile)

Description copied from interface: AOTContext

Registers a generated source file.

Specified by:

registerGeneratedSourceFile in interface AOTContext

Parameters:

javaFile - the file to be added.

registerStaticInitializer

public void registerStaticInitializer(com.squareup.javapoet.MethodSpec staticInitializer)

Description copied from interface: AOTContext

Registers a code block to be executed statically when the optimized binary is loaded.

Specified by:

registerStaticInitializer in interface AOTContext

Parameters:

staticInitializer - the static initializer method

registerGeneratedResource

public void registerGeneratedResource(@NonNull
                                      java.lang.String path,
                                      java.util.function.Consumer<? super java.io.File> consumer)

Description copied from interface: AOTContext

Registers a new generated resource.

Specified by:

registerGeneratedResource in interface AOTContext

Parameters:

path - the relative path to the resource (including file name)

consumer - the consumer to be called when the resource is generated.

registerExcludedResource

public void registerExcludedResource(@NonNull
                                     java.lang.String path)

Description copied from interface: AOTContext

Registers a resource path as excluded. Excluded resources should be removed, as much as possible, from the final binary/deliverable since they are either not used or substituted with code.

Specified by:

registerExcludedResource in interface AOTContext

Parameters:

path - the path of the resource to exclude

registerClassNeededAtCompileTime

public void registerClassNeededAtCompileTime(@NonNull
                                             java.lang.Class<?> clazz)

Description copied from interface: AOTContext

Registers a class as needed at compile time (where compile time is the compile time of generated classes). This will typically be used when source generators need classes which are not on the application classpath.

Specified by:

registerClassNeededAtCompileTime in interface AOTContext

Parameters:

clazz - a class

javaFile

@NonNull
public com.squareup.javapoet.JavaFile javaFile(com.squareup.javapoet.TypeSpec typeSpec)

Description copied from interface: AOTContext

Generates a java file spec.

Specified by:

javaFile in interface AOTContext

Parameters:

typeSpec - the type spec of the main class

Returns:

a java file

addDiagnostics

@NonNull
public void addDiagnostics(java.lang.String category,
                                    java.lang.String message)

Description copied from interface: AOTContext

Adds a diagnostic message, which is going to be written in a log file.

Specified by:

addDiagnostics in interface AOTContext

Parameters:

category - a category for the message, typically corresponding to the source generator type

message - a message to log

put

public <T> void put(@NonNull
                    java.lang.Class<T> type,
                    @NonNull
                    T value)

Description copied from interface: AOTContext

Stores an entry in the context. The entry may be read by other processors, as long as they are executed in the proper order.

Specified by:

put in interface AOTContext

Type Parameters:

T - the type of the value

Parameters:

type - the class of the value to store

value - the value to store

get

@NonNull
public <T> java.util.Optional<T> get(@NonNull
                                              java.lang.Class<T> type)

Description copied from interface: AOTContext

Reads an entry from the context.

Specified by:

get in interface AOTContext

Type Parameters:

T - the type of the entry

Parameters:

type - the class of the entry

Returns:

an empty value if absent

getDiagnostics

@NonNull
public java.util.Map<java.lang.String,java.util.List<java.lang.String>> getDiagnostics()

Description copied from interface: AOTContext

Returns the diagnostics map.

Specified by:

getDiagnostics in interface AOTContext

Returns:

the diagnostics

getRuntime

@NonNull
public Runtime getRuntime()

Description copied from interface: AOTContext

Returns the target runtime environment.

Specified by:

getRuntime in interface AOTContext

Returns:

target runtime