Java Native Access (JNA)

Il y a des projets qui font plaisirs quand on les découvre et, JNA en fait partie.

Ce projet actuellement dans l’incubateur des prochaines JDK offre la possibilité d’appeler des fonctions natives sans avoir besoin de passer explicitement par du JNI. Fini le temps où pour exploiter une fonction Win32 existante il fallait sortir l’arme lourde. J’entends par là qu’il fallait se munir d’un compilateur C, générer un .h et développer du C. Par contre si vous avez besoin de passer par du code natif vous avez simplement besoin de construire une DLL. La partie avec Javah n’est plus nécessaire.

Ce projet s’occupe donc de masquer le développement de la couche JNI pour appeler du code natif.

Bref voici un exemple tiré du site du projet. L’objectif étant de faire appel à la fonction GetSystemTime qui se trouve dans la DLL kernel32.lib.

On commence par définir une interface dont le but et la définition des fonctions et structure à exploiter. Noter l’héritage de StdCallLibrary qui précise l’ordre des paramètres. Enfin, on récupère une référence sur l’ouverture de la bibliothèque concernée.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
public interface Kernel32 extends StdCallLibrary {  
    Kernel32 INSTANCE = (Kernel32)Native.loadLibrary("kernel32", Kernel32.class);
  
    public static class SYSTEMTIME extends Structure {
        public short wYear;
        public short wMonth;
        public short wDayOfWeek;
        public short wDay;
        public short wHour;
        public short wMinute;
        public short wSecond;
        public short wMilliseconds;
    }  
  
    void GetSystemTime(SYSTEMTIME result);
    }
}

Au niveau utilisation de l’interface précédente voilà un petit exemple :

1
2
3
4
5
6
7
8
public class Kernel32Impl {
    public static void main(String\[\] argv) {
        Kernel32 lib = Kernel32.INSTANCE;
        Kernel32.SYSTEMTIME time = new Kernel32.SYSTEMTIME();
        lib.GetSystemTime(time);
        System.out.println("Today's integer value is " + time.wDay);
    }
}

Le projet JNA se trouve ici : JNA.

Les sources du projet JNA sont disponibles. Vous trouverez par ailleurs un ensemble d’exemples.

Il y a également sur le blog de Romain Guy un billet qui en parle.

Dans le même style que JNA, on peut trouver :

À noter que JNA est dans l’incubateur de la JDK donc potentiellement disponible dans les prochaines versions de Java.

Ce billet est open source. Vous avez noté un problème de typographie ?
Ou quelque chose d'obscur ? Améliorer ce billet à partir du dépôt GitHub.

Je suis Mickaël BARON Ingénieur de Recherche en Informatique 💻 au @LIAS_LAB le jour 🌞
Responsable de zones #Java sur @javaDeveloppez la nuit 🌚
❤️ #Java #Docker #VueJS #Eclipse #Services #WebSemantic