Starting a Portlet Project

The BOM Concept

To make the management of dependencies easier, GateIn Portal Team has prepared the Bill of Materials (BOM) needed for developing typical portlet applications. BOM is a Maven pom.xml file which specifies the versions of dependencies which are granted to be compatible with (or indeed in many cases provided by) GateIn Portal.

Please note that GateIn Portal BOM is closely tied to JBoss AS/EAP and therefore we cannot guarantee that the examples below will work on other servers.

How to Use GateIn Portal BOM

Let us look at the pom.xml file from Simplest Hello World Quickstart below, which contains all necessary details.

In its <dependencyManagement> section, it declares <dependency> gatein-3.6-bom with <scope> import. It indicates that the dependency will de facto be replaced with the dependencies in its dependencyManagement section. Due to this fact, in the <dependencies> section of the Simplest Hello World pom.xml, we can declare the javax.portlet:portlet-api dependency without specifying its <version> because it is managed by gatein-3.6-bom.

Further steps, after you have set up the pom.xml file for your project, depend on the technology you have chosen for writing portlets.