Jetspeed Simple JSF Portlet Guide Documentation for Creating a Simple JSF Portlet

This guide provides a tutorial for creating a very simple JSF portlet with one template in the portlet view mode.

Create the file JSFSimplest.java in a directory called jsf-simplest/WEB-INF/classes: public class JSFSimplest extends org.apache.portals.bridges.jsf.FacesPortlet { public void doView(javax.portlet.RenderRequest request, javax.portlet.RenderResponse response) throws javax.portlet.PortletException, java.io.IOException { super.doView(request, response); } }

Compile the class in the jsf-simplest/WEB-INF/classes directory using the command, javac -cp portlet-api-1.0.jar:portals-bridges-jsf-1.0.jar:portals-bridges-common-1.0.jar JSFSimplest.java

Create the file portlet.xml in the jsf-simplest/WEB-INF directory. JSFSimplestPortlet JSF Simplest Display Name JSFSimplest ViewPage /WEB-INF/view/view.jsp text/html VIEW en fr JSF Simplest Title JSF Simplest Short Title ]]>

Create the file web.xml in the jsf-simplest/WEB-INF directory. JSF Simplest The world's simplest JSF portlet javax.faces.application.CONFIG_FILES /WEB-INF/faces-config.xml Faces Servlet javax.faces.webapp.FacesServlet Faces Servlet *.jsf ]]>

Create the view.jsp file in the jsf-simplest/WEB-INF/view directory. <%@ taglib uri="/WEB-INF/tld/portlet.tld" prefix='portlet'%>

A JSF Portlet

Hello <% if ( renderRequest.getUserPrincipal() == null ) { %> guest <% } else { %> <%=renderRequest.getUserPrincipal().getName()%> <% } %>! ]]>

Create a faces-config.xml file in the jsf-simplest/WEB-INF directory. en fr ]]>

Copy the dependencies to the WEB-INF/lib directory. These jars should be in your Maven repository. If so executing these commands in the lib directory will set up the dependencies for you. ln -s ~/.maven/repository/commons-beanutils/jars/commons-beanutils-1.7.0.jar ln -s ~/.maven/repository/commons-collections/jars/commons-collections-3.1.jar ln -s ~/.maven/repository/commons-digester/jars/commons-digester-1.7.jar ln -s ~/.maven/repository/myfaces/jars/myfaces-api-1.1.0.jar ln -s ~/.maven/repository/myfaces/jars/myfaces-impl-1.1.0.jar ln -s ~/.maven/repository/myfaces/jars/tomahawk-1.1.0.jar ln -s ~/.maven/repository/org.apache.portals.bridges/jars/portals-bridges-jsf-1.0.jar ln -s ~/.maven/repository/xerces/jars/xerces-2.4.0.jar ln -s ~/.maven/repository/xml-apis/jars/xml-apis-2.0.2.jar

From the directory jsf-simplest combine the files above into a war file using the command, jar cvf ../jsfsimplest.war .

Copy the war file to $CATALINA_HOME/webapps/jetspeed/WEB-INF/deploy. Jetspeed-2 will deploy the webapp.

Create the PSML page using the Jetspeed portlet chooser. Login and click on the edit page icon. Click on the add portlet icon. Checkbox and add the JSFSimplestPortlet to your page. Your user must have the permission to edit pages. The user admin password admin has permission to edit all pages.