First, please review our Minimum Requirements to ensure a smooth installation.
Maven Setup
Follow these easy steps:
- Update your pom.xml with NES package versions and repository details
- Install and run!
Example
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.
1. Substitute your existing Spring Data dependencies for NES dependencies in your pom.xml like the following (use appropriate version):
Note: Use the Latest Versions of NES for Spring Artifacts to find the NES replacement version.
...
<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. Add your email address to the global Maven settings file in your home directory (~/.m2/settings.xml) or wherever you store project secrets. (preferably not in source code)
<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>
3. Install and run your application
./mvnw clean install -U
Note, 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 Install
Follow these easy steps:
- Update your build.gradle
- Update your Gradle properties file
- Build and run!
Example
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 changes are needed to use NES packages.
Detailed Gradle Instructions
1. Substitute your existing Spring Data dependencies for NES dependencies in your build.gradle like the following (use appropriate version):
Note: Use the Latest Versions of NES for Spring Artifacts to find the NES replacement version.
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()
}
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. Add NES repository information to global Gradle properties file (e.g. ~/.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
3. Add the NES maven repository to 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()
}
}
4. Install and run your application
./gradlew clean build
Additional Information
The direct download URLs for NES for Spring: Data Essentials follow this format (replace the package and version with that of the desired package):
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
[base_url] / [package_name] / [version] / [filename]
Example