JDT 随记---介绍

因公司项目的需要，最近开始研究Eclipse JDT ,边研究边记录如下：

JDT（java development tooling）是Eclipse提供的一组API。其功能引用其官方文档上的说法：

1. Programmatically manipulate Java resources, such as creating projects, generating Java source code, performing builds, or detecting problems in code.
2. Programmatically launch a Java program from the platform.
3. Provide a new type of VM launcher to support a new family of Java runtimes.
4. Add new functions and extensions to the Java IDE itself.

总之，提供了一系列强大的API供我们操作Java代码。

JDT实际上是将Java代码构建成一个基于DOM结构的抽象语法树AST（Abstract Syntax Tree ）。代码中的每个部分都对应一个ASTNode，许多的ASTNode就构成了这个抽象的语法树。Java Class一般对应Compilation Unit node，该节点也是AST树上的顶点。创建一个AST如下：

java 代码

ASTParser parser = ASTParser.newParser(AST.JLS3);
parser.setSource("".toCharArray());
CompilationUnit unit = (CompilationUnit) parser.createAST(null);
unit.recordModifications();
AST ast = unit.getAST();

其中createAST，当parse需要较长时间时，可以采用createAST(new NullProgressMonitor())，否则直接传null即可。

recordModifications()用于记录节点的变动，比如修改、删除等，当需要对AST树进行变动操作时，必须要预先调用这个方法。

比较重要的是：一个AST树上的所有节点必须都属于该AST。不允许直接将其他AST树上的节点添加该AST树上。否则会抛出java.lang.IllegalArgumentException异常。须使用ASTNode.copySubtree(AST target, ASTNode node)返回一个目标树的深度拷贝，才能进行添加操作。例如:

java 代码

ASTParser parser = ASTParser.newParser(AST.JLS3);
parser.setSource("".toCharArray());
CompilationUnit targetRoot= (CompilationUnit) parser.createAST(null);
targetRoot.recordModifications();
parser.setSource("class T{}”".toCharArray());
CompilationUnit srcRoot= (CompilationUnit) parser.createAST(null);

//这是非法操作，两者的AST源不一样
targetRoot.types().add(srcRoot.types().get(0));

//这是合法操作
targetRoot.types().add(ASTNode.copySubtree(
targetRoot.getAST(), (ASTNode) srcRoot.types().get(0)));

//这是合法操作
targetRoot.types().add(targetRoot.getAST().newTypeDeclaration());