Foundations 5.3.x

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

<parent>
  <groupId>com.herodevs.nes.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>

  <!-- NES version here -->  
  <version>2.7.18-spring-boot-2.7.19</version>

  <relativePath />
</parent>

<!--...-->
<dependencies>
  <dependency>
    <groupId>com.herodevs.nes.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
  <dependency>
    <groupId>com.herodevs.nes.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
  </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

./mvnw spring-boot:run

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

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 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

plugins {
  id 'java'
  id 'com.herodevs.nes.springframework.boot' version '2.7.18-spring-boot-2.7.19'
  id 'io.spring.dependency-management' version '1.0.15.RELEASE'
}

dependencies {
  implementation "com.herodevs.nes.springframework.boot:spring-boot-starter-web"
  implementation "com.herodevs.nes.springframework.boot:spring-boot-starter-security"
  implementation "com.herodevs.nes.springframework.boot:spring-boot-starter-validation"
}

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

./gradlew bootRun

Additional Information

The direct download URLs for NES for Spring: Foundations 5.3.x follow this format:

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

Example Link

https://registry.nes.herodevs.com/maven/com/herodevs/nes/springframework/boot/spring-boot-starter-parent/2.7.18-spring-boot-2.7.19/spring-boot-starter-parent-2.7.18-spring-boot-2.7.19.pom