com.uwyn.rife.engine
Class ElementSupport

java.lang.Object
  com.uwyn.rife.engine.ElementSupport

All Implemented Interfaces:

ContinuableObject, Cloneable

Direct Known Subclasses:

Element

public class ElementSupport
extends Object
implements ContinuableObject, Cloneable

The ElementSupport class provides all the methods to communicate from inside an element with the context in which it is being executed.

Since:

1.0

Version:

$Revision: 3846 $

Author:

Geert Bevin (gbevin[remove] at uwyn dot com)

See Also:

ElementAware

Constructor Summary

protected

ElementSupport()

Method Summary

void	addDateHeader(String name, long date) Sets a response header with the given name and date-value.
void	addHeader(String name, String value) Adds a response header with the given name and value.
void	addIntHeader(String name, int value) Adds a response header with the given name and integer value.
void	addOutputValue(String name, boolean value) Adds a boolean value to the current values of an output.
void	addOutputValue(String name, char value) Adds a char value to the current values of an output.
void	addOutputValue(String name, char[] value) Adds values from an array of chars to the current values of an output.
void	addOutputValue(String name, double value) Adds a double value to the current values of an output.
void	addOutputValue(String name, float value) Adds a float value to the current values of an output.
void	addOutputValue(String name, int value) Adds a int value to the current values of an output.
void	addOutputValue(String name, long value) Adds a long value to the current values of an output.
void	addOutputValue(String name, Object value) Adds a generic object value to the current values of an output.
void	addOutputValue(String name, String value) Adds a value to the current values of an output.
void	addOutputValues(String name, String[] values) Adds values to the current values of an output.
void	answer() Resumes the execution in the calling element by providing no answer object.
void	answer(Object answer) Resumes the execution in the calling element by providing an answer.
Object	call(String exit) Pauses the execution of the element and creates a new continuation.
void	child() Interrupts the execution in this element and transfers the execution to the child element.
boolean	childTriggered(String name, String[] values) Called by the engine when a child trigger occurs, this method should never be called explicitly.
void	clearBuffer() Clears the request text output buffer, all buffered text will be discarded.
void	clearNamedOutputBean(String name) Clears the outputs that correspond to the properties of a named output bean.
void	clearOutput(String name) Clears the output value of an output.
void	clearOutputBean(Class beanClass) Clears the outputs that correspond to the properties of an output bean.
void	clearOutputBean(Class beanClass, String prefix) Clears the outputs that correspond to the properties of an output bean, taking the provided prefix into account.
Object	clone() When continuations are resumed, they are by default cloned to ensure that their state is properly isolated.
boolean	cloneContinuations() Indicates whether continuations are cloned at each step.
boolean	containsHeader(String name) Returns a boolean indicating whether the named response header has already been set.
void	defer() Interrupts the execution in RIFE completely and defers it to the servlet container.
boolean	duringStepBack() Indicates whether the current element execution is a step back.
void	enableTextBuffer(boolean enabled) Enables or disables the response text buffer.
String	encodeHtml(String source) Transforms a provided String object into a new string, containing only valid HTML characters.
String	encodeXml(String source) Transforms a provided String object into a new string, containing only valid XML characters.
List<String>	evaluateExpressionRoleUserTags(Template template, String id) Evaluate the ROLEUSER expression tags in a template.
void	exit(String name) Activates an exit.
void	fillSubmissionBean(Object bean) Fills the properties of an existing bean with the parameter values of the submission that was sent.
void	fillSubmissionBean(Object bean, String prefix) Fills the properties of an existing bean with the parameter values of the submission that was sent, taking the provided prefix into account.
void	fillSubmissionBean(String submissionName, Object bean) Fills the properties of an existing bean with the parameter values of a submission.
void	fillSubmissionBean(String submissionName, Object bean, String prefix) Fills the properties of an existing bean with the parameter values of a submission, taking the provided prefix into account.
void	flush() Flushes the request text output buffer and the request output stream.
void	forward(String url) Interrupts the execution in this element and forwards the entire request to another URL.
void	generateEmptyForm(Template template, Class beanClass) Generates a form that corresponds to an empty instance of a bean class.
void	generateEmptyForm(Template template, Class beanClass, String prefix) Generates a form that corresponds to an empty instance of a bean class.
void	generateForm(Template template, Object beanInstance) Generates a form that corresponds to a bean instance.
void	generateForm(Template template, Object beanInstance, String prefix) Generates a form that corresponds to a bean instance.
String	getContentType() Returns the MIME type of the body of the request, or null if the type is not known.
String	getContinuationId() Returns the unique identifier of the current continuation.
Cookie	getCookie(String name) Retrieves a cookie.
String	getCookieValue(String name) Retrieves the value of a cookie.
String	getCookieValue(String name, String defaultValue) Retrieves the value of a named cookie, using a default value as fallback.
boolean	getCookieValueBoolean(String name) Retrieves the value of a named cookie and converts it to a boolean.
boolean	getCookieValueBoolean(String name, boolean defaultValue) Retrieves the value of a named cookie and converts it to a boolean, using a default value if no input value is present.
double	getCookieValueDouble(String name) Retrieves the value of a named cookie and converts it to a double.
double	getCookieValueDouble(String name, double defaultValue) Retrieves the value of a named cookie and converts it to a double, using a default value if no input value is present.
float	getCookieValueFloat(String name) Retrieves the value of a named cookie and converts it to a float.
float	getCookieValueFloat(String name, float defaultValue) Retrieves the value of a named cookie and converts it to a float, using a default value if no input value is present.
int	getCookieValueInt(String name) Retrieves the value of a named cookie and converts it to an integer.
int	getCookieValueInt(String name, int defaultValue) Retrieves the value of a named cookie and converts it to an integer, using a default value if no input value is present.
long	getCookieValueLong(String name) Retrieves the value of a named cookie and converts it to a long.
long	getCookieValueLong(String name, long defaultValue) Retrieves the value of a named cookie and converts it to a long, using a default value if no input value is present.
Map<String,String>	getCookieValues() Retrieves all current cookies names with their values.
long	getDateHeader(String name) Returns the value of the specified request header as a long value that represents a Date object.
String	getDeclarationName() Retrieves the declaration name of this element.
ElementDeployer	getDeployer() Retrieves the deployer of this element.
Class	getDeploymentClass() Retrieves the class that will be used for the deployment of the element.
ElementContext	getElementContext() Retrieves the context of this element.
ElementInfo	getElementInfo() Retrieves the declaration information of this element.
Object	getEmbedData() Retrieves the data that was passed on for the processing of this embedded element.
String	getEmbedDifferentiator() Retrieves the differentiator that was used to set this embedded element apart.
ElementSupport	getEmbeddingElement() Retrieves the element that is embedding the current element.
Template	getEmbeddingTemplate() Retrieves the template that is embedding the current element.
Properties	getEmbedProperties() Retrieves the embed value as a property list (see getEmbedValue() for more information about embed values).
String	getEmbedValue() Retrieves the current content of the value tag of this embedded element.
CharSequence	getExitFormParameters(String name) Generates the XHTML hidden form parameters for an exit.
CharSequence	getExitFormParameters(String name, String[] outputValues) Generates the hidden XHTML form parameters for an exit and overrides the current output values only for this method.
CharSequence	getExitFormParametersJavascript(String name, String[] outputValues) Generates Javascript that will generate hidden XHTML form parameters for an exit and overrides the current output values only for this method.
CharSequence	getExitFormUrl(String name) Generates a form action URL for an exit.
CharSequence	getExitFormUrl(String name, String pathinfo) Generates a form action URL for an exit and appends a pathinfo to the URL of the destination element.
CharSequence	getExitQueryUrl(String name) Generates a query URL for an exit.
CharSequence	getExitQueryUrl(String name, String pathinfo) Generates a query URL for an exit and appends a pathinfo to the URL of the destination element.
CharSequence	getExitQueryUrl(String name, String[] outputValues) Generates a query URL for an exit and overrides the current output values only for this method.
CharSequence	getExitQueryUrl(String name, String pathinfo, String[] outputValues) Generates a query URL for an exit and appends a pathinfo to the URL of the destination element.
String	getHeader(String name) Returns the value of the specified request header as a String.
Enumeration	getHeaderNames() Returns an enumeration of all the header names this request contains.
Enumeration	getHeaders(String name) Returns all the values of the specified request header as an Enumeration of String objects.
Template	getHtmlTemplate() Creates a new template instance of the enginehtml type, using the current element's absolute ID as the template name.
Template	getHtmlTemplate(String name) Creates a new template instance of the enginehtml type.
Template	getHtmlTemplate(String name, String encoding) Creates a new template instance of the enginehtml type.
Template	getHtmlTemplate(String name, String encoding, TemplateTransformer transformer) Creates a new template instance of the enginehtml type.
Template	getHtmlTemplate(String name, TemplateTransformer transformer) Creates a new template instance of the enginehtml type.
HttpServletRequest	getHttpServletRequest() Returns the current HttpServletRequest.
HttpServletResponse	getHttpServletResponse() Returns the current HttpServletResponse.
InitConfig	getInitConfig() Retrieves initialization configuration of this web application.
String	getInput(String name) Retrieves the value of an input.
String	getInput(String name, String defaultValue) Retrieves the value of an input and returns a default value if no input value is present
<BeanType> BeanType	getInputBean(Class<BeanType> beanClass) Retrieves an instance of an input bean and populates the properties with the input values.
<BeanType> BeanType	getInputBean(Class<BeanType> beanClass, String prefix) Retrieves an instance of an input bean and populates the properties with the input values, taking the provided prefix into account.
boolean	getInputBoolean(String name) Retrieves the value of an input and converts it to a boolean.
boolean	getInputBoolean(String name, boolean defaultValue) Retrieves the value of an input and converts it to a boolean, using a default value if no input value is present.
Date	getInputDate(String name) Retrieves the value of an input and converts it to a Date.
Date	getInputDate(String name, Date defaultValue) Retrieves the value of an input and converts it to a Date, using a default value if no input value is present.
double	getInputDouble(String name) Retrieves the value of an input and converts it to a double.
double	getInputDouble(String name, double defaultValue) Retrieves the value of an input and converts it to a double, using a default value if no input value is present.
float	getInputFloat(String name) Retrieves the value of an input and converts it to a float.
float	getInputFloat(String name, float defaultValue) Retrieves the value of an input and converts it to a float, using a default value if no input value is present.
int	getInputInt(String name) Retrieves the value of an input and converts it to an integer.
int	getInputInt(String name, int defaultValue) Retrieves the value of an input and converts it to an integer, using a default value if no input value is present.
long	getInputLong(String name) Retrieves the value of an input and converts it to a long.
long	getInputLong(String name, long defaultValue) Retrieves the value of an input and converts it to a long, using a default value if no input value is present.
<TargetType extends Serializable> TargetType	getInputSerializable(String name) Retrieves the value of a serialized input.
<TargetType extends Serializable> TargetType	getInputSerializable(String name, TargetType defaultValue) Retrieves the value of a serialized input and returns a default value if no input value is present
String[]	getInputValues(String name) Retrieves the values of an input.
int	getIntHeader(String name) Returns the value of the specified request header as an int.
RequestMethod	getMethod() Returns the method of this request.
<BeanType> BeanType	getNamedInputBean(String name) Retrieves an instance of a named input bean and populates the properties with the input values.
<BeanType> BeanType	getNamedSubmissionBean(String beanName) Retrieves an instance of a named submission bean for the current submission and populates the properties with the parameter values.
<BeanType> BeanType	getNamedSubmissionBean(String submissionName, String beanName) Retrieves an instance of a named submission bean and populates the properties with the parameter values.
String[]	getOutput(String name) Retrieves the value of the ouput.
OutputStream	getOutputStream() Retrieves an output stream to send binary data through the response.
String	getParameter(String name) Retrieves the value of a parameter.
String	getParameter(String name, String defaultValue) Retrieves the value of a parameter and returns a default value if no parameter value is present
boolean	getParameterBoolean(String name) Retrieves the value of a parameter and converts it to a boolean.
boolean	getParameterBoolean(String name, boolean defaultValue) Retrieves the value of a parameter and converts it to a boolean, using a default value if no parameter value is present.
double	getParameterDouble(String name) Retrieves the value of a parameter and converts it to a double.
double	getParameterDouble(String name, double defaultValue) Retrieves the value of a parameter and converts it to a double, using a default value if no parameter value is present.
double[]	getParameterDoubleValues(String name) Retrieves the values of a parameter as an array of doubles.
float	getParameterFloat(String name) Retrieves the value of a parameter and converts it to a float.
float	getParameterFloat(String name, float defaultValue) Retrieves the value of a parameter and converts it to a float, using a default value if no parameter value is present.
float[]	getParameterFloatValues(String name) Retrieves the values of a parameter as an array of floats.
int	getParameterInt(String name) Retrieves the value of a parameter and converts it to an integer.
int	getParameterInt(String name, int defaultValue) Retrieves the value of a parameter and converts it to an integer, using a default value if no parameter value is present.
int[]	getParameterIntValues(String name) Retrieves the values of a parameter as an array of integers.
long	getParameterLong(String name) Retrieves the value of a parameter and converts it to a long.
long	getParameterLong(String name, long defaultValue) Retrieves the value of a parameter and converts it to a long, using a default value if no parameter value is present.
long[]	getParameterLongValues(String name) Retrieves the values of a parameter as an array of longs.
ArrayList<String>	getParameterNames() Retrieves the names of all the parameters that are present.
ArrayList<String>	getParameterNames(String regexp) Retrieves the names of all the parameters that are present and that match a regular expression.
String[]	getParameterValues(String name) Retrieves the values of a parameter.
String	getPathInfo() Returns any extra path information associated with the URL the client sent when it made this request.
Object	getProperty(String name) Retrieves the value of an injected named property.
Object	getProperty(String name, Object defaultValue) Retrieves the value of an injected named property, using a default value as fallback.
String	getPropertyString(String name) Retrieves the value of an injected named property and converts it to a string.
String	getPropertyString(String name, String defaultValue) Retrieves the value of an injected named property and converts it to a string, using a default value as fallback.
<T> T	getPropertyTyped(String name, Class<T> type) Retrieves the value of an injected named property and converts it to the specified type.
<T> T	getPropertyTyped(String name, Class<T> type, T defaultValue) Retrieves the value of an injected named property and converts it to the specified type, using a default value as fallback.
String	getProtocol() Returns the name and version of the protocol the request uses in the form protocol/majorVersion.minorVersion, for example, HTTP/1.1.
String	getRemoteAddr() Returns the Internet Protocol (IP) address of the client or last proxy that sent the request.
String	getRemoteHost() Returns the fully qualified name of the client or the last proxy that sent the request.
String	getRemoteUser() Returns the login of the user making this request, if the user has been authenticated, or null if the user has not been authenticated.
Object	getRequestAttribute(String name) Returns the value of the named attribute as an Object, or null if no attribute of the given name exists.
Enumeration	getRequestAttributeNames() Returns an Enumeration containing the names of the attributes available to this request.
String	getRequestCharacterEncoding() Returns the name of the character encoding used in the body of this request.
Locale	getRequestLocale() Returns the preferred Locale that the client will accept content in, based on the Accept-Language header.
Enumeration	getRequestLocales() Returns an Enumeration of Locale objects indicating, in decreasing order starting with the preferred locale, the locales that are acceptable to the client based on the Accept-Language header.
String	getResponseCharacterEncoding() Returns the name of the character encoding (MIME charset) used for the body sent in this response.
Locale	getResponseLocale() Returns the locale specified for this response using the setResponseLocale(java.util.Locale) method.
String	getScheme() Returns the name of the scheme used to make this request, for example, http, https, or ftp.
String	getServerName() Returns the host name of the server to which the request was sent.
int	getServerPort() Returns the port number to which the request was sent.
String	getServerRootUrl() Returns the root URL of the server that is running this web applications.
ServletContext	getServletContext() Returns the ServletContext of this web application.
Site	getSite() Retrieves the site in which this element is declared.
String	getSourceName() Retrieves the source implementation name of this element.
String	getSubmission() Retrieves the name of the submission that was sent to this element
<BeanType> BeanType	getSubmissionBean(Class<BeanType> beanClass) Retrieves an instance of a submission bean and populates the properties with the parameter values.
<BeanType> BeanType	getSubmissionBean(Class<BeanType> beanClass, String prefix) Retrieves an instance of a submission bean and populates the properties with the parameter values, taking the provided prefix into account.
<BeanType> BeanType	getSubmissionBean(String submissionName, Class<BeanType> beanClass) Retrieves an instance of a submission bean and populates the properties with the parameter values.
<BeanType> BeanType	getSubmissionBean(String submissionName, Class<BeanType> beanClass, String prefix) Retrieves an instance of a submission bean and populates the properties with the parameter values, taking the provided prefix into account.
CharSequence	getSubmissionFormParameters(String name) Generates the hidden XHTML form parameters for a submission.
CharSequence	getSubmissionFormParameters(String name, String[] parameterValues) Generates the hidden XHTML form parameters for a submission and overrides the current output values only for this method.
CharSequence	getSubmissionFormParametersJavascript(String name, String[] parameterValues) Generates Javascript that will generate hidden XHTML form parameters for a submission and overrides the current output values only for this method.
CharSequence	getSubmissionFormUrl() Generates a form action URL for a submission.
CharSequence	getSubmissionFormUrl(String pathinfo) Generates a form action URL for a submission and appends a pathinfo to the URL of the element.
CharSequence	getSubmissionQueryUrl(String name) Generates a query URL for a submission.
CharSequence	getSubmissionQueryUrl(String name, String pathinfo) Generates a query URL for a submission and appends a pathinfo to the URL of the element.
CharSequence	getSubmissionQueryUrl(String name, String[] parameterValues) Generates a query URL for a submission with default parameter values.
CharSequence	getSubmissionQueryUrl(String name, String pathinfo, String[] parameterValues) Generates a query URL for a submission and appends a pathinfo to the URL of the element, default parameter values can also be added.
ElementInfo	getTarget() Retrieves the information of the target element of the active request.
Template	getTxtTemplate() Creates a new template instance of the enginetxt type, using the current element's absolute ID as the template name.
Template	getTxtTemplate(String name) Creates a new template instance of the enginetxt type.
Template	getTxtTemplate(String name, String encoding) Creates a new template instance of the enginetxt type.
Template	getTxtTemplate(String name, String encoding, TemplateTransformer transformer) Creates a new template instance of the enginetxt type.
Template	getTxtTemplate(String name, TemplateTransformer transformer) Creates a new template instance of the enginetxt type.
UploadedFile	getUploadedFile(String name) Retrieves an uploaded file.
ArrayList<String>	getUploadedFileNames() Retrieves the list of uploaded file names.
ArrayList<String>	getUploadedFileNames(String regexp) Retrieves the names of all the files that are present and that match a regular expression.
UploadedFile[]	getUploadedFiles(String name) Retrieves all files that have been uploaded for a particular name.
String	getWebappRootUrl() Returns the root URL of this web applications.
Template	getXhtmlTemplate() Creates a new template instance of the enginexhtml type, using the current element's absolute ID as the template name.
Template	getXhtmlTemplate(String name) Creates a new template instance of the enginexhtml type.
Template	getXhtmlTemplate(String name, String encoding) Creates a new template instance of the enginexhtml type.
Template	getXhtmlTemplate(String name, String encoding, TemplateTransformer transformer) Creates a new template instance of the enginexhtml type.
Template	getXhtmlTemplate(String name, TemplateTransformer transformer) Creates a new template instance of the enginexhtml type.
Template	getXmlTemplate() Creates a new template instance of the enginexml type, using the current element's absolute ID as the template name.
Template	getXmlTemplate(String name) Creates a new template instance of the enginexml type.
Template	getXmlTemplate(String name, String encoding) Creates a new template instance of the enginexml type.
Template	getXmlTemplate(String name, String encoding, TemplateTransformer transformer) Creates a new template instance of the enginexml type.
Template	getXmlTemplate(String name, TemplateTransformer transformer) Creates a new template instance of the enginexml type.
boolean	hasCookie(String name) Checks whether a cookie is present.
boolean	hasEmbedData() Indicates whether data was passed on during the processing of this embedded element.
boolean	hasEmbedValue() Indicates whether the embedded element's template value has content.
boolean	hasInputValue(String name) Checks whether a value has been provided to an input.
boolean	hasParameterValue(String name) Checks whether a value has been provided to an parameter.
boolean	hasProperty(String name) Indicates whether this element has a certain injected named property.
boolean	hasRequestAttribute(String name) Checks if a request attribute exists.
boolean	hasSubmission() Indicates whether this element received a submission.
boolean	hasSubmission(String submissionName) Indicates whether this element received a certain submission.
boolean	hasUploadedFile(String name) Checks if a particular file has been uploaded during the last submission.
void	initialize() Initializes the element, this method should never be called explicitly.
boolean	isEmbedded() Indicates whether this element is running embedded inside another element's template.
boolean	isFileEmpty(String name) Checks if an uploaded file wasn't sent or if it is empty.
boolean	isInputEmpty(String name) Checks whether an input has no value or whether the value is empty.
boolean	isParameterEmpty(String name) Checks whether a parameter is empty.
boolean	isPropertyEmpty(String name) Checks if a property is not available or if the string presentation is empty.
boolean	isSecure() Returns a boolean indicating whether this request was made using a secure channel, such as HTTPS.
boolean	isTextBufferEnabled() Indicates whether the response text buffer is enabled or disabled.
void	pause() Pauses the execution of the element and creates a new continuation.
void	preventCaching() Sets up the current request to prevent all caching of the response by the client.
void	print(Object value) Prints the string representation of an object to the request text output.
void	print(Template template) Prints the content of a template to the request text output.
void	processEmbeddedElement(Template template, String elementId) Processes an embedded element without a differentiator in a template.
void	processEmbeddedElement(Template template, String elementId, Object data) Processes an embedded element without a differentiator in a template and pass on data to the processed embedded element.
void	processEmbeddedElement(Template template, String elementId, String differentiator) Processes an embedded element with a differentiator in a template.
void	processEmbeddedElement(Template template, String elementId, String differentiator, Object data) Processes an embedded element with a differentiator in a template and pass on data to the processed embedded element.
List<String>	processTemplate(Template template) Processes a template in the active element context.
boolean	prohibitRawAccess() Indicates whether the access to raw servlet API methods is allowed.
void	redirect(String url) Interrupts the execution in this element and redirects the client to another URL.
void	removeForm(Template template, Class beanClass) Removes a generated form, leaving the builder value tags empty again as if this form never had been generated.
void	removeForm(Template template, Class beanClass, String prefix) Removes a generated form, leaving the builder value tags empty again as if this form never had been generated.
void	removeRequestAttribute(String name) Removes an attribute from this request.
Collection<String>	selectInputParameter(Template template, String name, String[] values) Sets a select box option, a radio button or a checkbox to selected or checked according to input values.
Collection<String>	selectParameter(Template template, String name, String[] values) Sets a select box option, a radio button or a checkbox to selected or checked.
Collection	selectSubmissionParameter(Template template, String name, String value) Sets a select box option, a radio button or a checkbox to selected or checked according to a submission parameter value.
Collection<String>	selectSubmissionParameter(Template template, String name, String[] values) Sets a select box option, a radio button or a checkbox to selected or checked according to submission parameter values.
void	sendError(int statusCode) Sends an error response to the client using the specified status code and clearing the buffer.
void	sendError(int statusCode, String message) Sends an error response to the client using the specified status.
void	sendRedirect(String location) Sends a temporary redirect response to the client using the specified redirect location URL.
void	setChildTrigger(ElementChildTrigger childTrigger) Sets the ElementChildTrigger class that will be used to child trigger is executed.
void	setCloneContinuations(boolean clone) Changes the engine's behavior when new continuation steps are created.
void	setContentLength(int length) Sets the length of the content body in the response In HTTP servlets, this method sets the HTTP Content-Length header.
void	setContentType(String type) Sets the content type of the response being sent to the client, if the response has not been committed yet.
void	setCookie(Cookie cookie) Sets a cookie which will be sent to the browser.
void	setDateHeader(String name, long date) Sets a response header with the given name and date-value.
void	setDeploymentClass(Class<? extends ElementDeployer> klass) Set the ElementDeployer class that will be used for deployment.
void	setElementContext(ElementContext elementContext)
void	setExitForm(Template template, String name) Generates a form action URL for an exit and sets it as the content of a template value.
void	setExitForm(Template template, String name, String pathinfo) Generates a form action URL for an exit with a pathinfo and sets it as the content of a template value.
void	setExitForm(Template template, String name, String[] outputValues) Generates a form action URL for an exit with overridden outputs and sets it as the content of a template value.
void	setExitForm(Template template, String name, String pathinfo, String[] outputValues) Generates a form action URL for an exit with a pathinfo and overridden outputs and sets it as the content of a template value.
void	setExitQuery(Template template, String name) Generates a query URL for an exit and sets it as the content of a template value.
void	setExitQuery(Template template, String name, String pathinfo) Generates a query URL with a pathinfo for an exit and sets it as the content of a template value.
void	setExitQuery(Template template, String name, String[] outputValues) Generates a query URL for an exit with overridden outputs and sets it as the content of a template value.
void	setExitQuery(Template template, String name, String pathinfo, String[] outputValues) Generates a query URL for an exit with a pathinfo and overridden outputs and sets it as the content of a template value.
void	setHeader(String name, String value) Sets a response header with the given name and value.
void	setInitializer(ElementInitializer initializer) Sets the ElementInitializer class that will be used to initialize the element.
void	setIntHeader(String name, int value) Sets a response header with the given name and integer value.
void	setNamedOutputBean(String name, Object bean) Sets an instance of a named output bean and populates the output values from the property values.
void	setOutput(String name, boolean value) Sets the value of an output from a boolean.
void	setOutput(String name, char value) Sets the value of an output from a char.
void	setOutput(String name, char[] value) Set the value of an output from an array of chars that will be concatenated to a String.
void	setOutput(String name, double value) Sets the value of an output from a double.
void	setOutput(String name, float value) Sets the value of an output from a float.
void	setOutput(String name, int value) Sets the value of an output from an int.
void	setOutput(String name, long value) Sets the value of an output from a long.
void	setOutput(String name, Object value) Sets the value of an output from a generic object.
void	setOutput(String name, String value) Sets the value of an output.
void	setOutput(String name, String[] values) Set the values of an output.
void	setOutputBean(Object bean) Sets an instance of a named input bean and populates the output values from the property values.
void	setOutputBean(Object bean, String prefix) Sets an instance of a named input bean and populates the output values from the property values.
void	setProhibitRawAccess(boolean access) Changes the access permissions to raw servlet API methods.
void	setRequestAttribute(String name, Object object) Stores an attribute in this request.
void	setResponseLocale(Locale locale) Sets the locale of the response, if the response has not been committed yet.
void	setStatus(int statusCode) Sets the status code for this response.
void	setSubmissionBean(Template template, Object beanInstance) Sets the content of all values that correspond to bean property names to the data of the bean properties.
void	setSubmissionBean(Template template, Object beanInstance, boolean encode) Sets the content of all values that correspond to bean property names to the data of the bean properties.
void	setSubmissionForm(Template template, String name) Generates a form action URL for an submission and sets it as the content of a template value.
void	setSubmissionForm(Template template, String name, String pathinfo) Generates a form action URL for an submission with a pathinfo and sets it as the content of a template value.
void	setSubmissionForm(Template template, String name, String[] parameterValues) Generates a form action URL for an submission with default parameter values and sets it as the content of a template value.
void	setSubmissionForm(Template template, String name, String pathinfo, String[] parameterValues) Generates a form action URL for an submission with a pathinfo and default parameter values and sets it as the content of a template value.
void	setSubmissionQuery(Template template, String name) Generates a query URL for a submission sets it as the content of a template value.
void	setSubmissionQuery(Template template, String name, String pathinfo) Generates a query URL for a submission with a pathinfo and sets it as the content of a template value.
void	setSubmissionQuery(Template template, String name, String[] parameterValues) Generates a query URL for a submission with default parameter values and sets it as the content of a template value.
void	setSubmissionQuery(Template template, String name, String pathinfo, String[] parameterValues) Generates a query URL for a submission with pathinfo and default parameter values and sets it as the content of a template value.
void	stepBack() Steps back to the start of the previous continuation.

