Package org.codehaus.groovy.ant
Class Groovy
java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.Task
org.apache.tools.ant.taskdefs.Java
org.codehaus.groovy.ant.Groovy
- All Implemented Interfaces:
Cloneable
public class Groovy
extends org.apache.tools.ant.taskdefs.Java
Executes a series of Groovy statements.
Statements can either be read in from a text file using the src attribute or from between the enclosing groovy tags.
- Version:
- $Id$
-
Field Summary
Fields inherited from class org.apache.tools.ant.taskdefs.Java
redirector, redirectorElementFields inherited from class org.apache.tools.ant.Task
target, taskName, taskType, wrapperFields inherited from class org.apache.tools.ant.ProjectComponent
description, location, project -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionprotected voidaddClassPathes(GroovyClassLoader classLoader) Adds the class paths (if any)voidaddFileset(org.apache.tools.ant.types.FileSet set) Adds a set of files (nested fileset attribute).voidSet an inline command to execute.org.apache.tools.ant.types.Commandline.Argumentorg.apache.tools.ant.types.PathReturns a new path element that can be configured.protected voidexecGroovy(String txt, PrintStream out) Exec the statement.voidexecute()Load the file and then execute itorg.apache.tools.ant.types.PathGets the classpath.static voidprotected voidprintResults(PrintStream out) print any results in the statement.protected voidrunStatements(Reader reader, PrintStream out) Read in lines and execute them.voidsetAppend(boolean append) Whether output should be appended to or overwrite an existing file.voidsetClasspath(org.apache.tools.ant.types.Path classpath) Sets the classpath for loading.voidsetClasspathRef(org.apache.tools.ant.types.Reference ref) Set the classpath for loading using the classpath reference.voidsetContextClassLoader(boolean contextClassLoader) Setting to true will cause the contextClassLoader to be set with the classLoader of the shell used to run the script.voidsetFork(boolean fork) Should the script be executed using a forked process.voidsetIncludeAntRuntime(boolean includeAntRuntime) Should the system classpath be included on the classpath when forking.voidSet the output file; optional, defaults to the Ant log.voidSet the name of the file to be run.voidsetStacktrace(boolean stacktrace) Enable compiler to report stack trace information if a problem occurs during compilation.voidsetUseGroovyShell(boolean useGroovyShell) Should a new GroovyShell be used when forking.Methods inherited from class org.apache.tools.ant.taskdefs.Java
addAssertions, addConfiguredRedirector, addEnv, addSysproperty, addSyspropertyset, checkConfiguration, clearArgs, createBootclasspath, createJvmarg, createModulepath, createPermissions, createUpgrademodulepath, createWatchdog, executeJava, executeJava, getCommandLine, getSysProperties, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, maybeSetResultPropertyValue, run, setArgs, setClassname, setCloneVm, setDir, setDiscardError, setDiscardOutput, setError, setErrorProperty, setFailonerror, setInput, setInputString, setJar, setJvm, setJvmargs, setJVMVersion, setLogError, setMaxmemory, setModule, setModulepath, setModulepathRef, setNewenvironment, setOutputproperty, setResultProperty, setSourceFile, setSpawn, setTimeout, setupRedirectorMethods inherited from class org.apache.tools.ant.Task
bindToOwner, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskTypeMethods inherited from class org.apache.tools.ant.ProjectComponent
clone, getDescription, getLocation, getProject, setDescription, setLocation, setProject
-
Constructor Details
-
Groovy
public Groovy()
-
-
Method Details
-
setFork
public void setFork(boolean fork) Should the script be executed using a forked process. Defaults to false.- Overrides:
setForkin classorg.apache.tools.ant.taskdefs.Java- Parameters:
fork- true if the script should be executed in a forked process
-
setUseGroovyShell
public void setUseGroovyShell(boolean useGroovyShell) Should a new GroovyShell be used when forking. Special variables won't be available but you don't need Ant in the classpath.- Parameters:
useGroovyShell- true if GroovyShell should be used to run the script directly
-
setIncludeAntRuntime
public void setIncludeAntRuntime(boolean includeAntRuntime) Should the system classpath be included on the classpath when forking. Defaults to true.- Parameters:
includeAntRuntime- true if the system classpath should be on the classpath
-
setStacktrace
public void setStacktrace(boolean stacktrace) Enable compiler to report stack trace information if a problem occurs during compilation.- Parameters:
stacktrace- set to true to enable stacktrace reporting
-
setSrc
Set the name of the file to be run. The folder of the file is automatically added to the classpath. Required unless statements are enclosed in the build file- Parameters:
srcFile- the file containing the groovy script to execute
-
addText
Set an inline command to execute. NB: Properties are not expanded in this text.- Parameters:
txt- the inline groovy ommands to execute
-
addFileset
public void addFileset(org.apache.tools.ant.types.FileSet set) Adds a set of files (nested fileset attribute).- Parameters:
set- the fileset representing source files
-
setOutput
Set the output file; optional, defaults to the Ant log.- Overrides:
setOutputin classorg.apache.tools.ant.taskdefs.Java- Parameters:
output- the output file
-
setAppend
public void setAppend(boolean append) Whether output should be appended to or overwrite an existing file. Defaults to false.- Overrides:
setAppendin classorg.apache.tools.ant.taskdefs.Java- Parameters:
append- set to true to append
-
setClasspath
public void setClasspath(org.apache.tools.ant.types.Path classpath) Sets the classpath for loading.- Overrides:
setClasspathin classorg.apache.tools.ant.taskdefs.Java- Parameters:
classpath- The classpath to set
-
createClasspath
public org.apache.tools.ant.types.Path createClasspath()Returns a new path element that can be configured. Gets called for instance by Ant when it encounters a nested <classpath> element.- Overrides:
createClasspathin classorg.apache.tools.ant.taskdefs.Java- Returns:
- the resulting created path
-
setClasspathRef
public void setClasspathRef(org.apache.tools.ant.types.Reference ref) Set the classpath for loading using the classpath reference.- Overrides:
setClasspathRefin classorg.apache.tools.ant.taskdefs.Java- Parameters:
ref- the refid to use
-
getClasspath
public org.apache.tools.ant.types.Path getClasspath()Gets the classpath.- Returns:
- Returns a Path
-
execute
public void execute() throws org.apache.tools.ant.BuildExceptionLoad the file and then execute it- Overrides:
executein classorg.apache.tools.ant.taskdefs.Java- Throws:
org.apache.tools.ant.BuildException
-
createArg
public org.apache.tools.ant.types.Commandline.Argument createArg()- Overrides:
createArgin classorg.apache.tools.ant.taskdefs.Java
-
runStatements
Read in lines and execute them.- Parameters:
reader- the reader from which to get the groovy source to execout- the outputstream to use- Throws:
IOException- if something goes wrong
-
execGroovy
Exec the statement.- Parameters:
txt- the groovy source to execout- not used?
-
main
-
addClassPathes
Adds the class paths (if any)- Parameters:
classLoader- the classloader to configure
-
printResults
print any results in the statement.- Parameters:
out- the output PrintStream to print to
-
setContextClassLoader
public void setContextClassLoader(boolean contextClassLoader) Setting to true will cause the contextClassLoader to be set with the classLoader of the shell used to run the script. Not used if fork is true. Not allowed when running from Maven but in that case the context classLoader is set appropriately for Maven.- Parameters:
contextClassLoader- set to true to set the context classloader
-