Package org.apache.catalina.ant
Class BaseRedirectorHelperTask
java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.Task
org.apache.catalina.ant.BaseRedirectorHelperTask
- All Implemented Interfaces:
- Cloneable
- Direct Known Subclasses:
- AbstractCatalinaTask,- JMXAccessorTask,- ValidatorTask
public abstract class BaseRedirectorHelperTask
extends org.apache.tools.ant.Task
Abstract base class to add output redirection support for Catalina Ant tasks.
 These tasks require Ant 1.5 or later.
 
WARNING: due to depends chain, Ant could call a Task more than once and this can affect the output redirection when configured. If you are collecting the output in a property, it will collect the output of only the first run, since Ant properties are immutable and once created they cannot be changed.
If you are collecting output in a file the file will be overwritten with the output of the last run, unless you set append="true", in which case each run will append it's output to the file.
WARNING: due to depends chain, Ant could call a Task more than once and this can affect the output redirection when configured. If you are collecting the output in a property, it will collect the output of only the first run, since Ant properties are immutable and once created they cannot be changed.
If you are collecting output in a file the file will be overwritten with the output of the last run, unless you set append="true", in which case each run will append it's output to the file.
- Since:
- 5.5
- Author:
- Gabriele Garuglieri
- 
Field SummaryFieldsModifier and TypeFieldDescriptionprotected booleanFlag which indicates that, if redirected, output should also be always sent to the log.protected booleanWhether to fail (with a BuildException) if ManagerServlet returns an error.protected OutputStreamThe stream for error outputprotected final org.apache.tools.ant.taskdefs.RedirectorRedirector helperprotected booleanwill be set totruewhen the configuration of the Redirector is complete.protected org.apache.tools.ant.types.RedirectorElementRedirector element for this taskprotected booleantruetrue when output redirection is requested for this task.protected OutputStreamThe stream for info outputFields inherited from class org.apache.tools.ant.Tasktarget, taskName, taskType, wrapperFields inherited from class org.apache.tools.ant.ProjectComponentdescription, location, project
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionvoidaddConfiguredRedirector(org.apache.tools.ant.types.RedirectorElement redirectorElement) Add aRedirectorElementto this task.protected voidAsk redirector to close all the streams.protected voidhandleErrorFlush(String output) Handles error output with the ERR priority and flushes the stream.protected voidhandleErrorOutput(String output) Handles error output with the ERR priority.protected voidhandleFlush(String output) Handles output with the INFO priority and flushes the stream.protected voidhandleOutput(String output) Handles output with the INFO priority.protected voidhandleOutput(String output, int priority) Handles output with ERR priority to error stream and all other priorities to output stream.booleanReturns the value of the failOnError property.protected voidSet up properties on the Redirector and create output streams.voidsetAlwaysLog(boolean alwaysLog) If true, (error and non-error) output will be redirected as specified while being sent to Ant's logging mechanism as if no redirection had taken place.voidsetAppend(boolean append) If true, append output to existing file.voidsetCreateEmptyFiles(boolean createEmptyFiles) Whether output and error files should be created even when empty.voidFile the error output of the task is redirected to.voidsetErrorProperty(String errorProperty) Property name whose value should be set to the error of the task.voidsetFailonerror(boolean fail) Whether to fail (with a BuildException) if ManagerServlet returns an error.voidsetLogError(boolean logError) Controls whether error output is logged.voidFile the output of the task is redirected to.voidsetOutputproperty(String outputProperty) Property name whose value should be set to the output of the task.Methods inherited from class org.apache.tools.ant.TaskbindToOwner, execute, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleInput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskTypeMethods inherited from class org.apache.tools.ant.ProjectComponentclone, getDescription, getLocation, getProject, setDescription, setLocation, setProject
- 
Field Details- 
redirectorprotected final org.apache.tools.ant.taskdefs.Redirector redirectorRedirector helper
- 
redirectorElementprotected org.apache.tools.ant.types.RedirectorElement redirectorElementRedirector element for this task
- 
redirectOutStreamThe stream for info output
- 
redirectErrStreamThe stream for error output
- 
failOnErrorprotected boolean failOnErrorWhether to fail (with a BuildException) if ManagerServlet returns an error. The default behavior is to do so. This flag does not control parameters checking. If the task is called with wrong or invalid parameters, it will throw BuildException independently from the setting of this flag.
- 
redirectOutputprotected boolean redirectOutputtruetrue when output redirection is requested for this task. Default is to log on Ant log.
- 
redirectorConfiguredprotected boolean redirectorConfiguredwill be set totruewhen the configuration of the Redirector is complete.
- 
alwaysLogprotected boolean alwaysLogFlag which indicates that, if redirected, output should also be always sent to the log. Default is that output is sent only to redirected streams.
 
