ELProcessor

java.lang.Object
- javax.el.ELProcessor

```
public class ELProcessor
extends java.lang.Object
```
Provides an API for using Jakarta Expression Language in a stand-alone environment.
This class provides a direct and simple interface for
- Evaluating Jakarta Expression Language expressions.
- Assigning values to beans or setting a bean property.
- Setting a ValueExpression to a Jakarta Expression Language variable.
- Defining a static method as Jakarta Expression Language function.
- Defining an object instance as Jakarta Expression Language name.
This API is not a replacement for the APIs in Jakarta Expression Language 2.2. Containers that maintain Jakarta Expression Language environments can continue to do so, without using this API.
For Jakarta Expression Language users who want to manipulate Jakarta Expression Language environments, like adding custom ELResolvers, ELManager can be used.
Scope and Life Cycle

Since it maintains the state of the Jakarta Expression Language environments, ELProcessor is not thread safe. In the simplest case, an instance can be created and destroyed before and after evaluating Jakarta Expression Language expressions. A more general usage is to use an instance of ELProcessor for a session, so that the user can configure the Jakarta Expression Language evaluation environment for that session.

Automatic Bracketing of Expressions

A note about the Jakarta Expression Language expressions strings used in the class. The strings allowed in the methods getValue(java.lang.String, java.lang.Class<?>), setValue(java.lang.String, java.lang.Object), and setVariable(java.lang.String, java.lang.String) are limited to non-composite expressions, i.e. expressions of the form ${...} or #{...} only. Also, it is not necessary (in fact not allowed) to bracket the expression strings with ${ or #{ and } in these methods: they will be automatically bracketed. This reduces the visual cluster, without any lost of functionalities (thanks to the addition of the concatenation operator).
Example
The following code snippet illustrates the use of ELProcessor to define a bean and evaluate its property.
```
 ELProcessor elp = new ELProcessor();
 elp.defineBean("employee", new Employee("Charlie Brown"));
 String name = elp.eval("employee.name");
 
```
Since:

Jakarta Expression Language 3.0

Constructor Summary

Constructors
Constructor and Description

ELProcessor()

Constructors
Constructor and Description
`ELProcessor()`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`defineBean(java.lang.String name, java.lang.Object bean)` Define a bean in a local bean repository, hiding other beans of the same name.
`void`	`defineFunction(java.lang.String prefix, java.lang.String function, java.lang.reflect.Method method)` Define a Jakarta Expression Language function in the local function mapper.
`void`	`defineFunction(java.lang.String prefix, java.lang.String function, java.lang.String className, java.lang.String method)` Define a Jakarta Expression Language function in the local function mapper.
`java.lang.Object`	`eval(java.lang.String expression)` Evaluates an Jakarta Expression Language expression.
`ELManager`	`getELManager()` Return the ELManager used for Jakarta Expression Language processing.
`java.lang.Object`	`getValue(java.lang.String expression, java.lang.Class<?> expectedType)` Evaluates an Jakarta Expression Language expression, and coerces the result to the specified type.
`void`	`setValue(java.lang.String expression, java.lang.Object value)` Sets an expression with a new value.
`void`	`setVariable(java.lang.String var, java.lang.String expression)` Assign a Jakarta Expression Language expression to a Jakarta Expression Language variable.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ELProcessor
```
public ELProcessor()
```
- Method Detail
  - getELManager
```
public ELManager getELManager()
```
    Return the ELManager used for Jakarta Expression Language processing.
    
    Returns:
    
    The ELManager used for Jakarta Expression Language processing.
  - eval
```
public java.lang.Object eval(java.lang.String expression)
```
    Evaluates an Jakarta Expression Language expression.
    
    Parameters:
    
    expression - The Jakarta Expression Language expression to be evaluated.
    
    Returns:
    
    The result of the expression evaluation.
  - getValue
```
public java.lang.Object getValue(java.lang.String expression,
                                 java.lang.Class<?> expectedType)
```
    Evaluates an Jakarta Expression Language expression, and coerces the result to the specified type.
    
    Parameters:
    
    expression - The Jakarta Expression Language expression to be evaluated.
    
    expectedType - Specifies the type that the resultant evaluation will be coerced to.
    
    Returns:
    
    The result of the expression evaluation.
  - setValue
```
public void setValue(java.lang.String expression,
                     java.lang.Object value)
```
    Sets an expression with a new value. The target expression is evaluated, up to the last property resolution, and the resultant (base, property) pair is set to the provided value.
    
    Parameters:
    
    expression - The target expression
    
    value - The new value to set.
    
    Throws:
    
    PropertyNotFoundException - if one of the property resolutions failed because a specified variable or property does not exist or is not readable.
    
    PropertyNotWritableException - if the final variable or property resolution failed because the specified variable or property is not writable.
    
    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.
  - setVariable
```
public void setVariable(java.lang.String var,
                        java.lang.String expression)
```
    Assign a Jakarta Expression Language expression to a Jakarta Expression Language variable. The expression is parsed, but not evaluated, and the parsed expression is mapped to the Jakarta Expression Language variable in the local variable map. Any previously assigned expression to the same variable will be replaced. If the expression is null, the variable will be removed.
    
    Parameters:
    
    var - The name of the variable.
    
    expression - The Jakarta Expression Language expression to be assigned to the variable.
  - defineFunction
```
public void defineFunction(java.lang.String prefix,
                           java.lang.String function,
                           java.lang.String className,
                           java.lang.String method)
                    throws java.lang.ClassNotFoundException,
                           java.lang.NoSuchMethodException
```
    Define a Jakarta Expression Language function in the local function mapper.
    
    Parameters:
    
    prefix - The namespace for the function or "" for no namesapce.
    
    function - The name of the function. If empty (""), the method name is used as the function name.
    
    className - The full Java class name that implements the function.
    
    method - The name (specified without parenthesis) or the signature (as in the Java Language Spec) of the static method that implements the function. If the name (e.g. "sum") is given, the first declared method in class that matches the name is selected. If the signature (e.g. "int sum(int, int)" ) is given, then the declared method with the signature is selected.
    
    Throws:
    
    java.lang.NullPointerException - if any of the arguments is null.
    
    java.lang.ClassNotFoundException - if the specified class does not exists.
    
    java.lang.NoSuchMethodException - if the method (with or without the signature) is not a declared method of the class, or if the method signature is not valid, or if the method is not a static method.
  - defineFunction
```
public void defineFunction(java.lang.String prefix,
                           java.lang.String function,
                           java.lang.reflect.Method method)
                    throws java.lang.NoSuchMethodException
```
    Define a Jakarta Expression Language function in the local function mapper.
    
    Parameters:
    
    prefix - The namespace for the function or "" for no namesapce.
    
    function - The name of the function. If empty (""), the method name is used as the function name.
    
    method - The java.lang.reflect.Method instance of the method that implements the function.
    
    Throws:
    
    java.lang.NullPointerException - if any of the arguments is null.
    
    java.lang.NoSuchMethodException - if the method is not a static method
  - defineBean
```
public void defineBean(java.lang.String name,
                       java.lang.Object bean)
```
    Define a bean in a local bean repository, hiding other beans of the same name.
    
    Parameters:
    
    name - The name of the bean
    
    bean - The bean instance to be defined. If null, the name will be removed from the local bean repository.

Class ELProcessor

Scope and Life Cycle

Automatic Bracketing of Expressions

Example

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ELProcessor

Method Detail

getELManager

eval

getValue

setValue

setVariable

defineFunction

defineFunction

defineBean