Criando uma aplicação SOA simples com o NetBeans

Neste tutorial, você criará um simples projeto SOA. Você então adicionará um documento WSDL para o projeto e usará a visualização Parceiro do editor WSDL para adicionar as mensagens, o tipo de link do parceiro, o tipo de porta e a operação. Você criará então um projeto de aplicação composta e usará o editor de Aplicação composta (Composição de serviço) para modificar a configuração do projeto. Este tutorial também ilustra um cenário básico que mostra como um componente Vinculação de arquivo pode ser usado em uma aplicação composta.

Duração esperada: 45 minutos

Requisitos do tutorial

Antes de prosseguir, revise os requisitos nesta seção.

início

Configurando e iniciando o servidor da aplicação GlassFish

Quando o download completo do NetBeans 6.0 é instalado, ele inclui o servidor da aplicação GlassFish. O NetBeans iniciará automaticamente o servidor da aplicação quando necessário.

Para iniciar o servidor da aplicação GlassFish:

1. Se a janela Serviços não estiver visível, escolha Janela > Serviços.
2. Na janela Serviços, expanda o nó Servidores.
   O nó Servidores deve conter um subnó do servidor da aplicação GlassFish. Se um nó do servidor da aplicação GlassFish não aparecer, vá para Para configurar o servidor da aplicação GlassFish.

 

3. Clique com o botão direito do mouse no nó do servidor da aplicação GlassFish e selecione Iniciar.
   
   A janela de saída exibe informações de log sobre a inicialização da aplicação. Se a janela de saída não estiver visível, escolha Janela > Saída > Saída.
   
   Uma mensagem informando que a inicialização do servidor da aplicação está concluída será exibida na janela de saída, indicando que o servidor da aplicação está em execução.
   Observação: se um emblema com uma seta verde aparecer no nó do servidor da aplicação GlassFish, o servidor estará sendo executado.
   

Observação: a implantação de uma aplicação no servidor da aplicação GlassFish iniciará automaticamente o servidor da aplicação GlassFish. Não é necessário iniciar manualmente o servidor da aplicação.

Observação: os seguintes procedimentos mostram como configurar o NetBeans 6.0 IDE para usar uma versão alternativa do servidor da aplicação GlassFish V2.

Para configurar o servidor da aplicação GlassFish V2:

1. Você pode querer usar uma versão diferente do servidor da aplicação da fornecida com o NetBeans 6.0. Por exemplo, pode querer baixar e instalar uma versão mais atual do servidor da aplicação GlassFish V2 do site da comunidade do GlassFish.

   O seguinte procedimento mostra como configurar o NetBeans 6.0 IDE para usar uma versão alternativa do servidor da aplicação GlassFish V2. Ele supõe que você tenha baixado e instalado a versão alternativa do servidor da aplicação.

   1. Na janela Serviços, 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, da lista suspensa Servidor, selecione GlassFish V2.
   3. Clique em Próximo.
      
      A página Localização da pasta da plataforma é aberta.
   4. No campo Localização da plataforma, use o botão Procurar para navegar para o local de instalação do servidor da aplicação e selecionar esse local.
      
      Se você tiver instalado o servidor da aplicação GlassFish no local padrão, use a Tabela 1 como um aba para localizar a instalação. Caso contrário, navegue para o local onde instalou o servidor da aplicação GlassFish V2.
      
      

      Tabela 1: diretório padrão de instalação do servidor da aplicação

      Plataforma	Instalando como...	Instalação da SOA	Instalação do conjunto de ferramentas
      Solaris OS Linux	raiz	/opt/SUNWappserver	/opt/SDK
      Solaris OS Linux	usuário	~/SUNWappserver	~/SDK
      Mac OS X	N/D	~/SUNWappserver	~/SDK
      Windows	N/D	C:\Sun\AppServer	C:\Sun\SDK

   5. Selecione o botão de opção Registrar o domínio local padrão e clique em Próximo.
   6. Indique o nome de usuário e a senha do administrador do domínio.
      Caso você tenha aceitado os valores padrão durante a instalação, o nome de usuário é admin e a senha é adminadmin.
   7. Clique em Terminar.

