Package org.zkoss.stateless.state

Class ICascaderController<DataT>

java.lang.Object

org.zkoss.stateless.state.ICascaderController<DataT>

All Implemented Interfaces:

ItemController<DataT,org.zkoss.zul.TreeModel<DataT>,ICascader,java.lang.String>

public class ICascaderController<DataT>
extends java.lang.Object
implements ItemController<DataT,org.zkoss.zul.TreeModel<DataT>,ICascader,java.lang.String>

An ICascader controller to control any operation on the given model.

Note: this class is not thread-safe, so when it's used in multi-threading environment, the developer should handle the threading issue.

Author:

katherine

Method Summary

Modifier and Type	Method	Description
ICascader	build()	Returns the immutable instance that the controller to build with
void	clear()	Clears all the rendered data.
org.zkoss.zul.TreeModel<DataT>	getModel()	Returns the model, which is set through by ItemController.setModel(Object), or null.
CheckedFunction2<DataT,java.lang.Integer,java.lang.String>	getRenderer()	Returns the renderer, which is set through by ItemController.setRenderer(CheckedFunction2), or a default one which is depended on implementation.
DataT	getSelectedObject()	Returns the selected object.
java.util.Set<DataT>	getSelectedObjects()	Returns all selected items.
static <D> ICascaderController<D>	of(ICascader owner, org.zkoss.zul.TreeModel<D> model)	Returns the controller instance with the given cascader, and TreeModel.
static <D> ICascaderController<D>	of(ICascader owner, org.zkoss.zul.TreeModel<D> model, CheckedFunction2<java.lang.Object,java.lang.Integer,java.lang.String> renderer)	Returns the controller instance with the given cascader, and TreeModel.
void	setItemConverter(org.zkoss.util.Converter<java.util.Collection<DataT>,java.lang.String> converter)	Sets the converter that generates the label text shown in the cascader from selected items.
void	setModel(org.zkoss.zul.TreeModel<DataT> model)	Sets the given model to this controller.
void	setRenderer(CheckedFunction2<DataT,java.lang.Integer,java.lang.String> renderer)	Sets the renderer which is used to render each data if ItemController.getModel() is not null.
void	setSelectedObject(DataT item)	Deselects selected object and selects the given object.

Methods inherited from class java.lang.Object

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

Method Detail

of

public static <D> ICascaderController<D> of(ICascader owner,
                                            org.zkoss.zul.TreeModel<D> model)

Returns the controller instance with the given cascader, and TreeModel.

Parameters:

owner - The controller to control with

model - The data model for the cascader.

of

public static <D> ICascaderController<D> of(ICascader owner,
                                            org.zkoss.zul.TreeModel<D> model,
                                            CheckedFunction2<java.lang.Object,java.lang.Integer,java.lang.String> renderer)

Returns the controller instance with the given cascader, and TreeModel.

Parameters:

owner - The controller to control with

model - The data model for the cascader.

renderer - The data renderer for the cascader.

setModel

public void setModel(org.zkoss.zul.TreeModel<DataT> model)

Description copied from interface: ItemController

Sets the given model to this controller.

Note: calling this method after ItemController.build(), you should invoke ItemController.build() again to take effect to replace the current one at client.
For example,

 
 uiAgent.replaceWith(locator, itemController.build());
 

Default: null

Specified by:

setModel in interface ItemController<DataT,org.zkoss.zul.TreeModel<DataT>,ICascader,java.lang.String>

getModel

public org.zkoss.zul.TreeModel<DataT> getModel()

Description copied from interface: ItemController

Returns the model, which is set through by ItemController.setModel(Object), or null.

Specified by:

getModel in interface ItemController<DataT,org.zkoss.zul.TreeModel<DataT>,ICascader,java.lang.String>

setRenderer

public void setRenderer(CheckedFunction2<DataT,java.lang.Integer,java.lang.String> renderer)

Description copied from interface: ItemController

Sets the renderer which is used to render each data if ItemController.getModel() is not null.

Note: calling this method after ItemController.build(), you should invoke ItemController.build() again to take effect to replace the current one at client.
For example,

 
 uiAgent.replaceWith(locator, itemController.build());
 

Default: null, or depended on the implementation

Specified by:

setRenderer in interface ItemController<DataT,org.zkoss.zul.TreeModel<DataT>,ICascader,java.lang.String>

getRenderer

public CheckedFunction2<DataT,java.lang.Integer,java.lang.String> getRenderer()

Description copied from interface: ItemController

Returns the renderer, which is set through by ItemController.setRenderer(CheckedFunction2), or a default one which is depended on implementation.

Specified by:

getRenderer in interface ItemController<DataT,org.zkoss.zul.TreeModel<DataT>,ICascader,java.lang.String>

build

public ICascader build()

Description copied from interface: ItemController

Returns the immutable instance that the controller to build with

Specified by:

build in interface ItemController<DataT,org.zkoss.zul.TreeModel<DataT>,ICascader,java.lang.String>

clear

public void clear()

Description copied from interface: ItemController

Clears all the rendered data.

Specified by:

clear in interface ItemController<DataT,org.zkoss.zul.TreeModel<DataT>,ICascader,java.lang.String>

setItemConverter

public void setItemConverter(org.zkoss.util.Converter<java.util.Collection<DataT>,java.lang.String> converter)

Sets the converter that generates the label text shown in the cascader from selected items.

Parameters:

converter - the converter, or null to use the default implementation.

getSelectedObjects

public java.util.Set<DataT> getSelectedObjects()

Returns all selected items.

getSelectedObject

public DataT getSelectedObject()

Returns the selected object.

setSelectedObject

public void setSelectedObject(DataT item)

Deselects selected object and selects the given object.