Methods inherited from class java.lang.Object

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

Constructor Detail

ElementSupport

protected ElementSupport()

Method Detail

setInitializer

public void setInitializer(ElementInitializer initializer)

Sets the ElementInitializer class that will be used to initialize the element.

Customizing the initialization can also simply be done by overloading the initialize() method if the element extends the Element class.

Parameters:

initializer - the initializer

Since:

1.0

See Also:

initialize(), ElementInitializer

initialize

public void initialize()

Initializes the element, this method should never be called explicitly.

The initialization happens in a fully setup context and is the first method that will be called by the engine.

The default implementation executes the ElementInitializer that has been registered with setInitializer(com.uwyn.rife.engine.ElementInitializer).

Since:

1.0

See Also:

setInitializer(ElementInitializer)

setChildTrigger

public void setChildTrigger(ElementChildTrigger childTrigger)

Sets the ElementChildTrigger class that will be used to child trigger is executed.

Customizing the child trigger can also simply be done by overloading the childTriggered() method if the element extends the Element class.

Parameters:

childTrigger - the child trigger

Since:

1.0

See Also:

childTriggered(String, String[]), ElementChildTrigger

childTriggered

public boolean childTriggered(String name,
                              String[] values)

Called by the engine when a child trigger occurs, this method should never be called explicitly.

