gb 50169—2006 电气装置安装工程接地装置施工及验收规范(条文说明).pdf

Eclipse AST Eclipse AST 是 Eclipse JDT 的一个重要组成部分,. 中, 用来表示 Java 语言中的所有语法结构。 Eclipse AST 采用工厂方法模式和访问者模式(见 节)来设计和实现,这样可以减轻用户深入了解其内部结构的压力,并且方便用户利用它们构建并处理 AST 。你可以打开 Eclipse 帮助页面,通过鼠标依次点击窗口左边的目录“ JDT Plug-in Developer Guide ”?“Reference ”?“API Reference ”?“ ”, 即可打开这个包的详细说明。本节将对这个包中重要的类作简要说明,为简便起见,这里省去这些类的包名,. 。在 Eclipse AST 中,与本书的课程设计相关的类主要有以下三部分: ? ASTNode 类及其派生类:用于描述各种 AST 节点的类,每个 AST 节点表示一个 Java 源程序中的一个语法结构,例如,一个名字、类型、表达式、语句或声明等。? AST 类:创建 AST 节点的工厂类,类中包含许多创建各类 AST 节点的工厂方法, 用户可以利用这些方法来构建 AST 。? ASTVisitor 类: AST 的访问者抽象类, 类中声明了一组访问各类 AST 节点的 visit( ) 方法、 endVisit( ) 方法和 preVisit( ) 方法。 AST 节点类在 Eclipse AST 中, Java 源程序中的每个语法结构对应为一个 AST 节点,所有的 AST 节点按其在语法上的关系连接形成一棵 AST 树。类 ASTNode 是 AST 树中各类节点的抽象基类,其余的 AST 节点类都由它派生。在 ASTNode 类中声明有各个具体的 AST 节点类所对应的类型标识,如 PILATION_UNIT pilation_Unit 节点类,这类节点用来表示一个 Java 源程序文件。为便于自顶向下(从父节点到子节点)或者自底向上(从子节点到父节点)访问 AST 树, AST 节点含有指向其父节点的 parent 域以及若干关联的子节点域。在 AST 节点类中, 以属性( property )来统一处理子节点以及用户自定义的节点属性,属性的访问方法有: void setProperty(String propertyName, Object data) // 设置指定属性的值 Object getProperty(String propertyName) // 取得指定属性的值 Map properties( ) // 返回节点的所有属性表,这个表是不可修改的在每个具体的 AST 节点类中,以类常量形式声明该类节点所拥有的基本属性(即基本的子节点)类别,并定义了存放属性值的域以及设置和访问属性的方法。例如,在一个 Java 源程序文件中,有可选的 package 声明、 0个或多个 import 声明以及至少 1个类型声明(可以是类声明或接口声明) ,从而在表示 Java 源程序文件(称为编译单元)的 AST pilationUnit 中就声明有 final 类变量 PACKAGE_PROPERTY 、IMPORTS_PROPERTY 和 TYPES_PROPERTY ,分别表示 package 属性、 imports 属性和 types 属性,同时还定义有如下的访问方法: List imports( ) // 该节点的所有 import 声明,按在程序中的出现次序排列 List types( ) // 该节点的所有顶层类型声明, 按在程序中的出现次序排列 void setPackage(PackageD eclaration pkgDecl) // 设置该节点的 package 声明 PackageDeclaration getPackage( ) // 取得该节点的 package 声明其中,类型相同的子节点组成的序列以 接口类来表示,这个接口类包含 add 、 get 、set 、remove 等方法用于访问和修改序列。在实际构造和访问 AST 树时,需要注意统一所使用的 List 接口类的实现类,例如,可以统一使用类 或者统一使用类 来表示序列。在 AST 节点类中,只提供获取父节点的方法,即 ASTNode getParent( ) 而没有提供设置父节点的方法,