início

Criando o projeto do módulo BPEL

Nesta seção, você cria um projeto do módulo BPEL chamado HelloSample.

Para criar o projeto ::

1. No menu principal, escolha Arquivo > Novo arquivo.
   O assistente para novo projeto é aberto.
2. Na lista Categorias, selecione o nó SOA.
3. Na lista Projetos, selecione nó Módulo BPEL.
4. Clique em Próximo.
5. No campo Nome do projeto, digite HelloSample.
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 Terminar.
   A janela Projetos agora contém um nó de um projeto do módulo BPEL chamado HelloSample.
   

início

Criando o documento WSDL

Nesta seção, você adiciona um documento WSDL, HelloSample.wsdl ao seu projeto de módulo BPEL e, em seguida, usa a visualização Parceiro do editor WSDL para configurar os componentes do documento WSDL.

Para criar o documento WSDL:

1. Na janela Projetos, expanda o nó do projeto HelloSample, clique com o botão direito do mouse no nó Arquivos do processo e escolha Novo > Documento WSDL.
   O assistente para Novo documento WSDL é aberto.
2. No campo Nome do arquivo, digite HelloSample.
3. Clique em Terminar.
   
   • Na janela Projetos, o IDE adiciona um nó HelloSample.wsdl sob o nó Arquivos do processo.
   • O arquivo HelloSample.wsdl é aberto no editor WSDL.
     O editor WSDL possui três visualizações: Código-fonte, WSDL e Parceiro.
     Para obter mais informações sobre o editor WSDL, consulte Guia do desenvolvedor para o editor WSDL.
   • A janela Propriedades se abre.
     Se você não vir a janela Propriedades, escolha Janela > Propriedades.
   • A janela Navegador se abre.

   

Para adicionar mensagens:

1. Na visualização WSDL, clique no botão Parceiro para abrir a visualização Parceiro do editor WSDL.
   O editor alterna para a visualização Parceiro e a Paleta é aberta.
   Se a janela Paleta não estiver visível, escolha Janela > Paleta no menu principal.
2. Na seção Componentes WSDL da Paleta, selecione o ícone Mensagem.
3. Arraste sua seleção para a área de design da visualização Paleta, para a área Mensagens (a parte inferior da área de design).
   O IDE adiciona uma mensagem chamada message1.
   
   

   

   Observação: se você não vir as colunas Nome da parte, Elemento da parte ou Tipo, clique na seta para baixo na caixa message1 para expandir a caixa.
4. Na coluna Nome da parte de message1, clique duas vezes no valor padrão, part1, para tornar o campo editável.
5. Digite inputType e pressione Enter.
6. Na coluna Elemento da parte ou Tipo de message1, clique no botão de reticências, e na caixa de diálogo que se abre, expanda Tipos de esquema internos, selecione string e clique em OK.
7. Repita as etapas 2-6 para criar outra mensagem, message2 e use resultType como o Nome da parte.
   Quando você terminar, sua área de design deve ser semelhante àquela mostrada abaixo.
   
   

   

Para adicionar um tipo de link de parceiro:

1. Na seção Componentes WSDL da Paleta, selecione o ícone Tipo de link de parceiro.
2. Arraste a sua seleção para a área de design, para a área Tipos de link de parceiro (a parte superior da área de design).
   O IDE adiciona um tipo de link de parceiro chamado partnerlinktype1. Agora você pode criar novas funções e tipos de porta. As funções e os tipos de porta são desenhados como linhas verticais pontilhadas com os nomes externos mostrados na parte superior.
   
   

   

3. Na caixa partnerlinktype1, clique duas vezes na caixa sob role1.
   Isso torna a porta editável e um valor padrão, portType1, aparece no campo.
4. Pressione Enter.
   O novo portType1 é atribuído.
5. Na seção Componentes WSDL da Paleta, selecione o ícone Solicitação-resposta.
6. Arraste a sua seleção para a área de design, abaixo de portType1.
   O IDE adiciona uma operação, operation1.
   
   

   

