Setup
Installation and configuration guide for NES for Apache Struts 1.3.x Modern Compatibility
About
NES for Apache Struts 1.3.x Modern Compatibility is a modernized version of the original Struts 1.3.x framework, designed to be compatible with modern 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 modern Java features and being secure.
Migration Instructions
- NES for Apache Struts 1 Modern Compatibility recommends Java 11
- Java EE9 compatibility is available in this version.
- Recommend migrating from NES Struts 1.3.x to Struts 1.3 Modern 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 Modern Compatibility
Look up the latest artifact version in the "Struts Modern Compatibility Release Notes".
Update NES Dependencies: Replace your existing Struts 1.3.x dependencies with the NES for Apache Struts 1.3.x Modern 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 Modern 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 |