29.6. Invoking Script Functions from Java

You can invoke a script function defined in JavaScript using the Invocable interface:

String script =
"function greet(name) { return 'Hello, ' + name; }";
engine.eval(script);

This chunk explains how to define a JavaScript function within a Java application using the Nashorn scripting engine. To do this, you first create a string that represents your JavaScript code. In this case, the script defines a function named greet, which takes a name as an argument and returns a greeting message. The engine.eval(script); line executes the script, making the greet function available for later use.

You can think of the process like hiring a new employee (the function) and teaching them their tasks (defining the function). The eval method acts as a training session where the new employee learns their job before they can start helping customers.

Invocable invocable = (Invocable) engine; String result = (String) invocable.invokeFunction("greet", "Abraham");

After defining the JavaScript function, you need to prepare to call it. This is done by casting the engine to the Invocable interface, which allows you to invoke functions defined in the scripting environment. The invokeFunction method is then called with the name of the function (greet) and the argument (Abraham). The result of the function call is stored in the result variable, which is expected to be of type String.

Imagine you've called that new employee to serve a customer (invoking the function). You specify what you need (the function name and the customer's name). After they respond with a greeting, you save that response to give to your management.

System.out.println(result); // Output: Hello, Abraham

Finally, the result of the invocation is printed to the console. The line System.out.println(result); displays the output of the function call, which in this case is 'Hello, Abraham'. This step effectively communicates the function's output to the user or developer through the console.

This is like giving a report to your boss about how well the new employee handled the customer interaction. You print the message they crafted, showing how they greeted the customer beautifully.

--