7. Em operation1, selecione a seta de mensagem sólida rotulada <Nenhuma mensagem selecionada>.
8. Na janela Propriedades, na lista suspensa Mensagem, selecione tns:message1.
   O rótulo muda para message1.
9. Em operation1, selecione a seta de mensagem pontilhada rotulada <Nenhuma mensagem selecionada>.
10. Na janela Propriedades, na lista suspensa Mensagem, selecione tns:message2.
    O rótulo muda para message2.
    Quando você concluir essas etapas, sua área de design deverá ser semelhante àquela mostrada abaixo.
    
    

    

início

Criando o processo BPEL

Nesta seção, você adiciona um arquivo de processo BPEL, HelloSample.bpel. Em seguida, adicione um link de parceiro e três atividades ao arquivo do processo BPEL.

Para criar o arquivo de processo BPEL:

1. Na janela Projetos, expanda o nó do projeto HelloSample, clique com o botão direito do mouse no nó Arquivos do processo e escolha Novo > Processo BPEL.
   O assistente para Novo processo BPEL é aberto.
2. No campo Nome do arquivo, digite HelloSample.
3. Clique em Terminar.
   
   • Na janela Projetos, o IDE adiciona um nó HelloSample.bpel sob o nó Arquivos do processo.
   • O arquivo HelloSample.bpel é aberto no BPEL Designer.
     O BPEL Designer possui duas visualizações: Código-fonte e Design.
     Para obter mais informações sobre o BPEL Designer, consulte Guia do desenvolvedor para o BPEL Designer.
   • A janela Propriedades se abre.
     Se você não vir a janela Propriedades, escolha Janela > Propriedades.
   • A janela Navegador se abre mostrando a visualização Lógica BPEL do documento do processo BPEL.
   A janela IDE deve ter uma aparência semelhante à mostrada abaixo.
   
   

   

Para adicionar um link de parceiro:

1. Na seção Serviço Web da Paleta, selecione o ícone Link de parceiro e arraste sua seleção para a área de design.
   A caixa de diálogo Criar novo link de parceiro é aberta.
2. Aceite os padrões (Nome: PartnerLink1, Arquivos WSDL: /HelloSample.wsdl, botão de opção Usar tipo de link de parceiro existente selecionado) e clique em OK.
   O IDE adiciona uma caixa para o link de parceiro à área de design.
   
   

   

Para adicionar uma atividade Receber:

1. Na seção Serviço Web da Paleta, selecione o ícone Receber.
2. Arraste a sua seleção para a caixa HelloSample na área de design, entre as atividades Início do processo e Fim do processo.
   O IDE lhe oferece pistas visuais para mostrar onde você pode soltar a seleção.
   Esta ação coloca uma atividade Receber chamada Receber1 na visualização Design.
3. Clique duas vezes na atividade Receber1.
   O Editor de propriedades de Receber1 [Receber] é aberto.
4. Na aba Principal, na lista suspensa Link de parceiro, selecione PartnerLink1.
   O IDE preenche o campo Operação com operation1.
5. Crie uma nova variável de entrada adotando o seguinte procedimento:
   1. Clique no botão Criar ao lado do campo Variável de entrada.
      A caixa de diálogo Nova variável de entrada é aberta.
   2. Altere o valor no campo Nome para inputVar.
   3. Clique em OK.
6. Clique em OK para fechar o Editor de propriedades de Receber1 [Receber].
   A visualização Design agora mostra uma conexão entre operation1 em PartnerLink1 e a atividade Receber1.
   
   

   

Para adicionar uma atividade Responder:

1. Na seção Serviço Web da Paleta, selecione o ícone Responder.
2. Arraste a sua seleção para a área de design entre a atividade Receber1 e a atividade Fim do processo.
   O IDE lhe oferece pistas visuais para mostrar onde você pode soltar a seleção.
   Esta ação coloca uma atividade Responder chamada Responder1 na visualização Design.
3. Clique duas vezes na atividade Responder1.
   O Editor de propriedades de Responder1 [Responder] é aberto.
4. Na aba Principal, na lista suspensa Link de parceiro, selecione PartnerLink1.
   O IDE preenche o campo Operação com operation1.
