Skip to content

Nebula Java

Nebula Java is a Java client for connecting to and managing the NebulaGraph database.

Prerequisites

You have installed Java 8.0 or later versions.

Compatibility with NebulaGraph

NebulaGraph version Nebula Java version
3.1.0 3.0.0
2.6.x 2.6.1
2.0.x 2.0.0
2.0.0-rc1 2.0.0-rc1

Download Nebula Java

  • (Recommended) To install a specific version of Nebula Java, use the Git option --branch to specify the branch. For example, to install v3.0.0, run the following command:

    $ git clone --branch v3.0.0 https://github.com/vesoft-inc/nebula-java.git
    
  • To install the daily development version, run the following command to download the source code from the master branch:

    $ git clone https://github.com/vesoft-inc/nebula-java.git
    

Use Nebula Java

Note

We recommend that each thread uses one session. If multiple threads use the same session, the performance will be reduced.

When importing a Maven project with tools such as IDEA, set the following dependency in pom.xml.

Note

3.0.0-SNAPSHOT indicates the daily development version that may have unknown issues. We recommend that you replace 3.0.0-SNAPSHOT with a released version number to use a table version.

<dependency>
  <groupId>com.vesoft</groupId>
  <artifactId>client</artifactId>
  <version>3.0.0-SNAPSHOT</version>
</dependency>

If you cannot download the dependency for the daily development version, set the following content in pom.xml. Released versions have no such issue.

<repositories> 
  <repository> 
    <id>snapshots</id> 
    <url>https://oss.sonatype.org/content/repositories/snapshots/</url> 
  </repository> 
</repositories>

If there is no Maven to manage the project, manually download the JAR file to install Nebula Java.

Core of the example code

This sub-section shows the core of the example code. For all the code, see GraphClientExample.


Last update: March 13, 2023