The default implementation executes the ElementChildTrigger that has been registered with setChildTrigger(com.uwyn.rife.engine.ElementChildTrigger).

Parameters:

name - the name of the variable that initiated the child trigger

values - the values of the variable that initiated the child trigger

Returns:

true if the execution should be interrupted and step down the inheritance stack (ie. when the activation of the child has been triggered); or

false if the execution should just continue

Since:

1.0

See Also:

setChildTrigger(ElementChildTrigger)

setDeploymentClass

public void setDeploymentClass(Class<? extends ElementDeployer> klass)

Set the ElementDeployer class that will be used for deployment.

An instance of this class will be created when the element is deployed within a site. The instance's ElementDeployer.deploy() method will be called. This is handy if you need to setup element-specific resources for all its instances.

Customizing the element deployer can also simply be done by overloading the getDeploymentClass() method if the element extends the Element class.

Parameters:

klass - the ElementDeployer that will be used to deploy the element

Since:

1.0

See Also:

ElementDeployer.deploy(), getDeploymentClass(), getDeployer()

getDeploymentClass

public Class getDeploymentClass()

Retrieves the class that will be used for the deployment of the element.

Returns:

an instance of ElementDeployer; or

null if no deployment class is used

Since:

1.0

See Also:

setDeploymentClass(Class), getDeployer()

