railo.runtime.tag
Class Execute

java.lang.Object
  extended by railo.runtime.ext.tag.TagImpl
      extended by railo.runtime.ext.tag.BodyTagImpl
          extended by railo.runtime.tag.Execute
All Implemented Interfaces:
javax.servlet.jsp.tagext.BodyTag, javax.servlet.jsp.tagext.IterationTag, javax.servlet.jsp.tagext.Tag

public final class Execute
extends BodyTagImpl

Enables CFML developers to execute a process on a server computer.


Field Summary
 
Fields inherited from interface javax.servlet.jsp.tagext.BodyTag
EVAL_BODY_BUFFERED, EVAL_BODY_TAG
 
Fields inherited from interface javax.servlet.jsp.tagext.IterationTag
EVAL_BODY_AGAIN
 
Fields inherited from interface javax.servlet.jsp.tagext.Tag
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
 
Constructor Summary
Execute()
           
 
Method Summary
 int doAfterBody()
           
 int doEndTag()
           
 void doInitBody()
           
 int doStartTag()
           
 void release()
           
 void setArguments(Object args)
          set the value arguments Command-line arguments passed to the application.
 void setName(String name)
          set the value name The full pathname of the application to execute.
 void setOutputfile(String outputfile)
          set the value outputfile The file to which to direct the output of the program.
 void setTerminateontimeout(boolean terminateontimeout)
           
 void setTimeout(double timeout)
          set the value timeout Indicates how long, in seconds, the CFML executing thread waits for the spawned process.
 void setVariable(String variable)
          define name of variable where output is written to
 
Methods inherited from class railo.runtime.ext.tag.BodyTagImpl
setBodyContent
 
Methods inherited from class railo.runtime.ext.tag.TagImpl
getParent, required, required, required, required, setPageContext, setPageContext, setParent
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface javax.servlet.jsp.tagext.Tag
getParent, setPageContext, setParent
 

Constructor Detail

Execute

public Execute()
Method Detail

release

public void release()
Specified by:
release in interface javax.servlet.jsp.tagext.Tag
Overrides:
release in class BodyTagImpl

setArguments

public void setArguments(Object args)
set the value arguments Command-line arguments passed to the application.

Parameters:
args - value to set

setTimeout

public void setTimeout(double timeout)
                throws ApplicationException
set the value timeout Indicates how long, in seconds, the CFML executing thread waits for the spawned process. A timeout of 0 is equivalent to the non-blocking mode of executing. A very high timeout value is equivalent to a blocking mode of execution. The default is 0; therefore, the CFML thread spawns a process and returns without waiting for the process to terminate.If no output file is specified, and the timeout value is 0, the program output is discarded.

Parameters:
timeout - value to set
Throws:
ApplicationException

setTerminateontimeout

public void setTerminateontimeout(boolean terminateontimeout)

setName

public void setName(String name)
set the value name The full pathname of the application to execute. Note: On Windows, you must specify the extension as part of the application's name. For example, myapp.exe,

Parameters:
name - value to set

setVariable

public void setVariable(String variable)
                 throws PageException
define name of variable where output is written to

Parameters:
variable -
Throws:
PageException

setOutputfile

public void setOutputfile(String outputfile)
set the value outputfile The file to which to direct the output of the program. If not specified, the output is displayed on the page from which it was called.

Parameters:
outputfile - value to set
Throws:
SecurityException

doStartTag

public int doStartTag()
               throws PageException
Specified by:
doStartTag in interface javax.servlet.jsp.tagext.Tag
Overrides:
doStartTag in class TagImpl
Throws:
PageException

doEndTag

public int doEndTag()
             throws PageException
Specified by:
doEndTag in interface javax.servlet.jsp.tagext.Tag
Overrides:
doEndTag in class TagImpl
Throws:
PageException

doInitBody

public void doInitBody()
Specified by:
doInitBody in interface javax.servlet.jsp.tagext.BodyTag
Overrides:
doInitBody in class BodyTagImpl

doAfterBody

public int doAfterBody()
Specified by:
doAfterBody in interface javax.servlet.jsp.tagext.IterationTag
Overrides:
doAfterBody in class BodyTagImpl


Copyright © 2012 Railo