com.sun.faces.renderkit.html_basic

Class MenuRenderer

java.lang.Object

jakarta.faces.render.Renderer

com.sun.faces.renderkit.html_basic.HtmlBasicRenderer

com.sun.faces.renderkit.html_basic.HtmlBasicInputRenderer

com.sun.faces.renderkit.html_basic.MenuRenderer

Direct Known Subclasses:

ListboxRenderer, SelectManyCheckboxListRenderer

public class MenuRenderer
extends HtmlBasicInputRenderer

MenuRenderer is a class that renders the current value of UISelectOne or UISelectMany component as a list of menu options.

Nested Class Summary

Nested classes/interfaces inherited from class com.sun.faces.renderkit.html_basic.HtmlBasicRenderer

HtmlBasicRenderer.OptionComponentInfo, HtmlBasicRenderer.Param

Field Summary

Fields inherited from class com.sun.faces.renderkit.html_basic.HtmlBasicRenderer

EMPTY_PARAMS, logger

Fields inherited from class jakarta.faces.render.Renderer

PASSTHROUGH_RENDERER_LOCALNAME_KEY

Constructor Summary

Constructors

Constructor and Description
MenuRenderer()

Method Summary

Modifier and Type	Method and Description
protected Collection<Object>	bestGuess(Class<? extends Collection<Object>> type, int initialSize)
protected Collection<Object>	cloneValue(Object value) Utility method to invoke the the clone method on the provided value.
protected Object	coerceToModelType(jakarta.faces.context.FacesContext ctx, Object value, Class<?> itemValueType)
protected boolean	containsaValue(Object valueArray)
Object	convertSelectManyValue(jakarta.faces.context.FacesContext context, jakarta.faces.component.UISelectMany uiSelectMany, String[] newValues)
protected Object	convertSelectManyValuesForArray(jakarta.faces.context.FacesContext context, jakarta.faces.component.UISelectMany uiSelectMany, Class<?> elementType, String[] newValues)
protected Collection<Object>	convertSelectManyValuesForCollection(jakarta.faces.context.FacesContext context, jakarta.faces.component.UISelectMany uiSelectMany, Class<? extends Collection<Object>> collectionType, String[] newValues)
protected Object	convertSelectManyValuesForModel(jakarta.faces.context.FacesContext context, jakarta.faces.component.UISelectMany uiSelectMany, Class<?> modelType, String[] newValues)
Object	convertSelectOneValue(jakarta.faces.context.FacesContext context, jakarta.faces.component.UISelectOne uiSelectOne, String newValue)
protected Collection<Object>	createCollection(Collection<Object> collection, Class<? extends Collection<Object>> fallBackType)
protected Collection<Object>	createCollectionFromHint(Object collectionTypeHint) Create a collection from the provided hint.
void	decode(jakarta.faces.context.FacesContext context, jakarta.faces.component.UIComponent component) Decode any new state of the specified UIComponent from the request contained in the specified FacesContext, and store that state on the UIComponent.
void	encodeBegin(jakarta.faces.context.FacesContext context, jakarta.faces.component.UIComponent component) Render the beginning specified UIComponent to the output stream or writer associated with the response we are creating.
void	encodeEnd(jakarta.faces.context.FacesContext context, jakarta.faces.component.UIComponent component) Render the ending of the current state of the specified UIComponent, following the rules described for encodeBegin() to acquire the appropriate value to be rendered.
Object	getConvertedValue(jakarta.faces.context.FacesContext context, jakarta.faces.component.UIComponent component, Object submittedValue) Attempt to convert previously stored state information into an object of the type required for this component (optionally using the registered Converter for this component, if there is one).
protected Object	getCurrentSelectedValues(jakarta.faces.component.UIComponent component)
protected String	getMultipleText(jakarta.faces.component.UIComponent component)
protected Object[]	getSubmittedSelectedValues(jakarta.faces.component.UIComponent component)
protected static boolean	isHideNoSelection(jakarta.faces.component.UIComponent component)
protected boolean	isSelected(jakarta.faces.context.FacesContext context, jakarta.faces.component.UIComponent component, Object itemValue, Object valueArray, jakarta.faces.convert.Converter<?> converter)
protected boolean	renderOption(jakarta.faces.context.FacesContext context, jakarta.faces.component.UIComponent component, jakarta.faces.component.UIComponent selectComponent, jakarta.faces.convert.Converter<?> converter, jakarta.faces.model.SelectItem curItem, Object currentSelections, Object[] submittedValues, HtmlBasicRenderer.OptionComponentInfo optionInfo)
protected int	renderOptions(jakarta.faces.context.FacesContext context, jakarta.faces.component.UIComponent component, SelectItemsIterator<jakarta.faces.model.SelectItem> items)
protected void	renderSelect(jakarta.faces.context.FacesContext context, jakarta.faces.component.UIComponent component)
protected void	writeDefaultSize(jakarta.faces.context.ResponseWriter writer, int itemCount)

Methods inherited from class com.sun.faces.renderkit.html_basic.HtmlBasicInputRenderer

getNonOnChangeBehaviors, getNonOnClickSelectBehaviors, getValue, setSubmittedValue

Methods inherited from class com.sun.faces.renderkit.html_basic.HtmlBasicRenderer

augmentIdReference, convertClientId, decodeBehaviors, encodeRecursive, getBehaviorParameters, getChildren, getCurrentValue, getEndTextToRender, getFacet, getForComponent, getFormattedValue, getFormattedValue, getMessageIter, getParamList, getPassThruBehaviors, getRendersChildren, isBehaviorSource, rendererParamsNotNull, shouldDecode, shouldEncode, shouldEncodeChildren, shouldWriteIdAttribute, writeIdAttributeIfNecessary

Methods inherited from class jakarta.faces.render.Renderer

encodeChildren

Methods inherited from class java.lang.Object

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

Constructor Detail

MenuRenderer

public MenuRenderer()

Method Detail

convertSelectManyValue

public Object convertSelectManyValue(jakarta.faces.context.FacesContext context,
                                     jakarta.faces.component.UISelectMany uiSelectMany,
                                     String[] newValues)
                              throws jakarta.faces.convert.ConverterException

Throws:

jakarta.faces.convert.ConverterException

convertSelectOneValue

public Object convertSelectOneValue(jakarta.faces.context.FacesContext context,
                                    jakarta.faces.component.UISelectOne uiSelectOne,
                                    String newValue)
                             throws jakarta.faces.convert.ConverterException

Throws:

jakarta.faces.convert.ConverterException

decode

public void decode(jakarta.faces.context.FacesContext context,
                   jakarta.faces.component.UIComponent component)

Description copied from class: jakarta.faces.render.Renderer

Decode any new state of the specified UIComponent from the request contained in the specified FacesContext, and store that state on the UIComponent.

During decoding, events may be enqueued for later processing (by event listeners that have registered an interest), by calling queueEvent() on the associated UIComponent.

Overrides:

decode in class HtmlBasicRenderer

Parameters:

context - FacesContext for the request we are processing

component - UIComponent to be decoded.

encodeBegin

public void encodeBegin(jakarta.faces.context.FacesContext context,
                        jakarta.faces.component.UIComponent component)
                 throws IOException

Description copied from class: jakarta.faces.render.Renderer

Render the beginning specified UIComponent to the output stream or writer associated with the response we are creating. If the conversion attempted in a previous call to getConvertedValue() for this component failed, the state information saved during execution of decode() should be used to reproduce the incorrect input.

Overrides:

encodeBegin in class jakarta.faces.render.Renderer

Parameters:

context - FacesContext for the request we are processing

component - UIComponent to be rendered

Throws:

IOException - if an input/output error occurs while rendering

encodeEnd

public void encodeEnd(jakarta.faces.context.FacesContext context,
                      jakarta.faces.component.UIComponent component)
               throws IOException

Description copied from class: jakarta.faces.render.Renderer

Render the ending of the current state of the specified UIComponent, following the rules described for encodeBegin() to acquire the appropriate value to be rendered.

Overrides:

encodeEnd in class HtmlBasicRenderer

Parameters:

context - FacesContext for the response we are creating

component - UIComponent to be rendered

Throws:

IOException - if an input/output error occurs while rendering

getConvertedValue

public Object getConvertedValue(jakarta.faces.context.FacesContext context,
                                jakarta.faces.component.UIComponent component,
                                Object submittedValue)
                         throws jakarta.faces.convert.ConverterException

Description copied from class: jakarta.faces.render.Renderer

Attempt to convert previously stored state information into an object of the type required for this component (optionally using the registered Converter for this component, if there is one). If conversion is successful, the new value should be returned from this method; if not, a ConverterException should be thrown.

Overrides:

getConvertedValue in class HtmlBasicInputRenderer

Parameters:

context - FacesContext for the request we are processing

component - UIComponent to be decoded.

submittedValue - a value stored on the component during decode.

Returns:

the converted value

Throws:

jakarta.faces.convert.ConverterException - if the submitted value cannot be converted successfully.

convertSelectManyValuesForModel

protected Object convertSelectManyValuesForModel(jakarta.faces.context.FacesContext context,
                                                 jakarta.faces.component.UISelectMany uiSelectMany,
                                                 Class<?> modelType,
                                                 String[] newValues)

convertSelectManyValuesForArray

protected Object convertSelectManyValuesForArray(jakarta.faces.context.FacesContext context,
                                                 jakarta.faces.component.UISelectMany uiSelectMany,
                                                 Class<?> elementType,
                                                 String[] newValues)
                                          throws jakarta.faces.convert.ConverterException

Throws:

jakarta.faces.convert.ConverterException

convertSelectManyValuesForCollection

protected Collection<Object> convertSelectManyValuesForCollection(jakarta.faces.context.FacesContext context,
                                                                  jakarta.faces.component.UISelectMany uiSelectMany,
                                                                  Class<? extends Collection<Object>> collectionType,
                                                                  String[] newValues)

renderOption

protected boolean renderOption(jakarta.faces.context.FacesContext context,
                               jakarta.faces.component.UIComponent component,
                               jakarta.faces.component.UIComponent selectComponent,
                               jakarta.faces.convert.Converter<?> converter,
                               jakarta.faces.model.SelectItem curItem,
                               Object currentSelections,
                               Object[] submittedValues,
                               HtmlBasicRenderer.OptionComponentInfo optionInfo)
                        throws IOException

Throws:

IOException

writeDefaultSize

protected void writeDefaultSize(jakarta.faces.context.ResponseWriter writer,
                                int itemCount)
                         throws IOException

Throws:

IOException

containsaValue

protected boolean containsaValue(Object valueArray)

getCurrentSelectedValues

protected Object getCurrentSelectedValues(jakarta.faces.component.UIComponent component)

getMultipleText

protected String getMultipleText(jakarta.faces.component.UIComponent component)

getSubmittedSelectedValues

protected Object[] getSubmittedSelectedValues(jakarta.faces.component.UIComponent component)

isSelected

protected boolean isSelected(jakarta.faces.context.FacesContext context,
                             jakarta.faces.component.UIComponent component,
                             Object itemValue,
                             Object valueArray,
                             jakarta.faces.convert.Converter<?> converter)

renderOptions

protected int renderOptions(jakarta.faces.context.FacesContext context,
                            jakarta.faces.component.UIComponent component,
                            SelectItemsIterator<jakarta.faces.model.SelectItem> items)
                     throws IOException

Throws:

IOException

renderSelect

protected void renderSelect(jakarta.faces.context.FacesContext context,
                            jakarta.faces.component.UIComponent component)
                     throws IOException

Throws:

IOException

coerceToModelType

protected Object coerceToModelType(jakarta.faces.context.FacesContext ctx,
                                   Object value,
                                   Class<?> itemValueType)

createCollection

protected Collection<Object> createCollection(Collection<Object> collection,
                                              Class<? extends Collection<Object>> fallBackType)

Parameters:

collection - a Collection instance

Returns:

a new Collection instance or null if the instance cannot be created

cloneValue

protected Collection<Object> cloneValue(Object value)

Utility method to invoke the the clone method on the provided value.

Parameters:

value - the value to clone

Returns:

the result of invoking clone() or null if the value could not be cloned or does not implement the Cloneable interface

bestGuess

protected Collection<Object> bestGuess(Class<? extends Collection<Object>> type,
                                       int initialSize)

Parameters:

type - the target model type

initialSize - the initial size of the Collection

Returns:

a Collection instance that best matches type

createCollectionFromHint

protected Collection<Object> createCollectionFromHint(Object collectionTypeHint)

Create a collection from the provided hint.

Parameters:

collectionTypeHint - the Collection type as either a String or Class

Returns:

a new Collection instance

isHideNoSelection

protected static boolean isHideNoSelection(jakarta.faces.component.UIComponent component)