Skip to content

Latest commit

 

History

History
32 lines (23 loc) · 2.74 KB

README.md

File metadata and controls

32 lines (23 loc) · 2.74 KB
Raw

Welcome to the JDK!

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

See https://openjdk.java.net/ for more information about the OpenJDK Community and the JDK.

About Project Panama

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/

About the panama-foreign repository

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 found here and here, 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 found here.

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.

Building notes

Jextract requires LLVM 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 see doc/building.md for general building instructions.