IBM Rational Application Developer Versão 7.5 - Kit de Ferramentas do Portal: Parte 5. Suporte do kit de ferramentas para eventos e parâmetros de renderização pública para aplicativos do portal e de portlet

Opções de documento Opções de documento que necessitam de JavaScript não são exibidas Código de amostra Classificar esta página Ajude-nos a melhorar este conteúdo

Nível: Introdutório

Lakshmi Priya, Systems Software Engineer, IBM

06/Ago/2009

Os novos recursos introduzidos no portlet Java, especificação 2.0, baseados no JSR 286, dão suporte à coordenação entre os portlets. Eventos e parâmetros de renderização pública são dois mecanismos que permitem que os portlets se comuniquem uns com os outros. Após uma breve passagem por alguns dos principais conceitos, este artigo o orienta na criação de uma amostra de aplicativo de portlet básico JSR 286, usando o Portal Toolkit no IBM® Rational® Application Developer, Versão 7.5. No decorrer do artigo, será explicado como o Portal Toolkit acelera todo o processo de forma a aproveitar esses recursos. Instruções detalhadas mostram como ativar eventos e parâmetros de renderização pública usando o novo assistente de eventos e o aprimorado editor visual do descritor de implementação do portlet. A amostra de aplicativo que você desenvolverá no artigo pode ser implementada no IBM® WebSphere® Portal, Versão 6.1.

Conceitos principais

Os principais conceitos deste artigo são inicialmente explicados e, em seguida, ilustrados usando uma amostra de aplicativo de portlet.

Eventos

A Versão 2 da especificação Java™ Specification Request (JSR) 286 possibilita que portlets enviem e recebam eventos. Os eventos permitem que os portlets se comuniquem uns com os outros. O IBM® Rational® Application Developer, Versão 7.5, fornece um conjunto de ferramentas para definir eventos, ativar portlets e passar dados entre eles usando os eventos. Um portlet pode lidar com ambas as extremidades da comunicação:

• Enviar eventos para outros portlets
• Receber e processar eventos de outros portlets

Atributos de eventos

Cada evento deve ter um nome e, se possível, outros atributos:

