Liferay Faces 3.2 and 4.2 are compatible with Liferay Portal 6.2 (see the Liferay Faces Version Scheme for more info on Liferay Portal compatibility). Migrating to Liferay Faces 3.2/4.2 from Liferay Faces 3.1 requires a few changes to ensure your projects continue working correctly.
This tutorial covers the following migration topics:
- Migrating the liferay-portlet.xml File for Liferay Faces 3.2/4.2
- Migrating Liferay Faces Alloy Tags for Liferay Faces Alloy 3.2/4.2
First, you’ll learn how to upgrade your
Migrating the liferay-portlet.xml File
Liferay Portal 6.2 has two compatible Liferay Faces Versions: 3.2 and 4.2. Liferay provides Liferay Faces 3.2 for compatibility with JSF 2.1 and Liferay Faces 4.2 for compatibility with JSF 2.2 (see the Liferay Faces Version Scheme for more info on Liferay Portal and JSF compatibility). If you’re currently using Liferay Faces 3.1 and are interested in upgrading from Liferay Portal 6.1 to 6.2, but aren’t interested in compatibility with JSF 2.2, you should upgrade from Liferay Faces 3.1 to 3.2. But, if you want to use JSF 2.2 in addition to Liferay 6.2, you must upgrade to Liferay Faces 4.2.
Liferay Portal 6.2 can enforce namespacing of portlet request parameters, but you must turn this off for your JSF portlets by specifying
<requires-namespaced-parameters>false</requires-namespaced-parameters> in each
<portlet> element of your portlet project’s
WEB-INF/liferay-portlet.xml file. Here’s a snippet that specifies this descriptor:
<liferay-portlet-app> <portlet> ... <requires-namespaced-parameters>false</requires-namespaced-parameters> ... </portlet> ... </liferay-portlet-app>
Turning off the parameter namespace requirement is all you need to do to upgrade your JSF portlets to Liferay Faces 3.2 or 4.2, for use in Liferay Portal 6.2.
liferay-portlet.xml file is now migrated to Liferay Faces 3.2/4.2. Stupendous!
Migrating Liferay Faces Alloy 3.1 Tags to Liferay Faces Alloy 3.2/4.2 Tags
First, you’ll look at the changes to the
aui namespace tags.
Changes to the Liferay Faces Alloy aui Tags
The following table identifies the
aui tags that are deprecated in 3.2/4.2 and each tag’s replacement, if a replacement exists.
Tag Deprecations in the
|Deprecated ||Replacement |
| || |
| ||No Replacement|
Next, you’ll look at the changes to the tags in the
Changes to the Liferay Faces Alloy aui-cc Tags
Below is a table of the
aui-cc tags that are deprecated or removed with respect to the Liferay Faces 3.2 and 4.2 releases:
Tag Deprecations in the
Excellent! You’re now familiar with the AlloyUI related migration changes, in addition to other changes required to migrate to Liferay Faces 3.2/4.2.