Introduction to GraalVM
This page provides an architectural overview of GraalVM and its runtime modes, supported platforms, available distributions, core and additional functionalities, and support levels for various features.
- GraalVM Architecture
- Runtime Modes
- Available Distributions
- Distribution Components List
- Licensing and Support
- Features Support
- What to Read Next
GraalVM Architecture #
GraalVM adds an advanced just-in-time (JIT) optimizing compiler, which is written in Java, to the HotSpot Java Virtual Machine.
Runtime Modes #
GraalVM is unique as a runtime environment offering several modes of operation: JVM runtime mode, Native Image, Java on Truffle (the same Java applications can be run on either).
JVM Runtime Mode
When running programs on the HotSpot JVM, GraalVM defaults to the GraalVM compiler as the top-tier JIT compiler. At runtime, an application is loaded and executed normally on the JVM. The JVM passes bytecodes for Java or any other JVM-native language to the compiler, which compiles that to the machine code and returns it to the JVM. Interpreters for supported languages, written on top of the Truffle framework, are themselves Java programs that run on the JVM.
Native Image is an innovative technology that compiles Java code into a standalone binary executable or a native shared library. The Java bytecode that is processed during the native image build includes all application classes, dependencies, third party dependent libraries, and any JDK classes that are required. A generated self-contained native executable is specific to each individual operating systems and machine architecture that does not require a JVM.
Java on Truffle
Java on Truffle is an implementation of the Java Virtual Machine Specification, built with the Truffle language implementation framework. It is a complete Java VM that includes all core components, implements the same API as the Java Runtime Environment library, and reuses all JARs and native libraries from GraalVM. Java on Trufle is an experimental technology in GraalVM, available as of version 21.0.0.
Available Distributions #
GraalVM is available as GraalVM Enterprise and GraalVM Community editions and includes support for Java 8, Java 11 and Java 16. GraalVM Enterprise is based on Oracle JDK while GraalVM Community is based on OpenJDK.
GraalVM is available for Linux, macOS, and Windows platforms on x86 64-bit systems, and for Linux on ARM 64-bit system. The GraalVM distribution based on Oracle JDK 16 is experimental with several known limitations. Depending on the platform, the distributions are shipped as .tar.gz or .zip archives. See the Getting Started guide for installation instructions.
Distribution Components List #
GraalVM consists of core and additional components. The core components enable using GraalVM as a runtime platform for programs written in JVM-based languages or embeddable polyglot applications.
Core Components #
- Java HotSpot VM
- LLVM runtime
Libraries (JAR files)
- GraalVM compiler - the top-tier JIT compiler
- Polyglot API – the APIs for combining programming languages in a shared runtime
llitool to directly execute programs from LLVM bitcode
- GraalVM Updater to install additional functionalities
Additional Components #
GraalVM core installation can be extended with more languages runtimes and utilities.
- Native Image – a technology to compile an application ahead-of-time into a native executable.
- LLVM toolchain – a set of tools and APIs for compiling native programs to bitcode that can be executed with on the GraalVM runtime.
- Java on Truffle – a JVM implementation built upon the Truffle framework to run Java via a Java bytecode interpreter.
- Python – Python 3.8.5 compatible
- Ruby – Ruby 2.7.3 compatible
- R – GNU R 4.0.3 compatible
- GraalWasm – WebAssembly (Wasm)
Licensing and Support #
GraalVM Community Edition is open source software built from the sources available on GitHub and distributed under version 2 of the GNU General Public License with the “Classpath” Exception, which are the same terms as for Java. Check the licenses of individual GraalVM components which are generally derivative of the license of a particular language and may differ. GraalVM Community is free to use for any purpose and comes with no strings attached, but also no guarantees or support.
Features Support #
GraalVM technologies are distributed as production-ready and experimental.
Experimental features are being considered for future versions of GraalVM and are not meant to be used in production. The development team welcomes feedback on experimental features, but users should be aware that experimental features might never be included in a final version, or might change significantly before being considered production-ready.
The following table lists production-ready and experimental features in GraalVM Community Edition 21 by platform.
|Feature||Linux AMD64||Linux ARM64||macOS||Windows|
|LLVM runtime||stable||stable||stable||not available|
|LLVM toolchain||stable||stable||stable||not available|
|Java on Truffle||experimental||experimental||experimental||experimental|
|Python||experimental||not available||experimental||not available|
|R||experimental||not available||experimental||not available|
What to Read Next #
Whether you are new to GraalVM or have little experience using it, continue to Get Started with GraalVM. Install GraalVM on your local machine, try running the examples provided in the guide, or test GraalVM with your workload. After that we suggest you to look at more complex Examples Applications.
Developers who have GraalVM already installed or have experience using, can skip the getting started guide and proceed to the Reference Manuals for in-depth coverage of GraalVM technologies.
To start coding with the GraalVM Polyglot APIs, check out the GraalVM SDK Java API Reference.