概述:java的抽象语法树可以理解为java文件的dom模型,dom4j解析xml文件的时候会有一套模型,而AST其实就是解析java文件的模型。听说AST跟java的编译原理有关,没考证过。此文只是从使用的角度描述一下AST的一些用法,能力有限,见谅!
1.ASTParser:
ASTParser:AST语法树的解析器,创建该实体的时候需要传递一个参数来描述解析的jdk版本。这个类中有些方法是跟编译解析相关的,跳过。
ASTParser中的属性:
ITypeRoot typeRoot:指定的是一个编辑单元,也就是一个java类的描述模型
IJavaProject project:指定的是当前编辑单元所在的java类
WorkingCopyOwner workingCopyOwner:一个工作副本的处理者,具体处理什么暂不关注,需要关注的是AST解析中的工作副本这个概念。
ASTParser中的方法:
setSource(char[] source):设置需要解析的内容,如果你是加载一个已有的java类,需要把其内容用此方法set到ASTParser中。这个方法是一个重载方法,参数出char[]以外还有ICompilationUnit和IClassFile类型的对象,记住此两个对象都是javamodel的模型对象。
setProject(IJavaProject project):为当前的ASTParser设定一个java工程对象。
ASTNode createAST(IProgressMonitor monitor):创建一个抽象的语法节点,ASTNode是所有AST节点的父类。它所获得的对象会根据解析器传入的类型来进行判断。
备注:需要清楚一点的是,ASTParser主要作用和意义是,把传入的字符串或者javamodel对象,转换为你所需要的AST节点,至于这个节点是什么,由你在创建这个ASTParser的时候指定。
2.AST:
AST此类无争议,抽象语法树的工厂类,创建一个个ASTNode的。需要注意的是,在创建AST对象的时候,需要指定level,用于标示当前使用的jdk版本
AST的方法:
ASTNode createInstance(int nodeType):创建一个指定类型的节点,内容为null。
除了这个方法以外还有很多newXXX()的方法,功能更这个类似。
3.ASTNode:
描述节点的类,你可以把它看做一个模型。
这里说一个看代码的技巧:ASTNode把它的子节点的信息都是放在StructuralPropertyDescriptor里面的,
static final ChildPropertyDescriptor internalJavadocPropertyFactory(Class nodeClass) {
return new ChildPropertyDescriptor(nodeClass, "javadoc", Javadoc.class, OPTIONAL, NO_CYCLE_RISK); //$NON-NLS-1$
}
如上第三个参数就是传入值的class类型Javadoc.class,所以,如果不清楚某个节点怎么用直接看这个方法能放那些东西
就行了。
4.StructuralPropertyDescriptor有三个子类:
ChildListPropertyDescriptor:相当于一个list容器
ChildPropertyDescriptor:只能放一个节点
SimplePropertyDescriptor:存放字符串之类的静态的东西,不能存放ASTNode
5.Name和QualifiedName,SimpleName:
QualifiedName:一个Qualified它包含一个Name和一个SimpleName,Name本身就有两种可能,所以这东西的长度就常了,恶心的是,它中间的分隔符是点。
QualifiedName:
Name . SimpleName
6.ASTRewrite:AST中跟持久相关的类,它的功能跟CompilationUnit.rewrite类似,只是它可以很好的处理多个源交替进行覆盖java文件的问题。下面是官方的例子:
ASTRewrite rewriter = ASTRewrite.create(ast);
TypeDeclaration td = (TypeDeclaration) cu.types().get(0);
ITrackedNodePosition tdLocation = rewriter.track(td);
ListRewrite lrw = rewriter.getListRewrite(cu, CompilationUnit.IMPORTS_PROPERTY);
lrw.insertLast(id, null);
TextEdit edits = rewriter.rewriteAST(document, null);
UndoEdit undo = null;
try {
undo = edits.apply(document);
} catch(MalformedTreeException e) {
e.printStackTrace();
} catch(BadLocationException e) {
e.printStackTrace();
}