Module jdk.compiler

软件包 com.sun.source.util

Class JavacTask

java.lang.Object

com.sun.source.util.JavacTask

All Implemented Interfaces:

Callable<Boolean> ， JavaCompiler.CompilationTask

public abstract class JavacTask
extends Object
implements JavaCompiler.CompilationTask

提供对JDK Java编译器javac特有的功能的访问。

从以下版本开始：

1.6

构造方法摘要

构造方法

Constructor	描述
JavacTask()

方法摘要

Modifier and Type	方法	描述
abstract void	addTaskListener(TaskListener taskListener)	添加指定的侦听器，以便它接收到描述此编译任务进度的事件的通知。
abstract Iterable<? extends Element>	analyze()	完成所有分析。
abstract Iterable<? extends JavaFileObject>	generate()	生成代码。
abstract Elements	getElements()	返回用于处理程序元素的实用程序对象。
abstract TypeMirror	getTypeMirror(Iterable<? extends 树> path)	返回由指定路径确定的树节点的类型镜像。
abstract Types	getTypes()	返回用于处理类型镜像的实用程序对象。
static JavacTask	instance(ProcessingEnvironment processingEnvironment)	返回 JavacTask为 ProcessingEnvironment 。
abstract Iterable<? extends CompilationUnitTree>	parse()	解析指定的文件，返回抽象语法树列表。
abstract void	removeTaskListener(TaskListener taskListener)	删除指定的侦听器，使其不再收到描述此编译任务进度的事件的通知。
abstract void	setTaskListener(TaskListener taskListener)	设置指定的侦听器以接收描述此编译任务进度的事件的通知。

Methods inherited from interface javax.tools.JavaCompiler.CompilationTask

addModules, call, setLocale, setProcessors

Methods inherited from class java.lang.Object

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

构造方法详细信息

JavacTask

public JavacTask()

方法详细信息

instance

public static JavacTask instance(ProcessingEnvironment processingEnvironment)

返回JavacTask为ProcessingEnvironment 。 如果使用CompilationTask调用编译器，那么该任务将被返回。

参数

processingEnvironment - 处理环境

结果

JavacTask为 ProcessingEnvironment

从以下版本开始：

1.8

parse

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

解析指定的文件，返回抽象语法树列表。

结果

抽象语法树的列表

异常

IOException - 如果编译器中发生未处理的I / O错误。

IllegalStateException - 如果此时无法执行操作。

analyze

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

完成所有分析。

结果

分析的元素列表

异常

IOException - 如果编译器中发生未处理的I / O错误。

IllegalStateException - 如果此时无法执行操作。

generate

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

生成代码。

结果

生成的文件列表

异常

IOException - 如果编译器中发生未处理的I / O错误。

IllegalStateException - 如果此时无法执行操作。

setTaskListener

public abstract void setTaskListener(TaskListener taskListener)

设置指定的侦听器以接收描述此编译任务进度的事件的通知。 如果另一个侦听器因此先前调用此方法而收到通知，则该侦听器将不再接收通知。 非正式地，此方法相当于为以前设置的任何侦听器调用removeTaskListener ，其次是新的侦听器的addTaskListener 。

参数

taskListener - 任务侦听器

异常

IllegalStateException - 如果指定的侦听器已经被添加。

addTaskListener

public abstract void addTaskListener(TaskListener taskListener)

添加指定的侦听器，以便它接收到描述此编译任务进度的事件的通知。 可以在编译之前或期间的任何时间调用此方法。

参数

taskListener - 任务侦听器

异常

IllegalStateException - 如果指定的侦听器已经被添加。

从以下版本开始：

1.8

removeTaskListener

public abstract void removeTaskListener(TaskListener taskListener)

删除指定的侦听器，使其不再收到描述此编译任务进度的事件的通知。 可以在编译之前或期间的任何时间调用此方法。

参数

taskListener - 任务侦听器

从以下版本开始：

1.8

getTypeMirror

public abstract TypeMirror getTypeMirror(Iterable<? extends 树> path)

返回由指定路径确定的树节点的类型镜像。 该方法已被Trees的方法取代。

参数

path - 路径

结果

类型镜

另请参见：

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

getElements

public abstract Elements getElements()

返回用于处理程序元素的实用程序对象。

结果

用于处理程序元素的实用程序对象

getTypes

public abstract Types getTypes()

返回用于处理类型镜像的实用程序对象。

结果

用于处理类型镜的实用程序对象