org.codehaus.mojo.javacc.JTBMojo 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;
/**
* Parses a JTB file and transforms it into source files for an AST and a JavaCC
* grammar file which automatically builds the AST.
*
* Note: JTB
* requires Java 1.5 or higher. This goal will not work with earlier versions of
* the JRE.
*
* @goal jtb
* @phase generate-sources
* @since 2.2
* @deprecated As of version 2.4, use the jtb-javacc goal instead.
* @author Gregory Kick ([email protected])
* @version $Id: JTBMojo.java 7743 2008-09-28 15:22:44Z bentmann $
*/
@Deprecated
public class JTBMojo extends AbstractPreprocessorMojo
{
/**
* This option is short for nodePackageName =
* <packageName>.syntaxtree and
* visitorPackageName = <packageName>.visitor.
* Note that this option takes precedence over nodePackageName
* and visitorPackageName if specified.
*
* @parameter property=package
*/
private String packageName;
/**
* This option specifies the package for the generated AST nodes. 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 *.demo, the tree node classes will be
* located in the package org.apache.demo. Default value is
* *.syntaxtree.
*
* @parameter property=nodePackageName
*/
private String nodePackageName;
/**
* This option specifies the package for the generated visitors. 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 *.demo, the visitor classes will be
* located in the package org.apache.demo. Default value is
* *.visitor.
*
* @parameter property=visitorPackageName
*/
private String visitorPackageName;
/**
* If true, JTB will suppress its semantic error checking.
* Default value is false.
*
* @parameter property=supressErrorChecking
*/
private Boolean supressErrorChecking;
/**
* If true, all generated comments will be wrapped in
* <pre> tags so that they are formatted correctly in API
* docs. Default value is false.
*
* @parameter property=javadocFriendlyComments
*/
private Boolean javadocFriendlyComments;
/**
* Setting this option to true causes JTB to generate field names
* that reflect the structure of the tree instead of generic names like
* f0, f1 etc. Default value is false.
*
* @parameter property=descriptiveFieldNames
*/
private Boolean descriptiveFieldNames;
/**
* The qualified name of a user-defined class from which all AST nodes will
* inherit. By default, AST nodes will inherit from the generated class
* Node.
*
* @parameter property=nodeParentClass
*/
private String nodeParentClass;
/**
* If true, all nodes will contain fields for its parent node.
* Default value is false.
*
* @parameter property=parentPointers
*/
private Boolean parentPointers;
/**
* If true, JTB will include JavaCC "special tokens" in the AST.
* Default value is false.
*
* @parameter property=specialTokens
*/
private Boolean specialTokens;
/**
* If true, JTB will generate the following files to support the
* Schema programming language:
*
* - Scheme records representing the grammar.
* - A Scheme tree building visitor.
*
* Default value is false.
*
* @parameter property=scheme
*/
private Boolean scheme;
/**
* If true, JTB will generate a syntax tree dumping visitor.
* Default value is false.
*
* @parameter property=printer
*/
private Boolean printer;
/**
* The directory where the JavaCC grammar files (*.jtb) are
* located. It will be recursively scanned for input files to pass to JTB.
*
* @parameter property=sourceDirectory default-value="${basedir}/src/main/jtb"
*/
private File sourceDirectory;
/**
* The directory where the output Java files will be located.
*
* @parameter property=outputDirectory
* default-value="${project.build.directory}/generated-sources/jtb"
*/
private File outputDirectory;
/**
* The directory to store the processed input files for later detection of
* stale sources.
*
* @parameter property=timestampDirectory default-value=
* "${project.build.directory}/generated-sources/jtb-timestamp"
*/
private File timestampDirectory;
/**
* The granularity in milliseconds of the last modification date for testing
* whether a source needs recompilation.
*
* @parameter property=lastModGranularityMs default-value="0"
*/
private int staleMillis;
/**
* A set of Ant-like inclusion patterns used to select files from the source
* directory for processing. By default, the patterns
* **/*.jtb and **/*.JTB 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;
/**
* {@inheritDoc}
*/
@Override
protected File getSourceDirectory ()
{
return this.sourceDirectory;
}
/**
* {@inheritDoc}
*/
@Override
protected String [] getIncludes ()
{
if (this.includes != null)
{
return this.includes;
}
else
{
return new String [] { "**/*.jtb", "**/*.JTB" };
}
}
/**
* {@inheritDoc}
*/
@Override
protected String [] getExcludes ()
{
return this.excludes;
}
/**
* {@inheritDoc}
*/
@Override
protected File getOutputDirectory ()
{
return this.outputDirectory;
}
/**
* {@inheritDoc}
*/
@Override
protected File getTimestampDirectory ()
{
return this.timestampDirectory;
}
/**
* {@inheritDoc}
*/
@Override
protected int getStaleMillis ()
{
return this.staleMillis;
}
/**
* {@inheritDoc}
*/
@Override
protected void processGrammar (final GrammarInfo grammarInfo) throws MojoExecutionException, MojoFailureException
{
final File jtbFile = grammarInfo.getGrammarFile ();
final File jjDirectory = new File (getOutputDirectory (), grammarInfo.getParserDirectory ());
final String nodePackage = grammarInfo.resolvePackageName (getNodePackageName ());
final File nodeDirectory = new File (getOutputDirectory (), nodePackage.replace ('.', File.separatorChar));
final String visitorPackage = grammarInfo.resolvePackageName (getVisitorPackageName ());
final File visitorDirectory = new File (getOutputDirectory (), visitorPackage.replace ('.', File.separatorChar));
// generate final grammar file and the node/visitor files
final JTB jtb = newJTB ();
jtb.setInputFile (jtbFile);
jtb.setOutputDirectory (jjDirectory);
jtb.setNodeDirectory (nodeDirectory);
jtb.setVisitorDirectory (visitorDirectory);
jtb.setNodePackageName (nodePackage);
jtb.setVisitorPackageName (visitorPackage);
jtb.run ();
// create timestamp file
createTimestamp (grammarInfo);
}
/**
* Gets the effective package name for the AST node files.
*
* @return The effective package name for the AST node files, never
* null.
*/
private String getNodePackageName ()
{
if (this.packageName != null)
{
return this.packageName + ".syntaxtree";
}
else
if (this.nodePackageName != null)
{
return this.nodePackageName;
}
else
{
return "*.syntaxtree";
}
}
/**
* Gets the effective package name for the visitor files.
*
* @return The effective package name for the visitor files, never
* null.
*/
private String getVisitorPackageName ()
{
if (this.packageName != null)
{
return this.packageName + ".visitor";
}
else
if (this.visitorPackageName != null)
{
return this.visitorPackageName;
}
else
{
return "*.visitor";
}
}
/**
* Creates a new facade to invoke JTB. 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 directories and
* packages on the returned facade.
*
* @return The facade for the tool invocation, never null.
*/
private JTB newJTB ()
{
final JTB jtb = new JTB ();
jtb.setLog (getLog ());
jtb.setDescriptiveFieldNames (this.descriptiveFieldNames);
jtb.setJavadocFriendlyComments (this.javadocFriendlyComments);
jtb.setNodeParentClass (this.nodeParentClass);
jtb.setParentPointers (this.parentPointers);
jtb.setPrinter (this.printer);
jtb.setScheme (this.scheme);
jtb.setSpecialTokens (this.specialTokens);
jtb.setSupressErrorChecking (this.supressErrorChecking);
return jtb;
}
}