ptolemy.backtrack.eclipse.ast

Class ASTBuilder

java.lang.Object

ptolemy.backtrack.eclipse.ast.ASTBuilder

public class ASTBuilder
extends java.lang.Object

Static methods that build Eclipse Abstract Syntax Trees (ASTs) from Java source files.

Currently only Java 1.4 source files are accepted.

Since:

Ptolemy II 5.1

Version:

$Id$

Author:

Thomas Feng

Pt.AcceptedRating:

Red (tfeng)

Pt.ProposedRating:

Red (tfeng)

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_LANGUAGE_SPECIFICATION The ID of the Java language specification being used by the parser.

Constructor Summary

Constructors

Constructor and Description
ASTBuilder()

Method Summary

Modifier and Type	Method and Description
static int	getLanguageSpecification() Return the ID of the Java language specification being used by the parser.
static org.eclipse.jdt.core.dom.CompilationUnit	parse(char[] source) Parse the Java source code given in the source buffer, and return the root of the AST.
static org.eclipse.jdt.core.dom.CompilationUnit	parse(java.lang.String fileName) Parse a Java source file given by its name, and return the root of the AST.
static void	setLanguageSpecification(int level) Set the ID of the Java language specification being used by the parser.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_LANGUAGE_SPECIFICATION

public static int DEFAULT_LANGUAGE_SPECIFICATION

The ID of the Java language specification being used by the parser.

See Also:

getLanguageSpecification(), setLanguageSpecification(int)

Constructor Detail

ASTBuilder

public ASTBuilder()

Method Detail

getLanguageSpecification

public static int getLanguageSpecification()

Return the ID of the Java language specification being used by the parser.

Returns:

The ID of the Java language specification.

See Also:

setLanguageSpecification(int)

parse

public static org.eclipse.jdt.core.dom.CompilationUnit parse(java.lang.String fileName)
                                                      throws java.io.IOException,
                                                             ASTMalformedException

Parse a Java source file given by its name, and return the root of the AST.

Parameters:

fileName - The Java source file name.

Returns:

The root of the AST.

Throws:

java.io.IOException - If IO exception occurs.

ASTMalformedException - If the Java source file does not conform to the supported Java grammar.

See Also:

parse(char[])

parse

public static org.eclipse.jdt.core.dom.CompilationUnit parse(char[] source)
                                                      throws ASTMalformedException

Parse the Java source code given in the source buffer, and return the root of the AST.

Parameters:

source - The char array that contains the source code in a single Java source file.

Returns:

The root of the AST.

Throws:

ASTMalformedException - If the Java source file does not conform to the supported Java grammar.

setLanguageSpecification

public static void setLanguageSpecification(int level)

Set the ID of the Java language specification being used by the parser.

Users may change the language specification before Java source is parsed. The language specification is set statically. It is users' responsibility to synchronize its usage if multiple threads parse Java sources at the same time with different language specifications.

Parameters:

level - The ID of the Java language specification.

See Also:

getLanguageSpecification()