JNI Generator

Scopo e intento dell’utente: questo strumento genera scaffolding JNI standardizzato a partire dalle dichiarazioni di classi Java, per supportare l’integrazione del codice nativo. Gli utenti target sono sviluppatori Java/NDK, autori di librerie e pipeline di automazione che richiedono binding JNI ripetibili. Riduce boilerplate, applica firme corrette e accelera il prototipaggio di interfacce multi-lingua.

Logica di base e funzionalità: convalida dei dati, mapping dei tipi ai tipi JNI, generazione delle firme JNI e rilascio di un set coerente di file C/C++. Richiede una classe Java e una lista di metodi native. Output: header, sorgenti e stub Java; template opzionali per JNI_OnLoad e gestione delle referenze; supporto multi-file e template specifici per versione.

Ingressi e uscite: input – nome classe, package, metodi native (nome, tipo restituzione, parametri) e versione JNI. Output – sorgenti e header con implementazioni native, stub Java e guida minima di build per CMake o ndk-build.

Algoritmi e calcoli: mapping dei tipi secondo regole Java→JNI (int → jint, long → jlong, String → jstring). Prototipi seguono JNIEXPORT JNICALL e lo schema di naming Java_package_Class_method; overloads ottengono signature dei parametri.

Errori e casi limite: classi o metodi mancanti generano errori espliciti; tipi di parametri non supportati producono avvisi o rifiuti. Dopo la generazione, integra nel sistema di build.

Industria e localizzazione: conforme a specifiche JNI Java SE e convenzioni Android NDK; UTF-8 per stringhe e tipi C/C++ standard.

Assunzioni ed esclusioni: richiede runtime Python e input; esclude orchestrazione completa di build e binding oltre lo scaffolding JNI.