Package com.sun.tools.javac.api

Class JavacTaskImpl

java.lang.Object

com.sun.source.util.JavacTask

com.sun.tools.javac.api.BasicJavacTask

com.sun.tools.javac.api.JavacTaskImpl

All Implemented Interfaces:

Callable<Boolean>, JavaCompiler.CompilationTask

public class JavacTaskImpl
extends BasicJavacTask

Provides access to functionality specific to the JDK Java Compiler, javac.

This is NOT part of any supported API. If you write code that depends on this, you do so at your own risk. This code and its internal interfaces are subject to change or deletion without notice.

Author:

Peter von der Ahé, Jonathan Gibbons

Field Summary

Fields inherited from class com.sun.tools.javac.api.BasicJavacTask

context

Method Summary

Modifier and Type	Method and Description
Iterable<? extends Element>	analyze() Complete all analysis.
Iterable<? extends Element>	analyze(Iterable<? extends TypeElement> classes) Complete all analysis on the given classes.
JavaFileObject	asJavaFileObject(File file) Construct a JavaFileObject from the given file.
Boolean	call()
Main.Result	doCall()
Iterable<? extends TypeElement>	enter() Translate all the abstract syntax trees to elements.
Iterable<? extends TypeElement>	enter(Iterable<? extends CompilationUnitTree> trees) Translate the given abstract syntax trees to elements.
Iterable<? extends JavaFileObject>	generate() Generate code.
Iterable<? extends JavaFileObject>	generate(Iterable<? extends TypeElement> classes) Generate code corresponding to the given classes.
JavacElements	getElements() Get a utility object for dealing with program elements.
TypeMirror	getTypeMirror(Iterable<? extends Tree> path) Get a type mirror of the tree node determined by the specified path.
JavacTypes	getTypes() Get a utility object for dealing with type mirrors.
Iterable<? extends CompilationUnitTree>	parse() Parse the specified files returning a list of abstract syntax trees.
Type	parseType(String expr, TypeElement scope) For internal use only.
Iterable<? extends Tree>	pathFor(CompilationUnitTree unit, Tree node)
void	setLocale(Locale locale)
void	setProcessors(Iterable<? extends Processor> processors)

Methods inherited from class com.sun.tools.javac.api.BasicJavacTask

addTaskListener, getContext, getTaskListeners, instance, removeTaskListener, setTaskListener, updateContext

Methods inherited from class com.sun.source.util.JavacTask

instance

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.tools.JavaCompiler.CompilationTask

addModules

Method Detail

doCall

public Main.Result doCall()

call

public Boolean call()

Specified by:

call in interface Callable<Boolean>

Specified by:

call in interface JavaCompiler.CompilationTask

Overrides:

call in class BasicJavacTask

setProcessors

public void setProcessors(Iterable<? extends Processor> processors)

Specified by:

setProcessors in interface JavaCompiler.CompilationTask

Overrides:

setProcessors in class BasicJavacTask

setLocale

public void setLocale(Locale locale)

Specified by:

setLocale in interface JavaCompiler.CompilationTask

Overrides:

setLocale in class BasicJavacTask

asJavaFileObject

public JavaFileObject asJavaFileObject(File file)

Construct a JavaFileObject from the given file.

TODO: this method is useless here

Parameters:

file - a file

Returns:

a JavaFileObject from the standard file manager.

parse

public Iterable<? extends CompilationUnitTree> parse()
                                              throws IOException

Parse the specified files returning a list of abstract syntax trees.

Overrides:

parse in class BasicJavacTask

Returns:

a list of abstract syntax trees

Throws:

IOException - TODO

enter

public Iterable<? extends TypeElement> enter()
                                      throws IOException

Translate all the abstract syntax trees to elements.

Returns:

a list of elements corresponding to the top level classes in the abstract syntax trees

Throws:

IOException - TODO

enter

public Iterable<? extends TypeElement> enter(Iterable<? extends CompilationUnitTree> trees)
                                      throws IOException

Translate the given abstract syntax trees to elements.

Parameters:

trees - a list of abstract syntax trees.

Returns:

a list of elements corresponding to the top level classes in the abstract syntax trees

Throws:

IOException - TODO

analyze

public Iterable<? extends Element> analyze()
                                    throws IOException

Complete all analysis.

Overrides:

analyze in class BasicJavacTask

Returns:

a list of elements that were analyzed

Throws:

IOException - TODO

analyze

public Iterable<? extends Element> analyze(Iterable<? extends TypeElement> classes)
                                    throws IOException

Complete all analysis on the given classes. This can be used to ensure that all compile time errors are reported. The classes must have previously been returned from enter(). If null is specified, all outstanding classes will be analyzed.

Parameters:

classes - a list of class elements

Throws:

IOException

generate

public Iterable<? extends JavaFileObject> generate()
                                            throws IOException

Generate code.

Overrides:

generate in class BasicJavacTask

Returns:

a list of files that were generated

Throws:

IOException - TODO

generate

public Iterable<? extends JavaFileObject> generate(Iterable<? extends TypeElement> classes)
                                            throws IOException

Generate code corresponding to the given classes. The classes must have previously been returned from enter(). If there are classes outstanding to be analyzed, that will be done before any classes are generated. If null is specified, code will be generated for all outstanding classes.

Parameters:

classes - a list of class elements

Throws:

IOException

getTypeMirror

public TypeMirror getTypeMirror(Iterable<? extends Tree> path)

Description copied from class: JavacTask

Get a type mirror of the tree node determined by the specified path. This method has been superceded by methods on Trees.

Overrides:

getTypeMirror in class BasicJavacTask

See Also:

Trees.getTypeMirror(com.sun.source.util.TreePath)

getElements

public JavacElements getElements()

Description copied from class: JavacTask

Get a utility object for dealing with program elements.

Overrides:

getElements in class BasicJavacTask

getTypes

public JavacTypes getTypes()

Description copied from class: JavacTask

Get a utility object for dealing with type mirrors.

Overrides:

getTypes in class BasicJavacTask

pathFor

public Iterable<? extends Tree> pathFor(CompilationUnitTree unit,
                                        Tree node)

parseType

public Type parseType(String expr,
                      TypeElement scope)

For internal use only. This method will be removed without warning.