GraphAr Java (under development)

This directory contains the code and build system for the GraphAr Java library which powered by Alibaba-FastFFI.

Dependencies

Java

  • JDK 8 or higher
  • Maven3+

C++

  • CMake 3.5 or higher
  • LLVM 11

Install

Only support installing from source currently, but we will support installing from Maven in the future.

Firstly, install llvm-11. LLVM11_HOME should point to the home of LLVM 11. In Ubuntu, it is at /usr/lib/llvm-11. Basically, the build procedure the following binary:

  • $LLVM11_HOME/bin/clang++
  • $LLVM11_HOME/bin/ld.lld
  • $LLVM11_HOME/lib/cmake/llvm

Tips:

  • Use Ubuntu as example:

    $ sudo apt-get install llvm-11 clang-11 lld-11 libclang-11-dev libz-dev -y
$ export LLVM11_HOME=/usr/lib/llvm-11

  • Or compile from source with this script:

    $ export LLVM11_HOME=/usr/lib/llvm-11
$ export LLVM_VAR=11.0.0
$ sudo ./install-llvm11.sh

Make the graphar-java-library directory as the current working directory:

 $ git clone https://github.com/apache/incubator-graphar.git
 $ cd incubator-graphar
 $ git submodule update --init
 $ cd maven-projects/java

Compile package:

 $ mvn clean install -DskipTests

This will build GraphAr C++ library internally for Java. If you already installed GraphAr C++ library in your system, you can append this option to skip: -DbuildGarCPP=OFF

Then set GraphAr as a dependency in maven project:

<dependencies>
    <dependency>
      <groupId>org.apache.graphar</groupId>
      <artifactId>java</artifactId>
      <version>0.1.0</version>
    </dependency>
</dependencies>

Generate API document

Building the API document with maven:

mvn javadoc:javadoc

The API document will be generated in the target/site/apidocs directory.

How to use

Please refer to GraphAr Java Library Documentation.