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.
<?xml version="1.0" encoding="UTF-8"?> <portlet-app id="jsfsimplest" version="1.0"> <portlet id="JSFSimplest"> <portlet-name>JSFSimplestPortlet</portlet-name> <display-name>JSF Simplest Display Name</display-name> <portlet-class>JSFSimplest</portlet-class> <init-param> <name>ViewPage</name> <value>/WEB-INF/view/view.jsp</value> </init-param> <supports> <mime-type>text/html</mime-type> <portlet-mode>VIEW</portlet-mode> </supports> <supported-locale>en</supported-locale> <supported-locale>fr</supported-locale> <portlet-info> <title>JSF Simplest Title</title> <short-title>JSF Simplest Short Title</short-title> </portlet-info> </portlet> </portlet-app>
Create the file web.xml in the jsf-simplest/WEB-INF directory.
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <display-name>JSF Simplest</display-name> <description>The world's simplest JSF portlet</description> <!-- Faces Config --> <context-param> <param-name>javax.faces.application.CONFIG_FILES</param-name> <param-value>/WEB-INF/faces-config.xml</param-value> </context-param> <!-- Faces Servlet --> <servlet> <servlet-name>Faces Servlet</servlet-name> <servlet-class>javax.faces.webapp.FacesServlet</servlet-class> </servlet> <!-- Faces extension mapping --> <servlet-mapping> <servlet-name>Faces Servlet</servlet-name> <url-pattern>*.jsf</url-pattern> </servlet-mapping> </web-app>
Create the view.jsp file in the jsf-simplest/WEB-INF/view directory.
<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %> <%@ taglib uri="/WEB-INF/tld/portlet.tld" prefix='portlet'%> <portlet:defineObjects/> <f:view> <h2>A JSF Portlet</h2> Hello <% if ( renderRequest.getUserPrincipal() == null ) { %> guest <% } else { %> <%=renderRequest.getUserPrincipal().getName()%> <% } %>! </f:view>
Create a faces-config.xml file in the jsf-simplest/WEB-INF directory.
<?xml version='1.0' encoding='UTF-8'?> <!DOCTYPE faces-config PUBLIC "-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.1//EN" "http://java.sun.com/dtd/web-facesconfig_1_1.dtd"> <faces-config> <application> <locale-config> <default-locale>en</default-locale> <supported-locale>fr</supported-locale> </locale-config> </application> </faces-config>
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.