Unlock Faster Java and Polyglot Apps with GraalVM: A Quick Reference Guide

Introduction

GraalVM helps developers use Java more effectively, offering three main benefits: a cutting‑edge JIT compiler for speed, the ability to compile to native binaries with instant startup and low memory, and support for multiple languages.

The quick reference is a one‑page summary of what GraalVM can do and the key options and commands that illustrate its features.

1. Running Java Applications

The GraalVM distribution includes a JDK, so you can compile with

javac

and run Java programs as usual. GraalVM’s JIT compiler often yields higher peak performance than standard JDKs.

<code>javac MyApp.java</code>

<code>java -jar MyApp.jar</code>

When running, the underlying JVM is HotSpot, so standard options such as classpath work:

<code>java -cp target/myapp.jar com.example.Main</code>

Key compiler options include

-XX:+-UseJVMCINativeLibrary

, configuration modes (

economy

,

enterprise

) via

-Dgraal.CompilerConfiguration=…

, and logging flags like

-Dgraal.PrintCompilation=true

or

-Dgraal.Dump=:2

. Java agents can also be attached.

<code>-javaagent:path/to/jar.jar
-agentlib:path/to/native/agent</code>

2. Compiling to Native Executables

GraalVM’s Native Image feature lets you ahead‑of‑time compile applications into native binaries. Install the component with:

<code>gu install -L native-image.jar</code>

Generate a binary with:

<code>native-image [options] MyClass
native-image -jar MyApp.jar
./myApp</code>

Use

--shared

to build a shared library, or

--static --libc=muslc

for a statically linked binary.

3. Polyglot Programming

GraalVM supports Truffle‑based languages such as JavaScript, Ruby, Python, R, and LLVM. Enable them with flags like

--language:js

,

--language:python

, etc.

Native Image can be optimized with profile‑guided optimization (PGO):

<code>native-image — pgo-instrument MyApp
./myApp
native-image — pgo profile.iprof MyApp</code>

Debugging options include class‑initialization tracing and attaching a debugger:

<code>-H:+TraceClassInitialization=package.class.Name
--debug-attach=[port]</code>

Run language‑specific launchers (e.g.,

node myApp.js

,

graalpython myApp.py

) and control execution mode with

--jvm

or

--polyglot

. Resource limits can be set, for example

--sandbox.MaxCPUTime=Nms

.

4. General Development Tools

GraalVM bundles tools such as Chrome DevTools debugging, CPU samplers, tracers, and memory analyzers, enabled with flags like

--inspect

,

--cpusampler

,

--cputracer

,

--memsampler

.

Conclusion

GraalVM is a versatile platform that supports Java, other JVM languages, JavaScript, Ruby, Python, R, and more. It offers a high‑performance JIT compiler, native‑image generation, and polyglot runtime capabilities, making it valuable for modern cloud‑native applications.