org.apache.tools.ant.taskdefs.optional

Class ANTLR

public class ANTLR extends Task

Invokes the ANTLR Translator generator on a grammar file.
Constructor Summary
ANTLR()
Constructor for ANTLR task.
Method Summary
protected voidaddClasspathEntry(String resource)
Search for the given resource and add the directory or archive that contains it to the classpath.
PathcreateClasspath()
Adds a classpath to be set because a directory might be given for Antlr debug.
Commandline.ArgumentcreateJvmarg()
Adds a new JVM argument.
voidexecute()
Execute the task.
voidinit()
Adds the jars or directories containing Antlr this should make the forked JVM work without having to specify it directly.
protected booleanis272()
Whether the antlr version is 2.7.2 (or higher).
voidsetDebug(boolean enable)
Sets a flag to enable ParseView debugging
voidsetDiagnostic(boolean enable)
Sets a flag to emit diagnostic text
voidsetDir(File d)
The working directory of the process
voidsetFork(boolean s)
voidsetGlib(String superGrammar)
Sets an optional super grammar file.
voidsetGlib(File superGrammar)
Sets an optional super grammar file
voidsetHtml(boolean enable)
If true, emit html
voidsetOutputdirectory(File outputDirectory)
The directory to write the generated files to.
voidsetTarget(File target)
The grammar file to process.
voidsetTrace(boolean enable)
If true, enables all tracing.
voidsetTraceLexer(boolean enable)
If true, enables lexer tracing.
voidsetTraceParser(boolean enable)
If true, enables parser tracing.
voidsetTraceTreeWalker(boolean enable)
Sets a flag to allow the user to enable tree walker tracing

Constructor Detail

ANTLR

public ANTLR()
Constructor for ANTLR task.

Method Detail

addClasspathEntry

protected void addClasspathEntry(String resource)
Search for the given resource and add the directory or archive that contains it to the classpath.

Doesn't work for archives in JDK 1.1 as the URL returned by getResource doesn't contain the name of the archive.

Parameters: resource the resource name to search for

createClasspath

public Path createClasspath()
Adds a classpath to be set because a directory might be given for Antlr debug.

Returns: a path to be configured

createJvmarg

public Commandline.Argument createJvmarg()
Adds a new JVM argument.

Returns: create a new JVM argument so that any argument can be passed to the JVM.

See Also: ANTLR

execute

public void execute()
Execute the task.

Throws: BuildException on error

init

public void init()
Adds the jars or directories containing Antlr this should make the forked JVM work without having to specify it directly.

Throws: BuildException on error

is272

protected boolean is272()
Whether the antlr version is 2.7.2 (or higher).

Returns: true if the version of Antlr present is 2.7.2 or later.

Since: Ant 1.6

setDebug

public void setDebug(boolean enable)
Sets a flag to enable ParseView debugging

Parameters: enable a boolean value

setDiagnostic

public void setDiagnostic(boolean enable)
Sets a flag to emit diagnostic text

Parameters: enable a boolean value

setDir

public void setDir(File d)
The working directory of the process

Parameters: d the working directory

setFork

public void setFork(boolean s)

Parameters: s a boolean value

UNKNOWN: ignore="true"

setGlib

public void setGlib(String superGrammar)

Deprecated: since ant 1.6

Sets an optional super grammar file. Use setGlib(File superGrammar) instead.

Parameters: superGrammar the super grammar filename

setGlib

public void setGlib(File superGrammar)
Sets an optional super grammar file

Parameters: superGrammar the super grammar file

Since: ant 1.6

setHtml

public void setHtml(boolean enable)
If true, emit html

Parameters: enable a boolean value

setOutputdirectory

public void setOutputdirectory(File outputDirectory)
The directory to write the generated files to.

Parameters: outputDirectory the output directory

setTarget

public void setTarget(File target)
The grammar file to process.

Parameters: target the gramer file

setTrace

public void setTrace(boolean enable)
If true, enables all tracing.

Parameters: enable a boolean value

setTraceLexer

public void setTraceLexer(boolean enable)
If true, enables lexer tracing.

Parameters: enable a boolean value

setTraceParser

public void setTraceParser(boolean enable)
If true, enables parser tracing.

Parameters: enable a boolean value

setTraceTreeWalker

public void setTraceTreeWalker(boolean enable)
Sets a flag to allow the user to enable tree walker tracing

Parameters: enable a boolean value