setProhibitRawAccess

public void setProhibitRawAccess(boolean access)

Changes the access permissions to raw servlet API methods.

By default, RIFE shields you away from raw access to the servlet API and controls all incoming and outgoing data. This makes it possible to offer the advanced engine features.

Sometimes it's useful however to still be able to access the raw servlet API features, for instance when integrating other libraries. The fact that a method needs to be called before being able to do so makes it easy to identify which elements are outside of the controlled context of the RIFE application.

Parameters:

access - true if the raw servlet API access is prohibited; or

false if it is allowed

Since:

1.0

See Also:

prohibitRawAccess()

prohibitRawAccess

public boolean prohibitRawAccess()

Indicates whether the access to raw servlet API methods is allowed.

Instead of using the setProhibitRawAccess(boolean) method, one can also overload this method to allow raw access. By default, raw access is forbidden.

Returns:

true if the raw servlet API access is prohibited; or

false if it is allowed

Since:

1.0

See Also:

setProhibitRawAccess(boolean)

setCloneContinuations

public void setCloneContinuations(boolean clone)

Changes the engine's behavior when new continuation steps are created.

By default, the active continuation is cloned when a new step needs to be created. This makes it possible to use the browser's back button and start a new continuation trail. Each previous step thus keeps it associated state. By disabling the cloning, performance will increase and memory usage will decrease since the active continuation will simply be migrated to the new continuation step. Note that none of the previous steps will be usable anymore though.

Parameters:

clone - true to make the engine clone continuations; or

false to disable the cloning

Since:

1.0

See Also:

cloneContinuations()

cloneContinuations

public boolean cloneContinuations()

Indicates whether continuations are cloned at each step.

Instead of using the setCloneContinuations(boolean) method, one can also overload this method to configure the cloning. By default, cloning is active.

Returns:

true to make the engine clone continuations; or

false to disable the cloning

Since:

1.0

See Also:

(boolean)

pause

public final void pause()

Pauses the execution of the element and creates a new continuation.

The next request will resume exactly at the same location with a completely restored call stack and variable stack.

Since:

1.0

stepBack

public final void stepBack()

Steps back to the start of the previous continuation.

If there is no previous continuation, the element will be executed from the beginning again.

Since:

1.5

See Also:

duringStepBack()

duringStepBack

public boolean duringStepBack()

Indicates whether the current element execution is a step back.

Returns:

true if a step back occurred in this request; or

false otherwise

Since:

1.5

See Also:

stepBack()

call

public final Object call(String exit)

Pauses the execution of the element and creates a new continuation. The execution will immediately continue in the element that is the target of the called exit.

As soon as the called element returns or executes answer(), the execution will resume in the calling element with a completely restored call stack and variable stack.

Parameters:

exit - the name of the exit whose target element will be called

Returns:

the object that was provided through the answer(Object) method in the called element; or

null if no answer was provided

Since:

1.0

See Also:

answer(), answer(Object)

answer

public final void answer()
                  throws EngineException

Resumes the execution in the calling element by providing no answer object.

The execution in the active element will be interrupted immediately and the call continuation will be resumed exactly where is was paused before.

Throws:

EngineException - a runtime exception that is used to immediately interrupt the execution, don't catch this exception

Since:

1.0

See Also:

call(String), answer(Object)

answer

public final void answer(Object answer)
                  throws EngineException

Resumes the execution in the calling element by providing an answer.

The execution in the active element will be interrupted immediately and the call continuation will be resumed exactly where is was paused before.

Parameters:

answer - the object that will be answered to the calling element

Throws:

EngineException - a runtime exception that is used to immediately interrupt the execution, don't catch this exception

Since:

1.0

See Also:

call(String), answer()

getHtmlTemplate

public Template getHtmlTemplate()
                         throws TemplateException,
                                EngineException

Creates a new template instance of the enginehtml type, using the current element's absolute ID as the template name.

If the element is an arrival, the absolute ID of the real element it points to will be used.

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.3

See Also:

getHtmlTemplate(String), getHtmlTemplate(String, TemplateTransformer), getHtmlTemplate(String, String), getHtmlTemplate(String, String, TemplateTransformer)

getHtmlTemplate

public Template getHtmlTemplate(String name)
                         throws TemplateException,
                                EngineException

Creates a new template instance of the enginehtml type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getHtmlTemplate(), getHtmlTemplate(String, TemplateTransformer), getHtmlTemplate(String, String), getHtmlTemplate(String, String, TemplateTransformer)

getHtmlTemplate

public Template getHtmlTemplate(String name,
                                TemplateTransformer transformer)
                         throws TemplateException,
                                EngineException

Creates a new template instance of the enginehtml type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

transformer - the template transformer that will be used to modify the template's source before it's parsed

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getHtmlTemplate(), getHtmlTemplate(String), getHtmlTemplate(String, String), getHtmlTemplate(String, String, TemplateTransformer)

getHtmlTemplate

public Template getHtmlTemplate(String name,
                                String encoding)
                         throws TemplateException,
                                EngineException

Creates a new template instance of the enginehtml type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

encoding - the encoding of the template's source

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getHtmlTemplate(), getHtmlTemplate(String), getHtmlTemplate(String, TemplateTransformer), getHtmlTemplate(String, String, TemplateTransformer)

getHtmlTemplate

public Template getHtmlTemplate(String name,
                                String encoding,
                                TemplateTransformer transformer)
                         throws TemplateException,
                                EngineException

Creates a new template instance of the enginehtml type.

The special engine template types contain additional block and value filters to offer the following features:

• embedded elements
  (eg.: <!--V 'ELEMENT:my.elementid'/-->)
• role user context for scripted block assignment to values
  (eg.: <!--V 'OGNL:ROLEUSER:rolecheck'-->User is not in role "admin"<!--/V-->
<!--B 'OGNL:ROLEUSER:rolecheck:[[ isInRole("admin") ]]'-->User is in role "admin"<!--/B-->)

Non-engine versions of the same template types are not able to provide these functionalities.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

encoding - the encoding of the template's source

transformer - the template transformer that will be used to modify the template's source before it's parsed

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getHtmlTemplate(), getHtmlTemplate(String), getHtmlTemplate(String, TemplateTransformer), getHtmlTemplate(String, String)

getXhtmlTemplate

public Template getXhtmlTemplate()
                          throws TemplateException,
                                 EngineException

Creates a new template instance of the enginexhtml type, using the current element's absolute ID as the template name.

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.3

See Also:

getXhtmlTemplate(String), getXhtmlTemplate(String, TemplateTransformer), getXhtmlTemplate(String, String), getXhtmlTemplate(String, String, TemplateTransformer)

getXhtmlTemplate

public Template getXhtmlTemplate(String name)
                          throws TemplateException,
                                 EngineException

Creates a new template instance of the enginexhtml type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getXhtmlTemplate(), getXhtmlTemplate(String, TemplateTransformer), getXhtmlTemplate(String, String), getXhtmlTemplate(String, String, TemplateTransformer)

getXhtmlTemplate

public Template getXhtmlTemplate(String name,
                                 TemplateTransformer transformer)
                          throws TemplateException,
                                 EngineException

Creates a new template instance of the enginexhtml type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

transformer - the template transformer that will be used to modify the template's source before it's parsed

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getXhtmlTemplate(), getXhtmlTemplate(String), getXhtmlTemplate(String, String), getXhtmlTemplate(String, String, TemplateTransformer)

getXhtmlTemplate

public Template getXhtmlTemplate(String name,
                                 String encoding)
                          throws TemplateException,
                                 EngineException

Creates a new template instance of the enginexhtml type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

encoding - the encoding of the template's source

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getXhtmlTemplate(), getXhtmlTemplate(String), getXhtmlTemplate(String, TemplateTransformer), getXhtmlTemplate(String, String, TemplateTransformer)

getXhtmlTemplate

public Template getXhtmlTemplate(String name,
                                 String encoding,
                                 TemplateTransformer transformer)
                          throws TemplateException,
                                 EngineException

Creates a new template instance of the enginexhtml type.

The special engine template types contain additional block and value filters to offer the following features:

• embedded elements
  (eg.: <!--V 'ELEMENT:my.elementid'/-->)
