Um simples processo BPEL assíncrono

Este tutorial fornece uma visão geral do projeto de amostra, AsynchronousSample, e mostra a implantação, execução e teste de um processo BPEL assíncrono por meio do pacote NetBeans Enterprise Pack 5.5 com todos os tempos de execução necessários.

O processo é simples. É um processo de eco, mas é um eco assíncrono, não um eco síncrono. Um cliente envia uma mensagem ao processo. O processo recebe a mensagem de entrada e retorna imediatamente. Em seguida, o processo chama de forma assíncrona o cliente original e envia a mesma mensagem de volta. Um processo assíncrono é usado quando o processo BPEL é de longa execução (leva um longo tempo para computar o resultado). Os resultados são retornados para o cliente por meio da chamada no cliente. Neste tutorial, você usará um projeto BPEL simples chamado AsynchronousSample e um projeto de aplicativo composto chamado AsynchronousSampleApplication. O projeto inclui os arquivos WSDL e de esquema, um descritor de implantação e os arquivos de entrada para teste. A interface do serviço da Web desse processo é uma única operação assíncrona.

superior

Configurando o ambiente do tutorial

Antes de implantar o seu aplicativo, o servidor de aplicativos Sun Java System e o tempo de execução JBI devem estar configurados corretamente e em execução.

Para configurar o ambiente do tutorial:

1. Clique na guia Tempo de execução para abrir a janela Tempo de execução.
2. Na janela Tempo de execução, expanda o nó Servidores.
3. Se o nó Servidores já contiver um nó Servidor de aplicativos Sun Java System 9, vá para a etapa 5.
4. Se o nó Servidores não contiver um nó Servidor de aplicativos Sun Java System 9, faça o seguinte para adicionar um servidor de aplicativos:
   
   1. Clique com o botão direito do mouse no nó Servidores e escolha Adicionar servidor no menu pop-up.
      A caixa de diálogo Adicionar instância do servidor é aberta.
   2. Na página Escolher servidor, na lista suspensa Servidor, selecione Servidor de aplicativos Sun Java System.
   3. (Opcional) No campo Nome, aceite o valor padrão ou digite o nome que você deseja usar para identificar o servidor no IDE.
   4. Clique em Próximo.
      A página Local da pasta da plataforma é aberta.
   5. No campo Local da plataforma, use o botão Explorar para navegar e selecionar o local de instalação do servidor de aplicativos.
      Caso você tenha aceito os valores padrão durante a instalação, o local é C:\Sun\Appserver.
   6. Selecione a opção Registrar domínio local padrão.
   7. Clique em Próximo.
   8. Forneça o nome de usuário e a senha do administrador do domínio.
      Caso você tenha aceito os valores padrão durante a instalação, o nome de usuário é admin e a senha é adminadmin.
   9. Clique em Finalizar.
5. Na janela Tempo de execução, clique com o botão direito do mouse no nó Servidor de aplicativos Sun Java System 9 e escolha Iniciar.
   Se a opção Iniciar não estiver disponível, o servidor já está em execução e você pode ignorar a próxima etapa.
6. Espere até que a mensagem seguinte apareça na janela Saída:
   Inicialização do servidor de aplicativos concluída.
   Quando o servidor está em execução, o IDE exibe um símbolo de seta verde no nó Servidor de aplicativos Sun Java System 9.

Clique para aumentar

superior

Abrindo o projeto AsynchronousSample

1. No menu principal do IDE, escolha Arquivo > Novo projeto.
   O assistente para Novo projeto é aberto.
2. Na lista Categorias, selecione Amostras > Service Oriented Architecture.
3. Na lista Projetos, selecione Processo BPEL assíncrono.

   
   Clique para aumentar

4. Clique em Próximo.
5. No campo Nome do projeto, digite AsynchronousSample.

   

6. (Opcional) No campo Local do projeto, use o botão Explorar para navegar e selecionar uma pasta diferente, onde o IDE armazenará os arquivos do projeto.
7. Clique em Finalizar.
   A janela Projetos agora contém dois nós de projeto: um para o projeto BPEL chamado AsynchronousSample, e um para o projeto de aplicativo composto chamado AsynchronousSampleApplication.
   Observe uma referência quebrada no nó AsynchronousSampleApplication. Este é um comportamento normal. O aplicativo composto tem uma dependência do módulo JBI.
   Você pode resolver a referência quebrada mais tarde na seção Implantando o projeto no servidor de aplicativos.
   

