org.codehaus.gmavenplus.mojo

Class AbstractGenerateStubsMojo

java.lang.Object

org.apache.maven.plugin.AbstractMojo

org.codehaus.gmavenplus.mojo.AbstractGroovyMojo

org.codehaus.gmavenplus.mojo.AbstractGroovySourcesMojo

org.codehaus.gmavenplus.mojo.AbstractGroovyStubSourcesMojo

org.codehaus.gmavenplus.mojo.AbstractGenerateStubsMojo

All Implemented Interfaces:

org.apache.maven.plugin.ContextEnabled, org.apache.maven.plugin.Mojo

Direct Known Subclasses:

GenerateStubsMojo, GenerateTestStubsMojo

public abstract class AbstractGenerateStubsMojo
extends AbstractGroovyStubSourcesMojo

The base generate stubs mojo, which all generate stubs mojos extend.

Author:

Keegan Witt

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	debug Whether Groovy compiler should be set to debug.
protected static Version	MIN_GROOVY_VERSION The minimum version of Groovy that this mojo supports.
protected Set<String>	scriptExtensions The file extensions of Groovy source files.
protected String	sourceEncoding The encoding of source files.
protected String	targetBytecode The Groovy compiler bytecode compatibility.
protected int	tolerance Groovy compiler error tolerance (the number of non-fatal errors (per unit) that should be tolerated before compilation is aborted).
protected boolean	verbose Whether Groovy compiler should be set to verbose.
protected int	warningLevel Groovy compiler warning level.

Fields inherited from class org.codehaus.gmavenplus.mojo.AbstractGroovyStubSourcesMojo

stubsOutputDirectory, testStubsOutputDirectory

Fields inherited from class org.codehaus.gmavenplus.mojo.AbstractGroovySourcesMojo

MAIN, sources, TEST, testSources

Fields inherited from class org.codehaus.gmavenplus.mojo.AbstractGroovyMojo

GROOVY_SOURCES_PATTERN, JAVA_SOURCES_PATTERN, localRepository, pluginArtifacts, project, reactorProjects, session, settings

Fields inherited from interface org.apache.maven.plugin.Mojo

ROLE

Constructor Summary

Constructors

Constructor and Description
AbstractGenerateStubsMojo()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doStubGeneration(Set<File> stubSources, List classpath, File outputDirectory) Performs the stub generation on the specified source files.
protected boolean	groovyVersionSupportsAction() Determines whether this mojo can be run with the version of Groovy supplied.
protected void	resetStubModifiedDates(Set<File> stubs) This is a fix for http://jira.codehaus.org/browse/MGROOVY-187 It modifies the dates of the created stubs to 1/1/1970, ensuring that the Java compiler will not overwrite perfectly good compiled Groovy just because it has a newer source stub.

Methods inherited from class org.codehaus.gmavenplus.mojo.AbstractGroovyStubSourcesMojo

getStubs, getTestStubs

Methods inherited from class org.codehaus.gmavenplus.mojo.AbstractGroovySourcesMojo

getFiles, getFilesets, getSourceRoots, getSourceRoots, getSources, getSources, getTestSourceRoots, getTestSourceRoots, getTestSources, getTestSources, setSources, setTestSources

Methods inherited from class org.codehaus.gmavenplus.mojo.AbstractGroovyMojo

getGroovyDependency, getGroovyVersion, getGroovyVersionString, getJavaVersion, getJavaVersionString, isGroovyArtifactId, isGroovyArtifactId, isGroovyGroupId, isGroovyGroupId, isGroovyIndy, isJavaSupportIndy, logGroovyVersion

Methods inherited from class org.apache.maven.plugin.AbstractMojo

getLog, getPluginContext, setLog, setPluginContext

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.maven.plugin.Mojo

execute

Field Detail

MIN_GROOVY_VERSION

protected static final Version MIN_GROOVY_VERSION

The minimum version of Groovy that this mojo supports.

sourceEncoding

protected String sourceEncoding

The encoding of source files.

scriptExtensions

protected Set<String> scriptExtensions

The file extensions of Groovy source files.

targetBytecode

protected String targetBytecode

The Groovy compiler bytecode compatibility. One of

• 1.4
• 1.5
• 1.6
• 1.7
• 1.8

debug

protected boolean debug

Whether Groovy compiler should be set to debug.

verbose

protected boolean verbose

Whether Groovy compiler should be set to verbose.

warningLevel

protected int warningLevel

Groovy compiler warning level. Should be one of:

0

None

1

Likely Errors

2

Possible Errors

3

Paranoia

tolerance

protected int tolerance

Groovy compiler error tolerance (the number of non-fatal errors (per unit) that should be tolerated before compilation is aborted).

Constructor Detail

AbstractGenerateStubsMojo

public AbstractGenerateStubsMojo()

Method Detail

doStubGeneration

protected void doStubGeneration(Set<File> stubSources,
                    List classpath,
                    File outputDirectory)
                         throws ClassNotFoundException,
                                InvocationTargetException,
                                IllegalAccessException,
                                InstantiationException,
                                MalformedURLException

Performs the stub generation on the specified source files.

Parameters:

stubSources - the sources to perform stub generation on

classpath - The classpath to use for compilation

outputDirectory - the directory to write the stub files to

Throws:

ClassNotFoundException - When a class needed for stub generation cannot be found

InstantiationException - When a class needed for stub generation cannot be instantiated

IllegalAccessException - When a method needed for stub generation cannot be accessed

InvocationTargetException - When a reflection invocation needed for stub generation cannot be completed

MalformedURLException - When a classpath element provides a malformed URL

groovyVersionSupportsAction

protected boolean groovyVersionSupportsAction()

Determines whether this mojo can be run with the version of Groovy supplied. Must be >= 1.8.2 because not all the classes needed were available and functioning correctly in previous versions.

Returns:

true only if the version of Groovy supports this mojo.

resetStubModifiedDates

protected void resetStubModifiedDates(Set<File> stubs)

This is a fix for http://jira.codehaus.org/browse/MGROOVY-187 It modifies the dates of the created stubs to 1/1/1970, ensuring that the Java compiler will not overwrite perfectly good compiled Groovy just because it has a newer source stub. Basically, this prevents the stubs from causing a side effect with the Java compiler, but still allows stubs to work with JavaDoc.

Parameters:

stubs - the files on which to reset the modified date