Java Native Access (JNA) ist eine Java-Programmbibliothek für den Zugriff auf plattformspezifische („native“) dynamische Programmbibliotheken (DLLs in Windows oder „shared libraries“ auf anderen Systemen). Hierbei braucht im Unterschied zu Java Native Interface (JNI) kein plattformspezifischer Code geschrieben zu werden.
JNA ist in der Funktion mit den Platform Invocation Services (P/Invoke) des .Net-Frameworks unter Windows vergleichbar. Es unterstützt eine automatische Umwandlung zwischen einigen C- und Java-Datentypen. Die minimal erforderliche Java-Version ist 1.4.
Lizenz LGPL Version 2.1 oder höher und (ab V4.0) die Apache Software License V2.0.github.com
Mapping der Datentypen Die folgende Tabelle zeigt, wie das Mapping zwischen Java und dem nativen Code mit JNA erfolgt.
Nativer TypGrößeJava TypStandard Windows Typechar8-bit integerbyteBYTE, TCHARshort16-bitshortshort WORDwchar_t16/32-bit charactercharWCHAR, TCHARint32-bit integerintDWORDintboolean valuebooleanBOOLlong32/64-bit integerNativeLongLONGlong long, __int6464-bit integerlongfloat32-bit FPfloatdouble64-bit FPdoublechar*C stringStringLPCTSTRvoid*pointerPointerLPVOID, HANDLE, LPXXX
Anwendungen Die folgenden Softwareprojekte verwenden JNA: JRuby Java Media Framework#FMJ IntelliJ IDEA
Beispiel Das folgende Beispiel lädt die Standard C Library, um die printf-Funktion aufzurufen. Dieses Beispiel funktioniert auf Microsoft Windows und Linux / Unix / Mac OS X.
import com.sun.jna.Library; import com.sun.jna.Native; import com.sun.jna.Platform;
/** Einfaches Beispiel einer Deklaration und Nutzung einer Dynamischen Programmbibliothek bzw. "shared library". */ public class HelloWorld { public interface CLibrary extends Library { CLibrary INSTANCE = (CLibrary)Native.loadLibrary((Platform.isWindows() ? "msvcrt" : "c"), CLibrary.class);
void printf(String format, Object... args);
public static void main(String[] args) { CLibrary.INSTANCE.printf("Hello, World\n"); for (int i=0;i < args.length;i++) { CLibrary.INSTANCE.printf("Argument %d: %s\n", i, args[i]);
Weblinks Java Native Access Homepage (englisch) Java Native Access – Download page (englisch) Java Native Access – User Mailing List (englisch)
Einzelnachweise
Kategorie:Java-Bibliothek