- 
- 
Constructor Details- 
BaseRedirectorHelperTaskpublic BaseRedirectorHelperTask()
 
- 
- 
Method Details- 
setFailonerrorpublic void setFailonerror(boolean fail) Whether to fail (with a BuildException) if ManagerServlet returns an error. The default behavior is to do so.- Parameters:
- fail- The new value of failonerror
 
- 
isFailOnErrorpublic boolean isFailOnError()Returns the value of the failOnError property.- Returns:
- trueif the task should will if an error occurs, otherwise- false
 
- 
setOutputFile the output of the task is redirected to.- Parameters:
- out- name of the output file
 
- 
setErrorFile the error output of the task is redirected to.- Parameters:
- error- name of the error file
 
- 
setLogErrorpublic void setLogError(boolean logError) Controls whether error output is logged. This is only useful when output is being redirected and error output is desired in the Ant log- Parameters:
- logError- if true the standard error is sent to the Ant log system and not sent to output stream.
 
- 
setOutputpropertyProperty name whose value should be set to the output of the task.- Parameters:
- outputProperty- property name
 
- 
setErrorPropertyProperty name whose value should be set to the error of the task.- Parameters:
- errorProperty- property name
 
- 
setAppendpublic void setAppend(boolean append) If true, append output to existing file.- Parameters:
- append- if true, append output to existing file
 
- 
setAlwaysLogpublic void setAlwaysLog(boolean alwaysLog) If true, (error and non-error) output will be redirected as specified while being sent to Ant's logging mechanism as if no redirection had taken place. Defaults to false.
 Actually handled internally, with Ant 1.6.3 it will be handled by theRedirectoritself.- Parameters:
- alwaysLog-- boolean
 
- 
setCreateEmptyFilespublic void setCreateEmptyFiles(boolean createEmptyFiles) Whether output and error files should be created even when empty. Defaults to true.- Parameters:
- createEmptyFiles-- boolean.
 
- 
addConfiguredRedirectorpublic void addConfiguredRedirector(org.apache.tools.ant.types.RedirectorElement redirectorElement) Add aRedirectorElementto this task.- Parameters:
- redirectorElement-- RedirectorElement.
 
- 
openRedirectorprotected void openRedirector()Set up properties on the Redirector and create output streams.
- 
closeRedirectorprotected void closeRedirector()Ask redirector to close all the streams. It is necessary to call this method before leaving the Task to have the Streams flush their contents. If you are collecting output in a property, it will be created only if this method is called, otherwise you'll find it unset.
- 
handleOutputHandles output with the INFO priority.- Overrides:
- handleOutputin class- org.apache.tools.ant.Task
- Parameters:
- output- The output to log. Should not be- null.
 
- 
handleFlushHandles output with the INFO priority and flushes the stream.- Overrides:
- handleFlushin class- org.apache.tools.ant.Task
- Parameters:
- output- The output to log. Should not be- null.
 
- 
handleErrorOutputHandles error output with the ERR priority.- Overrides:
- handleErrorOutputin class- org.apache.tools.ant.Task
- Parameters:
- output- The error output to log. Should not be- null.
 
- 
handleErrorFlushHandles error output with the ERR priority and flushes the stream.- Overrides:
- handleErrorFlushin class- org.apache.tools.ant.Task
- Parameters:
- output- The error output to log. Should not be- null.
 
- 
handleOutputHandles output with ERR priority to error stream and all other priorities to output stream.- Parameters:
- output- The output to log. Should not be- null.
- priority- The priority level that should be used
 
 
-