org.jxls.command

Class EachCommand

java.lang.Object

org.jxls.command.AbstractCommand

org.jxls.command.EachCommand

All Implemented Interfaces:

Command

public class EachCommand
extends AbstractCommand

Implements iteration over collection of items 'items' is a bean name of the collection in context 'var' is a name of a collection item to put into the context during the iteration 'direction' defines expansion by rows (DOWN) or by columns (RIGHT). Default is DOWN. 'cellRefGenerator' defines custom strategy for target cell references. Date: Nov 10, 2009

Author:

Leonid Vysochyn

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	EachCommand.Direction

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMMAND_NAME

Fields inherited from interface org.jxls.command.Command

ADJACENT_SHIFT_MODE, INNER_SHIFT_MODE

Constructor Summary

Constructors

Constructor and Description
EachCommand()
EachCommand(String items, Area area)
EachCommand(String var, String items, Area area)
EachCommand(String var, String items, Area area, CellRefGenerator cellRefGenerator)
EachCommand(String var, String items, Area area, EachCommand.Direction direction)
EachCommand(String var, String items, EachCommand.Direction direction)

Method Summary

Modifier and Type	Method and Description
Command	addArea(Area area) Adds an area to this command
Size	applyAt(CellRef cellRef, Context context) Applies a command at the given cell reference
CellRefGenerator	getCellRefGenerator() Gets defined cell ref generator
EachCommand.Direction	getDirection() Gets iteration directino
String	getGroupBy()
String	getGroupOrder()
String	getItems() Gets collection bean name
String	getMultisheet()
String	getName()
String	getSelect() Gets current 'select' expression for filtering out collection items
String	getVar() Gets current variable name for collection item in the context during iteration
void	setCellRefGenerator(CellRefGenerator cellRefGenerator)
void	setDirection(EachCommand.Direction direction) Sets iteration direction
void	setDirection(String direction)
void	setGroupBy(String groupBy)
void	setGroupOrder(String groupOrder)
void	setItems(String items) Sets collection bean name
void	setMultisheet(String multisheet) Sets name of context variable holding a list of Excel sheet names to output the collection to
void	setSelect(String select) Sets current 'select' expression for filtering collection
void	setVar(String var) Sets current variable name for collection item in the context during iteration

Methods inherited from class org.jxls.command.AbstractCommand

getAreaList, getShiftMode, getTransformationConfig, getTransformer, reset, setShiftMode

Methods inherited from class java.lang.Object

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

Field Detail

COMMAND_NAME

public static final String COMMAND_NAME

See Also:

Constant Field Values

Constructor Detail

EachCommand

public EachCommand()

EachCommand

public EachCommand(String var,
                   String items,
                   EachCommand.Direction direction)

Parameters:

var - name of the key in the context to contain each collection items during iteration

items - name of the collection bean in the context

direction - defines processing by rows (DOWN - default) or columns (RIGHT)

EachCommand

public EachCommand(String items,
                   Area area)

EachCommand

public EachCommand(String var,
                   String items,
                   Area area)

EachCommand

public EachCommand(String var,
                   String items,
                   Area area,
                   EachCommand.Direction direction)

EachCommand

public EachCommand(String var,
                   String items,
                   Area area,
                   CellRefGenerator cellRefGenerator)

Parameters:

var - name of the key in the context to contain each collection items during iteration

items - name of the collection bean in the context

area - body area for this command

cellRefGenerator - generates target cell ref for each collection item during iteration

Method Detail

getDirection

public EachCommand.Direction getDirection()

Gets iteration directino

Returns:

current direction for iteration

setDirection

public void setDirection(EachCommand.Direction direction)

Sets iteration direction

Parameters:

direction - -

setDirection

public void setDirection(String direction)

getCellRefGenerator

public CellRefGenerator getCellRefGenerator()

Gets defined cell ref generator

Returns:

current CellRefGenerator instance or null

setCellRefGenerator

public void setCellRefGenerator(CellRefGenerator cellRefGenerator)

getName

public String getName()

Returns:

command name

getVar

public String getVar()

Gets current variable name for collection item in the context during iteration

Returns:

collection item key name in the context

setVar

public void setVar(String var)

Sets current variable name for collection item in the context during iteration

Parameters:

var - name of the loop var

getItems

public String getItems()

Gets collection bean name

Returns:

collection bean name in the context

setItems

public void setItems(String items)

Sets collection bean name

Parameters:

items - collection bean name in the context

getSelect

public String getSelect()

Gets current 'select' expression for filtering out collection items

Returns:

current 'select' expression or null if undefined

setSelect

public void setSelect(String select)

Sets current 'select' expression for filtering collection

Parameters:

select - filtering expression

getMultisheet

public String getMultisheet()

Returns:

Context variable name holding a list of Excel sheet names to output the collection to

setMultisheet

public void setMultisheet(String multisheet)

Sets name of context variable holding a list of Excel sheet names to output the collection to

Parameters:

multisheet - var name

getGroupBy

public String getGroupBy()

Returns:

property name for grouping the collection

setGroupBy

public void setGroupBy(String groupBy)

Parameters:

groupBy - property name for grouping the collection

getGroupOrder

public String getGroupOrder()

Returns:

group order

setGroupOrder

public void setGroupOrder(String groupOrder)

Parameters:

groupOrder - group ordering

addArea

public Command addArea(Area area)

Description copied from interface: Command

Adds an area to this command

Specified by:

addArea in interface Command

Overrides:

addArea in class AbstractCommand

Parameters:

area - -

Returns:

this command instance

applyAt

public Size applyAt(CellRef cellRef,
                    Context context)

Description copied from interface: Command

Applies a command at the given cell reference

Parameters:

cellRef - cell reference where the command must be applied

context - bean context to use

Returns:

size of enclosing command area after transformation