JSF 2.x to Jakarta Server Faces 3.x
Recipe ID
com.oracle.weblogic.rewrite.jakarta.Faces2xMigrationToJakartaFaces3xArtifactorg.openrewrite.recipe:rewrite-third-partyJakarta EE 9 uses Faces 3.0 a major upgrade to Jakarta packages and XML namespaces.
Composite recipefacesjsfjakartajakartaeeApache 2.0
Usage
This recipe has no required configuration options. You’ll need the Moderne CLI configured before running the command below.
mod run . --recipe com.oracle.weblogic.rewrite.jakarta.Faces2xMigrationToJakartaFaces3xIf the recipe isn’t available locally, install it with:
mod config recipes jar install org.openrewrite.recipe:rewrite-third-party:RELEASEDefinition
This recipe runs the following recipes in order.
- Migrate JSF values inside EcmaScript files
org.openrewrite.java.migrate.jakarta.JakartaFacesEcmaScript - Replace
CURRENT_COMPONENTandCURRENT_COMPOSITE_COMPONENTwithgetCurrentComponent()andgetCurrentCompositeComponent()org.openrewrite.java.migrate.jakarta.RemovedUIComponentConstant - Faces XHTML migration for Jakarta EE 9
com.oracle.weblogic.rewrite.jakarta.JakartaFaces3Xhtml - Migrate xmlns entries in
faces-config.xmlfiles for Jakarta Server Faces 3com.oracle.weblogic.rewrite.jakarta.JavaxFacesConfigXmlToJakartaFaces3ConfigXml - Migrate xmlns entries in
*taglib*.xmlfiles for Jakarta Server Faces 3com.oracle.weblogic.rewrite.jakarta.JavaxFacesTagLibraryXmlToJakartaFaces3TagLibraryXml - Migrate xmlns entries in
test-web.xmlfiles for Jakarta Server Faces 3 using test interfacescom.oracle.weblogic.rewrite.jakarta.JavaxTestWebXmlToJakartaTestWebXml5 - Migrate xmlns entries in
web-fragment.xmlfiles for Jakarta Server Faces 3com.oracle.weblogic.rewrite.jakarta.JavaxWebFragmentXmlToJakartaWebFragmentXml5 - Migrate xmlns entries in
web.xmlfiles for Jakarta Server Faces 3com.oracle.weblogic.rewrite.jakarta.JavaxWebXmlToJakartaWebXml5 - JNDI name
jsf/ClientSideSecretKeyhas been renamed tofaces/ClientSideSecretKey, and thejsf/FlashSecretKeyJNDI name has been renamed tofaces/FlashSecretKey.com.oracle.weblogic.rewrite.jakarta.FacesJNDINamesChanged3 - Use
jakarta.elinstead ofjakarta.faces.elandjavax.faces.elcom.oracle.weblogic.rewrite.jakarta.RemovedJakartaFaces3ExpressionLanguageClasses - Update deprecated Faces method calls
com.oracle.weblogic.rewrite.jakarta.UpdateJakartaFacesMethodCalls - Replace
ResourceResolverwithResourceHandlercom.oracle.weblogic.rewrite.jakarta.RemovedJakartaFaces3ResourceResolver - Use
StateManagementStrategycom.oracle.weblogic.rewrite.jakarta.RemovedStateManagerMethods3 - Substitute deprecated Faces Managed Beans
com.oracle.weblogic.rewrite.jakarta.FacesManagedBeansRemoved3 - Upgrade Faces open source libraries
com.oracle.weblogic.rewrite.jakarta.UpgradeFacesOpenSourceLibraries3
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