org.savantbuild.plugin.groovy

Class BaseGroovyPlugin

java.lang.Object

groovy.lang.GroovyObjectSupport

org.savantbuild.plugin.groovy.BaseGroovyPlugin

All Implemented Interfaces:

groovy.lang.GroovyObject, Plugin

public class BaseGroovyPlugin
extends groovy.lang.GroovyObjectSupport
implements Plugin

Abstract base class for plugins. This defines some helper methods that all plugins will need and it also allows Savant to pass the Project and Output objects to plugins.

Field Summary

Fields

Modifier and Type	Field and Description
org.savantbuild.output.Output	output
Project	project
RuntimeConfiguration	runtimeConfiguration

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BaseGroovyPlugin(Project project, RuntimeConfiguration runtimeConfiguration, org.savantbuild.output.Output output)

Method Summary

Modifier and Type	Method and Description
protected void	fail(java.lang.String message, java.lang.Object... values) Fails the build with the given message by throwing a BuildFailureException.
protected java.util.Properties	loadConfiguration(org.savantbuild.dep.domain.ArtifactID id, java.lang.String errorMessage) Loads the plugin configuration file.

Methods inherited from class groovy.lang.GroovyObjectSupport

getMetaClass, getProperty, invokeMethod, setMetaClass, setProperty

Methods inherited from class java.lang.Object

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

Field Detail

output

public final org.savantbuild.output.Output output

project

public final Project project

runtimeConfiguration

public final RuntimeConfiguration runtimeConfiguration

Constructor Detail

BaseGroovyPlugin

protected BaseGroovyPlugin(Project project,
                           RuntimeConfiguration runtimeConfiguration,
                           org.savantbuild.output.Output output)

Method Detail

fail

protected void fail(java.lang.String message,
                    java.lang.Object... values)

Fails the build with the given message by throwing a BuildFailureException.

Parameters:

message - The failure message.

values - Values used to format the message String.

loadConfiguration

protected java.util.Properties loadConfiguration(org.savantbuild.dep.domain.ArtifactID id,
                                                 java.lang.String errorMessage)

Loads the plugin configuration file. If the configuration file doesn't exist, this throws an exception.

The configuration file location is standardized and based on the ArtifactID of the plugin and the user's home directory.

The location pattern is as follows:

   <user.home>/plugins/<id.group>.<id.name>.properties
 

Parameters:

id - The artifact Id that is used to load the configuration file.

errorMessage - The error message to print out if the configuration file doesn't exist or is invalid.

Returns:

The Properties object for the configuration file.