net.wotonomy.web
Class WOConditional

java.lang.Object
  net.wotonomy.web.WOElement
      net.wotonomy.web.WODynamicElement
          net.wotonomy.web.WOConditional

All Implemented Interfaces:

java.io.Serializable, WOActionResults

public class WOConditional
extends WODynamicElement

WOConditional renders whatever is inside its opening and closing tags only if a condition is met. Bindings are:

• condition: a boolean property that indicates whether the contents of the element should be displayed, invoked, or passed the request form values.
• negate: if this is true, then the behavior of the element is reversed, showing its contents only if the condition is NOT met.

Version:

$Revision: 893 $

Author:

ezamudio@nasoft.com, $Author: cgruber $

See Also:

Serialized Form

Field Summary

boolean	condition
boolean	negate

Fields inherited from class net.wotonomy.web.WODynamicElement

associations, name, rootElement

Constructor Summary

protected	WOConditional()
	WOConditional(java.lang.String aName, net.wotonomy.foundation.NSDictionary aMap, WOElement template)

Method Summary

void	appendToResponse(WOResponse aResponse, WOContext aContext) This method is called on all elements of the content tree to build a response to a user request.
boolean	condition()
WOActionResults	invokeAction(WORequest aRequest, WOContext aContext) This method is called on all objects and elements of the application until a non-null value is returned.
boolean	negate()
protected void	pullValuesFromParent(WOComponent c)
void	setCondition(boolean value)
void	setNegate(boolean value)
void	takeValuesFromRequest(WORequest aRequest, WOContext aContext) This method is called to retrieve user-entered data from the request.

Methods inherited from class net.wotonomy.web.WODynamicElement

generateResponse

Methods inherited from class java.lang.Object

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

Field Detail

condition

public boolean condition

negate

public boolean negate

Constructor Detail

WOConditional

protected WOConditional()

WOConditional

public WOConditional(java.lang.String aName,
                     net.wotonomy.foundation.NSDictionary aMap,
                     WOElement template)

Method Detail

setCondition

public void setCondition(boolean value)

condition

public boolean condition()

setNegate

public void setNegate(boolean value)

negate

public boolean negate()

pullValuesFromParent

protected void pullValuesFromParent(WOComponent c)

takeValuesFromRequest

public void takeValuesFromRequest(WORequest aRequest,
                                  WOContext aContext)

Description copied from class: WODynamicElement

This method is called to retrieve user-entered data from the request. WOElements should retrieve data from the request based on their elementID and set values in the context's current WOComponent, typically those values that are associated with the element in the binding. This implementation does nothing.

Overrides:

takeValuesFromRequest in class WODynamicElement

invokeAction

public WOActionResults invokeAction(WORequest aRequest,
                                    WOContext aContext)

Description copied from class: WODynamicElement

This method is called on all objects and elements of the application until a non-null value is returned. WOElements should first check to see if they are the target of an action by checking the WOContext's senderID to see if it matches this element's elementID. If this element is the target, it should perform an appropriate action on the context's current WOComponent, usually the action specified in the binding, and return the result of that action. This implementation returns null.

Overrides:

invokeAction in class WODynamicElement

appendToResponse

public void appendToResponse(WOResponse aResponse,
                             WOContext aContext)

Description copied from class: WODynamicElement

This method is called on all elements of the content tree to build a response to a user request. The message should be forwarded to any child elements so that the entire tree is traversed. This implementation does nothing.

Overrides:

appendToResponse in class WODynamicElement