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

 

 

 

 

你可能感兴趣的:(JET)