GraalVM demos: Polyglot JavaScript, Java, R application

This page describes a simple example of a polyglot application you can run with GraalVM.

Prerequisites

Preparation

Download or clone the repository and navigate into the polyglot-javascript-java-r directory:

git clone https://github.com/graalvm/graalvm-demos
cd graalvm-demos/polyglot-javascript-java-r

Build the benchmark. You can manually execute npm install, but there’s also a build.sh script included for your convenience.

Execute:

./build.sh

Now you are all set to run the polyglot JavaScript, Java, R application.

Export the GraalVM home directory as the $GRAALVM_HOME and add $GRAALVM_HOME/bin to the path, using a command-line shell for Linux:

export GRAALVM_HOME=/home/${current_user}/path/to/graalvm

and for Mac OS:

export GRAALVM_HOME=/Users/${current_user}/path/to/graalvm/Contents/Home

Note that your paths are likely to be different depending on the download location.

Note that this application contains R code, so you need to install the R language component to add R support to GraalVM, run the Graal updater command to do it:

gu -c install org.graalvm.r

For more information on using Graal updater please refer to its documentation.

Running the application

To run the application, you need to execute the server.js file. You can run it with the following command (or run the run.sh script):

$GRAALVM_HOME/bin/node --jvm --polyglot server.js

If you would like to run the benchmark on a different instance of Node, you can run it with whatever node you have. However, presumably, the polyglot capability will not be supported.

Open localhost:3000 and enjoy the output of the polyglot app. Play with the source code and restart the application to see what else you can do with the mix of JavaScript, Java, and R.

Debugging polyglot applications

GraalVM also supports debugging of polyglot applications and provides a built-in implementation of the Chrome DevTools Protocol. Add the --inspect parameter to the command line, open the URL the application prints at the startup in the Chrome browser and start debugging, set breakpoints, evaluate expressions of this app in JavaScript and R code alike.

A note about the application

This sample application for brevity contains large-ish snippets of code inside the strings. This is not the best approach for structuring polyglot apps, but it is the easiest to show in a single file.