Setup
Installation and configuration guide for NES for Apache Struts 1.3.x Forward Compatibility
About
NES for Apache Struts 1.3.x Forward Compatibility is a modernized version of the original Struts 1.3.x framework, designed to be compatible with forward EE9 application servers and Java 11. It provides a drop-in replacement for the original Struts 1.3.x libraries, ensuring that existing applications can run with minimal changes while benefiting from forward Java features and being secure.
Migration Instructions
- NES for Apache Struts 1 Forward Compatibility recommends Java 11
- Java EE9 compatibility is available in this version.
- Recommend migrating from NES Struts 1.3.x to Struts 1.3 Forward Compatibility.
- See the guides for Sonatype Nexus or JFrog Artifactory for setup to the HeroDevs NES registry.
Update Your Application to NES for Apache Struts 1.3.x Forward Compatibility
Look up the latest artifact version in the "Struts Forward Compatibility Release Notes".
Update NES Dependencies: Replace your existing Struts 1.3.x dependencies with the NES for Apache Struts 1.3.x Forward Compatibility version in your build configuration.
<dependencies>
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts-core</artifactId>
<version>1.3.10-struts-1.4.1</version><!-- Updated Version -->
</dependency>
<!-- Other dependencies as needed -->
</dependencies>
Update Your Application Dependencies, Code, and Configuration
Update Java EE to Jakarta EE: If your application uses Java EE APIs, update them to their Jakarta EE equivalents. This may involve changing package names from javax.*
to jakarta.*
.
- Upgrade dependency
javax.servlet:servlet-api:2.3
tojakarta.servlet:jakarta.servlet-api:5.0.0
- Add dependency
jakarta.servlet.jsp:jakarta.servlet.jsp-api:3.0.0
- If using
struts-el
, add dependencyjakarta.servlet.jsp.jstl:jakarta.servlet.jsp.jstl-api:2.0.0
andorg.glassfish.web:jakarta.servlet.jsp.jstl:2.0.0
- If using
struts-faces
, add dependencyjakarta.faces:jakarta.faces-api:3.0.0
,jakarta.el:jakarta.el-api:4.0.0
,jakarta.servlet.jsp.jstl:jakarta.servlet.jsp.jstl-api:2.0.0
,org.glassfish.web:jakarta.servlet.jsp.jstl:2.0.0
- Upgrade dependency
commons-fileupload:commons-fileupload
toorg.apache.commons:commons-fileupload2-core:2.0.0-M4
andorg.apache.commons:commons-fileupload2-jakarta-servlet5:2.0.0-M4
- Switch imports from
javax.
tojakarta.
in your Java code, JSPs, and configuration files.
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:
mvn clean install
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 Apache Struts Forward Compatibility packages follow this format:
Portion | Value |
---|---|
base_url | https://registry.nes.herodevs.com/maven/org/apache/struts/ |
package_name | struts-core |
version | 1.3.10-struts-1.4.1 |
filename | package_name + version + extension |