5. Crie uma nova variável de saída adotando o seguinte procedimento:
   1. Verifique se o botão de opção Resposta normal está selecionado.
   2. Clique no botão Criar ao lado do campo Variável de saída.
      A caixa de diálogo Nova variável de saída é aberta.
   3. Altere o valor no campo Nome para outputVar.
   4. Clique em OK.
6. Clique em OK para fechar o Editor de propriedades de Responder1 [Responder].
   A visualização Design agora mostra uma conexão entre a atividade Reply1 e operation1 em PartnerLink1.
   
   

   

Para adicionar uma atividade Atribuir:

1. Na seção Atividades básicas da Paleta, selecione o ícone Atribuir.
2. Arraste a sua seleção para a área de design entre a atividade Receber1 e a atividade Reply1.
   Esta ação coloca uma atividade Atribuir chamada Atribuir1 na visualização Design.
3. Selecione a nova atividade Atribuir1.
4. Se a janela Mapeador BPEL não estiver visível, escolha Janela > Outro > Mapeador BPEL no menu principal.
5. No painel da árvore de origem (o painel à esquerda) do Mapeador BPEL, em Variáveis, expanda o nó inputVar.
   Um nó inputType aparece sob o nó inputVar.
6. No painel da árvore de destino (o painel à direita) do Mapeador BPEL, em Variáveis, expanda o nó outputVar.
   Um nó resultType aparece no nó inputVar.
7. No painel da árvore de origem, selecione o nó inputType e arraste a sua seleção para o nó resultType no painel da árvore de destino.
   Esta atribuição copia a declaração de entrada para a saída.
   
   

   

8. Para salvar suas alterações, na janela Projetos, selecione o nó do projeto HelloSample e, no menu principal, escolha Arquivo > Salvar todos.

início

Criando o projeto de aplicação composta

Antes de implantar o projeto do módulo BPEL, você deve adicionar o módulo JBI ao projeto de deployment. O deployment do projeto torna a composição de serviço disponível no servidor da aplicação, permitindo, portanto, que suas unidades de serviço sejam executadas.

Para criar o projeto da aplicação composta:

1. No menu principal, escolha Arquivo > Novo arquivo.
   O assistente para novo projeto é aberto.
2. Na lista Categorias, selecione o nó SOA.
3. Na lista Projetos, selecione o nó Aplicação composta.
4. Clique em Próximo.
5. No campo Nome do projeto, digite SampleCompositeApp.
6. Clique em Terminar.
   A janela Projetos agora contém um nó do projeto de aplicação composta chamado SampleCompositeApp.
   
   

   

início

Usando o Editor Composite Application (Service Assembly)

Nesta seção, use o Editor CASA (Composite Application Service Assembly) para modificar a configuração do projeto e construir o projeto do módulo BPEL. Em seguida, adicione uma conexão e um ponto final WSDL e depois verifique e altere as propriedades dos pontos finais WSDL gerados automaticamente.

Para usar o Editor CASA (Composite Application Service Assembly) para modificar a configuração do projeto e construir o projeto do módulo BPEL:

1. Na janela Projetos, selecione o nó do projeto SampleCompositeApp e escolha Editar configuração da aplicação no menu pop-up.
   O IDE abre o arquivo .casa no Editor CASA. A área de design da visualização Design do editor possui três partes: Portas WSDL, Módulos JBI e Módulos externos.
   
   

   

2. Na janela Projetos, selecione o nó do projeto HelloSample e arraste a sua seleção para a área Módulos JBI na visualização Design do arquivo SampleCompositeApp.casa.
   
   

   

3. Na barra de ferramentas do editor, clique no botão Construir projeto de módulo BPEL HelloSample.
   Após concluir esta etapa:
   • A barra de status exibe a seguinte mensagem:
     Construção de build.xml (jbi-build) finalizada.
   • A janela de saída deve ter uma aparência semelhante à mostrada abaixo.
     
     

     

   • A visualização Design do arquivo SampleCompositeApp.casa deve parecer com a mostrada abaixo.
     
     

     

Para criar o ponto final WSDL:

