org.codehaus.mojo.javacc.JJTreeJavaCCMojo Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of ph-javacc-maven-plugin Show documentation
Show all versions of ph-javacc-maven-plugin Show documentation
Maven 3 Plugin for processing JavaCC grammar files.
package org.codehaus.mojo.javacc;
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
import java.io.File;
import org.apache.maven.plugin.MojoExecutionException;
import org.apache.maven.plugin.MojoFailureException;
/**
* Preprocesses decorated grammar files (*.jjt) with JJTree and
* passes the output to JavaCC in order to finally generate a parser with parse
* tree actions.
*
* @goal jjtree-javacc
* @phase generate-sources
* @since 2.4
* @author Benjamin Bentmann
* @version $Id: JJTreeJavaCCMojo.java 10603 2009-09-06 15:05:08Z bentmann $
*/
public class JJTreeJavaCCMojo extends AbstractJavaCCMojo
{
/**
* A flag whether to generate sample implementations for
* SimpleNode and any other nodes used in the grammar. Default
* value is true.
*
* @parameter property=buildNodeFiles
*/
private Boolean buildNodeFiles;
/**
* A flag whether to generate a multi mode parse tree or a single mode parse
* tree. Default value is false.
*
* @parameter property=multi
*/
private Boolean multi;
/**
* A flag whether to make each non-decorated production void instead of an
* indefinite node. Default value is false.
*
* @parameter property=nodeDefaultVoid
*/
private Boolean nodeDefaultVoid;
/**
* The name of a custom class that extends SimpleNode and will be
* used as the super class for the generated tree node classes. By default,
* the tree node classes will directly extend the class
* SimpleNode.
*
* @parameter property=nodeClass
* @since 2.5
*/
private String nodeClass;
/**
* The name of a custom factory class used to create Node
* objects. This class must have a method with the signature
* public static Node jjtCreate(int id). By default, the class
* SimpleNode will be used as the factory class.
*
* @parameter property=nodeFactory
*/
private String nodeFactory;
/**
* The package to generate the AST node classes into. This value may use a
* leading asterisk to reference the package of the corresponding parser. For
* example, if the parser package is org.apache and this
* parameter is set to *.node, the tree node classes will be
* located in the package org.apache.node. By default, the
* package of the corresponding parser is used.
*
* @parameter property=nodePackage
*/
private String nodePackage;
/**
* The prefix used to construct node class names from node identifiers in
* multi mode. Default value is AST.
*
* @parameter property=nodePrefix
*/
private String nodePrefix;
/**
* A flag whether user-defined parser methods should be called on entry and
* exit of every node scope. Default value is false.
*
* @parameter property=nodeScopeHook
*/
private Boolean nodeScopeHook;
/**
* A flag whether the node construction routines need an additional method
* parameter to receive the parser object. Default value is false
* .
*
* @parameter property=nodeUsesParser
*/
private Boolean nodeUsesParser;
/**
* A flag whether to insert the methods jjtGetFirstToken(),
* jjtSetFirstToken(), getLastToken() and
* jjtSetLastToken() into the class SimpleNode.
* Default value is false.
*
* @parameter property=trackTokens
* @since 2.5
*/
private Boolean trackTokens;
/**
* A flag whether to insert a jjtAccept() method in the node
* classes and to generate a visitor implementation with an entry for every
* node type used in the grammar. Default value is false.
*
* @parameter property=visitor
*/
private Boolean visitor;
/**
* The name of a class to use for the data argument of the
* jjtAccept() and visit() methods. Default value is
* java.lang.Object.
*
* @parameter property=visitorDataType
* @since 2.5
*/
private String visitorDataType;
/**
* The name of a class to use as the return type of the
* jjtAccept() and visit() methods. Default value is
* java.lang.Object.
*
* @parameter property=visitorReturnType
* @since 2.5
*/
private String visitorReturnType;
/**
* The name of an exception class to include in the signature of the generated
* jjtAccept() and visit() methods. By default, the
* throws clause of the generated methods is empty such that only
* unchecked exceptions can be thrown.
*
* @parameter property=visitorException
*/
private String visitorException;
/**
* The directory where the decorated JavaCC grammar files (*.jjt)
* are located. It will be recursively scanned for input files to pass to
* JJTree. The parameters includes and excludes can
* be used to select a subset of files.
*
* @parameter property=sourceDirectory
* default-value="${basedir}/src/main/jjtree"
*/
private File sourceDirectory;
/**
* The directory where the AST node files generated by JJTree will be stored.
* The directory will be registered as a compile source root of the project
* such that the generated files will participate in later build phases like
* compiling and packaging.
*
* @parameter property=interimDirectory
* default-value="${project.build.directory}/generated-sources/jjtree"
*/
private File interimDirectory;
/**
* The directory where the parser files generated by JavaCC will be stored.
* The directory will be registered as a compile source root of the project
* such that the generated files will participate in later build phases like
* compiling and packaging.
*
* @parameter property=outputDirectory
* default-value="${project.build.directory}/generated-sources/javacc"
*/
private File outputDirectory;
/**
* A set of Ant-like inclusion patterns used to select files from the source
* directory for processing. By default, the patterns **/*.jj
* , **/*.JJ, **/*.jjt and
* **/*.JJT are used to select grammar files.
*
* @parameter
*/
private String [] includes;
/**
* A set of Ant-like exclusion patterns used to prevent certain files from
* being processed. By default, this set is empty such that no files are
* excluded.
*
* @parameter
*/
private String [] excludes;
/**
* The granularity in milliseconds of the last modification date for testing
* whether a grammar file needs recompilation.
*
* @parameter property=lastModGranularityMs default-value="0"
*/
private int staleMillis;
/**
* {@inheritDoc}
*/
@Override
protected File getSourceDirectory ()
{
return this.sourceDirectory;
}
/**
* {@inheritDoc}
*/
@Override
protected String [] getIncludes ()
{
if (this.includes != null)
{
return this.includes;
}
else
{
return new String [] { "**/*.jj", "**/*.JJ", "**/*.jjt", "**/*.JJT" };
}
}
/**
* {@inheritDoc}
*/
@Override
protected String [] getExcludes ()
{
return this.excludes;
}
/**
* {@inheritDoc}
*/
@Override
protected File getOutputDirectory ()
{
return this.outputDirectory;
}
/**
* {@inheritDoc}
*/
@Override
protected int getStaleMillis ()
{
return this.staleMillis;
}
/**
* Gets the absolute path to the directory where the interim output from
* JJTree will be stored.
*
* @return The absolute path to the directory where the interim output from
* JJTree will be stored.
*/
private File getInterimDirectory ()
{
return this.interimDirectory;
}
/**
* {@inheritDoc}
*/
@Override
protected File [] getCompileSourceRoots ()
{
return new File [] { getOutputDirectory (), getInterimDirectory () };
}
/**
* {@inheritDoc}
*/
@Override
protected void processGrammar (final GrammarInfo grammarInfo) throws MojoExecutionException, MojoFailureException
{
final File jjtFile = grammarInfo.getGrammarFile ();
final File jjtDirectory = jjtFile.getParentFile ();
final File tempDirectory = getTempDirectory ();
// setup output directory of grammar file (*.jj) and node files (*.java)
// generated by JJTree
final File jjDirectory = new File (tempDirectory, "node");
// setup output directory of parser file (*.java) generated by JavaCC
final File parserDirectory = new File (tempDirectory, "parser");
// setup output directory of tree node files (*.java) generated by JJTree
final String nodePackageName = grammarInfo.resolvePackageName (this.nodePackage);
// generate final grammar file
final JJTree jjtree = newJJTree ();
jjtree.setInputFile (jjtFile);
jjtree.setOutputDirectory (jjDirectory);
jjtree.setNodePackage (nodePackageName);
jjtree.run ();
// generate parser files
final JavaCC javacc = newJavaCC ();
javacc.setInputFile (jjtree.getOutputFile ());
javacc.setOutputDirectory (parserDirectory);
javacc.run ();
// copy output from JJTree
copyGrammarOutput (getInterimDirectory (),
(nodePackageName != null) ? nodePackageName : grammarInfo.getParserPackage (),
jjDirectory,
grammarInfo.getParserName () + "TreeConstants*");
// copy parser files from JavaCC
copyGrammarOutput (getOutputDirectory (),
grammarInfo.getParserPackage (),
parserDirectory,
grammarInfo.getParserName () + "*");
// copy source files which are next to grammar unless the grammar resides in
// an ordinary source root
// (legacy support for custom sources)
if (!isSourceRoot (grammarInfo.getSourceDirectory ()))
{
copyGrammarOutput (getOutputDirectory (), grammarInfo.getParserPackage (), jjtDirectory, "*");
}
deleteTempDirectory (tempDirectory);
}
/**
* Creates a new facade to invoke JJTree. Most options for the invocation are
* derived from the current values of the corresponding mojo parameters. The
* caller is responsible to set the input file, output directory and package
* on the returned facade.
*
* @return The facade for the tool invocation, never null.
*/
protected JJTree newJJTree ()
{
final JJTree jjtree = new JJTree ();
jjtree.setLog (getLog ());
jjtree.setGrammarEncoding (getGrammarEncoding ());
jjtree.setJdkVersion (getJdkVersion ());
jjtree.setStatic (getIsStatic ());
jjtree.setBuildNodeFiles (this.buildNodeFiles);
jjtree.setMulti (this.multi);
jjtree.setNodeDefaultVoid (this.nodeDefaultVoid);
jjtree.setNodeClass (this.nodeClass);
jjtree.setNodeFactory (this.nodeFactory);
jjtree.setNodePrefix (this.nodePrefix);
jjtree.setNodeScopeHook (this.nodeScopeHook);
jjtree.setNodeUsesParser (this.nodeUsesParser);
jjtree.setTrackTokens (this.trackTokens);
jjtree.setVisitor (this.visitor);
jjtree.setVisitorDataType (this.visitorDataType);
jjtree.setVisitorReturnType (this.visitorReturnType);
jjtree.setVisitorException (this.visitorException);
return jjtree;
}
}