superior

Explorando o projeto BPEL e JBI na janela Projetos

1. Na janela Projetos, expanda o nó AsynchronousSample e expanda o nó Arquivos do processo.
   O nó Arquivos do processo contém estes itens:
   • AsynchronousSample.bpel, o processo BPEL
   • AsynchronousSample.wsdl, a interface do serviço da Web do processo
   • AsynchronousSample.xsd, o arquivo do esquema.
   • AsynchronousSampleClient.bpel, o processo do cliente de teste.
   • AsynchronousSampleClient.wsdl, o wsdl do processo do cliente
2. Na janela Projetos, expanda o nó AsynchronousSampleApplication . O projeto de implantação JBI contém:
   • Pacotes de origem
   • Módulos JBI
   • Teste

   

3. Clique duas vezes no nó AsynchronousSample.bpel.
   Observe o seguinte:
   • O Editor de fontes contém uma guia para AsynchronousSample.bpel.
   • O diagrama AsynchronousSample é mostrado na exibição Design.
     A exibição Design é o designer visual dos processos comerciais. Nessa exibição, você pode modelar visualmente um processo comercial. A ferramenta BPEL Design gera automaticamente o código BPEL que corresponde ao design visual.
   • A Paleta de elementos BPEL é aberta à direita do Editor de fontes.
   • A janela Navegador mostra a exibição lógica BPEL do processo BPEL.

   
   Clique para aumentar

superior

Explorando o AsynchronousSampleClient na janela Projetos

O projeto AsynchronousSample é um processo BPEL assíncrono. Testar um processo assíncrono requer um cliente que seja capaz de receber um retorno de chamada assíncrono. Portanto, o projeto também contém um processo BPEL AsynchronousSampleClient. O único propósito do processo AsynchronousSampleClient é facilitar o teste de unidade do AsynchronousSample.

1. Clique duas vezes no nó AsynchronousSampleClient.bpel.
   O IDE exibe o diagrama AsynchronousSampleClient na exibição Design.
   Observe que AsynchronousSample ( partnerLinkB ) faz uma chamada no AsynchronousSampleClient para retornar a resposta.
   

   

2. Clique duas vezes na atividade de recepção receiveCallback no processo AsynchronousSampleClient.
   O Editor de propriedades de receiveCallback é aberto.
3. Clique na guia Correlações, selecione a linha do correlator e clique em Editar.
   O editor para editar o conjunto de correlações é exibido.
   Observe que agora a correlação é usada para correlacionar a resposta para a instância correta de AsynchronousSampleClient.

superior

Implantando o projeto 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. A implantação do projeto torna a composição do serviço disponível no servidor de aplicativos, permitindo, portanto, que suas unidades de serviço sejam executadas.

1. Na guia Projeto, clique com o botão direito do mouse no nó do projeto de implantação AsynchronousSampleApplication e escolha Adicionar módulo JBI.
   É exibido o assistente para Selecionar projeto.
2. No assistente, selecione AsynchronousSample.

   

3. Clique no botão Adicionar arquivos JAR do projeto.
4. Expanda AsynchronousSampleApplication > Módulos JBI.
   Observe que o nó AsynchronousSample.jar é adicionado.
   
   

   

5. Clique com o botão direito do mouse no nó do projeto AsynchronousSampleApplication e escolha Implantar projeto.
6. Na caixa de diálogo Aviso, verifique se o Servidor de aplicativos Sun Java System 9 está selecionado e clique em OK.
7. A implantação foi bem-sucedida se aparecer a seguinte mensagem na janela Saída:

   

8. Se a janela Saída não estiver visível, escolha Janela > Saída.

superior

Testando o AsynchronousSampleApplication

1. Na janela Projetos, expanda o AsynchronousSampleApplication > Teste > NewTestcase0. O nó NewTestcase0 contém dois arquivos XML:
   • Input.xml para entrada
   • Output.xml para saída
   Cada vez que o teste é executado, a saída atual é comparada com o conteúdo de Output.xml.
   

   

2. Clique com o botão direito do mouse no nó do projeto AsynchronousSampleApplication, e escolha Testar projeto no menu de contexto.
   A mensagem seguinte é exibida na janela Saída:
   

   

superior