1. Na seção Vinculações WSDL da Paleta, selecione o ícone do arquivo.
2. Arraste a sua seleção para a área Portas WSDL na visualização Design do arquivo SampleCompositeApp.casa.
   O IDE adiciona uma porta WSDL rotulada como casaPort1.
   
   

   

Para criar uma conexão:

1. Na porta casaPort1 na visualização Design, clique no ícone do ponto final de consumo.
   As cores do ícone se alteram quando você seleciona o ponto final.
2. Arraste a sua seleção para role1_myRole na caixa (BPEL) HelloSample na área Módulos JBI.
   O IDE cria uma nova conexão.
   
   

   

Para verificar e alterar as propriedades do ponto final WSDL gerado automaticamente:

1. Se a janela Navegador não estiver visível, escolha Janela > Navegação > Navegador no menu principal.
2. Na janela Navegador, na lista suspensa, selecione Visualização lógica.
3. Expanda Portas WSDL > casaPort1 > casaBinding1 > operation1 > input1 e selecione o nó file:message.
   
   

   

4. Se a janela Propriedades não estiver visível, escolha Janela > Propriedades no menu principal.
   A janela Propriedades mostra as propriedades do nó file:message que você selecionou na janela Navegador.
5. Na janela Propriedades, altere as propriedades para corresponder aos valores mostrados abaixo:
   
   

   Propriedade	Valor
   use	literal
   fileName	input.txt
   pollingInterval	5000

6. Na janela Navegador, expanda Portas WSDL > casaPort1 > casaBinding1 > operation1 > output1 e selecione o nó file:message.
   
   

   

7. Na janela Propriedades de file:message, atribua output.txt à propriedade fileName.
8. Na janela Navegador, expanda Portas WSDL > casaPort1 > casaPort1 e selecione o nó file:address.
   
   

   

9. Na janela Propriedades de file:address, na propriedade fileDirectory, substitua C:\Temp pela string c:\test.
10. Para salvar suas alterações, na janela Projetos, selecione o nó do projeto SampleCompositeApp e, no menu principal, escolha Arquivo > Salvar todos.

início

Implantando e testando a aplicação composta

Nesta seção, você implanta o projeto de aplicação composta e, em seguida, testa essa aplicação implantada. Se você ignorou as etapas em Configurando e iniciando o servidor da aplicação Sun Java System anteriormente neste tutorial, deverá realizá-las antes dessas tarefas de deployment e teste.

Para implantar a aplicação composta:

• Na janela Projetos, selecione o nó do projeto SampleCompositeApp, clique com o botão direito do mouse e escolha Implantar.
  Uma mensagem semelhante à seguinte aparece na janela Saída:
  CONSTRUÇÃO BEM SUCEDIDA (tempo total: 6 segundos)

Para testar a aplicação composta:

• Use um editor para criar um novo arquivo de texto que contém a Hello World! e salve o arquivo como input.txt na pasta c:\test.
  O processo em execução deve fazer o seguinte:
  
  • Criar input.txt<UUID> _processed na pasta de arquivo.
  • Criar output.txt na pasta C:/test com o mesmo conteúdo de input.txt, nesse caso, a string Hello World!.
  Se isso não acontecer, então, há um erro de processamento que fará o seguinte:
  
  • Criar input.txt<UUID> _error na pasta c:\test\filebc_tmp

início

Resumo

Neste tutorial, você criou um projeto do módulo BPEL. Você, então, adicionou um documento WSDL ao projeto e usou a visualização Parceiro do editor WSDL para adicionar as mensagens, o tipo de link do parceiro, o tipo de porta e a operação. Em seguida, você criou um projeto de aplicação composta e usou o editor de aplicação composta (Composição de serviço) para modificar a configuração do projeto. Você também usou o componente Vinculação de arquivo na aplicação composta.

início

Próximas etapas

• Para enviar comentários e sugestões, obter suporte e manter-se informado sobre as alterações mais recentes nos recursos de desenvolvimento do NetBeans IDE J2EE , junte-se à lista de usuários em .

Veja também

• Guia do Desenvolvedor para o Editor WSDL
• Guia do Desenvolvedor para o Designer BPEL  
  

início