org.nuiton.plugin
Class AbstractMojoTest<P extends org.nuiton.plugin.Plugin>

java.lang.Object
  org.nuiton.plugin.AbstractMojoTest<P>

Type Parameters:

P - type of goal to test

Direct Known Subclasses:

SendEmailMojoTest

public abstract class AbstractMojoTest<P extends org.nuiton.plugin.Plugin>
extends java.lang.Object

Base test class for a mojo.

Note: replace the previous class org.nuiton.util.BasePluginTestCase.

Inside each test method, we can use the following objects :

• getTestDir() : location of mojo resources (where the pom file for example)
• getPomFile() : location of the pom file
• getMojo() : the instanciated and ready to execute mojo

To change the behaviour of initialization of mojo, you can override the following methods :

• getBasedir()
• getTestBasedir()
• getTestDir(java.lang.String, java.lang.String)
• getPomFile(java.io.File, java.lang.String, java.lang.String)
• createMojo(java.io.File, java.lang.String)
• setUpMojo(org.nuiton.plugin.Plugin, java.io.File)

Since:

1.0.3

Author:

chemit

Nested Class Summary

protected class

AbstractMojoTest.MojoTestRule To offer inside each test method (annotated by a Test) the following properties : AbstractMojoTest.MojoTestRule.testDir : location where to find resources for the test AbstractMojoTest.MojoTestRule.pomFile : location of the pom file to use to build the mojo AbstractMojoTest.MojoTestRule.mojo : the instanciated and initialized mojo

Field Summary

protected static java.io.File	basedir the basedir of the project
protected static org.apache.commons.logging.Log	log Test logger
AbstractMojoTest.MojoTestRule	name Your test rule which offers methodName, testDir, pomFile and mojo inside test methods.
protected static java.io.File	testBasedir the basedir of all tests (by convention getBasedir()/target/test-classes).

Constructor Summary

AbstractMojoTest()

Method Summary

protected P	createMojo(java.io.File pomFile, java.lang.String goalName) Create the mojo base on the given pomFile for the given goalName.
java.io.File	getBasedir()
protected abstract java.lang.String	getGoalName(java.lang.String methodName) Obtain the name of the goal according to the methodName.
protected java.lang.String	getMethodName()
protected P	getMojo()
protected java.io.File	getPomFile()
protected java.io.File	getPomFile(java.io.File testDir, java.lang.String methodName, java.lang.String goalName) Obtain the location of the pom file to use for next mojo test.
java.lang.String	getRelativePathFromBasedir(java.io.File f)
java.lang.String	getRelativePathFromTestBasedir(java.io.File f)
java.io.File	getTestBasedir()
protected java.io.File	getTestDir()
protected java.io.File	getTestDir(java.lang.String methodName, java.lang.String goalName) Obtain the location of the directory where to find resources for the next test.
protected boolean	isVerbose()
protected void	setUpMojo(P mojo, java.io.File pomFile) Initialize the given mojo.

Methods inherited from class java.lang.Object

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

Field Detail

log

protected static final org.apache.commons.logging.Log log

Test logger

basedir

protected static java.io.File basedir

the basedir of the project

testBasedir

protected static java.io.File testBasedir

the basedir of all tests (by convention getBasedir()/target/test-classes).

name

public AbstractMojoTest.MojoTestRule name

Your test rule which offers methodName, testDir, pomFile and mojo inside test methods.

Constructor Detail

AbstractMojoTest

public AbstractMojoTest()

Method Detail

getBasedir

public java.io.File getBasedir()

getTestBasedir

public java.io.File getTestBasedir()

getRelativePathFromBasedir

public java.lang.String getRelativePathFromBasedir(java.io.File f)

getRelativePathFromTestBasedir

public java.lang.String getRelativePathFromTestBasedir(java.io.File f)

getGoalName

protected abstract java.lang.String getGoalName(java.lang.String methodName)

Obtain the name of the goal according to the methodName.

By convention, we should consider that a test class use always the same goal's name.

Parameters:

methodName - the name of the next test to execute.

Returns:

the name of the goal to test for the given method test name.

getTestDir

protected java.io.File getTestDir(java.lang.String methodName,
                                  java.lang.String goalName)

Obtain the location of the directory where to find resources for the next test.

By convention, will be the package named by the test class name from the getTestBasedir().

Parameters:

methodName - the method of the next test to execute

goalName - the common goal name to use

Returns:

the directory where to find resources for the test

getPomFile

protected java.io.File getPomFile(java.io.File testDir,
                                  java.lang.String methodName,
                                  java.lang.String goalName)

Obtain the location of the pom file to use for next mojo test.

By default, the pom file is the file with name methodName+".xml" in the testDir.

Parameters:

testDir - the location of resources for the next test (is the result of the method getTestDir(java.lang.String, java.lang.String).

methodName - the name of the next test

goalName - the name of the common goal

Returns:

the location of the pom file for the next mojo test.

createMojo

protected P createMojo(java.io.File pomFile,
                       java.lang.String goalName)
                                                 throws java.lang.Exception

Create the mojo base on the given pomFile for the given goalName.

Parameters:

pomFile - the location of the pom file

goalName - the name of the goal to lookup

Returns:

the instanciated mojo

Throws:

java.lang.Exception - if any problem while creating the mojo

setUpMojo

protected void setUpMojo(P mojo,
                         java.io.File pomFile)
                  throws java.lang.Exception

Initialize the given mojo.

Parameters:

mojo - the instanciate mojo

pomFile - the pom file used to instanciate the mojo

Throws:

java.lang.Exception - if any pb

getMojo

protected P getMojo()

getMethodName

protected java.lang.String getMethodName()

getPomFile

protected java.io.File getPomFile()

getTestDir

protected java.io.File getTestDir()

isVerbose

protected boolean isVerbose()