Add jextract module: SQLite bindings generated with jextract, FFM arenas, C strings, out-parameters, errors, upcalls, and a JMH comparison with JNI

jextract-25 early-access build (25-jextract+2-4) on JDK 25.0.5+8 against SQLite 3.45.1: 25 functions and 13 constants generated into 4 committed files (the whole header would be 83 files), a small Db wrapper, the four arena kinds used wrongly on purpose, ADDRESS vs C_POINTER zero-length vs unbounded segments and the SIGSEGV from getString on a NULL pointer, sqlite3_open out-parameter, return codes to exceptions, a sqlite3_exec upcall and the VM exit when it throws, the JDK 25 native-access warning and --illegal-native-access=deny, library loading failures, and a JMH benchmark of FFM vs hand-written JNI vs plain Java (indicative only: shared 2-CPU machine). Co-Authored-By: Claude Sonnet 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_017ic4b6Kg9RWSTJzyz6KP9X
2026-10-30 16:36:09 +00:00
parent 41101bea40
commit ecceaa8b32
37 changed files with 2867 additions and 0 deletions
@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# Downloads the jextract early-access build for JDK 25 (linux-x64) from jdk.java.net and checks its SHA-256. Unpacks into ./tools.
+set -euo pipefail
+cd "$(dirname "$0")/.."; mkdir -p tools; cd tools
+F="openjdk-25-jextract+2-4_linux-x64_bin.tar.gz"
+U="https://download.java.net/java/early_access/jextract/25/2/$F"
+[ -s "$F" ] || curl -sSLO "$U"
+want="$(curl -sSL "$U.sha256" | cut -d' ' -f1)"; got="$(sha256sum "$F" | cut -d' ' -f1)"
+[ "$want" = "$got" ] && echo "sha256 ok  $got" || { echo "SHA256 MISMATCH"; exit 1; }
+tar xzf "$F"; echo "jextract at $(pwd)/jextract-25/bin/jextract"