Module jakarta.faces

Package com.sun.faces.el

Class DemuxCompositeELResolver

java.lang.Object

jakarta.el.ELResolver

jakarta.el.CompositeELResolver

com.sun.faces.el.FacesCompositeELResolver

com.sun.faces.el.DemuxCompositeELResolver

public class DemuxCompositeELResolver
extends FacesCompositeELResolver

Maintains an ordered composite list of child ELResolver for Faces.

Nested Class Summary

Nested classes/interfaces inherited from class com.sun.faces.el.FacesCompositeELResolver

FacesCompositeELResolver.ELResolverChainType

Constructor Summary

Constructors

Constructor	Description
DemuxCompositeELResolver(FacesCompositeELResolver.ELResolverChainType chainType)

Method Summary

Modifier and Type	Method	Description
void	_addPropertyELResolver(ELResolver elResolver)
void	add(ELResolver elResolver)	Adds the given resolver to the list of component resolvers.
void	addPropertyELResolver(ELResolver elResolver)
void	addRootELResolver(ELResolver elResolver)
FacesCompositeELResolver.ELResolverChainType	getChainType()
Class<?>	getCommonPropertyType(ELContext context, Object base)	Returns the most general type that this resolver accepts for the property argument, given a base object.
Class<?>	getType(ELContext context, Object base, Object property)	For a given base and property, attempts to identify the most general type that is acceptable for an object to be passed as the value parameter in a future call to the CompositeELResolver.setValue(jakarta.el.ELContext, java.lang.Object, java.lang.Object, java.lang.Object) method.
Object	getValue(ELContext context, Object base, Object property)	Attempts to resolve the given property object on the given base object by querying all component resolvers.
boolean	isReadOnly(ELContext context, Object base, Object property)	For a given base and property, attempts to determine whether a call to CompositeELResolver.setValue(jakarta.el.ELContext, java.lang.Object, java.lang.Object, java.lang.Object) will always fail.
void	setValue(ELContext context, Object base, Object property, Object val)	Attempts to set the value of the given property object on the given base object.

Methods inherited from class jakarta.el.CompositeELResolver

convertToType, invoke

Methods inherited from class java.lang.Object

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

Constructor Details

DemuxCompositeELResolver

public DemuxCompositeELResolver(FacesCompositeELResolver.ELResolverChainType chainType)

Method Details

getChainType

public FacesCompositeELResolver.ELResolverChainType getChainType()

Specified by:

getChainType in class FacesCompositeELResolver

_addPropertyELResolver

public void _addPropertyELResolver(ELResolver elResolver)

addRootELResolver

public void addRootELResolver(ELResolver elResolver)

Specified by:

addRootELResolver in class FacesCompositeELResolver

addPropertyELResolver

public void addPropertyELResolver(ELResolver elResolver)

Specified by:

addPropertyELResolver in class FacesCompositeELResolver

add

public void add(ELResolver elResolver)

Description copied from class: CompositeELResolver

Adds the given resolver to the list of component resolvers.

Resolvers are consulted in the order in which they are added.

Overrides:

add in class CompositeELResolver

Parameters:

elResolver - The component resolver to add.

getValue

public Object getValue(ELContext context,
 Object base,
 Object property)
                throws ELException

Description copied from class: CompositeELResolver

Attempts to resolve the given property object on the given base object by querying all component resolvers.

If this resolver handles the given (base, property) pair, the propertyResolved property of the ELContext object must be set to true by the resolver, before returning. If this property is not true after this method is called, the caller should ignore the return value.

First, propertyResolved is set to false on the provided ELContext.

Next, for each component resolver in this composite:

1. The getValue() method is called, passing in the provided context, base and property.
2. If the ELContext's propertyResolved flag is false then iteration continues.
3. Otherwise, iteration stops and no more component resolvers are considered. The value returned by getValue() is returned by this method.

If none of the component resolvers were able to perform this operation, the value null is returned and the propertyResolved flag remains set to false.

Any exception thrown by component resolvers during the iteration is propagated to the caller of this method.

Overrides:

getValue in class CompositeELResolver

Parameters:

context - The context of this evaluation.

base - The base object whose property value is to be returned, or null to resolve a top-level variable.

property - The property or variable to be resolved.

Returns:

If the propertyResolved property of ELContext was set to true, then the result of the variable or property resolution; otherwise undefined.

Throws:

ELException - if an exception was thrown while performing the property or variable resolution. The thrown exception must be included as the cause property of this exception, if available.

getType

public Class<?> getType(ELContext context,
 Object base,
 Object property)
                 throws ELException

Description copied from class: CompositeELResolver

For a given base and property, attempts to identify the most general type that is acceptable for an object to be passed as the value parameter in a future call to the CompositeELResolver.setValue(jakarta.el.ELContext, java.lang.Object, java.lang.Object, java.lang.Object) method. The result is obtained by querying all component resolvers.