• Nome: Um nome exclusivo para o evento. O nome do evento pode ser um QName completo: um nome qualificado conforme definido na especificação XML, que consiste em um espaço de nomes (por exemplo, http://www.ibm.com) e em uma parte local (por exemplo, sampleEvent). Como alternativa, é possível usar o mesmo espaço de nomes para vários eventos, declarando-o como o espaço de nomes padrão e, em seguida, especificando apenas a parte local para cada evento.

• Descrição: (Opcional) A descrição do evento.
• Tipo de valor: (Opcional) Um nome completo de classe Java do valor a ser transferido com o evento.
• Alias: (Opcional) Um nome qualificado pelo espaço de nomes para o evento.

Para criar um aplicativo de portlet que incorpore eventos e parâmetros de renderização pública para a comunicação entre portlets, conclua as seguintes tarefas:

1. Crie um projeto de portlet JSR 286 e portlets.
2. Crie uma definição de evento no descritor de implementação do portlet (PDD).
3. Adicione o evento como uma publicação suportada ou um evento de processamento pelo portlet.
4. Modifique a ação do processo ou o código de evento na classe do portlet para publicar ou processar o evento.
5. Adicione parâmetros de renderização pública.
6. Publique o projeto do portlet no servidor.
7. Conecte os portlets uns aos outros.

Essas tarefas são extremamente simplificadas pelo uso das ferramentas fornecidas pelo Rational Application Developer V7.5.

Parâmetros de renderização pública

A especificação JSR 286 fornece outro mecanismo que permite a coordenação entre os portlets: parâmetros de renderização pública (consulte Recursos para saber onde aprender mais sobre eles). Esses parâmetros oferecem uma forma de compartilhar parâmetros de solicitação entre os portlets.

Atributos dos parâmetros de renderização pública

Cada parâmetro deve ter um nome e, se possível, outros atributos:

• Nome: (Obrigatório) Um nome exclusivo para o parâmetro, seja uma cadeia de caractere ou um nome qualificado pelo espaço de nomes. Selecione o espaço de nomes padrão ou especifique outro. A cadeia de caractere localizada que você inseriu como nome do evento é acrescentada ao espaço de nomes.
• Identificador: (Obrigatório) Uma cadeia de caractere usada no código de portlet para fazer referência ao parâmetro de renderização.
• Descrição: (Opcional) Uma descrição do parâmetro de renderização.
• Alias: (Opcional) Um nome qualificado pelo espaço de nomes para o parâmetro.

Voltar para parte superior

Amostra de aplicativo usado neste artigo

Neste artigo, uma amostra de aplicativo de portlet demonstra a utilidade dos recursos de eventos e de parâmetros de renderização pública do JSR 286. Ela é usada por uma companhia de navegação para manutenção dos detalhes de seus pedidos e clientes. Ele consiste em três portlets:

• O portlet Orders faz a manutenção dos detalhes mensais dos pedidos da companhia.
• O portlet OrderDetails mostra os detalhes de um pedido.
• O portlet TrackingDetails mostra os detalhes de acompanhamento de um pedido.

Este artigo demonstra como criar eventos e parâmetros de renderização pública e usá-los na amostra. Consulte Download para obter a amostra completa.

O caso de uso da amostra

Um usuário pode selecionar o ID do pedido de um mês para visualizar os detalhes do pedido e do acompanhamento. Isso é implementado com o uso de eventos e parâmetros de renderização pública. O portlet Orders resume as informações de todos os pedidos durante um mês. Quando o usuário clica no ID de um pedido no portlet Orders, o portlet aciona um evento. Esse evento é processado pelo portlet OrderDetails, que mostra os detalhes do pedido do ID selecionado. O portlet OrderDetails, em seguida, busca o ID de acompanhamento do pedido em seus detalhes e os passa para o portlet TrackingDetails como um parâmetro de renderização. O portlet TrackingDetails, então, mostra os detalhes de acompanhamento desse pedido.

1. Para que esse caso de uso funcione, utilize o Portal Toolkit no Rational Application Developer 7.5 para, primeiro, declarar um evento chamado OrderIDType. Esse evento é adicionado como um evento de publicação suportado no portlet Orders, e como um evento de processamento suportado no portlet OrderDetails.
2. Depois, crie o parâmetro de renderização pública TrackingIDType e faça com que os portlets OrderDetails e TrackingDetails suportem o parâmetro.

Voltar para parte superior

Criação do projeto de portlet JSR 286 e dos portlets

O assistente Projeto de Portlet no Rational Application Developer suporta a criação de projetos de portlet compatíveis com o JSR 286.

Para criar o projeto de portlet:

1. Clique em Arquivo >Novo > Projeto de Portlet para abrir o assistente.
2. Especifique os detalhes, conforme mostrado na Figura 1:
   1. Para o ambiente de tempo de execução de destino, selecione WebSphere Portal v6.1.
   2. Para o API do portlet, selecione Portlet JSR 286.
   3. Para o tipo de portlet, selecione Portlet Básico.

A próxima etapa é adicionar os portlets necessários ao aplicativo de portlet que você criou. Considerando-se que o artigo abrange três portlets na amostra de aplicativo, é possível adicionar esses portlets ao projeto de portlet (consulte a Figura 2):

3. Clique com o botão direito do mouse no descritor de implementação do portlet e selecione Novo > Portlet.
4. Insira o nome do portlet como OrderDetail e clique em Concluir.
5. Repita essas etapas para adicionar os outros dois portlets: OrdersPortlet e TrackingPortlet.

Observação:
Este artigo não trata da modificação de arquivos Java™Server Pages (JSP™), nem da adição da função desejada aos portlets, uma vez que o foco é a criação de eventos e parâmetros de renderização pública. Supõe-se que os portlets passaram por modificações, com o portlet Orders mostrando os pedidos do mês, o portlet OrderDetails mostrando os detalhes do pedido e o portlet Tracking mostrando os detalhes de acompanhamento do pedido.

A Figura 3 mostra a aparência do OrdersPortlet após ser publicado no WebSphere Application Server V6.1.

Voltar para parte superior

Criação da definição de um evento no descritor de implementação do portlet

É fácil criar eventos com o assistente de eventos incorporado no Rational Application Developer. Para criar os três eventos:

1. Expanda o projeto de portlet no Explorador de Projetos.
2. Clique com o botão direito do mouse no descritor de implementação do portlet e selecione Evento.

Como mostra a Figura 4, há duas opções disponíveis em Evento:

• Permitir que Este Portlet Publique Eventos
• Permitir que Este Portlet Processe Eventos

Clique para ampliar

Voltar para parte superior

Adição do evento como um evento de publicação do portlet

Estas ações são executadas quando você seleciona a primeira opção, que é "Permitir que Este Portlet Publique Eventos":

• Adicione a definição do evento ao aplicativo de portlet
• Adicione o evento como um evento de publicação suportado ao portlet
• Modifique os métodos processAction() ou processEvent() para publicar o evento

Estas opção são executadas quando você seleciona a outra opção, "Permitir que Este Portlet Processe Eventos":

• Adicione a definição do evento ao aplicativo de portlet, caso essa definição ainda não exista
• Adicione o evento como um evento de processamento suportado ao portlet
• Modifique os métodos processEvent() para processar o evento

A próxima etapa é criar o evento usando o assistente. Para permitir que o portlet Orders publique o evento OrderIDType:

1. Clique com o botão direito do mouse no portlet Orders no descritor de implementação do portlet.
2. Selecione Evento > Permitir que Este Portlet Publique Eventos. Essa ação abre o assistente.
3. Especifique os detalhes, como na Figura 5:
   1. Para o Nome do evento, selecione OrderIDType.
   2. Para o Tipo de valor, especifique Cadeia de caractere.

4. Clique em Concluir.

Esse assistente faz duas alterações no descritor de implementação do portlet:

• Adiciona a definição do evento ao aplicativo de portlet
• Adiciona o evento como um evento publicado suportado ao portlet

O código em negrito na Lista 1 mostra como o código do descritor de implementação do portlet é modificado pelo assistente do evento.

<?xml version="1.0" encoding="UTF-8"?>
<portlet-app xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd" 
version="2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd 
http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd" 
id="com.ibm.jsr286eventrenderparam.JSR286EventRenderParamPortlet.19a07d46c1">
	<portlet>
		<portlet-name>OrderDetail</portlet-name>
	<?xml version="1.0" encoding="UTF-8"?>
<portlet-app xmlns="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd" 
version="2.0" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd 
http://java.sun.com/xml/ns/portlet/portlet-app_2_0.xsd" 
id="com.ibm.jsr286eventrenderparam.JSR286EventRenderParamPortlet.19a07d46c1">
	<portlet>
		<portlet-name>OrderDetail</portlet-name>
		<display-name xml:lang="en">OrderDetail</display-name>
		<display-name>OrderDetail</display-name>
		<portlet-class>
		com.ibm.jsr286eventrenderparam.OrderDetailPortlet
		</portlet-class>
		<init-param>
			<name>wps.markup</name>
			<value>html</value>
		</init-param>
		<expiration-cache>0</expiration-cache>
		<supports>
			<mime-type>text/html</mime-type>
			<portlet-mode>view</portlet-mode>
		</supports>
		<supported-locale>en</supported-locale>
		<resource-bundle>
		com.ibm.jsr286eventrenderparam.nl.OrderDetailPortletResoure
		</resource-bundle>
		<portlet-info>
			<title>OrderDetail</title>
			<short-title>OrderDetail</short-title>
			<keywords>OrderDetail</keywords>
		</portlet-info>
	</portlet>
	<portlet>
		<portlet-name>OrdersPortlet</portlet-name>
		<display-name xml:lang="en">OrdersPortlet</display-name>
		<display-name>OrdersPortlet</display-name>
		<portlet-class>
		com.ibm.jsr286eventrenderparam.OrdersPortlet
		</portlet-class>
		<init-param>
			<name>wps.markup</name>
			<value>html</value>
		</init-param>
		<expiration-cache>0</expiration-cache>
		<supports>
			<mime-type>text/html</mime-type>
			<portlet-mode>view</portlet-mode>
		</supports>
		<supported-locale>en</supported-locale>
		<resource-bundle>
		com.ibm.jsr286eventrenderparam.nl.OrdersPortletResource
		</resource-bundle>
		<portlet-info>
			<title>OrdersPortlet</title>
			<short-title>OrdersPortlet</short-title>
			<keywords>OrdersPortlet</keywords>
		</portlet-info>
		<supported-publishing-event>
			<name>OrderIDType</name>
		</supported-publishing-event>
	</portlet>
	<portlet>
		<portlet-name>TrackingPortlet</portlet-name>
		<display-name xml:lang="en">TrackingPortlet</display-name>
		<display-name>TrackingPortlet</display-name>
		<portlet-class>
		com.ibm.jsr286eventrenderparam.TrackingPortlet
		</portlet-class>
		<init-param>
			<name>wps.markup</name>
			<value>html</value>
		</init-param>
		<expiration-cache>0</expiration-cache>
		<supports>
			<mime-type>text/html</mime-type>
			<portlet-mode>view</portlet-mode>
		</supports>
		<supported-locale>en</supported-locale>
		<resource-bundle>
		com.ibm.jsr286eventrenderparam.nl.TrackingPortletResource
		</resource-bundle>
		<portlet-info>
			<title>TrackingPortlet</title>
			<short-title>TrackingPortlet</short-title>
			<keywords>TrackingPortlet</keywords>
		</portlet-info>
	</portlet>
	<default-namespace>http://JSR286EventRenderParam/</default-namespace>
	<event-definition>
		<name>OrderIDType</name>
		<value-type>java.lang.String</value-type>
	</event-definition>
</portlet-app>

Voltar para parte superior

Modificação do código de ação do processo na classe do portlet para publicar o evento

O método processAction() é, em seguida, modificado para publicar o evento, como mostra a Lista 2.

public void processAction(ActionRequest request, ActionResponse response) 
throws PortletException, java.io.IOException {
	if( request.getParameter(FORM_SUBMIT) != null ) {
		// Configure o formato do texto no session bean
		OrdersPortletSessionBean sessionBean = getSessionBean(request);
		if( sessionBean != null )
			sessionBean.setFormText(request.getParameter(FORM_TEXT));
	}
//Inicialize os campos na classe de acordo com seu requisito
	java.lang.String sampleObject = new java.lang.String();
	response.setEvent("OrderIDType", sampleObject);

}

É necessário customizar o código gerado pelo assistente de eventos para que ele se ajuste às suas necessidades. Uma vez que é necessário enviar o OrderIDType, o ID do pedido vem do parâmetro do pedido de ação quando o ID do pedido é selecionado (consulte a Lista 3).

String order_id = request.getParameter(ORDER_ID);
	if (order_id!=null)
 response.setEvent("OrderIDType", order_id);

O assistente modifica o portlet no descritor de implementação do portlet, conforme mostrado no Explorador de Projetos na Figura 6. No nó OrdersPortlet, aparece o evento OrderIDType.

Adicione o evento como um evento de processamento suportado pelo portlet

Em seguida, o ID do pedido precisa ser recebido pelo portlet OrderDetail. Em outras palavras, o evento publicado agora precisa ser processado pelo portlet OrderDetail.

Para permitir que o portlet processe o evento:

1. Expanda o nó Descritor de Implementação do Portlet.
2. Clique com o botão direito do mouse no portlet OrderDetail e selecione Evento > Permitir que Este Portlet Processe Eventos.

Clique para ampliar

O assistente "Permitir que Este Portlet Processe Eventos" é aberto, como mostra a Figura 8.

3. Para o Nome do Evento, selecione OrderIDType, que já foi declarado usando o assistente de publicação de eventos. Não é possível modificar a definição do evento aqui, mas é possível editá-la manualmente no descritor de implementação do portlet.
4. Clique em Concluir para concluir o processamento:
   • Adicione o elemento supported-processing-event ao Portlet OrderDetail (a definição do evento já foi adicionada quando você o publicou)
   • Modifique o método processEvent() para processar o evento

A seção do portlet para o portlet OrderDetail é modificada, como mostra a Lista 4.

<portlet>
	<portlet-name>OrderDetail</portlet-name>
	<display-name xml:lang="en">OrderDetail</display-name>
	<display-name>OrderDetail</display-name>
	<portlet-class>
	com.ibm.jsr286eventrenderparam.OrderDetailPortlet
	</portlet-class>
	<init-param>
		<name>wps.markup</name>
		<value>html</value>
	</init-param>
	<expiration-cache>0</expiration-cache>
	<supports>
		<mime-type>text/html</mime-type>
		<portlet-mode>view</portlet-mode>
	</supports>
	<supported-locale>en</supported-locale>
	<resource-bundle>
	com.ibm.jsr286eventrenderparam.nl.OrderDetailPortletResoure
	</resource-bundle>
	<portlet-info>
		<title>OrderDetail</title>
		<short-title>OrderDetail</short-title>
		<keywords>OrderDetail</keywords>
	</portlet-info>
	<supported-processing-event>
		<name>OrderIDType</name>
	</supported-processing-event>
</portlet>

Modifique o código do evento na classe do portlet para processar o evento

Como mostra a Lista 5, as alterações também são feitas ao método processEvent(), que é responsável pelo processamento do evento recebido.

public void processEvent(EventRequest request, EventResponse response) 
throws PortletException, java.io.IOException {
	Event sampleEvent = request.getEvent();
		if(sampleEvent.getName().toString().equals("OrderIDType")) {
			Object sampleProcessObject = sampleEvent.getValue();
		}

É necessário enviar o TrackingID do portlet OrderDetail para o portlet Tracking. Por isso, é necessário modificar o método processEvent(), como mostra o código em negrito na Lista 6.

public void processEvent(EventRequest request, EventResponse response)
    throws IOException, PortletException {
     Event sampleEvent = request.getEvent();
	if(sampleEvent .getName().equals("OrderIDType")) {	
	 	   Object sampleProcessObject = sampleEvent.getValue();
	         response.setRenderParameter(ORDER_ID, sampleProcessObject.toString());
	         //defina a id da ordem como um parâmetro de processamento
	         OrderDetail od = ShippingDB.getOrderDetail(ev.getValue().toString());
      if (od != null) {
            request.getPortletSession().setAttribute(ORDER_DETAIL, od);
            response.setRenderParameter("TrackingID", od.getTrackingId());
            //localize o id de rastreio a partir dos detalhes do pedido e defina-o como um 
|-------10--------20--------30--------40--------50--------60--------70--------80--------9|
|-------- Erro XML:  A linha anterior não é maior do que o máximo de 90 caracteres ---------|
            parâmetro de processamento.
            }
	  }
}

Para que o Portlet OrderDetails mostre os Detalhes do Pedido, é necessário modificar o método doView() para adicionar o código que a Lista 7 mostra em negrito.

String orderId = (String) request.getParameter(ORDER_ID);//get the order set 
in the processAction()
  OrderDetail od = ShippingDB.getOrderDetail(orderId);
   PortletURL actionURL = ShippingUtils.createSimpleActionURL(ORDER_DETAILS, response);
    odb.setActionURL(actionURL);
	if (od != null) 
        odb.setOrderDetail(od);
     getPortletContext().getRequestDispatcher(getJspFilePath(request, VIEW_JSP))
     .include(request, response);

Voltar para parte superior

Adição de parâmetros de renderização pública

A próxima etapa é usar o mecanismo do parâmetro de renderização pública para compartilhar o ID de acompanhamento entre o portlet OrderDetail e o portlet Tracking:

1. Abra o descritor de implementação do portlet para o projeto EventSample.
2. Selecione a guia Parâmetros de Renderização e clique em Adicionar para criar um parâmetro de renderização pública com o nome padrão: NewPublicRenderParam.
3. Altere os campos Nome e Identificador para TrackingID, como mostra a Figura 9.

Clique para ampliar

Essa ação adiciona a seção mostrada na Lista 8 à definição do aplicativo de portlet do descritor de implementação do portlet.

<public-render-parameter>
	<identifier>TrackingID</identifier>
	<name>TrackingID</name>
</public-render-parameter>

4. Já que esse parâmetro precisa ser compartilhado pelos portlets Tracking e OrderDetail, é necessário adicioná-lo como um parâmetro de renderização pública suportado para ambos os portlets.
   1. Na guia Portlets, selecione o portlet Tracking .
   2. Role para baixo até a seção Parâmetros de Renderização Pública Suportados, no painel direito, e clique em Selecionar.
5. Para o nome, selecione ID de Acompanhamento, que foi criado na guia Parâmetros de Renderização no editor, como mostra a Figura 10.
6. Clique em OK.
7. Repita as Etapas 4 e 5 para adicionar TrackingID como um parâmetro de renderização pública suportado para o OrdersPortlet.

A Figura 10 mostra o parâmetro de renderização pública adicionado aos portlets.

Clique para ampliar

As alterações mostradas em negrito na Lista 9 são feitas ao descritor de implementação do portlet.

<portlet>
		<portlet-name>OrdersPortlet</portlet-name>
		<display-name xml:lang="en">OrdersPortlet</display-name>
		<display-name>OrdersPortlet</display-name>
		<portlet-class>
			com.ibm.jsr286eventrenderparam.OrdersPortlet
		</portlet-class>
		<init-param>
			<name>wps.markup</name>
			<value>html</value>
		</init-param>
		<expiration-cache>0</expiration-cache>
		<supports>
			<mime-type>text/html</mime-type>
			<portlet-mode>view</portlet-mode>
		</supports>
		<supported-locale>en</supported-locale>
		<resource-bundle>
			com.ibm.jsr286eventrenderparam.nl.OrdersPortletResource
		</resource-bundle>
		<portlet-info>
			<title>OrdersPortlet</title>
			<short-title>OrdersPortlet</short-title>
			<keywords>OrdersPortlet</keywords>
		</portlet-info>
		<supported-publishing-event>
			<name>OrderIDType</name>
		</supported-publishing-event>
		<supported-public-render-parameter>
			TrackingID
		</supported-public-render-parameter>
	</portlet>
	<portlet>
		<portlet-name>TrackingPortlet</portlet-name>
		<display-name xml:lang="en">TrackingPortlet</display-name>
		<display-name>TrackingPortlet</display-name>
		<portlet-class>
			com.ibm.jsr286eventrenderparam.TrackingPortlet
		</portlet-class>
		<init-param>
			<name>wps.markup</name>
			<value>html</value>
		</init-param>
		<expiration-cache>0</expiration-cache>
		<supports>
			<mime-type>text/html</mime-type>
			<portlet-mode>view</portlet-mode>
		</supports>
		<supported-locale>en</supported-locale>
		<resource-bundle>
		com.ibm.jsr286eventrenderparam.nl.TrackingPortletResource
		</resource-bundle>
		<portlet-info>
			<title>TrackingPortlet</title>
			<short-title>TrackingPortlet</short-title>
			<keywords>TrackingPortlet</keywords>
		</portlet-info>
		<supported-public-render-parameter>TrackingID
		</supported-public-render-parameter>
	</portlet>

8. É necessário modificar o método doView() do portlet Tracking para exibir os detalhes do acompanhamento, baseados no TrackingID do pedido (consulte a Lista 10).

String renderParam = request.getParameter("TrackingID");
//localize o parâmetro de processamento do id de acompanhamento que foi configurado no Portlet OrderDetails
|-------10--------20--------30--------40--------50--------60--------70--------80--------9|
|-------- Erro XML:  A linha anterior não é maior do que o máximo de 90 caracteres ---------|
	TrackingDetailBean tdb = new TrackingDetailBean();
	request.setAttribute(TRACKING_DETAIL_BEAN, tdb);
	if (renderParam!=null && renderParam.length()>0) {
		PortletURL actionURL = 
		ShippingUtils.createSimpleActionURL(TRACKING_DETAILS, response);
            tdb.setActionURL(actionURL);
	PortletURL rdActionURL = 
	ShippingUtils.createSimpleActionURL(ROUTING_DETAILS, response);
             tdb.setRoutingDetailActionURL(rdActionURL);
		TrackingDetail td = ShippingDB.getTrackingDetail(renderParam);
		 if (td != null) {
		tdb.setTrackingDetail(td);
		getPortletContext().getRequestDispatcher(getJspFilePath
		(request, VIEW_JSP)).include(request, response);
		} else {
		  //ID de rastreio não encontrado, imprimir página de erros
		 tdb.setErrorMessage("Tracking Id " + renderParam + " not found.");
		 getPortletContext().getRequestDispatcher(getJspFilePath
		(request, ERROR_JSP)).include(request, response);
		        }
		}

Voltar para parte superior

Publicação do projeto de portlet

Agora, é possível publicar o aplicativo de portlet no WebSphere Application Server V6.1:

1. Clique com o botão direito do mouse no projeto de portlet (consulte a Figura 11) e selecione Executar como > Executar no Servidor.

Clique para ampliar

2. Selecione WebSphere Portal V6.1 Server, como na Figura 12.
3. Clique em Avançar e depois em Concluir.

Voltar para parte superior

Conecte os portlets uns aos outros

A ferramenta de conexões disponível no servidor do portal pode ajudá-lo a conectar as relações entre os portlets que compartilham eventos entre si.

Para acessar a ferramenta de conexões:

1. Selecione Editar Layout da Página para a página na qual os portlets estão localizados.
2. Selecione a guia Redes.
3. Para o portlet de origem, selecione OrdersPortlet no menu suspenso e, para o portlet de destino, selecione o portlet OrderDetail (Figura 13). Para os nomes do evento, clique na seta suspensa dos campos de Envio e Recebimento.

Clique para ampliar

4. Clique no sinal de mais e em Concluído.
5. Selecione o ID de um pedido (por exemplo, o primeiro no OrdersPortlet).

Quando você clica no ID do pedido, um evento é acionado pelo portlet Orders, que envia o valor Order_ID para o portlet OrderDetails. Quando o portlet OrderDetails recebe o ID do pedido, executa o processamento do evento. Esse portlet busca os detalhes do ID do pedido e os exibe para o usuário. Além disso, o portlet OrderDetails recupera o ID de acompanhamento do pedido e o comunica para o portlet de detalhes de acompanhamento, já que TrackingID foi adicionado como parâmetro de renderização compartilhado para ambos os portlets OrderDetails e Tracking. Dessa forma, assim que o usuário clica no ID de um pedido, os detalhes do pedido e do acompanhamento são mostrados (consulte a Figura 14).

Agora, o usuário pode ver os detalhes do pedido e do acompanhamento, como mostra a Figura 15. Assim, eventos e parâmetros de renderização pública são usados para transferir o OrderID e o TrackingID para os respectivos portlets.

Clique para ampliar

Como mostrado aqui, as ferramentas oferecidas pelo Rational Application Developer 7.5 simplificam muito a criação de eventos e parâmetros de renderização pública. É necessário customizar apenas o código gerado para adequá-lo às necessidades de seu aplicativo.

Voltar para parte superior

Download

	Informações sobre métodos de download

Recursos

• Saiba O que há de novo na Java Service Specification V2.0 (JSR 286) para portlets.
  
  
• Leia O que há de novo no IBM WebSphere Portal V6.1: Recursos do JSR 286 para saber como os conceitos dos novos padrões, particularmente a comunicação entre portlets, foram integrados e para obter orientações para escolher entre o uso de eventos de portlet e de parâmetros de renderização pública para fins de comunicação.
  
  
• Saiba mais sobre os parâmetros de renderização pública, que permitem que os portlets JSR 286 compartilhem informações sobre o estado de navegação.
  
  
• Visite a Área de software Rational em developerWorks para obter os recursos técnicos e melhores práticas para produtos Rational Software Delivery Platform.
  
  
• Assine a newsletter IBM developerWorks, atualizada semanalmente para receber os melhores tutoriais, artigos, downloads, atividades de comunidade, webcasts e eventos sobre developerWorks.
  
  
• Assine a newsletter da zona Rational do developerWorks. Mantenha-se atualizado com o conteúdo sobre Rational no developerWorks. A cada duas semanas você receberá atualizações sobre os mais recentes recursos técnicos e melhores práticas da Rational Software Delivery Platform.
  
  
• Assine a newsletter Rational Edge para receber artigos sobre os conceitos por trás do desenvolvimento eficiente de software.
  
  
• Navegue até a livraria de tecnologia para ver livros sobre estes e outros tópicos técnicos.
  
  

• Faça o download de versões de avaliação do software IBM Rational.
  
  
• Baixe essas versões de avaliação de produtos IBM e use as ferramentas de desenvolvimento de aplicativos e produtos middleware a partir do DB2®, Lotus®, Tivoli® e WebSphere®.

Sobre o autor

		Lakshmi Priya is a software developer who works on the portal tooling component in Rational Application Developer at IBM India Software Labs in Delhi, India. She leads the Portlet Tooling subcomponent team. She started her career with a pervasive computing team, in Bangalore, and has been working on portlets and Eclipse-based technologies.

Avalie esta página

Reserve um instante para completar este formulário para nos ajudar a servi-lo melhor. As informações o ajudaram a alcançar seu objetivo? Sim Não Não sei   Faça comentários para ajudar a melhorar esta página:   Quão úteis são as informações? 1 2 3 4 5 Não são úteis Extremamente úteis