randoop.compile

Class SequenceCompiler

java.lang.Object

randoop.compile.SequenceCompiler

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class SequenceCompiler
extends java.lang.Object
implements java.io.Closeable

Compiles a Java class given as a String.

A simplified version of the javaxtools.compiler.CharSequenceCompiler from Create dynamic applications with javax.tools.

Field Summary

Fields

Modifier and Type	Field and Description
private javax.tools.JavaCompiler	compiler The Java compiler.
private java.util.List<java.lang.String>	compilerOptions The options to the compiler.
static @Nullable java.lang.String	debugCompilationFailure If non-null, do verbose output for compilation failures where the Java source code contains the string.
private javax.tools.JavaFileManager	fileManager The FileManager for this compiler.

Constructor Summary

Constructors

Constructor and Description
SequenceCompiler() Creates a SequenceCompiler.
SequenceCompiler(java.util.List<java.lang.String> compilerOptions) Creates a SequenceCompiler.

Method Summary

Modifier and Type	Method and Description
void	close() Releases any system resources associated with this.
private void	compile(java.lang.String packageName, java.lang.String classname, java.lang.String javaSource) Compiles the given class.
private boolean	compile(java.lang.String packageName, java.lang.String classname, java.lang.String javaSource, javax.tools.DiagnosticCollector<javax.tools.JavaFileObject> diagnostics) A helper method for the compile(String, String, String) and isCompilable(String, String, String) methods: compiles the given class using the given diagnostics collector.
java.lang.Class<?>	compileAndLoad(@DotSeparatedIdentifiers java.lang.String packageName, @Identifier java.lang.String classname, java.lang.String javaSource) Compiles the given class, leads it, and returns the Class object.
(package private) @BinaryName java.lang.String	fullyQualifiedName(@DotSeparatedIdentifiers java.lang.String packageName, @Identifier java.lang.String classname) Constructs a fully-qualified class name from the given package and unqualified class name.
boolean	isCompilable(java.lang.String packageName, java.lang.String classname, java.lang.String javaSource) Indicates whether the given class is compilable.
private static java.lang.Class<?>	loadClassFile(java.io.File directory, @BinaryName java.lang.String className) Given a .class file, returns the corresponding Class object.

Methods inherited from class java.lang.Object

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

Field Detail

debugCompilationFailure

public static final @Nullable java.lang.String debugCompilationFailure

If non-null, do verbose output for compilation failures where the Java source code contains the string.

compilerOptions

private final java.util.List<java.lang.String> compilerOptions

The options to the compiler.

compiler

private final javax.tools.JavaCompiler compiler

The Java compiler.

fileManager

private final javax.tools.JavaFileManager fileManager

The FileManager for this compiler.

Constructor Detail

SequenceCompiler

public SequenceCompiler()

Creates a SequenceCompiler.

SequenceCompiler

public SequenceCompiler(java.util.List<java.lang.String> compilerOptions)

Creates a SequenceCompiler.

Parameters:

compilerOptions - the compiler options

Method Detail

close

public void close()
           throws java.io.IOException

Releases any system resources associated with this.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException

isCompilable

public boolean isCompilable(java.lang.String packageName,
                            java.lang.String classname,
                            java.lang.String javaSource)

Indicates whether the given class is compilable.

Parameters:

packageName - the package name for the class, null if default package

classname - the simple name of the class

javaSource - the source text of the class

Returns:

true if class source was successfully compiled, false otherwise

compile

private void compile(java.lang.String packageName,
                     java.lang.String classname,
                     java.lang.String javaSource)
              throws SequenceCompilerException

Compiles the given class. If this method returns normally, compilation was successful.

Parameters:

packageName - the package of the class, null if default package

classname - the simple name of the class

javaSource - the source text of the class

Throws:

SequenceCompilerException - if the compilation fails

compile

private boolean compile(java.lang.String packageName,
                        java.lang.String classname,
                        java.lang.String javaSource,
                        javax.tools.DiagnosticCollector<javax.tools.JavaFileObject> diagnostics)

A helper method for the compile(String, String, String) and isCompilable(String, String, String) methods: compiles the given class using the given diagnostics collector.

Parameters:

packageName - the package of the class, null if default package

classname - the simple name of the class

javaSource - the source text of the class

diagnostics - the DiagnosticsCollector object to use for the compilation. Always use a new diagnostics collector each compilation to avoid accumulating errors.

Returns:

true if the class source is successfully compiled, false otherwise

compileAndLoad

public java.lang.Class<?> compileAndLoad(@DotSeparatedIdentifiers java.lang.String packageName,
                                         @Identifier java.lang.String classname,
                                         java.lang.String javaSource)
                                  throws SequenceCompilerException

Compiles the given class, leads it, and returns the Class object. If this method returns normally, compilation was successful.

Parameters:

packageName - the package of the class, null if default package

classname - the simple name of the class

javaSource - the source text of the class

Returns:

the loaded Class object

Throws:

SequenceCompilerException - if the compilation fails

loadClassFile

private static java.lang.Class<?> loadClassFile(java.io.File directory,
                                                @BinaryName java.lang.String className)

Given a .class file, returns the corresponding Class object.

Parameters:

directory - the directory containing the .class file (possibly in a package-named subdirectory)

className - the binary name of the class defined in the file

Returns:

the loaded Class object

fullyQualifiedName

@BinaryName java.lang.String fullyQualifiedName(@DotSeparatedIdentifiers java.lang.String packageName,
                                                @Identifier java.lang.String classname)

Constructs a fully-qualified class name from the given package and unqualified class name.

Parameters:

packageName - the package of the class, null if default package

classname - the name of the class, without the package

Returns:

the fully-qualified class name constructed from the arguments