Document: Jakarta EE 11: Support Jakarta Server Faces 4.1

[volosied]

OpenLiberty/open-liberty#25089

Differences between Jakarta Server Faces 4.1 and 4.0

Originally a Faces 5.0 release was planned, but was too ambitious. Instead, the scope was adjusted to deliver a minor 4.1 release focusing on general improvements and deprecations.

New Additions:

• CDI events, @Initialized, @BeforeDestroyed, and @Destroyed now fire for build-in scopes (ViewScoped, FlowScoped)
• It's now possible to inject Flow objects into backing beans using @Inject Flow currentFlow
• A built-in jakarta.faces.convert.UUIDConverter is now provided via the API.
• The jakarta.faces.context.ExternalContext.setResponseContentLengthLong() as been added.
• The rowStatePreserved property is now supported by the ui:repeat tag, just as with h:dataTable.
• The jakarta.faces.FACELETS_REFRESH_PERIOD default when ProjectStage is Development
• The jakarta.faces.application.FacesMessage class now implements the equals(), hashcode(), and toString() methods. These are useful to allow FacesMessages to stored within HashMaps.
• Generics were further incorporated throughout the API.

Deprecations:

• Full State Saving (FSS) has been deprecated. This setting is enabled by either jakarta.faces.PARTIAL_STATE_SAVING or jakarta.faces.FULL_STATE_SAVING_VIEW_ID.
• The jakarta.faces.event.PreDestroyCustomScopeEvent and jakarta.faces.event.PostConstructCustomScopeEvent classes have been deprecated. These were missed during the CustomScoped removal in Faces 4.0.
• The unimplemented composite:extension tag as been deprecated.
• All SecurityManager references within the API have been removed to align with the newer JDKs.

[ramkumar-k-9286]

Hi @volosied

The suggested information has been added to the differences page.

Draft link: https://docs-draft-openlibertyio.mqj6zf7jocq.us-south.codeengine.appdomain.cloud/docs/latest/reference/diff/jakarta-ee11-diff.html#faces

Please review the same and let me know if you are ok with the content or if we need to add more information in the section.

If that is the case, please explain what changes need to be made ( in this issue), so that those changes can be made.

Regards,
Ramkumar.

[volosied]

I would change the Removals title to Deprecations.

@ramkumar-k-9286

Otherwise, it looks good to me.

[pnicolucci]

I would change the Removals title to Deprecations.

@ramkumar-k-9286

Otherwise, it looks good to me.

1. Perhaps deprecations and removals? Since this section does talk about the removal of the SecurityManager APIs
2. Could we update The default value of jakarta.faces.FACELETS_REFRESH_PERIOD is updated when ProjectStage is set to Development. to give what the value change actually is? Link to the API for reference: https://jakarta.ee/specifications/faces/4.1/apidocs/jakarta.faces/jakarta/faces/application/viewhandler#FACELETS_REFRESH_PERIOD_PARAM_NAME

[volosied]

I agree to both.

Let's say The default value of jakarta.faces.FACELETS_REFRESH_PERIOD was updated to 0 (always recompile) for the 'Development' ProjectStage. The 'Production' default remains at -1 (never recompile).

[ramkumar-k-9286]

Hi @volosied

The suggested changes have been made to the differences page.

Draft link: https://docs-draft-openlibertyio.mqj6zf7jocq.us-south.codeengine.appdomain.cloud/docs/latest/reference/diff/jakarta-ee11-diff.html#faces

Regards,
Ramkumar.

[ramkumar-k-9286]

Hi @volosied

I had to do some re-work in the differences page. content-wise as well.

Could you have a look at the draft again.

Draft link: https://docs-draft-openlibertyio.mqj6zf7jocq.us-south.codeengine.appdomain.cloud/docs/latest/reference/diff/jakarta-ee11-diff.html#faces

Please review the same and let me know if you are ok with the content or if we need to add more information in the section.

If that is the case, please explain what changes need to be made ( in this issue), so that those changes can be made.

Please add Developer Reviewed label if you are satisfied with the changes.

Regards,
Ramkumar.

[volosied]

CDI lifecycle events: I would remove including since @ViewScoped and @FlowScoped are the two main faces scopes

Facelets refresh period: The Production default remains -1 (never recompile). May be add that last part in for consistency?

Otherwise, it look good to me.