If this resolver handles the given (base, property) pair, the propertyResolved property of the ELContext object must be set to true by the resolver, before returning. If this property is not true after this method is called, the caller should ignore the return value.

First, propertyResolved is set to false on the provided ELContext.

Next, for each component resolver in this composite:

1. The getType() method is called, passing in the provided context, base and property.
2. If the ELContext's propertyResolved flag is false then iteration continues.
3. Otherwise, iteration stops and no more component resolvers are considered. The value returned by getType() is returned by this method.

If none of the component resolvers were able to perform this operation, the value null is returned and the propertyResolved flag remains set to false.

Any exception thrown by component resolvers during the iteration is propagated to the caller of this method.

Overrides:

getType in class CompositeELResolver

Parameters:

context - The context of this evaluation.

base - The base object whose property value is to be analyzed, or null to analyze a top-level variable.

property - The property or variable to return the acceptable type for.

Returns:

If the propertyResolved property of ELContext was set to true, then the most general acceptable type which must be null if the either the property or the resolver is read-only; otherwise undefined

Throws:

ELException - if an exception was thrown while performing the property or variable resolution. The thrown exception must be included as the cause property of this exception, if available.

setValue

public void setValue(ELContext context,
 Object base,
 Object property,
 Object val)
              throws ELException

Description copied from class: CompositeELResolver

Attempts to set the value of the given property object on the given base object. All component resolvers are asked to attempt to set the value.

If this resolver handles the given (base, property) pair, the propertyResolved property of the ELContext object must be set to true by the resolver, before returning. If this property is not true after this method is called, the caller can safely assume no value has been set.

First, propertyResolved is set to false on the provided ELContext.

Next, for each component resolver in this composite:

1. The setValue() method is called, passing in the provided context, base, property and value.
2. If the ELContext's propertyResolved flag is false then iteration continues.
3. Otherwise, iteration stops and no more component resolvers are considered.

If none of the component resolvers were able to perform this operation, the propertyResolved flag remains set to false.

Any exception thrown by component resolvers during the iteration is propagated to the caller of this method.

Overrides:

setValue in class CompositeELResolver

Parameters:

context - The context of this evaluation.

base - The base object whose property value is to be set, or null to set a top-level variable.

property - The property or variable to be set.

val - The value to set the property or variable to.

Throws:

ELException - if an exception was thrown while attempting to set the property or variable. The thrown exception must be included as the cause property of this exception, if available.

isReadOnly

public boolean isReadOnly(ELContext context,
 Object base,
 Object property)
                   throws ELException

Description copied from class: CompositeELResolver

For a given base and property, attempts to determine whether a call to CompositeELResolver.setValue(jakarta.el.ELContext, java.lang.Object, java.lang.Object, java.lang.Object) will always fail. The result is obtained by querying all component resolvers.

If this resolver handles the given (base, property) pair, the propertyResolved property of the ELContext object must be set to true by the resolver, before returning. If this property is not true after this method is called, the caller should ignore the return value.

First, propertyResolved is set to false on the provided ELContext.

Next, for each component resolver in this composite:

1. The isReadOnly() method is called, passing in the provided context, base and property.
2. If the ELContext's propertyResolved flag is false then iteration continues.
3. Otherwise, iteration stops and no more component resolvers are considered. The value returned by isReadOnly() is returned by this method.

If none of the component resolvers were able to perform this operation, the value false is returned and the propertyResolved flag remains set to false

.

Any exception thrown by component resolvers during the iteration is propagated to the caller of this method.

Overrides:

isReadOnly in class CompositeELResolver

Parameters:

context - The context of this evaluation.

base - The base object whose property value is to be analyzed, or null to analyze a top-level variable.

property - The property or variable to return the read-only status for.

Returns:

If the propertyResolved property of ELContext was set to true, then true if the property is read-only or false if not; otherwise undefined.

Throws:

ELException - if an exception was thrown while performing the property or variable resolution. The thrown exception must be included as the cause property of this exception, if available.

getCommonPropertyType

public Class<?> getCommonPropertyType(ELContext context,
 Object base)

Description copied from class: CompositeELResolver

Returns the most general type that this resolver accepts for the property argument, given a base object. One use for this method is to assist tools in auto-completion. The result is obtained by querying all component resolvers.

The Class returned is the most specific class that is a common superclass of all the classes returned by each component resolver's getCommonPropertyType method. If null is returned by a resolver, it is skipped.

Overrides:

getCommonPropertyType in class CompositeELResolver

Parameters:

context - The context of this evaluation.

base - The base object to return the most general property type for, or null to enumerate the set of top-level variables that this resolver can evaluate.

Returns:

null if this ELResolver does not know how to handle the given base object; otherwise Object.class if any type of property is accepted; otherwise the most general property type accepted for the given base.