• role user context for scripted block assignment to values
  (eg.: <!--V 'OGNL:ROLEUSER:rolecheck'-->User is not in role "admin"<!--/V-->
<!--B 'OGNL:ROLEUSER:rolecheck:[[ isInRole("admin") ]]'-->User is in role "admin"<!--/B-->)

Non-engine versions of the same template types are not able to provide these functionalities.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

encoding - the encoding of the template's source

transformer - the template transformer that will be used to modify the template's source before it's parsed

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getXhtmlTemplate(), getXhtmlTemplate(String), getXhtmlTemplate(String, TemplateTransformer), getXhtmlTemplate(String, String)

getXmlTemplate

public Template getXmlTemplate()
                        throws TemplateException,
                               EngineException

Creates a new template instance of the enginexml type, using the current element's absolute ID as the template name.

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.3

See Also:

getXmlTemplate(String), getXmlTemplate(String, TemplateTransformer), getXmlTemplate(String, String), getXmlTemplate(String, String, TemplateTransformer)

getXmlTemplate

public Template getXmlTemplate(String name)
                        throws TemplateException,
                               EngineException

Creates a new template instance of the enginexml type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getXmlTemplate(), getXmlTemplate(String, TemplateTransformer), getXmlTemplate(String, String), getXmlTemplate(String, String, TemplateTransformer)

getXmlTemplate

public Template getXmlTemplate(String name,
                               TemplateTransformer transformer)
                        throws TemplateException,
                               EngineException

Creates a new template instance of the enginexml type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

transformer - the template transformer that will be used to modify the template's source before it's parsed

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getXmlTemplate(String), getXmlTemplate(String), getXmlTemplate(String, String), getXmlTemplate(String, String, TemplateTransformer)

getXmlTemplate

public Template getXmlTemplate(String name,
                               String encoding)
                        throws TemplateException,
                               EngineException

Creates a new template instance of the enginexml type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

encoding - the encoding of the template's source

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getXmlTemplate(String), getXmlTemplate(String), getXmlTemplate(String, TemplateTransformer), getXmlTemplate(String, String, TemplateTransformer)

getXmlTemplate

public Template getXmlTemplate(String name,
                               String encoding,
                               TemplateTransformer transformer)
                        throws TemplateException,
                               EngineException

Creates a new template instance of the enginexml type.

The special engine template types contain additional block and value filters to offer the following features:

• embedded elements
  (eg.: <!--V 'ELEMENT:my.elementid'/-->)
• role user context for scripted block assignment to values
  (eg.: <!--V 'OGNL:ROLEUSER:rolecheck'-->User is not in role "admin"<!--/V-->
<!--B 'OGNL:ROLEUSER:rolecheck:[[ isInRole("admin") ]]'-->User is in role "admin"<!--/B-->)

Non-engine versions of the same template types are not able to provide these functionalities.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

encoding - the encoding of the template's source

transformer - the template transformer that will be used to modify the template's source before it's parsed

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getXmlTemplate(String), getXmlTemplate(String), getXmlTemplate(String, TemplateTransformer), getXmlTemplate(String, String)

getTxtTemplate

public Template getTxtTemplate()
                        throws TemplateException,
                               EngineException

Creates a new template instance of the enginetxt type, using the current element's absolute ID as the template name.

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.3

See Also:

getTxtTemplate(String), getTxtTemplate(String, TemplateTransformer), getTxtTemplate(String, String), getTxtTemplate(String, String, TemplateTransformer)

getTxtTemplate

public Template getTxtTemplate(String name)
                        throws TemplateException,
                               EngineException

Creates a new template instance of the enginetxt type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getTxtTemplate(), getTxtTemplate(String, TemplateTransformer), getTxtTemplate(String, String), getTxtTemplate(String, String, TemplateTransformer)

getTxtTemplate

public Template getTxtTemplate(String name,
                               TemplateTransformer transformer)
                        throws TemplateException,
                               EngineException

Creates a new template instance of the enginetxt type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

transformer - the template transformer that will be used to modify the template's source before it's parsed

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getTxtTemplate(), getTxtTemplate(String), getTxtTemplate(String, String), getTxtTemplate(String, String, TemplateTransformer)

getTxtTemplate

public Template getTxtTemplate(String name,
                               String encoding)
                        throws TemplateException,
                               EngineException

Creates a new template instance of the enginetxt type.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

encoding - the encoding of the template's source

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getTxtTemplate(), getTxtTemplate(String), getTxtTemplate(String, TemplateTransformer), getTxtTemplate(String, String, TemplateTransformer)

getTxtTemplate

public Template getTxtTemplate(String name,
                               String encoding,
                               TemplateTransformer transformer)
                        throws TemplateException,
                               EngineException

Creates a new template instance of the enginetxt type.

The special engine template types contain additional block and value filters to offer the following features:

• embedded elements
  (eg.: [!V 'ELEMENT:my.elementid'/])
• role user context for scripted block assignment to values
  (eg.: [!V 'OGNL:ROLEUSER:rolecheck']User is not in role "admin"[!/V]
[!B 'OGNL:ROLEUSER:rolecheck:[[ isInRole("admin") ]]']User is in role "admin"[!/B])

Non-engine versions of the same template types are not able to provide these functionalities.

Parameters:

name - the name of the template. Note that this follows the Java naming conventions for classes and packages. Directories correspond to package names and file separators correspond to dots. Any non-valid class name character will be replaced by an underscore.

encoding - the encoding of the template's source

transformer - the template transformer that will be used to modify the template's source before it's parsed

Returns:

a new instance of the template

Throws:

TemplateException - if an error occurred during the retrieval, parsing or compilation of the template

EngineException - if an error occurs during the initialization of the template in the element context; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getTxtTemplate(), getTxtTemplate(String), getTxtTemplate(String, TemplateTransformer), getTxtTemplate(String, String)

encodeHtml

public String encodeHtml(String source)

Transforms a provided String object into a new string, containing only valid HTML characters.

Parameters:

source - The string that has to be transformed into a valid HTML string.

Returns:

The encoded String object.

Since:

1.0

See Also:

encodeXml(String)

encodeXml

public String encodeXml(String source)

Transforms a provided String object into a new string, containing only valid XML characters.

Parameters:

source - The string that has to be transformed into a valid XML string.

Returns:

The encoded String object.

Since:

1.0

See Also:

encodeHtml(String)

enableTextBuffer

public void enableTextBuffer(boolean enabled)
                      throws EngineException

Enables or disables the response text buffer. By default, it is enabled.

Disabling an enabled text buffer, flushes the already buffered content first.

If the text buffer is disabled, text content will be send immediately to the client, this can decrease performance. Unless you need to stream content in real time, it's best to leave the text buffer enabled. It will be flushed and sent in one go at the end of the request.

Exits that cancel embedding rely on the fact that the text buffer is active to be able to discard the partial content of the embedding element.

Parameters:

enabled - true to enable the text buffer; or

false to disable it

Throws:

EngineException - if an error occurred during the modification of the text buffer presence; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

isTextBufferEnabled(), flush(), clearBuffer()

isTextBufferEnabled

public boolean isTextBufferEnabled()
                            throws EngineException

Indicates whether the response text buffer is enabled or disabled.

Returns:

true if the text buffer is enabled; or

false if it is disabled

Throws:

EngineException - if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

enableTextBuffer(boolean), flush(), clearBuffer()

print

public void print(Template template)
           throws TemplateException,
                  EngineException

Prints the content of a template to the request text output. The template is first processed in the active element context by the processTemplate(Template) method.

Parameters:

template - the template that will be printed

Throws:

TemplateException - if an error occurs during the retrieval of the template content

EngineException - if an error occurs during the output of the template content; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

print(Object), processTemplate(Template)

processTemplate

public List<String> processTemplate(Template template)
                             throws TemplateException,
                                    EngineException

Processes a template in the active element context.

This performs the following value replacements if they haven't already been set.

Each template type can have a value encoder attached to it (for instance a HTML encoder to replace non-ascii characters with the appropriate entities). All variable content that is handled in this method will be encoded before being set in the template.

OGNL:ROLEUSER:valueid GROOVY:ROLEUSER:valueid JANINO:ROLEUSER:valueid	These scripted block value tags will be processed according to the active element context. For example: <!--V 'OGNL:ROLEUSER:rolecheck'-->User is no admin<!--/V--> <!--B 'OGNL:ROLEUSER:rolecheck:[[ isInRole("admin") ]]'-->User is admin<!--/B--> Will display 'User is admin' if the user has the admin role, and otherwise 'User is no admin'.
EXIT:QUERY:exitname	Will be replaced with the URL that links to the target of the named exit. The state will be carried around according to the currently set outputs.
EXIT:FORM:exitname	Will be replaced with the URL that links to the target of the named exit. No state information will be added to the URL. The EXIT:PARAMS value tag should be put at the location where hidden form parameters are allowed.
EXIT:PARAMS:exitname	Will be replaced by the hidden form parameters that are need to carry the state around according to the currently set outputs. This tag goes hand-in-hand with the EXIT:FORM tag.
SUBMISSION:QUERY:submissionname	Will be replaced with the URL that sends the named submission to currently the active element. The state will be carried around according to the currently set inputs.
SUBMISSION:FORM:submissionname	Will be replaced with the URL that sends the named submission to currently the active element. No state information will be added to the URL. The SUBMISSION:PARAMS value tag should be put at the location where hidden form parameters are allowed.
SUBMISSION:PARAMS:submissionname	Will be replaced by the hidden form parameters that are need to carry the state around according to the currently set inputs. This tag goes hand-in-hand with the SUBMISSION:FORM tag.
PARAM:name	Will be replaced with the encoded content of the named submission parameter.
INPUT:name	Will be replaced with the encoded content of the named input.
OUTPUT:name	Will be replaced with the encoded content of the named output.
INCOOKIE:name	Will be replaced with the encoded content of the named incookie.
OUTCOOKIE:nam	Will be replaced with the encoded content of the named outcookie.
WEBAPP:ROOTURL	Will be replaced with the absolute root URL of the web application. This is typically used in a <base href=""> tag. All URLs can then be relative according to this root URL and the application can be used anywhere and with any web application name.
automated form building for submission beans	see FormBuilder

