Is JNI built into Java, or is it a separate install?

It is built in. JNI ships with the JDK and the JVM, so the Java side needs nothing extra. Compiling the native half still requires a C or C++ toolchain for each target platform.

Does using JNI make a mod cross-platform?

No. The Java half stays portable, but a native library is compiled for one operating system and CPU. Shipping cross-platform means building and bundling a separate .dll, .so, and .dylib.

Is JNI the only way to call native code from Java?

No. JNI is the original mechanism. Recent Java releases add the Foreign Function and Memory API, which aims to be safer and require less boilerplate, but JNI remains widely deployed and well understood.

Why would a Minecraft client or mod use JNI?

When the JVM cannot do something directly (talk to a GPU or audio backend, hit a platform-only API, or run a performance-critical routine), a mod loads a native library and calls into it through JNI.

Learn · concepts

Was ist JNI? Java Native Interface für Modder

JNI (Java Native Interface) ist die in Java integrierte Brücke, um C/C++-Code vom JVM aufzurufen und umgekehrt. Es ist die Standardmethode, mit der ein Minecraft-Mod eine native Bibliothek lädt.

TRtrolPublished January 1, 19706 min read

Key takeaways

JNI (Java Native Interface) ist die Standardbrücke, die es JVM-Code ermöglicht, C- oder C++-Funktionen aufzurufen, und die es diesem nativen Code erlaubt, zurück in Java aufzurufen.
Eine Methode, die mit native markiert ist, hat keinen Java-Body; zur Laufzeit verknüpft die JVM sie mit einer kompilierten Funktion innerhalb einer Shared Library (.dll, .so, .dylib).
Die Brücke funktioniert in beide Richtungen: Nativer Code erhält einen JNIEnv-Zeiger, um Felder zu lesen, Methoden aufzurufen, Objekte zu allozieren und Ausnahmen zu werfen.
Modder greifen darauf zurück, um eine ausgereifte C-Bibliothek wiederzuverwenden, auf eine OS-spezifische Funktion zuzugreifen, einen kritischen Pfad zu beschleunigen oder mit GPU-, Audio- und Gerätetreibern zu kommunizieren.
Der Kompromiss ist real: Ein Absturz im nativen Code führt zum Absturz der gesamten JVM, nativer Speicher entgeht dem Garbage Collector, und jedes Build ist plattformspezifisch.

Was ist JNI in einfachen Worten?

JNI (Java Native Interface) ist der Teil von Java, der zwei Welten miteinander verbindet: verwalteten Bytecode auf der JVM und kompilierten Maschinencode, der in C oder C++ geschrieben wurde. Eine Methode erhält das Schlüsselwort native und keinen Rumpf, und zur Laufzeit verknüpft die JVM sie mit einer übereinstimmenden Funktion in einer geladenen nativen Bibliothek. Von dort aus tauschen beide Seiten Argumente und Rückgabewerte aus.

Die Grenze ist nicht einseitig. Die native Funktion empfängt einen JNIEnv-Zeiger, und dieser Handle ist das Tor zurück in Java: er stellt Aufrufe zum Lesen und Schreiben von Java-Feldern, zum Aufrufen von Java-Methoden, zum Erstellen von Objekten und zum Auslösen von Ausnahmen bereit. Also lässt dieselbe Brücke, die Java das Ausrufen ermöglicht, auch C das Einrufen zu.

Warum würde ein Minecraft-Mod oder -Client nativen Code berühren?

Die meisten Java-Programme benötigen JNI nicht. Ein Mod greift darauf zurück, wenn die JVM allein die Aufgabe nicht bewältigen kann, meistens bei Grafiken, Audio, Betriebssystemintegration oder einer Routine, die schnell sein muss. Die native Bibliothek erledigt die schwere Arbeit, und JNI ist der Standardweg, um sie zu laden und aufzurufen.

Verwenden Sie eine bewährte C-Bibliothek erneut

Ein ausgereifter, nativ entwickelter Codebestand löst das Problem bereits. Eine Überarbeitung in Java wäre eine verschwendete Mühe, daher bindet sich die Modifikation stattdessen an ihn.

Das Betriebssystem erreichen

