Add BridgeURL, BridgeURLWrapper, and BridgeURLFactory to the Bridge API

• Type: New Feature
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: facesbridge-api-5.0.0
• Fix Version/s: facesbridge-api-5.0.0
• Component/s: FacesBridge API
• Labels: None

Section 6.1.3.1 of the JSR 329 Spec has requirements that explain how the following methods deviate from the JSF ExternalContext javadoc (when running in a portlet environment):

• ExternalContext.encodeActionURL(String url) (JSF 1.2 javadoc)
• ExternalContext.encodeResourceURL(String url) (JSF 1.2 javadoc)

Since JSR 378 targets JSF 2.2, the JSR 378 Spec adds deviation requirements for the following methods:

• FACES-3516: ExternalContext.encodeBookmarkableURL(String baseUrl, Map<String,List<String>> parameters) (JSF 2.2 javadoc)
• FACES-3518: ExternalContext.encodePartialActionURL(String url) (JSF 2.2 javadoc)
• FACES-3517: ExternalContext.encodeRedirectURL(String baseUrl, Map<String,List<String>> parameters) (JSF 2.2 javadoc)

In order to achieve this goal, this issue serves as a proposal for adding the following to the Bridge API:

• javax.portlet.faces.BridgeURL (see com.liferay.faces.bridge.BridgeURL)
• javax.portlet.faces.BridgeURLWrapper (see com.liferay.faces.bridge.BridgeURLWrapper)
• javax.portlet.faces.BridgeURLFactory (see com.liferay.faces.bridge.BridgeURLFactory)

Note that the javadoc in BridgeURLFactory explains how the factory methods will help satisfy these encoding requirements.