You can generate a Liferay Faces application without having to create your own folder structure, descriptor files, and such manually. If you really want to do that manually, you can examine the structure of a JSF application and create one from scratch in the Creating a JSF Project Manually tutorial.
Before generating your JSF application, you should first visit liferayfaces.org, a great reference spot for JSF application development targeted for Liferay DXP. This site lets you choose the options for your JSF application and generates a Maven archetype command you can execute to generate an application with your chosen options. You can select the following archetype options:
- Liferay Portal Version
- JSF Version
- Component Suite
You can also choose a build framework (Gradle or Maven) and have a list of
dependencies generated for you and displayed on the page. The dependencies are
provided to you on the site page in a pom.xml
or build.gradle
, depending on
the build type you selected. This is useful because it gives you an idea of what
dependencies are required in your JSF application before generating it.
Note: Gradle developers can also use the archetype:generate
command
because it generates both a build.gradle
and a pom.xml
file for you to use.
Figure 1: You can select the Liferay Portal version, JSF version, and component suite for your archetype generation command.
Next you’ll generate an example JSF application (e.g., Liferay Portal 7 + JSF 2.2 + JSF Standard) via command line using liferayfaces.org.
-
Navigate to liferayfaces.org and select the following options:
- Liferay Portal: 7
- JSF: 2.2
- Component Suite: JSF Standard
-
Copy the archetype generation command and execute it. Make sure you’ve navigated to the folder where you want to generate your project.
That’s it! Your JSF application is generated in the current folder!
You can also generate a Liferay JSF application using Maven’s interactive
archetype UI. To do this, execute mvn archetype:generate -Dfilter=liferay
and
select the JSF archetype you want to use. Then you’ll step through each option
and select the version, group ID, artifact ID, etc. To learn more about this,
see the
Generating New Projects Using Archetypes
tutorial.
Once you have your JSF application generated, you can import it into Liferay Developer Studio and develop it further. To deploy it to your Liferay DXP instance, drag and drop it onto the Liferay DXP server.
You can build the project and deploy it to Liferay DXP from the command line too! If you’re using Gradle, run the following command to build your JSF application:
gradle build
For Maven, execute the following command:
mvn package
Then copy the generated WAR to Liferay DXP’s deploy
folder:
[cp|copy] ./com.mycompany.my.jsf.portlet.war LIFERAY_HOME/deploy
Awesome! You’ve generated your JSF application and deployed it using the command line.