Parameters:

template - the template instance that needs to be processed

Returns:

a list with the ids of all the template values that have been set

Throws:

TemplateException - if an error occurs during the manipulation of the template

EngineException - if an error occurs during the retrieval of the values from the current element context, or during the output of the template content; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

print

public void print(Object value)
           throws EngineException

Prints the string representation of an object to the request text output. The string representation will be created through a String.valueOf(value) call.

Parameters:

value - the object that will be output

Throws:

EngineException - if an error occurs during the output of the content; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

getOutputStream

public OutputStream getOutputStream()
                             throws EngineException

Retrieves an output stream to send binary data through the response.

Note that the text output is written to the same output stream. Of course, when the text buffer is active this only happen at the end of the request.

Returns:

an instance of the response output stream

Throws:

EngineException - if an error occurs during the creation of the output stream; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

clearBuffer

public void clearBuffer()
                 throws EngineException

Clears the request text output buffer, all buffered text will be discarded.

If no text buffer is active, this method doesn't do anything.

Throws:

EngineException - if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

isTextBufferEnabled(), enableTextBuffer(boolean), flush()

flush

public void flush()
           throws EngineException

Flushes the request text output buffer and the request output stream. This sends any buffered data immediately to the client.

All text in the active buffer will be sent to the client and the buffer will be empty again, if no text buffer is enabled only the output stream will be flushed.

Throws:

EngineException - if an error occurs during the output of the content; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

isTextBufferEnabled(), enableTextBuffer(boolean), clearBuffer()

getSite

public Site getSite()
             throws EngineException

Retrieves the site in which this element is declared.

Returns:

a site instance

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

getDeployer

public ElementDeployer getDeployer()
                            throws EngineException

Retrieves the deployer of this element.

Returns:

the instance of the deployer that was used to deploy the element; or

null if no deployment class has been declared

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getDeploymentClass(), setDeploymentClass(Class)

getElementInfo

public ElementInfo getElementInfo()
                           throws EngineException

Retrieves the declaration information of this element.

Returns:

the declaration information of this element

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

getSourceName

public String getSourceName()
                     throws EngineException

Retrieves the source implementation name of this element.

Returns:

the source implementation name

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

getDeclarationName

public String getDeclarationName()
                          throws EngineException

Retrieves the declaration name of this element.

Returns:

the declaration name

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

getTarget

public ElementInfo getTarget()
                      throws EngineException

Retrieves the information of the target element of the active request.

This can be different from the current element due to precedence, behavioural inheritance, child triggers, element embedding, ...

Returns:

the request's target element information

Throws:

EngineException - if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

getEmbeddingElement

public ElementSupport getEmbeddingElement()
                                   throws EngineException

Retrieves the element that is embedding the current element.

Returns:

the embedding element; or

null if this element is not embedded

Throws:

EngineException - if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getEmbeddingTemplate(), getEmbedDifferentiator(), hasEmbedValue(), getEmbedValue(), hasEmbedData(), getEmbedData(), getEmbedProperties(), isEmbedded()

getEmbeddingTemplate

public Template getEmbeddingTemplate()
                              throws EngineException

Retrieves the template that is embedding the current element.

Returns:

the embedding template; or

null if this element is not embedded

Throws:

EngineException - if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getEmbeddingElement(), getEmbedDifferentiator(), hasEmbedValue(), getEmbedValue(), hasEmbedData(), getEmbedData(), getEmbedProperties(), isEmbedded()

getEmbedDifferentiator

public String getEmbedDifferentiator()
                              throws EngineException

Retrieves the differentiator that was used to set this embedded element apart.

Returns:

this embedded element's differentiator; or

null if this embedded element didn't have a differentiator

Throws:

EngineException - if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getEmbeddingTemplate(), getEmbeddingElement(), hasEmbedValue(), getEmbedValue(), hasEmbedData(), getEmbedData(), getEmbedProperties(), isEmbedded()

hasEmbedValue

public boolean hasEmbedValue()
                      throws EngineException

Indicates whether the embedded element's template value has content.

Returns:

true if the value has content; or

false otherwise

Throws:

EngineException - if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getEmbeddingTemplate(), getEmbeddingElement(), getEmbedDifferentiator(), getEmbedValue(), hasEmbedData(), getEmbedData(), getEmbedProperties(), isEmbedded()

getEmbedValue

public String getEmbedValue()
                     throws EngineException

Retrieves the current content of the value tag of this embedded element.

For example:

<!--V 'ELEMENT:my.element'-->this is the embed value<!--/V-->

Will return:

this is the embed value

Note that when you have several embedded elements in the same template with the same element id, you have to use embedded element differentiators if you want to provide different embed values. For example:

<!--V 'ELEMENT:my.element:differentiator1'-->this is the first embed value<!--/V-->
<!--V 'ELEMENT:my.element:differentiator2'-->this is the second embed value<!--/V-->

Returns:

the value from the embedded template; or

null if no default value was provided or if the current element is not embedded

Throws:

EngineException - if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getEmbeddingTemplate(), getEmbeddingElement(), getEmbedDifferentiator(), hasEmbedValue(), getEmbedData(), hasEmbedData(), getEmbedProperties(), isEmbedded()

hasEmbedData

public boolean hasEmbedData()
                     throws EngineException

Indicates whether data was passed on during the processing of this embedded element.

Returns:

true if data was passed on; or

false otherwise

Throws:

EngineException - if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getEmbeddingTemplate(), getEmbeddingElement(), getEmbedDifferentiator(), hasEmbedValue(), getEmbedValue(), getEmbedData(), getEmbedProperties(), isEmbedded()

getEmbedData

public Object getEmbedData()
                    throws EngineException

Retrieves the data that was passed on for the processing of this embedded element.

Returns:

the value from the embedded template; or

null if no data was provided or if the current element is not embedded

Throws:

EngineException - if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.5

See Also:

getEmbeddingTemplate(), getEmbeddingElement(), getEmbedDifferentiator(), getEmbedValue(), hasEmbedValue(), hasEmbedData(), getEmbedProperties(), isEmbedded()

getEmbedProperties

public Properties getEmbedProperties()
                              throws EngineException

Retrieves the embed value as a property list (see getEmbedValue() for more information about embed values).

The content of the embed value will be parsed as a property list according to the format described in Properties.load(java.io.InputStream).

For instance:

<!--V 'ELEMENT:my.element'-->
key1 = value1
key2 = value1
<!--/V-->

Will return a property list where the key 'key1' is associated to 'value1' and 'key2' to 'value2'.

Returns:

the embed value parsed as a property list; or

null if no default value was provided, if the current element is not embedded

Throws:

EngineException - if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getEmbeddingTemplate(), getEmbeddingElement(), getEmbedDifferentiator(), hasEmbedValue(), getEmbedValue(), hasEmbedData(), isEmbedded()

isEmbedded

public boolean isEmbedded()
                   throws EngineException

Indicates whether this element is running embedded inside another element's template.

Returns:

true if this element is embedded; or

false otherwise

Throws:

EngineException - if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.4

See Also:

getEmbeddingTemplate(), getEmbeddingElement(), getEmbedDifferentiator(), hasEmbedValue(), getEmbedValue(), hasEmbedData(), getEmbedProperties()

hasProperty

public boolean hasProperty(String name)
                    throws EngineException

Indicates whether this element has a certain injected named property.

Parameters:

name - the name of the property

Returns:

true if the element contains the property; or

false otherwise

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getProperty(String), getProperty(String, Object), getPropertyTyped(String, Class), getPropertyTyped(String, Class, Object), getPropertyString(String), getPropertyString(String, String), isPropertyEmpty(String)

getProperty

public Object getProperty(String name)
                   throws EngineException

Retrieves the value of an injected named property.

Note that there are two types of properties, fixed value properties (string literals) and dynamic value properties (participant objects, template instances, ...). The fixed value is set during the declaration of the property and the dynamic value is retrieved or instantiated each time the property value is obtained.

Property values can be of any type and class. If the resulting value needs to be a certain standard type or primitive value, use the Convert helper class to perform the conversion in-line. Since properties are very often used as string literals, there's getPropertyString(String) method to make this more convenient.

Parameters:

name - the name of the property

Returns:

the property value; or

null if no such property exists

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasProperty(String), getProperty(String, Object), getPropertyTyped(String, Class), getPropertyTyped(String, Class, Object), getPropertyString(String), getPropertyString(String, String), isPropertyEmpty(String)

getProperty

public Object getProperty(String name,
                          Object defaultValue)
                   throws EngineException

Retrieves the value of an injected named property, using a default value as fallback.

Parameters:

name - the name of the property

defaultValue - the value that should be used if the property can't be found

Returns:

the property value; or

the default value if no such property exists

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasProperty(String), getProperty(String), getPropertyTyped(String, Class), getPropertyTyped(String, Class, Object), getPropertyString(String), getPropertyString(String, String), isPropertyEmpty(String)

getPropertyTyped

public <T> T getPropertyTyped(String name,
                              Class<T> type)

Retrieves the value of an injected named property and converts it to the specified type.

This method has advantages over a regular cast, since it throws a meaningful exception to the user in case the type of the property value is not compatible.

Parameters:

name - the name of the property

type - the class you want the property to be converted to

Returns:

the property value, casted to the requested type; or

null if no such property exists

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

com.uwyn.rife.engine.exceptions.PropertyIncompatibleTypeException - if the type of the property value wasn't compatible with the requested type

Since:

1.3

See Also:

hasProperty(String), getProperty(String), getProperty(String, Object), getPropertyTyped(String, Class, Object), getPropertyString(String), getPropertyString(String, String), isPropertyEmpty(String)

getPropertyTyped

public <T> T getPropertyTyped(String name,
                              Class<T> type,
                              T defaultValue)

