AST抽象的java语法树

概述：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();
        }