Data Essentials Installation Guide

System Requirements

See our Minimum Requirements for using NES for Spring products.

Maven

Example References Application

You can access and clone the these sample applications using NES for Spring to try out installing and building. A more detailed README file is provided in the example application.

Additionally, you can view an example Github commit to see exactly what code aspects to change to drop-in NES packages.

Detailed Maven Instructions

1. Update your Maven build files

Substitute Spring dependencies in your pom.xml like the following example (use appropriate version).

Look up a specific artifact version in the "NES for Spring Artifacts: Paid Versions" table.

pom.xml

<!-- ... -->
<dependencies>
<!-- other dependencies as needed -->
  <dependency>
    <groupId>com.herodevs.nes.springframework.data</groupId>
    <artifactId>spring-data-jpa</artifactId>
    <version>2.7.18-spring-data-jpa-2.7.19</version>
  </dependency>
  <dependency>
    <groupId>com.herodevs.nes.springframework.data</groupId>
    <artifactId>spring-ldap-core</artifactId>
    <version>2.4.1-spring-ldap-2.4.2</version>
  </dependency>
<!-- other dependencies as needed -->

</dependencies>
<!-- ... -->

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

<pluginRepositories>
  <pluginRepository>
    <id>herodevs-nes-registry</id>
    <url>https://registry.nes.herodevs.com/maven</url>
  </pluginRepository>
</pluginRepositories>

2. Set Up Access

See our Registry Access guide for setting up a Maven settings.xml with access the HeroDevs NES registry.

~/.m2/settings.xml

<settings>
  <servers>
    <server>
      <id>herodevs-nes-registry</id>
      <username>any_text_here_not_used</username>
      <configuration>
         <httpHeaders>
           <property>
             <name>Authorization</name>
             <value>Bearer NES_TOKEN_HERE</value>
           </property>
         </httpHeaders>
       </configuration>
    </server>
  </servers>
</settings>

The ID of "herodevs-nes-registry" should match that of the ID for source and plugin repositories in the applications' pom.xml (or parent pom.xml). See example snippet above.

3. Install and Run

Install and run your application

./mvnw clean install -U

If your Maven settings.xml file is located in a path other than Maven's global path, use "-s path/to/settings.xml"

./mvnw -s ./settings.xml clean install -U

Gradle

Example Reference Application

If you would like to see an example of the install, refer to the sample application for using NES for Spring Foundations. A more detailed README file is provided in the example application.

Additionally, you can view an example git diff to see exactly what code aspects to change to drop-in NES packages.

Detailed Gradle Instructions

1. Update your Gradle build files

Substitute Spring Boot references in your build.gradle like the following

Look up a specific artifact version in the "NES for Spring Artifacts: Paid Versions" table.

build.gradle

dependencies {
  // other dependencies as needed...
  implementation "com.herodevs.nes.springframework.data:spring-data-jpa:2.7.18-spring-data-jpa-2.7.19"
  implementation "com.herodevs.nes.springframework.data:spring-ldap-core:2.4.1-spring-ldap-2.4.2"
}

2. Set Up Access

For more information, see our Registry Access guide for configuring Gradle with the HeroDevs NES registry.

Add NES repository information to global Gradle properties file (e.g. ~/.gradle/gradle.properties)

~/.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

Add the NES Maven repository to Gradle build files.

build.gradle

//...
repositories {
  maven {
    url = uri(providers.gradleProperty("herodevs_nes_registry_url").get())
    credentials {
      username = providers.gradleProperty("herodevs_nes_registry_user").get()
      password = providers.gradleProperty("herodevs_nes_registry_token").get()
    }
    authentication {
      basic(BasicAuthentication)
    }
  }
  mavenCentral()
}
//...

settings.gradle

pluginManagement {
  repositories {
  //...
   maven {
     url = uri(providers.gradleProperty("herodevs_nes_registry_url").get())
     credentials {
       username = providers.gradleProperty("herodevs_nes_registry_user").get()
       password = providers.gradleProperty("herodevs_nes_registry_token").get()
     }
     authentication {
       basic(BasicAuthentication)
     }
   }
   mavenCentral()
  //...
  }
}

3. Install and Run

Install and run your application

./gradlew build

Additional Information

The direct download URLs for NES for Spring artifacts follow this format:

Portion	Value
base_url	https://registry.nes.herodevs.com/maven/com/herodevs/nes/springframework/data
package_name	spring-data-jpa
version	2.7.18-spring-data-jpa-2.7.19
filename	package_name + version + extension

Example Link

https://registry.nes.herodevs.com/maven/com/herodevs/nes/springframework/data/spring-data-jpa/2.7.18-spring-data-jpa-2.7.19/spring-data-jpa-2.7.18-spring-data-jpa-2.7.19.pom