Package org.grails.cli.compiler

Class GroovyCompiler

java.lang.Object

org.grails.cli.compiler.GroovyCompiler

public class GroovyCompiler
extends java.lang.Object

Compiler for Groovy sources. Primarily a simple Facade for GroovyClassLoader.parseClass(GroovyCodeSource) with the following additional features:

• CompilerAutoConfiguration strategies will be read from META-INF/services/org.grails.cli.compiler.CompilerAutoConfiguration (per the standard java ServiceLoader contract) and applied during compilation
• Multiple classes can be returned if the Groovy source defines more than one Class
• Generated class files can also be loaded using ClassLoader.getResource(String)

Since:

2022.1.0

Constructor Summary

Constructors

Constructor	Description
GroovyCompiler(GroovyCompilerConfiguration configuration)	Create a new GroovyCompiler instance.

Method Summary

Modifier and Type	Method	Description
void	addCompilationCustomizers(org.codehaus.groovy.control.customizers.CompilationCustomizer... customizers)
java.lang.Class<?>[]	compile(java.lang.String... sources)	Compile the specified Groovy sources, applying any CompilerAutoConfigurations.
java.util.List<org.codehaus.groovy.transform.ASTTransformation>	getAstTransformations()	Return a mutable list of the ASTTransformations to be applied during compile(String...).
ExtendedGroovyClassLoader	getLoader()

Methods inherited from class java.lang.Object

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

Constructor Detail

GroovyCompiler

public GroovyCompiler(GroovyCompilerConfiguration configuration)

Create a new GroovyCompiler instance.

Parameters:

configuration - the compiler configuration

Method Detail

getAstTransformations

public java.util.List<org.codehaus.groovy.transform.ASTTransformation> getAstTransformations()

Return a mutable list of the ASTTransformations to be applied during compile(String...).

Returns:

the AST transformations to apply

getLoader

public ExtendedGroovyClassLoader getLoader()

addCompilationCustomizers

public void addCompilationCustomizers(org.codehaus.groovy.control.customizers.CompilationCustomizer... customizers)

compile

public java.lang.Class<?>[] compile(java.lang.String... sources)
                             throws org.codehaus.groovy.control.CompilationFailedException,
                                    java.io.IOException

Compile the specified Groovy sources, applying any CompilerAutoConfigurations. All classes defined in the sources will be returned from this method.

Parameters:

sources - the sources to compile

Returns:

compiled classes

Throws:

org.codehaus.groovy.control.CompilationFailedException - in case of compilation failures

java.io.IOException - in case of I/O errors

org.codehaus.groovy.control.CompilationFailedException - in case of compilation errors