GraphQL Java Setup | HeroDevs Docs

Setup Instructions

NES for GraphQL Java 18.5.x requires Java 8.

Configure Registry

Create or update your registry configuration:

Maven (~/.m2/settings.xml)

<settings>
  <servers>
    <server>
      <id>herodevs-nes-registry</id>
      <username>any_text_here_not_used</username>
      <password>YOUR_NES_ACCESS_TOKEN</password>
    </server>
  </servers>
</settings>

Gradle (~/.gradle/gradle.properties)

herodevs_nes_registry_url=https://registry.nes.herodevs.com/maven
herodevs_nes_registry_user=any_text_here_not_used
herodevs_nes_registry_token=NES_TOKEN_HERE

See the guides for Sonatype Nexus or JFrog Artifactory for setup to the HeroDevs NES registry.

Update Build Configuration

Add the NES repository and dependencies to your build configuration:

Look up the latest artifact version in the "GraphQL Java Release Notes".

Maven (pom.xml)

<!-- Update GraphQL Java dependency version. Other option is using NES version for each graphql-java import -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.graphql-java</groupId>
      <artifactId>graphql-java</artifactId>
      <version>18.5.0-graphql-java-18.5.1</version><!-- Updated Version -->
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<!-- Add NES repository -->
<repositories>
  <repository>
    <id>herodevs-nes-registry</id>
    <url>https://registry.nes.herodevs.com/maven</url>
  </repository>
</repositories>

Gradle

buildscript {
  repositories {
    maven {
      url = uri("${herodevs_nes_registry_url}")
      credentials {
        username = "${herodevs_nes_registry_user}"
      }
    }
    mavenCentral()
  }
}

apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'idea'
apply plugin: 'application'

dependencies {
  implementation(platform("com.graphql-java:graphql-java:18.5.0-graphql-java-18.5.1")) // Updated Version
}

// Add NES Repository
repositories {
  maven {
    url = uri("${herodevs_nes_registry_url}")
    credentials {
      username = "${herodevs_nes_registry_user}"
      password = "${herodevs_nes_registry_token}"
    }
  }
  mavenCentral()
}

Build

In order to remove potential obstacles before building your project, make sure the following domains are whitelisted by your firewall/networking team:

registry.nes.herodevs.com
assets.nes.herodevs.com

This will ensure that your network/firewall allows connection to our registry.

Run your build tool:

Maven

mvn clean install

Gradle

gradle clean build

Verification

To verify your installation, check that:

Dependencies are downloaded successfully
No version conflicts are reported in your build
Your application starts without errors

Manual Downloads

The direct download URLs for NES for GraphQL Java packages follow this format:

Portion	Value
base_url	https://registry.nes.herodevs.com/maven/com/graphql-java/
package_name	graphql-java
version	18.5.0-graphql-java-18.5.1
filename	package_name + version + extension

Example Link

https://registry.nes.herodevs.com/maven/com/graphql-java/graphql-java/18.5.0-graphql-java-18.5.1/graphql-java-18.5.0-graphql-java-18.5.1.pom