Einige Plattformfunktionen haben keine reine Java-API. Ein nativer Aufruf wird zur einzigen Möglichkeit, auf diese zuzugreifen.

Einen heißen Pfad beschleunigen

Eine enge numerische oder Low-Level-Routine kann als kompilierter, nativer Code schneller laufen als als Bytecode auf der JVM.

Treiber und Hardware

Rendering, Klang und Gerätezugriff finden sich häufig hinter nativen Bibliotheken, die JNI der Java-Seite zugänglich macht.

Wie funktioniert ein JNI-Aufruf von Anfang bis Ende?

Der Ablauf ist auf jeder Plattform identisch: Deklarieren Sie die Methode in Java, kompilieren Sie eine passende C-Funktion in eine Shared Library, laden Sie diese zur Laufzeit, lassen Sie die JVM sie anhand des Namens verknüpfen und rufen Sie dann über die Grenze hinweg auf. Funktionsnamen folgen einem festen Muster, sodass die JVM sie auflösen kann, und eine generierte Header-Datei legt die genaue Signatur für die Implementierung fest.

Schritt	Was passiert
Deklarieren	Eine Java-Methode wird mit dem Schlüsselwort `native` geschrieben und auf der Java-Seite leer gelassen.
Erstellen	Eine C- oder C++-Funktion wird in eine Shared Library kompiliert: `.dll` unter Windows, `.so` unter Linux, `.dylib` unter macOS.
Laden	Java ruft `System.loadLibrary` auf, um die Bibliothek während der Programmausführung zu laden.
Verknüpfen	Die JVM ordnet jede `native`-Methode anhand einer Namens-Mangel-Signatur ihrer C-Funktion zu.
Aufrufen	Java ruft die Methode auf; die Kontrolle geht in nativen Code über und kehrt mit einem Ergebnis zurück.

Was kostet Sie JNI?

JNI ist leistungsstark, hat aber scharfe Kanten. Da nativ erstellter Code außerhalb der Sicherheitsabschirmung der JVM ausgeführt wird, führt ein Fehler dort zum Absturz des gesamten Prozesses anstatt einer abgefangbaren Ausnahme. Speicher, den die native Seite allokiert, ist für den Garbage Collector unsichtbar, sodass Speicherlecks entstehen, es sei denn, sie werden manuell freigegeben. Jeder Übergang verursacht Overhead, was den Aufruf über die Grenze innerhalb einer engen Schleife teuer macht. Und native Builds sind plattformgebunden: eine Windows-.dll-Datei wird unter Linux ohne separate Kompilierung nicht geladen.

Was es kauft

Direkter Zugriff auf bestehende C- und C++-Bibliotheken
Ein Weg zu Betriebssystem- und Hardwarefunktionen, die die JVM nicht erreichen kann
Nativer Geschwindigkeitsausführung für die wichtigsten Routinen

Was es kostet

Ein nativen Absturz kann die gesamte JVM zum Absturz bringen.
Manuelle Speicherverwaltung ohne Rückfallmöglichkeit durch Garbage Collector.
Plattformspezifische Builds zur Wartung und Auslieferung.
Overhead, der Plattformgrenzen überschreitet, in heißen Schleifen

JNI vs. die Foreign Function and Memory API

JNI ist der ursprüngliche Mechanismus, aber nicht mehr der einzige. Neuere Java-Versionen enthalten die Foreign Function and Memory (FFM) API, die entwickelt wurde, um nativen Code mit weniger Boilerplate und stärkeren Sicherheitsgarantien aufzurufen. JNI dominiert immer noch bestehende Toolchains, da es überall verfügbar und gründlich verstanden ist.

	JNI	FFM API
Alter	Ursprünglich, seit den frühen Java-Versionen vorhanden	Modern, in neueren Versionen hinzugefügt
Boilerplate	Generierte Header, name-gemangelte C-Funktionen	In Java definierte Method Handles, kein zusätzliches C
Speichersicherheit	Manuell; Fehler können die JVM beschädigen	Begrenzte Segmente mit stärkeren Prüfungen
Akzeptanz	Allgegenwärtig in bestehenden Bibliotheken	Wachsend, in neueren Codebasen

Häufig gestellte Fragen

Terminus erhalten

Erstellt von Leuten, die tatsächlich die JVM-Interna gelesen haben.