Acceso a objetos API de portlet desde archivos JSP
Añada atributos a objetos API de portlet (como PortletData y PortletPreferences), añada controles a archivos JSP de portlet para añadir, modificar o suprimir los atributos, e inserte controles para acceder a atributos o enlazar atributos a controles existentes en archivos JSP de portlet.
La API de portlet IBMy la API de portlet JSR 168 definen objetos API de portlet que encapsulan datos para los objetos de portlet. Por ejemplo, la API de portlet IBM define un objeto PortletData que cuando se combina con un portlet concreto define una instancia de portlet concreta. En la API de portlet JSR 168, se combina un objeto PortletPreferences con un objeto de portlet para definir una entidad de portlet. Consulte la Guía de Aprendizaje Examine differences between portlet APIs (Examine las diferencias entre las API de portlet) para obtener más detalles sobre los objetos API de portlet y su utilización.
Utilice la vista Datos de página de un archivo JSP de portlet para:
- Añada atributos a cualquiera de los tipos de objeto API de portlet que se enumeran a continuación:
- Para proyectos API de portlet IBM
- PortletApplicationSettings
- PortletSettings
- PortletData
- User
- Para proyectos API de portlet JSR 168
- PortletPreferences
- USER_INFO
- Inserte o añada controles al archivo JSP para visualizar, añadir, modificar o suprimir los valores de los atributos.
Realice los pasos siguientes para añadir atributos a los objetos de datos de portlet y, a continuación, añada controles a un archivo JSP para crear, modificar, suprimir o visualizar los datos:
- Abra un archivo JSP de portlet realizando sobre él una doble pulsación en la vista Explorador de proyectos.
- Abra la vista Datos de página, ubicada en la esquina izquierda de la parte inferior del área de trabajo. Hay varias vistas apiladas en esa esquina, así que es posible que deba utilizar el tabulador para ver la vista Datos de página.
- En la vista Datos de página, amplíe Portlet.
- Resalte uno de los objetos API de portlet.
- Pulse con el botón derecho del ratón y seleccione Añadir atributo.
- Especifique el nombre del atributo.
- Para los atributos PortletData, que están disponibles utilizando la API de portlet IBM, seleccione también el tipo Java del atributo. Los demás tipos de objetos de datos, para ambas API de portlet, sólo permiten java.lang.String como tipo de Java.
Nota: si utiliza un tipo de Java complejo (que no sea de serie) para un atributo PortletData, no suelte la variable en una página JSP. En ves de eso, utilice el código
<jsp:usebean>, como se muestra en este ejemplo:
<jsp:useBean id="date" class="java.util.Date" scope="request">
<% date = (java.util.Date)portletRequest.getData().getAttribute("date"); %>
</jsp:useBean>
Puede utilizar el bean de datos para acceder a los datos (por ejemplo,
${date.year}).
Paraalmacenar la variable en el objeto PortletData, el portlet debe estar en modalidad de edición y deberá llamar
<% portletRequest.getData().setAttribute("date", new java.util.Date()); %>
o algo equivalente.
- Pulse Aceptar.
- En la vista Datos de página, amplíe el objeto API de portlet en el que ha creado el atributo nuevo. El nuevo objeto de atributo aparece listado.
- Arrastre el objeto de atributo de la vista Datos de página al archivo JSP en el área de editor. Se abre el asistente Insertar registro.
- En la página Configurar controles de datos del asistente, seleccione una de estas opciones bajo Crear controles para:
- Visualización de un registro existente (sólo lectura)
- Esta opción proporciona código para mostrar el valor del atributo. Para cada atributo listado en el recuadro Campos de visualización, puede seleccionar la forma en que se visualizará el atributo seleccionando un Tipo de control en el menú desplegable. Las opciones se enumeran a continuación:
- Campo de salida
- Enlace de salida (un campo de salida de un hiperenlace)
- Actualización de un registro existente
- Esta opción proporciona un formulario con los botones Someter y Suprimir para alterar el valor del atributo. Para cada atributo listado en el recuadro Campos de visualización, puede seleccionar la forma en que se visualizará el atributo seleccionando un Tipo de control en el menú desplegable. Las opciones se enumeran a continuación:
- Campo de entrada
- Cuadro combinado
- Campo de salida
- Enlace de salida (un campo de salida de un hiperenlace)
- Creación de un registro nuevo
- Esta opción proporciona un formulario con un botón Someter para crear un atributo.
Para cada atributo listado en el recuadro Campos de visualización, puede seleccionar la forma en que se visualizará el atributo seleccionando un Tipo de control en el menú desplegable. Las opciones se enumeran a continuación:
- Campo de entrada
- Cuadro combinado
- Seleccione los atributos que desee añadir a la página en la lista que hay bajo Campos de visualización.
- Pulse Opciones para establecer uno de los valores siguientes:
- Botones: utilice la pestaña Botones para seleccionar o deseleccionar los botones Someter y Suprimir y proporcionar etiquetas para los botones. La pestaña Botones sólo aparece para las opciones Actualizar y Crear, no para la opción Mostrar.
El botón Suprimir sólo está disponible con la opción Actualizar.
- Formato de etiqueta: utilice la pestaña Formato de etiqueta para seleccionar la alineación (izquierda, derecha o centro). También existen opciones para:
- Adición de dos puntos (:) a cada etiqueta. Esta opción está activada por omisión.
- Letra mayúscula para la primera letra de cada etiqueta. Esta opción está activada por omisión.
- Avanzada: utilice la pestaña Avanzada para establecer las opciones siguientes:
- Profundidad. Este valor hace referencia a la profundidad con que se recuperan atributos en la jerarquía de objetos para mostrarlos. Por ejemplo, es posible que tenga un objeto con un campo matriz que contenga más objetos, que a su vez tengan más matrices y objetos. El valor de profundidad predeterminado es 3.
- Seleccione Utilizar como profundidad predeterminada para utilizar el valor Profundidad como valor predeterminado. Esta opción está desactivada por omisión.
- Seleccione Crear sólo controles de datos para crear el código subyacente, pero omita las etiquetas. Esta opción está desactivada (se crean las etiquetas) por omisión.
- Pulse Aceptar para guardar las opciones.
- Pulse Finalizar para añadir los controles al archivo JSP.
Si desea añadir al archivo JSP controles adicionales para un atributo, pulse con el botón derecho del ratón sobre el atributo en la vista Datos de página y seleccione Insertar controles nuevos.