com.api.jsonata4java

Class Expression

java.lang.Object

com.api.jsonata4java.Expression

public class Expression
extends Object

Class to provide embedding and extending JSONata features

Constructor Summary

Constructors

Constructor and Description
Expression(String expression) Constructor for Expression

Method Summary

Modifier and Type	Method and Description
void	assign(Binding binding) Assign the binding to the environment preparing for evaluation
void	assign(String varname, String expression) Assign the expression (variable or function declaration) to the variable name supplied
com.fasterxml.jackson.databind.JsonNode	evaluate(com.fasterxml.jackson.databind.JsonNode rootContext) Generate a result form the Expression's parsed expression and variable assignments or registered functions
com.fasterxml.jackson.databind.JsonNode	evaluate(com.fasterxml.jackson.databind.JsonNode rootContext, com.fasterxml.jackson.databind.JsonNode bindingObj) Generate a result form the Expression's parsed expression and variable assignments or registered functions specified in the bindings object
com.fasterxml.jackson.databind.JsonNode	evaluate(com.fasterxml.jackson.databind.JsonNode rootContext, List<Binding> bindings) Generate a result form the Expression's parsed expression and variable assignments or registered functions specified in the list of bindings
static Expression	jsonata(String expression) Genearte a new Expression based on evaluating the supplied expression
static void	main(String[] args) Testing the various methods based on https://docs.jsonata.org/embedding-extending#expressionregisterfunctionname-implementation-signature
void	registerFunction(String fctName, String implementation) Registers a function implementation (declaration) by name

Methods inherited from class java.lang.Object

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

Constructor Detail

Expression

public Expression(String expression)
           throws ParseException

Constructor for Expression

Parameters:

expression - the logic to be parsed for later execution via evaluate methods

Throws:

ParseException

Method Detail

jsonata

public static Expression jsonata(String expression)
                          throws ParseException

Genearte a new Expression based on evaluating the supplied expression

Parameters:

expression - the logic to be parsed for later execution via the evaluate methods

Returns:

new Expression object

Throws:

ParseException

main

public static void main(String[] args)

Testing the various methods based on https://docs.jsonata.org/embedding-extending#expressionregisterfunctionname-implementation-signature

Parameters:

args - not used

assign

public void assign(Binding binding)

Assign the binding to the environment preparing for evaluation

Parameters:

binding -

assign

public void assign(String varname,
                   String expression)
            throws ParseException

Assign the expression (variable or function declaration) to the variable name supplied

Parameters:

varname - name of the variable to map to a variable expression or function declaration expression

expression - logic to be assigned to the variable name

Throws:

ParseException

evaluate

public com.fasterxml.jackson.databind.JsonNode evaluate(com.fasterxml.jackson.databind.JsonNode rootContext)
                                                 throws EvaluateException,
                                                        ParseException

Generate a result form the Expression's parsed expression and variable assignments or registered functions

Parameters:

rootContext - JSON object specifying the content used to evaluate the expression

Returns:

the result from executing the Expression's parsed expression and variable assignments or registered functions

Throws:

EvaluateException

ParseException

evaluate

public com.fasterxml.jackson.databind.JsonNode evaluate(com.fasterxml.jackson.databind.JsonNode rootContext,
                                                        List<Binding> bindings)
                                                 throws EvaluateException,
                                                        ParseException

Generate a result form the Expression's parsed expression and variable assignments or registered functions specified in the list of bindings

Parameters:

rootContext - JSON object specifying the content used to evaluate the expression

bindings - assignments of variable names to variable expressions or function declarations

Returns:

the result from executing the Expression's parsed expression and variable assignments or registered functions specified in the list of bindings

Throws:

EvaluateException

ParseException

evaluate

public com.fasterxml.jackson.databind.JsonNode evaluate(com.fasterxml.jackson.databind.JsonNode rootContext,
                                                        com.fasterxml.jackson.databind.JsonNode bindingObj)
                                                 throws EvaluateException,
                                                        ParseException

Generate a result form the Expression's parsed expression and variable assignments or registered functions specified in the bindings object

Parameters:

rootContext - JSON object specifying the content used to evaluate the expression

bindingObj - a JSON object containing the assignments of variable names to variable expressions or function declarations

Returns:

the result from executing the Expression's parsed expression and variable assignments or registered functions specified in the bindings object

Throws:

EvaluateException

ParseException

registerFunction

public void registerFunction(String fctName,
                             String implementation)
                      throws ParseException

Registers a function implementation (declaration) by name

Parameters:

fctName - the name of the function

implementation - the function declaration

Throws:

ParseException