O Serviço de reserva de viagens é um processo comercial de amostra fornecido com o NetBeans Enterprise Pack 5.5.
O Serviço de reserva de viagens age como um agregador lógico dos outros serviços e é baseado na lógica comercial típica dos sistemas de reserva de viagens, como descrito abaixo.
O processo presume que um cliente inicia o processo enviando uma mensagem que contém um documento de itinerário de viagem parcial.
O itinerário da viagem do cliente pode ter:
Nenhuma reserva pré-existente ou
Uma combinação de reservas pré-existentes de linha aérea, carro e/ou hotel.
O Serviço de reserva de viagens examina o itinerário do cliente de entrada e processa esse itinerário para conclusão.
Se o itinerário do cliente não contiver uma reserva de linha aérea pré-existente, o Serviço de reserva de viagens passará o itinerário para o respectivo serviço de parceiro, o Serviço de reserva de linhas aéreas, para adicionar a reserva de linha aérea.
O Serviço de reserva de linha aérea passa o itinerário modificado de volta para o Serviço de reserva de viagens.
O Serviço de reserva de viagens executa uma lógica semelhante nas reservas de carro e hotel. Em cada caso, ele delegará a provisão real da reserva para o Serviço de reserva de veículos e o Serviço de reserva de hotel.
Finalmente, o Serviço de reserva de viagens passa o itinerário completo de volta para o cliente original, concluindo o processo.
Para obter mais informações sobre como trabalhar com o NetBeans IDE, consulte a página Docs & Support no site na Web do NetBeans.
Pré-requisitos
Este tutorial presume que você possui algum conhecimento básico ou experiência de programação na linguagem e na plataforma Java e no NetBeans IDE.
O tempo de execução JBI e o servidor de aplicativos Sun Java System deve ser configurado corretamente e estar em execução para que o aplicativo possa ser implantado.
Primeiro, realize as seguintes etapas para confirmar que o servidor JBI foi iniciado:
Abra a janela Tempo de execução.
Expanda o nó Servidores.
Se o nó já contiver um servidor de aplicativos Sun Java, pule para a etapa 5.
Se o nó não contiver um servidor de aplicativos Sun Java, siga estas etapas:
Clique com o botão direito do mouse no nó Servidores e escolha Adicionar servidor.
Na caixa de diálogo Adicionar instância do servidor, escolha Servidor de aplicativos Sun Java.
Clique em Próximo.
No Local da plataforma, especifique C:\Sun\AppServer. Esse é o caminho de instalação padrão do servidor de aplicativos, conforme definido pelo instalador do Enterprise Pack. Selecione Registrar domínio local padrão.
Clique em Próximo.
Forneça este nome de usuário e esta senha para o servidor de aplicativos: admin/adminadmin. Este é o nome de usuário e senha padrão definidos pelo instalador.
Clique em Finalizar
Clique com o botão direito do mouse no nó do Servidor de aplicativos Sun Java System e escolha Iniciar. Se a opção Iniciar não estiver disponível e se houver um triângulo verde ao lado do nó do Servidor de aplicativos Sun Java System, seu servidor já está em execução.
Criando um novo projeto com o projeto de amostra Serviço de reserva de viagens
Para criar um novo projeto usando a amostra do Serviço de reserva de viagens:
No menu principal do IDE, escolha Arquivo > Novo projeto.
Em Categorias, selecione Amostras > Service Oriented Architecture.
Em Projetos, selecione Serviço de reserva de viagens.
Clique em Próximo.
Digite o nome de projeto e o local da sua escolha, ou aceite os padrões.
Clique em Finalizar.
A janela Projetos agora contém dois nós de projeto: um para TravelReservationService, um módulo BPEL, e um para TravelReservationServiceApplication, um projeto de aplicativo composto.
O Serviço de reserva de viagens se comunica com seus serviços de parceiro através de suas interfaces públicas. Essas interfaces são definidas nos arquivos WSDL específicos do parceiro. O IDE inclui um projeto EJB empacotado chamado ReservationPartnerServices. O projeto ReservationPartnerServices contém uma implementação básica EJB e baseada em JMS dos três serviços de parceiro. Esses serviços de parceiro são o Serviço de reserva de hotel, o Serviço de reserva de veículos e o Serviço de reserva de linhas aéreas. Esses serviços da Web de parceiro devem ser implantados no servidor de aplicativos Sun Java empacotado para que você possa testar a execução do processo Serviço de reservas de viagens.
Essa implementação destina-se somente a servir como um harness de teste do processo do Serviço de reserva de viagens. A implementação dos serviços de parceiro não deve ser de nenhum interesse para o desenvolvedor do BPEL. Eles são meramente pré-requisitos para a testabilidade do Serviço de reserva de viagens.
Siga estas etapas para abrir e implantar o ReservationPartnerServices:
Escolha Abrir > Abrir projeto no menu principal.
Use o assistente para Abrir projeto para navegar para o diretório TravelReservationService. O diretório que contém o TravelReservationService também contém o ReservationPartnerServices empacotado.
Selecione o ReservationPartnerServices e clique no botão Abrir pasta do projeto.
Clique com o botão direito do mouse em ReservationPartnerServices e escolha Implantar projeto. Isso implanta o ReservationPartnerServices.
Verifique se o aplicativo ReservationPartnerServices foi implantado com êxito, realizando as seguintes etapas:
Alterne para a janela Tempo de execução e expanda o nó do Servidor de aplicativos Sun Java System.
Expanda o nó Aplicativos e expanda o nó Módulos EJB.
Implantando o projeto BPEL no servidor de aplicativos
Um projeto BPEL não pode ser implantado diretamente. Você deve adicionar um projeto BPEL, como um módulo JBI, em um projeto de aplicativo composto. Em seguida, você pode implantar o projeto de aplicativo composto. Desimplantar o projeto torna a composição do serviço disponível no servidor de aplicativos, permitindo, portanto, que suas unidades de serviço sejam executadas.
Clique com o botão direito do mouse no nó do projeto de implantação TravelReservationServiceApplication, na janela Projetos, e escolha Adicionar módulo JBI. O assistente para Selecionar projeto se abre.
Selecione TravelReservationService no assistente para Selecionar projeto.
Clique no botão Adicionar arquivos Jar do projeto.
Na janela Projetos, expanda TravelReservationServiceApplication > Módulos JBI.
Observe que o nó TravelReservationService.jar é adicionado.
Clique com o botão direito do mouse no nó do projeto TravelReservationServiceApplication e escolha Implantar projeto no menu pop-up.
Na caixa de diálogo Aviso, verifique se o servidor de aplicativos Sun Java 9 está selecionado e clique em OK.
A implantação foi bem sucedida, a seguinte mensagem for exibida na janela Saída:
Realizando uma execução de teste do processo do Serviço de reserva de viagens
O recurso de execução de teste permite que os desenvolvedores do processo comercial testem seus processos. Os processos BPEL são implantados no tempo de execução do BPEL, que gerencia o ciclo de vida do processo. Um processo BPEL começa com uma atividade Receber ou Selecionar responsável por iniciar o processo.
Um processo BPEL também é um serviço da Web. Como qualquer serviço da Web, um processo BPEL possui um arquivo WSDL que descreve sua interface pública. Essa interface, por sua vez, descreve as operações e as mensagens que os clientes podem alcançar para criar a instância do processo. Durante a recepção de uma mensagem destinada a uma dessas atividades Receber, o tempo de execução BPEL criará uma instância do processo BPEL e entregará a mensagem para a instância do processo a fim de que seja processada.
Por exemplo, no caso de TravelReservationService.wsdl existe uma operação chamada buildItinerary. Esta é a operação que os clientes do TravelReservationService chamarão para iniciar uma conversação com o TravelReservationService.
Portanto, para testar um processo BPEL, você deve enviar ao tempo de execução BPEL uma mensagem destinada a uma das atividades Receber do processo.
Esta versão do BPEL Designer contém recursos para tornar esse teste uma experiência de apontar e clicar. Especificamente, com o projeto de amostra TravelReservationService, você pode enviar solicitações buildItinerary para o TravelReservationService implantado.
Procedimento de execução de teste
Para testar a execução do TravelReservationService:
Expanda o nó TravelReservationServiceApplication. Este nó possui um subnó chamado Teste.
Expanda o nó Teste. Haverá 4 subnós.
HasNoReservations - um itinerário de teste sem reservas
HasAirline - um itinerário de teste com uma reserva de linha aérea pré-existente
HasVehicle - um itinerário de teste com reservas de linha área e de veículo pré-existentes
HasHotel - um itinerário de teste com reservas de linha aérea, veículo e hotel pré-existentes
Estes nós de teste são na verdade arquivos XML que contêm os dados da mensagem de SOAP. Cada um representa um caso diferente que pode ser usado para testar o TravelReservationService a fim de exercitar o processo de formas ligeiramente diferentes.
Clique com o botão direito do mouse no nó HasNoReservations e escolha Testar no menu pop-up. Quando você seleciona a ação Teste, o IDE envia a mensagem de SOAP HasNoReservations para o tempo de execução BPEL. O IDE indicará se o teste foi bem sucedido.
Observação: Se você realizar uma execução de teste em um dos cenários de teste antes de adicionar o módulo JBI ou implantar o projeto, a execução de teste falhará.
Depurando o processo do Serviço de reserva de viagens
Você pode usar o IDE para depurar o aplicativo BPEL de amostra.
Etapas gerais de depuração
Siga estas etapas ao depurar o aplicativo de amostra:
Abra a janela Tempo de execução
Expanda o nó do Servidor de aplicativos Sun Java System.
No nó JBI, faça o seguinte:
Expanda os mecanismos de serviço
Abaixo do nó JavaEEServiceEngine, clique com o botão direito do mouse em com.sun.bpelse-1.0-2 para obter as propriedades.
Na folha Propriedades, altere DebugEnabled de Falso para Verdadeiro, e lembre-se da configuração da porta 3343. Observe que você só precisa alterar a entrada na folha Propriedades uma vez, quando começar as sessões de depuração.
Selecione Executar > Anexar depurador no menu principal. O IDE exibe a caixa de diálogo Anexar.
Adote o seguinte procedimento:
Certifique-se de que o depurador BPEL esteja selecionado como o depurador.
Certifique-se de que o nome do host seja localhost e a porta seja 3343.
Na janela Projetos, no nó TravelReservationService, clique duas vezes no arquivo TravelReservationService.bpel.
No Editor de fontes, defina pontos de interrupção no código-fonte, clicando no número da linha do elemento em que você deseja colocar um ponto de interrupção. Usaremos o teste HasNoReservations, portanto, colocaremos pontos de interrupção nas atividades que chamam todos os três serviços de parceiro.
Coloque um ponto de interrupção na atividade Receber ReceiveItinerary na linha 46. Essa é a atividade que inicia o processo. Se os números de linha não estiverem visíveis, escolha Exibir > Mostrar números de linha no menu principal.
Você também pode definir pontos de interrupção no diagrama. Para isso, alterne para a exibição Design, clique com o botão direito do mouse no elemento e escolha Alternar ponto de interrupção no menu pop-up.
Uma caixa vermelha é mostrada na parte superior do elemento com um ponto de interrupção.
O comando de menu Alternar ponto de interrupção também está disponível para os elementos na exibição Lógica do navegador BPEL. Se a janela Navegador não estiver aberta, escolha Janela > Navegador no menu principal. Para os elementos com pontos de interrupção, o navegador mostra um quadrado vermelho pequeno, como o mostrado na captura de tela (ReceiveItinerary):
Colocar pontos de interrupção em ReserveAirline (linha 74), ReserveVehicle (linha115) e ReserveHotel (linha 156) chama as atividades.
Como alternativa, selecione o elemento If HasAirline no diagrama e copie a expressão XPath a partir da linha Condição na janela Propriedades. Se a janela Propriedades não estiver visível, escolha Janela > Propriedades no menu principal.
Clique com o botão direito do mouse dentro da janela Inspeções e escolha Nova inspeção.
Na caixa de diálogo Nova inspeção, cole a expressão XPath no campo Expressão de inspeção.
Adicione duas inspeções para as expressões nas linhas 112 e 153. A janela Inspeções agora deve ter três itens:
Na janela Projetos, clique com o botão direito do mouse em HasNoReservations no nó Teste em TraveReservationServiceApplication e escolha Executar.
Quando o processo alcançar o primeiro ponto de interrupção, observe a janela Inspeções: ela deve conter a seqüência <Impossível avaliar a expressão> na coluna Valor de todas as três expressões. Isso acontece porque o processo parou no início da primeira atividade Receber e a mensagem ItineraryIn ainda não chegou.
Clique em Continuar na barra de ferramentas Depuração (Ctrl+F5). O processo pára no segundo ponto de interrupção. Nesse momento, a mensagem ItineraryIn chegou e as condições das inspeções foram avaliadas. O valor de todas as três expressões deve ser definido como verdadeiro.
Observação: As expressões retornam verdadeiro se a mensagem não contiver um item de reserva correspondente. Se você executar o teste HasAirline, o valor da expressão not($ItineraryIn.itinerary/ItineraryInfo/ReservationItems/Item/Air), que verifica se a mensagem de entrada não contém item de reserva de linha aérea, será definido como falso.
Clique em Continuar. Observe o estado do processo BPEL na janela Instâncias do processo BPEL. Além disso, observe as variáveis mudarem seus valores à medida que o processo progride na janela Variáveis BPEL.
Quando uma instância do processo é suspensa, você pode realizar qualquer uma das seguintes ações convencionais da barra de ferramentas Depurar (se a barra de ferramentas Depurar não estiver visível, escolha Exibir > Barras de ferramentas > Depurar):
Concluir sessão do depurador (Shift F5). Termina a sessão de depuração atual.
Continuar (Ctrl F5). Faz com que a instância do processo atual seja executada até que encontre o próximo ponto de interrupção ou até que a instância seja concluída.
Passar dentro (F7). Vai para a próxima atividade do BPEL. Essa etapa só é aceita na granularidade de atividade em termos da linguagem BPEL. Ela não entra em uma granularidade superior. Conforme você entra, o indicador da linha atual avançará e o conteúdo das janelas Variáveis BPEL e Inspeções pode conseqüentemente se alterar.