Retrieves the value of an injected named property and converts it to the specified type, using a default value as fallback.

This method has advantages over a regular cast, since it throws a meaningful exception to the user in case the type of the property value is not compatible.

Parameters:

name - the name of the property

type - the class you want the property to be converted to

defaultValue - the object that should be used if the property can't be found

Returns:

the property value, casted to the requested type; or

the default value if no such property exists

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

com.uwyn.rife.engine.exceptions.PropertyIncompatibleTypeException - if the type of the property value wasn't compatible with the requested type

Since:

1.3

See Also:

hasProperty(String), getProperty(String), getProperty(String, Object), getPropertyTyped(String, Class), getPropertyString(String), getPropertyString(String, String), isPropertyEmpty(String)

getPropertyString

public String getPropertyString(String name)
                         throws EngineException

Retrieves the value of an injected named property and converts it to a string.

Parameters:

name - the name of the property

Returns:

the string representation of the property value; or

null if no such property exists

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasProperty(String), getProperty(String), getProperty(String, Object), getPropertyTyped(String, Class), getPropertyTyped(String, Class, Object), getPropertyString(String, String), isPropertyEmpty(String)

getPropertyString

public String getPropertyString(String name,
                                String defaultValue)
                         throws EngineException

Retrieves the value of an injected named property and converts it to a string, using a default value as fallback.

Parameters:

name - the name of the property

defaultValue - the string literal that should be used if the property can't be found

Returns:

the string representation of the property value; or

the default value if no such property exists or when the resulting string is empty

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasProperty(String), getProperty(String), getProperty(String, Object), getPropertyTyped(String, Class), getPropertyTyped(String, Class, Object), getPropertyString(String), isPropertyEmpty(String)

isPropertyEmpty

public boolean isPropertyEmpty(String name)
                        throws EngineException

Checks if a property is not available or if the string presentation is empty.

Parameters:

name - the name of the property

Returns:

true if the property is empty; or

false otherwise

Throws:

EngineException - if the element information hasn't been provided yet (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasProperty(String), getProperty(String), getProperty(String, Object), getPropertyTyped(String, Class), getPropertyTyped(String, Class, Object), getPropertyString(String), getPropertyString(String, String)

getNamedInputBean

public <BeanType> BeanType getNamedInputBean(String name)
                           throws EngineException

Retrieves an instance of a named input bean and populates the properties with the input values. The class of the bean is looked up through its name, as is the property prefix.

This bean is not serialized or deserialized, each property corresponds to an input and is individually sent by the client.

Parameters:

name - the name of the input bean

Returns:

the populated input bean instance

Throws:

EngineException - if no input bean is known with this name; or if an error occurred during the instantiation of the bean; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputBean

public <BeanType> BeanType getInputBean(Class<BeanType> beanClass)
                      throws EngineException

Retrieves an instance of an input bean and populates the properties with the input values.

This bean is not serialized or de-serialized, each property corresponds to an input and is individually sent by the client.

Parameters:

beanClass - the class of the input bean

Returns:

the populated input bean instance

Throws:

EngineException - if an error occurred during the instantiation of the bean; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputBean

public <BeanType> BeanType getInputBean(Class<BeanType> beanClass,
                                        String prefix)
                      throws EngineException

Retrieves an instance of an input bean and populates the properties with the input values, taking the provided prefix into account.

This bean is not serialized or de-serialized, each property corresponds to an input and is individually sent by the client.

Parameters:

beanClass - the class of the input bean

prefix - the prefix that will be put in front of each property name

Returns:

the populated input bean instance

Throws:

EngineException - if an error occurred during the instantiation of the bean; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInput(String), getInput(String, String), getInputValues(String)

hasInputValue

public boolean hasInputValue(String name)
                      throws EngineException

Checks whether a value has been provided to an input.

Parameters:

name - the name of the input

Returns:

true if the input has a value; or

false otherwise

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

isInputEmpty(String), getNamedInputBean(String), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

isInputEmpty

public boolean isInputEmpty(String name)
                     throws EngineException

Checks whether an input has no value or whether the value is empty.

Parameters:

name - the name of the input

Returns:

true if the input has no value or when the value is empty; or

false otherwise

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInput

public String getInput(String name)
                throws EngineException

Retrieves the value of an input.

Parameters:

name - the name of the input

Returns:

the value of the input; or

null if no value is present for this input

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String, String), getInputValues(String)

getInput

public String getInput(String name,
                       String defaultValue)
                throws EngineException

Retrieves the value of an input and returns a default value if no input value is present

Parameters:

name - the name of the input

defaultValue - the default value that will be used when no input value is present

Returns:

the input value; or

the default value if no input value is present

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInputValues(String)

getInputSerializable

public <TargetType extends Serializable> TargetType getInputSerializable(String name)
                                                     throws EngineException

Retrieves the value of a serialized input.

Parameters:

name - the name of the input

Returns:

the deserialized input

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.3.1

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInputValues(String)

getInputSerializable

public <TargetType extends Serializable> TargetType getInputSerializable(String name,
                                                                         TargetType defaultValue)
                                                     throws EngineException

Retrieves the value of a serialized input and returns a default value if no input value is present

Parameters:

name - the name of the input

defaultValue - the default value that will be used when no input value is present

Returns:

the deserialized input; or

the default value if no input value is present

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.3.1

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInputValues(String)

getInputDate

public Date getInputDate(String name)
                  throws EngineException

Retrieves the value of an input and converts it to a Date.

Parameters:

name - the name of the input

Returns:

the converted input value; or

null if the input didn't have a value

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.6.1

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputDate

public Date getInputDate(String name,
                         Date defaultValue)
                  throws EngineException

Retrieves the value of an input and converts it to a Date, using a default value if no input value is present.

Parameters:

name - the name of the input

defaultValue - the default value that will be used when no input value is present

Returns:

the converted input value; or

the default value if no input value is present

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.6.1

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputValues

public String[] getInputValues(String name)
                        throws EngineException

Retrieves the values of an input.

Parameters:

name - the name of the input

Returns:

a string array with all the input values; or

null if no input values are present

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String)

getInputBoolean

public boolean getInputBoolean(String name)
                        throws EngineException

Retrieves the value of an input and converts it to a boolean.

Parameters:

name - the name of the input

Returns:

the converted input value; or

false if no input value is present or if the input value is not a valid boolean

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputBoolean

public boolean getInputBoolean(String name,
                               boolean defaultValue)
                        throws EngineException

Retrieves the value of an input and converts it to a boolean, using a default value if no input value is present.

Parameters:

name - the name of the input

defaultValue - the default value that will be used when no input value is present

Returns:

the converted input value; or

the default value if no input value is present

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputInt

public int getInputInt(String name)
                throws EngineException

Retrieves the value of an input and converts it to an integer.

Parameters:

name - the name of the input

Returns:

the converted input value; or

0 if no input value is present or if the input value is not a valid integer

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputInt

public int getInputInt(String name,
                       int defaultValue)
                throws EngineException

Retrieves the value of an input and converts it to an integer, using a default value if no input value is present.

Parameters:

name - the name of the input

defaultValue - the default value that will be used when no input value is present

Returns:

the converted input value; or

the default value if no input value is present

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputLong

public long getInputLong(String name)
                  throws EngineException

Retrieves the value of an input and converts it to a long.

Parameters:

name - the name of the input

Returns:

the converted input value; or

0L if no input value is present or if the input value is not a valid long

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputLong

public long getInputLong(String name,
                         long defaultValue)
                  throws EngineException

Retrieves the value of an input and converts it to a long, using a default value if no input value is present.

Parameters:

name - the name of the input

defaultValue - the default value that will be used when no input value is present

Returns:

the converted input value; or

the default value if no input value is present

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputDouble

public double getInputDouble(String name)
                      throws EngineException

Retrieves the value of an input and converts it to a double.

Parameters:

name - the name of the input

Returns:

the converted input value; or

0.0d if no input value is present or if the input value is not a valid double

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputDouble

public double getInputDouble(String name,
                             double defaultValue)
                      throws EngineException

Retrieves the value of an input and converts it to a double, using a default value if no input value is present.

Parameters:

name - the name of the input

defaultValue - the default value that will be used when no input value is present

Returns:

the converted input value; or

the default value if no input value is present

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputFloat

public float getInputFloat(String name)
                    throws EngineException

Retrieves the value of an input and converts it to a float.

Parameters:

name - the name of the input

Returns:

the converted input value; or

0.0f if no input value is present or if the input value is not a valid float

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

getInputFloat

public float getInputFloat(String name,
                           float defaultValue)
                    throws EngineException

Retrieves the value of an input and converts it to a float, using a default value if no input value is present.

Parameters:

name - the name of the input

defaultValue - the default value that will be used when no input value is present

Returns:

the converted input value; or

the default value if no input value is present

Throws:

EngineException - if no input is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasInputValue(String), isInputEmpty(String), getNamedInputBean(String), getInputBean(Class), getInputBean(Class, String), getInput(String), getInput(String, String), getInputValues(String)

selectInputParameter

public Collection<String> selectInputParameter(Template template,
                                               String name,
                                               String[] values)
                                        throws EngineException

Sets a select box option, a radio button or a checkbox to selected or checked according to input values.

The actual logic is performed by the selectParameter(Template, String, String[]) method. This method only prefixes the parameter name with the INPUT: literal, which is the syntax that is used to be able to handle automatic population correctly for each value type (inputs or submission parameters).

This method is automatically called during the print(Template) for all the inputs and values that this element received. You should thus only call it explicitly if you need it to be executed with custom values.

Parameters:

template - the template instance where the selection should happen

name - the name of the input

values - the values that should selected or checked

Returns:

a list with the identifiers of the template values that have been set, this is never null, when no values are set an empty list is returned

Throws:

EngineException - if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

selectParameter(Template, String, String[]), selectSubmissionParameter(Template, String, String[])

