Top Description Inners Constructors Methods
jakarta.faces.component

pack-priv Class SelectUtils

extends Object
Class Inheritance
Imports
java.util.Iterator, .NoSuchElementException, jakarta.el.ELException, .ExpressionFactory, jakarta.faces.context.FacesContext, jakarta.faces.convert.Converter, jakarta.faces.model.SelectItem, .SelectItemGroup
Contains common utility methods used by both UISelectOne and UISelectMany.

Nested and Inner Type Summary

Modifier and TypeClass and Description
pack-priv static class
SelectUtils.ArrayIterator

Exposes an Array via an Iterator

Constructor Summary

AccessConstructor and Description
private
SelectUtils()

Method Summary

Modifier and TypeMethod and Description
private static Object

Returns:

the result of the Jakarta Expression Language coersion
coerceToModelType(FacesContext
the FacesContext for the current request
ctx, Object
the value to coerce
value, Class<T>
the type value should be coerced to
toType)

Coerce the provided value to the specified type using Jakarta Expression Language coercion.

private static Object
doConversion(FacesContext ctx, UIComponent component, SelectItem item, Object value, Converter<T> converter)

pack-priv static boolean
matchValue(FacesContext
FacesContext for the current request
ctx, UIComponent component, Object
UIComponent value to be tested
value, Iterator<SelectItem>
Iterator over the jakarta.faces.model.SelectItems to be checked
items, Converter<T>
the Converter associated with this component
converter)

Return true if the specified value matches one of the available options, performing a recursive search if if a jakarta.faces.model.SelectItemGroup instance is detected.

pack-priv static boolean
valueIsNoSelectionOption(FacesContext ctx, UIComponent component, Object value, Iterator<SelectItem> items, Converter<T> converter)

Returns true iff component has a UISelectItem child whose itemValue exactly matches the argument value

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Constructor Detail

SelectUtilsback to summary
private SelectUtils()

Method Detail

coerceToModelTypeback to summary
private static Object coerceToModelType(FacesContext ctx, Object value, Class<T> toType)

Coerce the provided value to the specified type using Jakarta Expression Language coercion.

Parameters
ctx:FacesContext

the FacesContext for the current request

value:Object

the value to coerce

toType:Class<T>

the type value should be coerced to

Returns:Object

the result of the Jakarta Expression Language coersion

See Also
ExpressionFactory#coerceToType(Object, Class)
doConversionback to summary
private static Object doConversion(FacesContext ctx, UIComponent component, SelectItem item, Object value, Converter<T> converter) throws IllegalStateException
matchValueback to summary
pack-priv static boolean matchValue(FacesContext ctx, UIComponent component, Object value, Iterator<SelectItem> items, Converter<T> converter)

Return true if the specified value matches one of the available options, performing a recursive search if if a jakarta.faces.model.SelectItemGroup instance is detected.

Parameters
ctx:FacesContext

FacesContext for the current request

value:Object

UIComponent value to be tested

items:Iterator<SelectItem>

Iterator over the jakarta.faces.model.SelectItems to be checked

converter:Converter<T>

the Converter associated with this component

valueIsNoSelectionOptionback to summary
pack-priv static boolean valueIsNoSelectionOption(FacesContext ctx, UIComponent component, Object value, Iterator<SelectItem> items, Converter<T> converter)

Returns true iff component has a UISelectItem child whose itemValue exactly matches the argument value

jakarta.faces.component back to summary

pack-priv Class SelectUtils.ArrayIterator

extends Object
implements Iterator
Class Inheritance
All Implemented Interfaces
java.util.Iterator
Exposes an Array via an Iterator

Field Summary

Modifier and TypeField and Description
private int
index

private Object[]
items

Constructor Summary

AccessConstructor and Description
public
ArrayIterator(Object[] items)

Method Summary

Modifier and TypeMethod and Description
public boolean
hasNext()

Implements java.util.Iterator.hasNext.

Returns true if the iteration has more elements.
public Object
next()

Implements java.util.Iterator.next.

Returns the next element in the iteration.
public void
remove()

Overrides default java.util.Iterator.remove.

Removes from the underlying collection the last element returned by this iterator (optional operation).
Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

indexback to summary
private int index
itemsback to summary
private Object[] items

Constructor Detail

ArrayIteratorback to summary
public ArrayIterator(Object[] items)

Method Detail

hasNextback to summary
public boolean hasNext()

Implements java.util.Iterator.hasNext.

Doc from java.util.Iterator.hasNext.

Returns true if the iteration has more elements. (In other words, returns true if next would return an element rather than throwing an exception.)

Returns:boolean

true if the iteration has more elements

Annotations
@Override
nextback to summary
public Object next()

Implements java.util.Iterator.next.

Doc from java.util.Iterator.next.

Returns the next element in the iteration.

Returns:Object

the next element in the iteration

Annotations
@Override
removeback to summary
public void remove()

Overrides default java.util.Iterator.remove.

Doc from java.util.Iterator.remove.

Removes from the underlying collection the last element returned by this iterator (optional operation). This method can be called only once per call to next.

The behavior of an iterator is unspecified if the underlying collection is modified while the iteration is in progress in any way other than by calling this method, unless an overriding class has specified a concurrent modification policy.

The behavior of an iterator is unspecified if this method is called after a call to the forEachRemaining method.

Annotations
@Override