com.sun.faces.facelets.el

Class ContextualCompositeValueExpression

java.lang.Object

javax.el.Expression

javax.el.ValueExpression

com.sun.faces.facelets.el.ContextualCompositeValueExpression

All Implemented Interfaces:

Serializable

public final class ContextualCompositeValueExpression
extends javax.el.ValueExpression

This specialized ValueExpression enables the evaluation of composite component expressions. Instances of this expression will be created when TagAttributeImpl.getValueExpression(javax.faces.view.facelets.FaceletContext, Class) is invoked and the expression represents a composite component expression (i.e. #{cc.[properties]}).

It's important to note that these ValueExpressions are context sensitive in that they leverage the location in which they were referenced in order to push the proper composite component to the evaluation context prior to evaluating the expression itself.

Here's an example:

 Using Page test.xhtml
 ---------------------------------
    <ez:comp1 greeting="Hello!" />


 comp1.xhtml
 ---------------------------------
 <composite:interface>
    <composite:attribute name="greeting" type="java.lang.String" required="true" />
 </composite:interface>
 <composite:implementation>
    <ez:nesting>
       <h:outputText value="#{cc.attrs.greetings}" />
    </ez:nesting>
 </composite:implementation>

 nesting.xhtml
 ---------------------------------
 <composite:interface />
 <composite:implementation>
    <composite:insertChildren>
 </composite:implementation>
 

In the above example, there will be two composite components available to the runtime: ez:comp1 and ez:nesting.

When <h:outputText value="#{cc.attrs.greeting}" />, prior to attempting to evaluate the expression, the Location object will be used to find the composite component that 'owns' the template in which the expression was defined in by comparing the path of the Location with the name and library of the Resource instance associated with each composite component. If a matching composite component is found, it will be made available to the EL by calling CompositeComponentStackManager.push(javax.faces.component.UIComponent).

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ContextualCompositeValueExpression()
ContextualCompositeValueExpression(javax.faces.view.Location location, javax.el.ValueExpression originalVE)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
Class<?>	getExpectedType()
String	getExpressionString()
javax.faces.view.Location	getLocation()
Class<?>	getType(javax.el.ELContext elContext)
Object	getValue(javax.el.ELContext elContext)
int	hashCode()
boolean	isLiteralText()
boolean	isReadOnly(javax.el.ELContext elContext)
void	setValue(javax.el.ELContext elContext, Object o)
String	toString()

Methods inherited from class javax.el.ValueExpression

getValueReference

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ContextualCompositeValueExpression

public ContextualCompositeValueExpression()

ContextualCompositeValueExpression

public ContextualCompositeValueExpression(javax.faces.view.Location location,
                                          javax.el.ValueExpression originalVE)

Method Detail

getValue

public Object getValue(javax.el.ELContext elContext)

Specified by:

getValue in class javax.el.ValueExpression

setValue

public void setValue(javax.el.ELContext elContext,
                     Object o)

Specified by:

setValue in class javax.el.ValueExpression

isReadOnly

public boolean isReadOnly(javax.el.ELContext elContext)

Specified by:

isReadOnly in class javax.el.ValueExpression

getType

public Class<?> getType(javax.el.ELContext elContext)

Specified by:

getType in class javax.el.ValueExpression

getExpectedType

public Class<?> getExpectedType()

Specified by:

getExpectedType in class javax.el.ValueExpression

getExpressionString

public String getExpressionString()

Specified by:

getExpressionString in class javax.el.Expression

equals

public boolean equals(Object o)

Specified by:

equals in class javax.el.Expression

hashCode

public int hashCode()

Specified by:

hashCode in class javax.el.Expression

isLiteralText

public boolean isLiteralText()

Specified by:

isLiteralText in class javax.el.Expression

toString

public String toString()

Overrides:

toString in class Object

getLocation

public javax.faces.view.Location getLocation()

Returns:

the Location of this ValueExpression