Eval (RestReplay 1.0.27 API)

java.lang.Object
- org.dynamide.interpreters.Eval

```
public class Eval
extends Object
```
Eval evaluates strings containing Jexl2 expressions bound within braces: ${expression1} some text ${expression2} If you pass a single expression, with its braces, the result will be the result object from the Jexl engine, for example eval'ing ${['a','b']} will return a Java array of String. If you pass several expressions, the result object's toString() results will be concatenated along with other plain text in the input String.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class Eval.MapContextWKeys

static class Eval.MyVar

Nested Classes
Modifier and Type	Class and Description
`static class`	`Eval.MapContextWKeys`
`static class`	`Eval.MyVar`

Field Summary

Fields
Modifier and Type	Field and Description
`Map<String,ServiceResult>`	`importsNamespace`
`org.apache.commons.jexl2.JexlContext`	`jc`
`org.apache.commons.jexl2.JexlEngine`	`jexl`
`static Kit`	`KIT`
`RunOptions`	`runOptions`
`Map<String,ServiceResult>`	`serviceResultsMap`
`static Tools`	`TOOLS`

Constructor Summary

Constructors
Constructor and Description

Eval()

Constructors
Constructor and Description
`Eval()`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addToEvalReport(EvalResult result)`
`protected static String`	`dumpContext(org.apache.commons.jexl2.JexlContext jc)`
`EvalResult`	`eval(String logname, String inputJexlExpression, Map<String,Object> vars)` You may pass in a Jexl 2 expression, e.g.
`protected static int`	`findMatchingCloseBrace(String in, int start)`
`List<EvalResult>`	`getEvalReport()`
`static void`	`main(String[] args)`
`boolean`	`popLastEvalReportItemIfUnused(EvalResult result)`
`void`	`resetContext()`
`EvalResult`	`setCurrentTestIDLabel(String val)` The current test label is the title of a block of evals in the Eval Report for this session.

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

- Field Detail
  - serviceResultsMap
```
public Map<String,ServiceResult> serviceResultsMap
```
  - importsNamespace
```
public Map<String,ServiceResult> importsNamespace
```
  - jexl
```
public org.apache.commons.jexl2.JexlEngine jexl
```
  - jc
```
public org.apache.commons.jexl2.JexlContext jc
```
  - TOOLS
```
public static Tools TOOLS
```
  - KIT
```
public static Kit KIT
```
  - runOptions
```
public RunOptions runOptions
```
- Constructor Detail
  - Eval
```
public Eval()
```
- Method Detail
  - getEvalReport
```
public List<EvalResult> getEvalReport()
```
  - popLastEvalReportItemIfUnused
```
public boolean popLastEvalReportItemIfUnused(EvalResult result)
```
  - addToEvalReport
```
public void addToEvalReport(EvalResult result)
```
  - setCurrentTestIDLabel
```
public EvalResult setCurrentTestIDLabel(String val)
```
    The current test label is the title of a block of evals in the Eval Report for this session. When checking variables such as <test loop="${expression}" ..., RestReplay calls setCurrentTestIDLabel(testID) which gets logged in the report as testID (preflight) If no evals occur in the evaluation of the expression, then RestReplay can remove the header line by calling popLastEvalReportItemIfUnused(token) where token is the value returned by this call.
    
    Parameters:
    
    val - becomes the testIDLabel.
    
    Returns:
    
    a token which can be used to call popLastEvalReportItemIfUnused(token). Do not use the token for any calls or values.
  - resetContext
```
public void resetContext()
```
  - eval
```
public EvalResult eval(String logname,
                       String inputJexlExpression,
                       Map<String,Object> vars)
```
    You may pass in a Jexl 2 expression, e.g. ${foo.bar} and it will be eval'd for you. We are looking at some URI like so: ${newOrgAuthority.CSID} The idea here is that the XML control file may bind to this namespace, and this module may find those values and any future extensions, specifically when someone says "I want to bind to ${CSID} and ${SUBRESOURCE.CSID} The code here is easy to extend, but the test cases build up, so you don't want to break all the config files by not being backward compatible. Binding to context variables like this makes it easy. EXAMPLE USAGE:
    String uri = "/cspace-services/orgauthorities/${OrgAuth1.CSID}/items/${Org1.CSID}";
    uri = eval(uri, serviceResultsMap, jexl, jc);
    RESULT: "/cspace-services/orgauthorities/43a2739c-4f40-49c8-a6d5/items/"
    
    Returns:
    
    EvalResult . It is the responsibility of the caller to check EvalResult.alerts which is a List<Alert>. The list will have size()==0 if there are not alerts. If there are alerts, It is up to the caller to decide whether to continue processing. This method continues processing each eval, which may include multiple WARN or ERROR alerts, so the caller should use Collection.addAll(EvalResult.alerts) or similar to grab all Alerts.
  - findMatchingCloseBrace
```
protected static int findMatchingCloseBrace(String in,
                                            int start)
```
    Returns:
    
    the string up to (but not including) the matching close brace.
  - dumpContext
```
protected static String dumpContext(org.apache.commons.jexl2.JexlContext jc)
```
  - main
```
public static void main(String[] args)
```

Class Eval

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

serviceResultsMap

importsNamespace

jexl

jc

TOOLS

KIT

runOptions

Constructor Detail

Eval

Method Detail

getEvalReport

popLastEvalReportItemIfUnused

addToEvalReport

setCurrentTestIDLabel

resetContext

eval

findMatchingCloseBrace

dumpContext

main