org.josef.web.jsf.bean

Class JosefSelectOneUtilBean

java.lang.Object

org.josef.web.jsf.bean.JosefSelectUtilBean

org.josef.web.jsf.bean.JosefSelectOneUtilBean

All Implemented Interfaces:

Serializable

public class JosefSelectOneUtilBean
extends JosefSelectUtilBean
implements Serializable

Utility bean for components of type SelectOne..., for example: SelectOneMenu and SelectOneRadio.

Version:

1.0 $Revision: 6236 $

Author:

Kees Schotanus

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
JosefSelectOneUtilBean()

Method Summary

Modifier and Type	Method and Description
String	getLabelFromSelectItemsAndValue(javax.faces.model.SelectItem[] selectItems, Object value) Gets the Label of the SelectItem with the supplied value from the supplied selectItems.
String	getLabelOfSelectOneComponent(String id) Gets the current Label (that is the one corresponding to the current value) of the Select component with the supplied id.
String	getLabelOfSelectOneComponent(javax.faces.component.UINamingContainer namingContainer, String componentId) Gets the current Label (that is the one corresponding to the current value) of the SelectOne...

Methods inherited from class org.josef.web.jsf.bean.JosefSelectUtilBean

hasZeroOrOneSelectItem, hasZeroOrOneSelectItem

Methods inherited from class java.lang.Object

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

Constructor Detail

JosefSelectOneUtilBean

public JosefSelectOneUtilBean()

Method Detail

getLabelFromSelectItemsAndValue

public String getLabelFromSelectItemsAndValue(javax.faces.model.SelectItem[] selectItems,
                                              Object value)

Gets the Label of the SelectItem with the supplied value from the supplied selectItems.

Parameters:

selectItems - The select items to get a single label from.

value - The value of the select item.

Returns:

the Label of the SelectItem with the supplied value from the supplied selectItems.

Throws:

IllegalArgumentException - When the supplied selectItems is empty or when the supplied selectItems does not contain a SelectItem with the supplied value.

NullPointerException - When the supplied selectItems is null.

See Also:

JsfSelectItemUtil.getLabelFromSelectItemsAndValue(SelectItem[], Object)

getLabelOfSelectOneComponent

public String getLabelOfSelectOneComponent(String id)

Gets the current Label (that is the one corresponding to the current value) of the Select component with the supplied id.

Parameters:

id - The id of the Select component.

Returns:

The Label corresponding to the current value of the Select component with the supplied id.

Throws:

IllegalArgumentException - when the supplied id is empty or when no component with the supplied id could be found or when the component could be found, but does not have any SelectItems.

NullPointerException - When the supplied id is null.

getLabelOfSelectOneComponent

public String getLabelOfSelectOneComponent(javax.faces.component.UINamingContainer namingContainer,
                                           String componentId)

Gets the current Label (that is the one corresponding to the current value) of the SelectOne... component, nested within the supplied namingContainer).

Parameters:

namingContainer - The naming container, containing the SelectOne... component.

componentId - The ID of the SelectOne... component.

Returns:

Label of the SelectOne... component or null when the SelectOne... component does not have a value (yet).

Throws:

IllegalArgumentException - When the supplied componentId is empty or does not refer to an existing component within the supplied namingContainer.

NullPointerException - When either the supplied namingContainer or componentId is null.