Repository files navigation

For build instructions please see theonline documentation,or either of these files:

• doc/building.html (html version)
• doc/building.md (markdown version)

Seehttps://openjdk.java.net/ for more information aboutthe OpenJDK Community and the JDK.

This repository contains changes which aim at improving the interoperability between the Java programming language and native libraries, which is one of the main goals of Project Panama. More information can be found at:https://openjdk.java.net/projects/panama/

The Project Panama JBS dashboard can be found at:https://bugs.openjdk.java.net/Dashboard.jspa?selectPageId=18412

Early acccess (EA) binary snapshots can be found at:http://jdk.java.net/panama/

This repository houses two main branches:

• foreign-memaccess+abi: Contains the developement of both the foreign memory access API (JEP 393) and the foreign linker API (JEP 389). The former can be used to interact with different kinds of memory resources, including so-called off-heap or native memory. The latter can be used to call native code in a .dll/.so/.dylib, or to create a native function pointer to a Java method which can be passed to code in a native library. More information on how to use the memory access API and foreign linker API can be foundhere andhere, respectively.
• foreign-jextract: Contains the development of an API to parse native headers, which can be used to create an abstract representation (declarations) from a C header file. This branch also provides an accompanying extraction tool (jextract), which is built on top of the API, and can be used to generate Java bindings to access functions and/or structs in a native library described by a given header file. More information on how to use the jextract tool can be foundhere.

The foreign-jextract branch depends on the foreign-memaccess+abi branch, which in turn depends on the master branch (which is kept periodically in sync with jdk/jdk). As such, the foreign-jextract branch is the most complete of the three and therefore the default branch of this repository.

Jextract requiresLLVM 9.x as a dependency. So, to build the foreign-jextract branch, the flag--with-libclang=/path/to/llvm/root must be supplied when generating a build configuration. Please seedoc/building.md for general building instructions.