JSF 2.x to Jakarta Faces 3.x

Usage

This recipe has no required configuration options. You’ll need the Moderne CLI configured before running the command below.

mod run . --recipe org.openrewrite.java.migrate.jakarta.Faces2xMigrationToJakartaFaces3x

If the recipe isn’t available locally, install it with:

mod config recipes jar install org.openrewrite.recipe:rewrite-migrate-java:3.41.0

Definition

This recipe runs the following recipes in order.

• Migrate deprecated javax.faces packages to jakarta.facesorg.openrewrite.java.migrate.jakarta.UpdateJakartaFacesApi3
• Faces XHTML migration for Jakarta EE 9org.openrewrite.java.migrate.jakarta.JakartaFacesXhtmlEE9
• Migrate JSF values inside EcmaScript filesorg.openrewrite.java.migrate.jakarta.JakartaFacesEcmaScript
• Migrate xmlns entries in faces-config.xml filesorg.openrewrite.java.migrate.jakarta.JavaxFacesConfigXmlToJakartaFacesConfigXml
• Migrate xmlns entries in taglib.xml filesorg.openrewrite.java.migrate.jakarta.JavaxFacesTagLibraryXmlToJakartaFacesTagLibraryXml
• Migrate xmlns entries in web-fragment.xml filesorg.openrewrite.java.migrate.jakarta.JavaxWebFragmentXmlToJakartaWebFragmentXml
• Migrate xmlns entries in web.xml filesorg.openrewrite.java.migrate.jakarta.JavaxWebXmlToJakartaWebXml
• JNDI name jsf/ClientSideSecretKey has been renamed to faces/ClientSideSecretKey, and the jsf/FlashSecretKey JNDI name has been renamed to faces/FlashSecretKeyorg.openrewrite.java.migrate.jakarta.FacesJNDINamesChanged
• Use jakarta.el instead of jakarta.faces.el and javax.faces.elorg.openrewrite.java.migrate.jakarta.RemovedJakartaFacesExpressionLanguageClasses
• Replace ResourceResolver with ResourceHandlerorg.openrewrite.java.migrate.jakarta.RemovedJakartaFacesResourceResolver
• Use StateManagementStrategyorg.openrewrite.java.migrate.jakarta.RemovedStateManagerMethods
• Replace CURRENT_COMPONENT and CURRENT_COMPOSITE_COMPONENT with getCurrentComponent() and getCurrentCompositeComponent()org.openrewrite.java.migrate.jakarta.RemovedUIComponentConstant
• Upgrade Faces open source librariesorg.openrewrite.java.migrate.jakarta.UpgradeFaces3OpenSourceLibraries

Data tables

Structured output this recipe can produce.

• Source files that had resultsSource files that were modified by the recipe run.org.openrewrite.table.SourcesFileResults
• Source files that had search resultsSearch results that were found during the recipe run.org.openrewrite.table.SearchResults
• Source files that errored on a recipeThe details of all errors produced by a recipe run.org.openrewrite.table.SourcesFileErrors
• Recipe performanceStatistics used in analyzing the performance of recipes.org.openrewrite.table.RecipeRunStats