- java.lang.Object
-
- javax.servlet.jsp.el.ExpressionEvaluator
-
Deprecated.As of JSP 2.1, replaced by
ExpressionFactory
public abstract class ExpressionEvaluator extends Object
The abstract base class for an expression-language evaluator. Classes that implement an expression language expose their functionality via this abstract class.
An instance of the ExpressionEvaluator can be obtained via the JspContext / PageContext
The parseExpression() and evaluate() methods must be thread-safe. That is, multiple threads may call these methods on the same ExpressionEvaluator object simultaneously. Implementations should synchronize access if they depend on transient state. Implementations should not, however, assume that only one object of each ExpressionEvaluator type will be instantiated; global caching should therefore be static.
Only a single EL expression, starting with '${' and ending with '}', can be parsed or evaluated at a time. EL expressions cannot be mixed with static text. For example, attempting to parse or evaluate "
abc${1+1}def${1+1}ghi
" or even "${1+1}${1+1}
" will cause anELException
to be thrown.The following are examples of syntactically legal EL expressions:
${person.lastName}
${8 * 8}
${my:reverse('hello')}
- Since:
- JSP 2.0
-
-
Constructor Summary
Constructors Constructor and Description ExpressionEvaluator()
Deprecated.
-
Method Summary
All Methods Instance Methods Abstract Methods Deprecated Methods Modifier and Type Method and Description abstract Object
evaluate(String expression, Class expectedType, VariableResolver vResolver, FunctionMapper fMapper)
Deprecated.Evaluates an expression.abstract Expression
parseExpression(String expression, Class expectedType, FunctionMapper fMapper)
Deprecated.Prepare an expression for later evaluation.
-
-
-
Method Detail
-
parseExpression
public abstract Expression parseExpression(String expression, Class expectedType, FunctionMapper fMapper) throws ELException
Deprecated.Prepare an expression for later evaluation. This method should perform syntactic validation of the expression; if in doing so it detects errors, it should raise an ELParseException.- Parameters:
expression
- The expression to be evaluated.expectedType
- The expected type of the result of the evaluationfMapper
- A FunctionMapper to resolve functions found in the expression. It can be null, in which case no functions are supported for this invocation. The ExpressionEvaluator must not hold on to the FunctionMapper reference after returning fromparseExpression()
. TheExpression
object returned must invoke the same functions regardless of whether the mappings in the providedFunctionMapper
instance change between callingExpressionEvaluator.parseExpression()
andExpression.evaluate()
.- Returns:
- The Expression object encapsulating the arguments.
- Throws:
ELException
- Thrown if parsing errors were found.
-
evaluate
public abstract Object evaluate(String expression, Class expectedType, VariableResolver vResolver, FunctionMapper fMapper) throws ELException
Deprecated.Evaluates an expression. This method may perform some syntactic validation and, if so, it should raise an ELParseException error if it encounters syntactic errors. EL evaluation errors should cause an ELException to be raised.- Parameters:
expression
- The expression to be evaluated.expectedType
- The expected type of the result of the evaluationvResolver
- A VariableResolver instance that can be used at runtime to resolve the name of implicit objects into Objects.fMapper
- A FunctionMapper to resolve functions found in the expression. It can be null, in which case no functions are supported for this invocation.- Returns:
- The result of the expression evaluation.
- Throws:
ELException
- Thrown if the expression evaluation failed.
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/08/2025 20:53:45 Cette version de la page est en cache (à la date du 21/08/2025 20:53:45) afin d'accélérer le traitement.Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la version plus récente de la page.
Document créé le 27/06/2008, dernière modification le 18/08/2025
Source du document imprimé : https://www.gaudry.be/java-api-javaee-rf-javax/servlet/jsp/el/ExpressionEvaluator.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.