setOutput

public void setOutput(String name,
                      String value)
               throws EngineException

Sets the value of an output.

Parameters:

name - the name of the output

value - the value that has to be set

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setOutput

public void setOutput(String name,
                      String[] values)
               throws EngineException

Set the values of an output.

Parameters:

name - the name of the output

values - the values that have to be set

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setOutput

public void setOutput(String name,
                      boolean value)
               throws EngineException

Sets the value of an output from a boolean.

Parameters:

name - the name of the output

value - the value that has to be set

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setOutput

public void setOutput(String name,
                      char value)
               throws EngineException

Sets the value of an output from a char.

Parameters:

name - the name of the output

value - the value that has to be set

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setOutput

public void setOutput(String name,
                      char[] value)
               throws EngineException

Set the value of an output from an array of chars that will be concatenated to a String.

Parameters:

name - the name of the output

value - the value that has to be set

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setOutput

public void setOutput(String name,
                      double value)
               throws EngineException

Sets the value of an output from a double.

Parameters:

name - the name of the output

value - the value that has to be set

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setOutput

public void setOutput(String name,
                      float value)
               throws EngineException

Sets the value of an output from a float.

Parameters:

name - the name of the output

value - the value that has to be set

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setOutput

public void setOutput(String name,
                      int value)
               throws EngineException

Sets the value of an output from an int.

Parameters:

name - the name of the output

value - the value that has to be set

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setOutput

public void setOutput(String name,
                      long value)
               throws EngineException

Sets the value of an output from a long.

Parameters:

name - the name of the output

value - the value that has to be set

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setOutput

public void setOutput(String name,
                      Object value)
               throws EngineException

Sets the value of an output from a generic object. The object will be converted to its String representation.

Parameters:

name - the name of the output

value - the value that has to be set

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

addOutputValue

public void addOutputValue(String name,
                           String value)
                    throws EngineException

Adds a value to the current values of an output.

Parameters:

name - the name of the output

value - the value that has to be added

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

addOutputValues

public void addOutputValues(String name,
                            String[] values)
                     throws EngineException

Adds values to the current values of an output.

Parameters:

name - the name of the output

values - the values that have to be added

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

addOutputValue

public void addOutputValue(String name,
                           boolean value)
                    throws EngineException

Adds a boolean value to the current values of an output.

Parameters:

name - the name of the output

value - the value that has to be added

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

addOutputValue

public void addOutputValue(String name,
                           char value)
                    throws EngineException

Adds a char value to the current values of an output.

Parameters:

name - the name of the output

value - the value that has to be added

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

addOutputValue

public void addOutputValue(String name,
                           char[] value)
                    throws EngineException

Adds values from an array of chars to the current values of an output.

Parameters:

name - the name of the output

value - the values that have to be added

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

addOutputValue

public void addOutputValue(String name,
                           double value)
                    throws EngineException

Adds a double value to the current values of an output.

Parameters:

name - the name of the output

value - the value that has to be added

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

addOutputValue

public void addOutputValue(String name,
                           float value)
                    throws EngineException

Adds a float value to the current values of an output.

Parameters:

name - the name of the output

value - the value that has to be added

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

addOutputValue

public void addOutputValue(String name,
                           int value)
                    throws EngineException

Adds a int value to the current values of an output.

Parameters:

name - the name of the output

value - the value that has to be added

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

addOutputValue

public void addOutputValue(String name,
                           long value)
                    throws EngineException

Adds a long value to the current values of an output.

Parameters:

name - the name of the output

value - the value that has to be added

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

addOutputValue

public void addOutputValue(String name,
                           Object value)
                    throws EngineException

Adds a generic object value to the current values of an output.

Parameters:

name - the name of the output

value - the value that has to be added

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setNamedOutputBean

public void setNamedOutputBean(String name,
                               Object bean)
                        throws EngineException

Sets an instance of a named output bean and populates the output values from the property values. The class of the bean is looked up through its name, as is the property prefix.

This bean is not serialized or deserialized, each output corresponds to a property and is individually sent to the client.

Parameters:

name - the name of the output bean

bean - the bean instance that should be used to set the outputs

Throws:

EngineException - if no output bean is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setOutputBean

public void setOutputBean(Object bean)
                   throws EngineException

Sets an instance of a named input bean and populates the output values from the property values.

This bean is not serialized or deserialized, each output corresponds to a property and is individually sent to the client.

Parameters:

bean - the bean instance that should be used to set the outputs

Throws:

EngineException - if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

setOutputBean

public void setOutputBean(Object bean,
                          String prefix)
                   throws EngineException

Sets an instance of a named input bean and populates the output values from the property values.

This bean is not serialized or deserialized, each output corresponds to a property and is individually sent to the client.

Parameters:

bean - the bean instance that should be used to set the outputs

prefix - the prefix that will be put in front of each property name

Throws:

EngineException - if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

clearOutput

public void clearOutput(String name)
                 throws EngineException

Clears the output value of an output.

Parameters:

name - the name of the output

Throws:

EngineException - if no output is known with this name; if no output is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

clearNamedOutputBean

public void clearNamedOutputBean(String name)
                          throws EngineException

Clears the outputs that correspond to the properties of a named output bean. The class of the bean is looked up through its name, as is the property prefix.

Parameters:

name - the name of the output bean

Throws:

EngineException - if no output bean is known with this name; or if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearOutputBean(Class), clearOutputBean(Class, String), getOutput(String)

clearOutputBean

public void clearOutputBean(Class beanClass)
                     throws EngineException

Clears the outputs that correspond to the properties of an output bean.

Parameters:

beanClass - the class of the output bean

Throws:

EngineException - if no output bean is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class, String), getOutput(String)

clearOutputBean

public void clearOutputBean(Class beanClass,
                            String prefix)
                     throws EngineException

Clears the outputs that correspond to the properties of an output bean, taking the provided prefix into account.

Parameters:

beanClass - the class of the output bean

prefix - the prefix that will be put in front of each property name

Throws:

EngineException - if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), getOutput(String)

getOutput

public String[] getOutput(String name)
                   throws EngineException

Retrieves the value of the ouput.

Parameters:

name - the name of the output

Returns:

the textual value of the output as it's used by framework; or null if the output couldn't be found.

Throws:

EngineException - if no output is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.6

See Also:

setNamedOutputBean(String, Object), setOutputBean(Object), setOutputBean(Object, String), setOutput(String, String), setOutput(String, String[]), addOutputValue(String, String), addOutputValues(String, String[]), clearOutput(String), clearNamedOutputBean(String), clearOutputBean(Class), clearOutputBean(Class, String)

hasCookie

public boolean hasCookie(String name)
                  throws EngineException

Checks whether a cookie is present.

Parameters:

name - the name of the cookie

Returns:

true if the cookie was present; or

false otherwise

Throws:

EngineException - if no incookie is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

getCookie(String), getCookieValue(String), getCookieValue(String, String), getCookieValues(), setCookie(Cookie)

getCookie

public Cookie getCookie(String name)
                 throws EngineException

Retrieves a cookie.

Parameters:

name - the name of the cookie.

Returns:

the instance of the cookie; or

null if no such cookie is present

Throws:

EngineException - if no incookie is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasCookie(String), getCookieValue(String), getCookieValue(String, String), getCookieValues(), setCookie(Cookie)

getCookieValue

public String getCookieValue(String name)
                      throws EngineException

Retrieves the value of a cookie.

Parameters:

name - the name of the cookie

Returns:

the value of the cookie; or

null if no such cookie is present

Throws:

EngineException - if no incookie is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasCookie(String), getCookie(String), getCookieValue(String, String), getCookieValues(), setCookie(Cookie)

getCookieValues

public Map<String,String> getCookieValues()
                                   throws EngineException

Retrieves all current cookies names with their values.

Returns:

a new map of all the current cookies names with their values

Throws:

EngineException - if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasCookie(String), getCookie(String), getCookieValue(String), getCookieValue(String, String), setCookie(Cookie)

getCookieValue

public String getCookieValue(String name,
                             String defaultValue)
                      throws EngineException

Retrieves the value of a named cookie, using a default value as fallback.

Parameters:

name - the name of the cookie

defaultValue - the default value that will be used when no cookie value is present

Returns:

the cookie value; or

the default value if no cookie value is present

Throws:

EngineException - if no incookie is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasCookie(String), getCookie(String), getCookieValue(String), getCookieValue(String, String), getCookieValues(), setCookie(Cookie)

getCookieValueBoolean

public boolean getCookieValueBoolean(String name)
                              throws EngineException

Retrieves the value of a named cookie and converts it to a boolean.

Parameters:

name - the name of the cookie

Returns:

the converted cookie value; or

false if no cookie value is present or if the cookie value is not a valid boolean

Throws:

EngineException - if no incookie is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasCookie(String), getCookie(String), getCookieValue(String), getCookieValue(String, String), getCookieValues(), setCookie(Cookie)

getCookieValueBoolean

public boolean getCookieValueBoolean(String name,
                                     boolean defaultValue)
                              throws EngineException

Retrieves the value of a named cookie and converts it to a boolean, using a default value if no input value is present.

Parameters:

name - the name of the cookie

defaultValue - the default value that will be used when no cookie value is present

Returns:

the converted cookie value; or

the default value if no cookie value is present

Throws:

EngineException - if no incookie is known with this name; if you don't have access to the request data (eg. you're inside a child trigger); or if there's no active element context (eg. you're using this method inside the constructor instead of inside the initialize() method)

Since:

1.0

See Also:

hasCookie(String), getCookie(String), getCookieValue(String), getCookieValue(String, String), getCookieValues(), setCookie(Cookie)

getCookieValueInt

public int getCookieValueInt(String name)
                      throws EngineException

Retrieves the value of a named cookie and converts it to an integer.

Parameters:

name - the name of the cookie

Returns:

the converted cookie value; or

0 if no cookie value is present or if the cookie value is not a valid integer

Throws: