com.sun.faces.el

Class ELUtils

java.lang.Object

com.sun.faces.el.ELUtils

public class ELUtils
extends Object

Utility class for EL related methods.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ELUtils.Scope

Field Summary

Fields

Modifier and Type	Field and Description
static jakarta.el.ArrayELResolver	ARRAY_RESOLVER
static jakarta.el.BeanELResolver	BEAN_RESOLVER
static jakarta.el.ResourceBundleELResolver	BUNDLE_RESOLVER
static CompositeComponentAttributesELResolver	COMPOSITE_COMPONENT_ATTRIBUTES_EL_RESOLVER
static FacesResourceBundleELResolver	FACES_BUNDLE_RESOLVER
static FlashELResolver	FLASH_RESOLVER
static ImplicitObjectELResolverForJsp	IMPLICIT_JSP_RESOLVER
static ImplicitObjectELResolver	IMPLICIT_RESOLVER
static jakarta.el.ListELResolver	LIST_RESOLVER
static ManagedBeanELResolver	MANAGED_BEAN_RESOLVER
static jakarta.el.MapELResolver	MAP_RESOLVER
static ResourceELResolver	RESOURCE_RESOLVER
static ScopedAttributeELResolver	SCOPED_RESOLVER

Method Summary

Modifier and Type	Method and Description
static void	buildFacesResolver(FacesCompositeELResolver composite, ApplicationAssociate associate) Create the ELResolver chain for programmatic EL calls.
static void	buildJSPResolver(FacesCompositeELResolver composite, ApplicationAssociate associate) Create the ELResolver chain for JSP.
static Object	coerce(Object value, Class<?> toType)
static jakarta.el.ValueExpression	createValueExpression(String expression) Create a ValueExpression with the expected type of Object.class
static jakarta.el.ValueExpression	createValueExpression(String expression, Class<?> expectedType)
static Object	evaluateValueExpression(jakarta.el.ValueExpression expression, jakarta.el.ELContext elContext)
static jakarta.el.ExpressionFactory	getDefaultExpressionFactory(ApplicationAssociate associate, jakarta.faces.context.FacesContext facesContext)
static jakarta.el.ExpressionFactory	getDefaultExpressionFactory(jakarta.faces.context.FacesContext facesContext)
static jakarta.faces.el.PropertyResolver	getDelegatePR(ApplicationAssociate associate, boolean provideDefault)
static jakarta.faces.el.VariableResolver	getDelegateVR(ApplicationAssociate associate, boolean provideDefault)
static List<String>	getExpressionsFromString(String expressionString)
static ELUtils.Scope	getNarrowestScopeFromExpression(String expression)
static ELUtils.Scope	getScope(String scope)
static ELUtils.Scope	getScope(String valueBinding, String[] outString) This method is used by the ManagedBeanFactory to ensure that properties set by an expression point to an object with an accepted lifespan.
static ELUtils.Scope	getScopeForExpression(String expression)
static ELUtils.Scope	getScopeForSingleExpression(String value)
static boolean	hasValidLifespan(ELUtils.Scope expressionScope, ELUtils.Scope beanScope)
static boolean	isCompositeComponentExpr(String expression)
static boolean	isCompositeComponentLookupWithArgs(String expression)
static boolean	isCompositeComponentMethodExprLookup(String expression)
static boolean	isScopeValid(String scopeName)

Methods inherited from class java.lang.Object

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

Field Detail

ARRAY_RESOLVER

public static final jakarta.el.ArrayELResolver ARRAY_RESOLVER

BEAN_RESOLVER

public static final jakarta.el.BeanELResolver BEAN_RESOLVER

FACES_BUNDLE_RESOLVER

public static final FacesResourceBundleELResolver FACES_BUNDLE_RESOLVER

IMPLICIT_JSP_RESOLVER

public static final ImplicitObjectELResolverForJsp IMPLICIT_JSP_RESOLVER

IMPLICIT_RESOLVER

public static final ImplicitObjectELResolver IMPLICIT_RESOLVER

FLASH_RESOLVER

public static final FlashELResolver FLASH_RESOLVER

LIST_RESOLVER

public static final jakarta.el.ListELResolver LIST_RESOLVER

MANAGED_BEAN_RESOLVER

public static final ManagedBeanELResolver MANAGED_BEAN_RESOLVER

MAP_RESOLVER

public static final jakarta.el.MapELResolver MAP_RESOLVER

BUNDLE_RESOLVER

public static final jakarta.el.ResourceBundleELResolver BUNDLE_RESOLVER

SCOPED_RESOLVER

public static final ScopedAttributeELResolver SCOPED_RESOLVER

RESOURCE_RESOLVER

public static final ResourceELResolver RESOURCE_RESOLVER

COMPOSITE_COMPONENT_ATTRIBUTES_EL_RESOLVER

public static final CompositeComponentAttributesELResolver COMPOSITE_COMPONENT_ATTRIBUTES_EL_RESOLVER

Method Detail

isCompositeComponentExpr

public static boolean isCompositeComponentExpr(String expression)

isCompositeComponentMethodExprLookup

public static boolean isCompositeComponentMethodExprLookup(String expression)

isCompositeComponentLookupWithArgs

public static boolean isCompositeComponentLookupWithArgs(String expression)

buildFacesResolver

public static void buildFacesResolver(FacesCompositeELResolver composite,
                                      ApplicationAssociate associate)

Create the ELResolver chain for programmatic EL calls.

Parameters:

composite - a CompositeELResolver

associate - our ApplicationAssociate

buildJSPResolver

public static void buildJSPResolver(FacesCompositeELResolver composite,
                                    ApplicationAssociate associate)

Create the ELResolver chain for JSP.

Parameters:

composite - a CompositeELResolver

associate - our ApplicationAssociate

evaluateValueExpression

public static Object evaluateValueExpression(jakarta.el.ValueExpression expression,
                                             jakarta.el.ELContext elContext)

getDelegatePR

public static jakarta.faces.el.PropertyResolver getDelegatePR(ApplicationAssociate associate,
                                                              boolean provideDefault)

Parameters:

associate - the ApplicationAssociate

provideDefault - whether or not to return a DummpyPropertyResolverImpl

Returns:

the PropertyResolvers set via Application.setPropertyResolver(jakarta.faces.el.PropertyResolver) or, if that is null, return the PropertyResolver chain from the parsed configuration resources. If either of those are null, and provideDefault is true, return the DummyPropertyResolverImpl.

getDelegateVR

public static jakarta.faces.el.VariableResolver getDelegateVR(ApplicationAssociate associate,
                                                              boolean provideDefault)

Parameters:

associate - the ApplicationAssociate

provideDefault - whether or not to return a DummpyPropertyResolverImpl

Returns:

the VariableResolvers set via Application.setVariableResolver(jakarta.faces.el.VariableResolver) or, if that is null, return the VariableResolver chain from the parsed configuration resources. If either of those are null, , and provideDefault is true, return the ChainAwareVariableResolver.

getExpressionsFromString

public static List<String> getExpressionsFromString(String expressionString)
                                             throws jakarta.faces.el.ReferenceSyntaxException

Parameters:

expressionString - the expression string, with delimiters intact.

Returns:

a List of expressions from the expressionString

Throws:

jakarta.faces.el.ReferenceSyntaxException - if the expression string is invalid

getScope

public static ELUtils.Scope getScope(String valueBinding,
                                     String[] outString)
                              throws jakarta.faces.el.ReferenceSyntaxException

This method is used by the ManagedBeanFactory to ensure that properties set by an expression point to an object with an accepted lifespan.

get the scope of the expression. Return null if it isn't scoped

For example, the expression: sessionScope.TestBean.one should return "session" as the scope.

Parameters:

valueBinding - the expression

outString - an allocated String Array into which we put the first segment.

Returns:

the scope of the expression

Throws:

jakarta.faces.el.ReferenceSyntaxException - if valueBinding is syntactically invalid

createValueExpression

public static jakarta.el.ValueExpression createValueExpression(String expression)

Create a ValueExpression with the expected type of Object.class

Parameters:

expression - an EL expression

Returns:

a new ValueExpression instance based off the provided valueRef

createValueExpression

public static jakarta.el.ValueExpression createValueExpression(String expression,
                                                               Class<?> expectedType)

coerce

public static Object coerce(Object value,
                            Class<?> toType)

getScope

public static ELUtils.Scope getScope(String scope)

getScopeForExpression

public static ELUtils.Scope getScopeForExpression(String expression)

hasValidLifespan

public static boolean hasValidLifespan(ELUtils.Scope expressionScope,
                                       ELUtils.Scope beanScope)
                                throws jakarta.faces.el.EvaluationException

Throws:

jakarta.faces.el.EvaluationException

getScopeForSingleExpression

public static ELUtils.Scope getScopeForSingleExpression(String value)
                                                 throws jakarta.faces.el.EvaluationException

Throws:

jakarta.faces.el.EvaluationException

getNarrowestScopeFromExpression

public static ELUtils.Scope getNarrowestScopeFromExpression(String expression)
                                                     throws jakarta.faces.el.ReferenceSyntaxException

Throws:

jakarta.faces.el.ReferenceSyntaxException

isScopeValid

public static boolean isScopeValid(String scopeName)

getDefaultExpressionFactory

public static jakarta.el.ExpressionFactory getDefaultExpressionFactory(jakarta.faces.context.FacesContext facesContext)

getDefaultExpressionFactory

public static jakarta.el.ExpressionFactory getDefaultExpressionFactory(ApplicationAssociate associate,
                                                                       jakarta.faces.context.FacesContext facesContext)