Upgrade JSF portlet archetypes to Liferay Faces 3.1.2-ga3

• Type: Task
• Status: Closed
• Priority: Minor
• Resolution: Fixed
• Affects Version/s: 6.1.1 GA2, 6.1.20 EE GA2
• Fix Version/s: 6.2.0 GA1, 6.1.30 EE GA3, 6.1.2 CE GA3
• Component/s: Archetypes
• Labels: None
• Branch Version/s:
  6.1.x
• Backported to Branch:
  Committed
• Git Pull Request: https://github.com/brianchandotcom/liferay-maven-support/pull/66

This task involves FIVE parts:

Part 1: Fix the following FQCN typo in log4j.properties:

log4j.logger.com.liferay.faces.bridge.lifecycle.BridgeDebugPhaseListener=DEBUG

By changing it to this:

log4j.logger.com.liferay.faces.util.lifecycle.DebugPhaseListener=DEBUG

Part 2: Modify the following pom.xml descriptors:

https://github.com/liferay/liferay-maven-support/blob/master/archetypes/liferay-portlet-icefaces-archetype/src/main/resources/archetype-resources/pom.xml
https://github.com/liferay/liferay-maven-support/blob/master/archetypes/liferay-portlet-jsf-archetype/src/main/resources/archetype-resources/pom.xml
https://github.com/liferay/liferay-maven-support/blob/master/archetypes/liferay-portlet-liferay-faces-alloy-archetype/src/main/resources/archetype-resources/pom.xml
https://github.com/liferay/liferay-maven-support/blob/master/archetypes/liferay-portlet-primefaces-archetype/src/main/resources/archetype-resources/pom.xml
https://github.com/liferay/liferay-maven-support/blob/master/archetypes/liferay-portlet-richfaces-archetype/src/main/resources/archetype-resources/pom.xml

Specifically:

• Upgrade Liferay Faces dependencies to 3.1.2-ga3
• Upgrade Mojarra dependencies to 2.1.21
• Upgrade ICEfaces to version 3.3.0
• Upgrade PrimeFaces to version 3.5
• Upgrade RichFaces to version 4.3.2.Final

Part 3: Explicitly specify order of startup listeners in web.xml descriptors in JSF portlet archetypes

As described in FACES-1483, the Mojarra ConfigureListener and Liferay Faces BridgeSessionListener must be explicitly specified in web.xml in order to guarantee order of registration by the servlet container.

This task involves modifying the following files:
https://github.com/liferay/liferay-maven-support/blob/master/archetypes/liferay-portlet-icefaces-archetype/src/main/resources/archetype-resources/src/main/webapp/WEB-INF/web.xml
https://github.com/liferay/liferay-maven-support/blob/master/archetypes/liferay-portlet-jsf-archetype/src/main/resources/archetype-resources/src/main/webapp/WEB-INF/web.xml
https://github.com/liferay/liferay-maven-support/blob/master/archetypes/liferay-portlet-liferay-faces-alloy-archetype/src/main/resources/archetype-resources/src/main/webapp/WEB-INF/web.xml
https://github.com/liferay/liferay-maven-support/blob/master/archetypes/liferay-portlet-primefaces-archetype/src/main/resources/archetype-resources/src/main/webapp/WEB-INF/web.xml
https://github.com/liferay/liferay-maven-support/blob/master/archetypes/liferay-portlet-richfaces-archetype/src/main/resources/archetype-resources/src/main/webapp/WEB-INF/web.xml

The Mojarra listener will be specified by default:

<listener>
	<listener-class&gt;com.sun.faces.config.ConfigureListener</listener-class&gt;
</listener>
<listener>
	<listener-class&gt;com.liferay.faces.bridge.servlet.BridgeSessionListener</listener-class&gt;
</listener>

Part 4: Add the WEB-INF/weblogic.xml descriptor for deployment on WebLogic Server

<?xml version="1.0" encoding="UTF-8"?>
<wls:weblogic-web-app xmlns:wls="http://xmlns.oracle.com/weblogic/weblogic-web-app" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd http://xmlns.oracle.com/weblogic/weblogic-web-app http://xmlns.oracle.com/weblogic/weblogic-web-app/1.4/weblogic-web-app.xsd">
	<wls:container-descriptor>
		<wls:prefer-application-packages>
			<wls:package-name>com.sun.xml.bind.*</wls:package-name>
			<wls:package-name>org.apache.commons.fileupload.*</wls:package-name>
			<wls:package-name>org.apache.xerces.*</wls:package-name>
		</wls:prefer-application-packages>
		<wls:optimistic-serialization>true</wls:optimistic-serialization>
		<wls:show-archived-real-path-enabled>true</wls:show-archived-real-path-enabled>
	</wls:container-descriptor>
</wls:weblogic-web-app>

Part 5: Exclude the jsf-api artifact from the icefaces dependency in the ICEfaces archetype project. For more info, see:

http://www.liferay.com/community/forums/-/message_boards/message/25896745