Property Detail

• final java.util.Set ancestors

• final java.lang.Object node

Constructor Detail

• ExecutionContext.NodeContext(java.lang.Object contextNode, java.lang.Object contextAncestors, java.lang.Object initialBindings = [:])

Method Detail

• void bind(java.lang.String key, java.lang.Object value)

  Binds a value to a name in the globals store under the node's namespace. The value may later be retrieved by any descendent node's context using binding().

• java.lang.Object binding(java.lang.String key)

  Retrieves a value previously bound using bind() to this node's context. If the given key is not found under this node's namespace, a NameNotFoundException is thrown.

• java.lang.Object binding(java.lang.Object ancestorNode, java.lang.String key)

  Retrieves a value previously bound using bind() under the given ancestor node's namespace and name.

• NodeContext dive(java.util.Map bindings)

  Creates and returns a new anonymous NodeContext for use in representing child context frames. For example, a list comprehension needs a new context in which to define its bound variable but can't modify its current node's context without potentially overwriting currently bound values.

• java.lang.Object getAll()

  Returns read-only version of the current bindings for this node only. This is only intended for read-only/reporting purposes.

• java.util.Map getAll(java.lang.String key)

  Returns all objects bound to the given name under any node namespace, as well as the node under which it is found. This should only be used at the end of an execution graph.

• java.lang.Object getAt(java.lang.String key)

  Operator alias for binding(java.lang.String) or, if a "namespace.key" is given, binding(def, java.lang.String).

• java.lang.Object interpolate(java.lang.Object obj)

  Interpolates the given object by evaluating all list comprehensions and substituting all variable expressions with previously bound values.

  example:

  Strings may contain variable expressions

  
     context.ofNode("a")["foo"] = "afoo"
     context.ofNode("b")["foo"] = "bfoo"
     assert (context.ofNode("b") % 'w-t-${.foo}') == "w-t-bfoo"
     assert (context.ofNode("b") % 'w-t-${a.foo}') == "w-t-afoo"
   

  example:

  Variable expressions may contain default values in cases where the name doesn't exist or is bound to a falsey value

  
     context.ofNode("a")["foo"] = ""
     assert (context.ofNode("a") % 'w-t-${.foo|frak}') == "w-t-frak"
     assert (context.ofNode("a") % 'w-t-${.bar|frak}') == "w-t-frak"
   

  example:

  List comprehensions can be embedded to dynamically construct lists of values derived from tokenizing a source string expression. A list comprehension's body ($yield) is given its own context namespace containing each token of $in bound to the name given as $each. The default $delimiter is a newline but can be any string.

  
     context.ofNode("a")["foo"] = "bar|baz"
  
     def fooList = [
       $each: 'item',
       $in: '${a.foo}|qux',
       $delimiter: '|',
       $yield: 'w-t-${.item}',
     ]
  
     assert context % fooList == [
       'w-t-bar',
       'w-t-baz',
       'w-t-qux',
     ]
   

  example:

  Two lists or maps can be merged using $merge

  
     def fooList = [
       $merge: ['foo', 'bar'],
       $with: ['baz', 'qux'],
     ]
  
     assert context % fooList == [
       'foo',
       'bar',
       'baz',
       'qux',
     ]
   

  example:

  The entries of a second map overwrite those of the first

  
     def fooMap = [
       $merge: [foo: 'x', bar: 'y'],
       $with: [bar: 'z'],
     ]
  
     assert context % fooMap == [
       foo: 'x',
       bar: 'z',
     ]
   

• java.lang.Object mod(java.lang.Object str)

  Operator alias for interpolate(). Use the modulo (%, percent) operator do variable expansion.

• void putAt(java.lang.String key, java.lang.Object value)

  Operator alias for bind().