Guía para la creación de un Portlet JSR-168 en Jetspeed 2

Contexto de este artículo

• Tecnología y versión: Portlet 1.0 (JSR-168) y Jetspeed 2.
• Año del artículo: 2006.
• Estado a 11 de octubre de 2026: Entorno heredado y contenedor retirado. Para desarrollar una aplicación web actual, compara Jakarta EE; no es un reemplazo directo de la API Portlet.
• Documentación de referencia: Documentación actual de Jakarta EE.

Conservo a continuación el texto y los ejemplos de aquella fecha como archivo técnico. No he ejecutado estos ejemplos en un entorno actual: esta revisión contextual no garantiza que funcionen hoy.

Para situar esta tecnología: estado del proyecto Jetspeed y documentación de Jakarta EE para aplicaciones web actuales. No son instrucciones de migración directa.

Prerrequisitos:

Tener instalado Jetspeed. Consulte nuestro artículo para la instalación de Jetspeed sobre un Tomcat bajo Windows.

Procedimiento – Pasos para la creación del Portlet:

1) Crear el archivo Simplest.java en el directorio llamado simplest/WEB-INF/classes:

public class Simplest extends javax.portlet.GenericPortlet
{
    public void doView(javax.portlet.RenderRequest request, javax.portlet.RenderResponse response)
                throws javax.portlet.PortletException, java.io.IOException
    {
            response.setContentType("text/html");
            response.getWriter().println("A very simple portlet.");
    }
}

2) Compilar la clase usando el comando:
javac -classpath ~/.maven/repository/org.apache.portals.jetspeed-2/jars/portlet-api-1.0.jar Simplest.java

3) Crear el archivo de configuración portlet.xml en el directorio simplest/WEB-INF.

<?xml version="1.0" encoding="UTF-8"?>
<portlet-app id="simplest" version="1.0">
  <portlet id="Simplest">
    <portlet-name>Simplest</portlet-name>
    <display-name>Simple Display Name</display-name>
    <portlet-class>Simplest</portlet-class>
    <supports>
      <mime-type>text/html</mime-type>
      <portlet-mode>VIEW</portlet-mode>
    </supports>
    <supported-locale>en</supported-locale>
    <portlet-info>
      <title>Simple Title</title>
      <short-title>The world's simplest portlet</short-title>
    </portlet-info>
  </portlet>
</portlet-app>

4) Crear el archivo de configuración web.xml en el directorio WEB-INF de simplest.

<?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>Simplest</display-name>
  <description>The world's simplest portlet</description>
</web-app>

5) Crear el siguiente archivo de configuración (propio de Jetspeed) simplest.psml en Apache_Jetspeed/webapps/jetspeed/WEB-INF/pages dentro del portal Jetspeed.

<page>
  <defaults
     skin="orange"
     layout-decorator="tigris"
     portlet-decorator="tigris"
  />
  	<title>The simplest portlet in the world</title>
  	<metadata name="title" xml:lang="fr">La plus simple portlet du monde</metadata>
	<fragment id="simplest" type="layout" name="jetspeed-layouts::VelocityTwoColumns">
		<fragment id="simplest-1" type="portlet" name="simplest::Simplest">
	  	<property layout="TwoColumns" name="row" value="0" />
		<property layout="TwoColumns" name="column" value="0"/>
		</fragment>
	</fragment>
	<security-constraints>
		<security-constraints-ref>public-view</security-constraints-ref>
	</security-constraints>
</page>

6) Crear el archivo WAR con toda la aplicación. Con el siguiente comando (debemos estar dentro del directorio simplest):

jar cvf ../simplest.war .

7) Deployar el archivo WAR
Copiar el archivo war a $CATALINA_HOME/webapps/jetspeed/WEB-INF/deploy. Jetspeed-2 desplegará la aplicación.

8) Acceder a la página en tu navegador:
http://localhost:8080/jetspeed/portal/simplest.psml

Para más información visitar la guía de instalación de Jetspeed (Inglés)