com.opensymphony.webwork.components
Class AppendIterator

java.lang.Object
  com.opensymphony.webwork.components.Component
      com.opensymphony.webwork.components.AppendIterator

All Implemented Interfaces:

Param.UnnamedParametric

public class AppendIterator
extends Component
implements Param.UnnamedParametric

Component for AppendIteratorTag, which jobs is to append iterators to form an appended iterator whereby entries goes from one iterator to another after each respective iterator is exhausted of entries.

For example, if there are 3 iterator appended (each iterator has 3 entries), the following will be how the appended iterator entries will be arranged:

1. First Entry of the First Iterator
2. Second Entry of the First Iterator
3. Third Entry of the First Iterator
4. First Entry of the Second Iterator
5. Second Entry of the Second Iterator
6. Third Entry of the Second Iterator
7. First Entry of the Third Iterator
8. Second Entry of the Third Iterator
9. Third Entry of the Third ITerator

• id (String) - the id of which if supplied will have the resultant appended iterator stored under in the stack's context

public class AppendIteratorTagAction extends ActionSupport { private List myList1; private List myList2; private List myList3; public String execute() throws Exception { myList1 = new ArrayList(); myList1.add("1"); myList1.add("2"); myList1.add("3"); myList2 = new ArrayList(); myList2.add("a"); myList2.add("b"); myList2.add("c"); myList3 = new ArrayList(); myList3.add("A"); myList3.add("B"); myList3.add("C"); return "done"; } public List getMyList1() { return myList1; } public List getMyList2() { return myList2; } public List getMyList3() { return myList3; } } <ww:append id="myAppendIterator"> <ww:param value="%{myList1}" /> <ww:param value="%{myList2}" /> <ww:param value="%{myList3}" /> </ww:append> <ww:iterator value="%{#myAppendIterator}"> <ww:property /> </ww:iterator>

Version:

$Date$ $Id$

Author:

tm_jee ( tm_jee (at) yahoo.co.uk )

See Also:

AppendIteratorFilter, AppendIteratorTag

Field Summary

Fields inherited from class com.opensymphony.webwork.components.Component

COMPONENT_STACK, id, parameters, stack

Constructor Summary

AppendIterator(com.opensymphony.xwork.util.OgnlValueStack stack)

Method Summary

void	addParameter(Object value) Adds the given value as a parameter to the outer tag.
boolean	end(Writer writer, String body) Callback for the end tag of this component.
void	setId(String id) the id of which if supplied will have the resultant appended iterator stored under in the stack's context
boolean	start(Writer writer) Callback for the start tag of this component.

Methods inherited from class com.opensymphony.webwork.components.Component

addAllParameters, addParameter, altSyntax, copyParams, determineActionURL, determineNamespace, end, fieldError, findAncestor, findString, findString, findValue, findValue, findValue, getComponentStack, getId, getParameters, getStack, popComponentStack, toString, usesBody

Methods inherited from class java.lang.Object

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

Constructor Detail

AppendIterator

public AppendIterator(com.opensymphony.xwork.util.OgnlValueStack stack)

Method Detail

start

public boolean start(Writer writer)

Description copied from class: Component

Callback for the start tag of this component. Should the body be evaluated?

Overrides:

start in class Component

Parameters:

writer - the output writer.

Returns:

true if the body should be evaluated

end

public boolean end(Writer writer,
                   String body)

Description copied from class: Component

Callback for the end tag of this component. Should the body be evaluated again?

NOTE: will pop component stack.

Overrides:

end in class Component

Parameters:

writer - the output writer.

body - the rendered body.

Returns:

true if the body should be evaluated again

addParameter

public void addParameter(Object value)

Description copied from interface: Param.UnnamedParametric

Adds the given value as a parameter to the outer tag.

Specified by:

addParameter in interface Param.UnnamedParametric

Parameters:

value - the value

setId

public void setId(String id)

the id of which if supplied will have the resultant appended iterator stored under in the stack's context

Overrides:

setId in class Component