Java Native Access

Infobox Software
name = Java Native Access



caption =
developer =
latest release version = 3.0.5
latest release date = release date|2008|08|14
latest preview version =
latest preview date =
operating system = Cross-platform
size = 606.9 KB (archived)
programming language = C and Java
genre = Software Library
license = LGPL version 2.1 or later.
website = https://jna.dev.java.net

Java Native Access provides Java programs easy access to native shared libraries (DLLs on Windows) without using Java Native Interface. JNA's design aims to provide native access in a natural way with a minimum of effort. No boilerplate or generated glue code is required. While some attention is paid to performance, correctness and ease of use take priority. The JNA library uses a small native library stub to dynamically invoke native code. The developer uses a Java interface to describe functions and structures in the target native library. This makes it quite easy to take advantage of native platform features without incurring the high overhead of configuring and building JNI code.

Adoption

Java Native Access is known to be used in:
*JRuby use JNA for POSIX functionality [ [http://headius.blogspot.com/2007/09/java-native-access-jruby-true-posix.html Java Native Access + JRuby = True POSIX] ]
*Freedom for Media in Java (FMJ) [ [http://fmj-sf.net/ Freedom for Media in Java] ]
*IntelliJ IDEA IDE by the company JetBrains
*SVNKit pure Java Subversion client library.
*Videolan JVLC Java Multimedia Library.

Mapping types

The following table shows the mapping of types between Java and native code and supported by the JNA library.

Example

The following program loads the the stdio.h "standard input/output header" from C standard library and uses it to call the "printf" function. Note that the code is portable and works the same on Windows and Linux / Unix / Mac OS X platforms.

import com.sun.jna.Library;import com.sun.jna.Native;import com.sun.jna.Platform;

/** Simple example of native library declaration and usage. */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 "); for (int i = 0; i < args.length; i++) { CLibrary.INSTANCE.printf("Argument %d: %s ", i, args [i] ); }

The following program loads the the C POSIX library and uses it to call the standard "mkdir" function. Note that the code is portable and works the same on POSIX standards platforms.

import com.sun.jna.Library;import com.sun.jna.Native;

/** Simple example of native C POSIX library declaration and usage. */public class exampleOfPOSIX { public interface POSIX extends Library { public int chmod(String filename, int mode); public int chown(String filename, int user, int group); public int rename(String oldpath, String newpath); public int kill(int pid, int signal); public int link(String oldpath, String newpath); public int mkdir(String path, int mode); public int rmdir(String path); }

public static void main(String [] args) { POSIX posix = (POSIX) Native.loadLibrary("c", POSIX.class); posix.mkdir("/tmp/newdir", 777); posix.rename("/tmp/newdir","/tmp/renamedir");

The program below loads the Kernel32.dll and uses it to call the "Beep" and "Sleep" functions.
Note: The following code works only on Windows platforms.import com.sun.jna.Library;import com.sun.jna.Native;

/** Simple example of Windows native library declaration and usage. */public class BeepExample { public interface Kernel32 extends Library { // FREQUENCY is expressed in hertz and ranges from 37 to 32767 // DURATION is expressed in milliseconds public boolean Beep(int FREQUENCY, int DURATION); public void Sleep(int DURATION); } public static void main(String [] args) { Kernel32 lib = (Kernel32) Native.loadLibrary("kernel32", Kernel32.class); lib.Beep(698, 500); lib.Sleep(500); lib.Beep(698, 500);

References

ee also

*Java Native Interface
*P/Invoke

External links

* [https://jna.dev.java.net Java Native Access Web Page]
* [http://www.javaworld.com/javaworld/jw-02-2008/jw-02-opensourcejava-jna.html Java Native Access:An easier way to access native code] By Jeff Friesen, JavaWorld.com, 02/05/08