javax.faces.el
Class MethodBinding

java.lang.Object
  |
  +--javax.faces.el.MethodBinding

public abstract class MethodBinding

extends java.lang.Object

MethodBinding is an object that can be used to call an arbitrary public method, on an instance that is acquired by evaluatng the leading portion of a method binding expression via a ValueBinding. An immutable MethodBinding for a particular method binding expression can be acquired by calling the createMethodBinding() method of the Application instance for this web application.

Constructor Summary

MethodBinding()

Method Summary

java.lang.String	getExpressionString() Return the (possibly null) expression String, with leading and trailing delimiters, from which this MethodBinding was built.
abstract java.lang.Class	getType(javax.faces.context.FacesContext context) Return the Java class representing the return type from the method identified by this method binding expression.
abstract java.lang.Object	invoke(javax.faces.context.FacesContext context, java.lang.Object[] params) Return the return value (if any) resulting from a call to the method identified by this method binding expression, passing it the specified parameters, relative to the specified FacesContext.

Methods inherited from class java.lang.Object

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

Constructor Detail

MethodBinding

public MethodBinding()

Method Detail

invoke

public abstract java.lang.Object invoke(javax.faces.context.FacesContext context,
                                        java.lang.Object[] params)
                                 throws EvaluationException,
                                        MethodNotFoundException

Return the return value (if any) resulting from a call to the method identified by this method binding expression, passing it the specified parameters, relative to the specified FacesContext.

Parameters:

context - FacesContext for the current request

params - Array of parameters to be passed to the called method, or null for no parameters

Throws:

EvaluationException - if an exception is thrown by the called method (the thrown exception must be included as the cause property of this exception)

MethodNotFoundException - if no suitable method can be found

java.lang.NullPointerException - if context is null

getType

public abstract java.lang.Class getType(javax.faces.context.FacesContext context)
                                 throws MethodNotFoundException

Return the Java class representing the return type from the method identified by this method binding expression. If the identified method has a return type of void, return null instead.

Parameters:

context - FacesContext for the current request

Throws:

MethodNotFoundException - if no suitable method can be found

java.lang.NullPointerException - if context is null

getExpressionString

public java.lang.String getExpressionString()

Return the (possibly null) expression String, with leading and trailing delimiters, from which this MethodBinding was built. The default implementation returns null.