>> Mais documentação do SOA

Introduzindo a visualização Parceiro do editor WSDL

Este tutorial lhe apresenta a visualização Parceiro do editor WSDL.

A visualização Parceiro do Editor WSDL representa os elementos abstratos de um arquivo WSDL como interações entre parceiros. Os elementos abstratos inclui tipos de link de parceiro, funções, tipos de porta, operações e mensagens.

Conteúdo

• Requisitos do Tutorial
• Configurando e iniciando o servidor da aplicação Sun Java System
• Criando o projeto do Módulo BPEL
• Criando o arquivo WSDL
• Criando o processo comercial
• Criando e implantando o projeto de aplicação composta
• Testando a aplicação composta
• Resumo
• Consulte também

Requisitos do tutorial

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

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.

Software necessário para o tutorial

Antes de começar, você deve instalar o seguinte software no seu computador:

• NetBeans IDE 6.0
  
  Selecione a opção Baixar tudo. A opção Download completo inclui o SOA Pack e o servidor da aplicação GlassFish V2, que são necessários para este tutorial.

início

Configurando e iniciando o servidor da aplicação Sun Java System

Antes que você possa implantar a sua aplicação composta, o servidor da aplicação Sun Java System e o mecanismo do serviço BPEL devem ser configurados corretamente e estar em execução.

Para verificar o status do servidor da aplicação Sun Java System:

1. Se a janela Tempo de execução não estiver visível, escolha Janela > Tempo de execução.
2. Na janela Tempo de execução, expanda o nó Servidores.
   O nó Servidores deve conter um subnó Servidor da aplicação Sun Java System. Se um nó Servidor da aplicação Sun Java System não aparece, vá para Para configurar o servidor da aplicação Sun Java System.
   Se um emblema com uma seta verde aparecer no nó Servidor da aplicação Sun Java System, o servidor estará sendo executado. Se um emblema com uma seta verde não aparecer, vá para Para iniciar o servidor da aplicação Sun Java System.

Para configurar o servidor da aplicação Sun Java System:

1. Se a janela Tempo de execução não estiver visível, escolha Janela > Tempo de execução.
2. Na janela Tempo de execução, 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.
3. Na página Escolher servidor, na lista suspensa Servidor, selecione Servidor da aplicação Sun Java System.
4. (Opcional) No campo Nome, altere o nome padrão do servidor.
   O IDE usa esse nome para identificar o servidor.
5. Clique em Próximo.
   A página Local da pasta da plataforma é aberta.
6. 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.
   O local de instalação padrão é diferente, dependendo do tipo de instalação e da plataforma, como mostrado na Tabela 1.
   
   

   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

7. Selecione o botão de opção Registrar o domínio local padrão e clique em Próximo.
8. 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.
9. Clique em Terminar.

Para iniciar o servidor da aplicação Sun Java System:

1. Na janela Tempo de execução, clique com o botão direito do mouse no nó Servidor da aplicação Sun Java System e escolha Iniciar.
2. Espere até que a mensagem seguinte apareça na janela Saída:
   Inicialização do servidor da aplicação concluída.
   Quando o servidor está em execução, o IDE exibe um emblema de seta verde no nó Servidor da aplicação Sun Java System.

Para verificar o status do mecanismo do serviço BPEL:

1. Na janela Tempo de execução, expanda Servidor da aplicação Sun Java System > JBI > Mecanismos de serviço.
2. Clique com o botão direito do mouse no nó sun-bpel-engine.
   Se a opção Iniciar não estiver disponível, então, o mecanismo de serviço é iniciado e você ignora o restante deste procedimento.
3. Clique em Iniciar.
4. Espere até que a mensagem seguinte apareça na janela Saída:
   Mecanismo do serviço BPEL iniciado

início

Criando o projeto do módulo BPEL

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

Para criar o projeto do módulo BPEL:

1. No menu principal do IDE, escolha Arquivo > Novo projeto.
   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 PartnerView.
6. Clique em Terminar.
   A janela Projetos agora contém um nó de um projeto do módulo BPEL chamado PartnerView.

início

Criando o arquivo WSDL

Nesta seção, você adiciona um arquivo WSDL ao projeto do módulo BPEL.

O arquivo WSDL descreve um serviço básico que recebe um valor string como entrada e envia um valor string como saída. Use a visualização Parceiro do editor WSDL para adicionar a mensagem de entrada, a mensagem de saída, o tipo de link de parceiro, o tipo de porta e a operação. Use a visualização WSDL do editor WSDL para adicionar a vinculação e o serviço.

Um tipo de link de parceiro caracteriza a relação interativa entre dois serviços. Um tipo de link de parceiro pode ter uma ou duas funções. Uma função descreve o papel de um serviço no relacionamento.

Uma função deve especificar o tipo de porta que o serviço usará para receber mensagens. Um tipo de porta contém uma ou mais operações relacionadas que o serviço Web pode realizar. O Editor WSDL suporta as seguintes categorias de operações:

• Solicitação-resposta. A operação recebe uma mensagem como entrada e envia uma mensagem como saída.
• Unidirecional. A operação recebe uma mensagem como entrada.

O tipo de porta no arquivo WSDL contém uma operação de solicitação-resposta.

Para criar o arquivo PartnerView.wsdl:

1. Na janela Projetos, clique com o botão direito do mouse no nó Arquivos do processo no projeto PartnerView e escolha Novo > Documento WSDL.
   O assistente para Novo documento WSDL é aberto.
2. No campo Nome do arquivo, digite PartnerView.
3. Clique em Terminar.
   O editor WSDL aparece com a visualização WSDL aberta.
4. Na barra de ferramentas da visualização WSDL, clique no botão Parceiro.
   A visualização Parceiro aparece.

Para adicionar a mensagem de entrada:

1. Se a Paleta não estiver visível, então escolha Janela > Paleta no menu principal do IDE.
2. Na Paleta, selecione o ícone Mensagem.
3. Arraste o ícone Mensagem para a área Mensagens da visualização Parceiro.
   O IDE adiciona uma mensagem. O nome da mensagem é message1.
4. Na coluna Nome da parte, 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, clique no botão de reticências (...).
7. Selecione o nó string.
8. Clique em OK.

Para adicionar a mensagem de saída:

1. Na Paleta, selecione o ícone Mensagem.
2. Arraste o ícone Mensagem para a área Mensagens da visualização Parceiro.
   O IDE adiciona uma mensagem. O nome da mensagem é message2.
3. Na coluna Nome da parte, clique duas vezes no valor padrão (part1) para tornar o campo editável.
4. Digite resultType e pressione Enter.
5. Na coluna Elemento da parte ou Tipo, clique no botão de reticências (...).
6. Selecione o nó string.
7. Clique em OK.

Para adicionar o tipo de link de parceiro, o tipo de porta e a operação:

1. Na Paleta, selecione o ícone Tipo de link de parceiro.
2. Arraste o ícone Tipo de link de parceiro para a área Tipos de link de parceiro da visualização Parceiro.
   O IDE adiciona um tipo de link de parceiro. O nome do tipo de link de parceiro é partnerlinktype1. O tipo de link de parceiro possui uma função padrão chamada role1.
3. Clique duas vezes em Indicar ou selecionar um tipo de porta e pressione Enter.
   O IDE adiciona um tipo de porta chamado portType1.
4. Na Paleta, selecione o ícone Solicitação-resposta.
5. Arraste o ícone Solicitação-resposta para a linha vertical pontilhada que se estende abaixo da caixa portType1.
   O IDE adiciona uma operação chamada operation1.
6. Em operation1, clique duas vezes na primeira <Nenhuma mensagem selecionada> e selecione tns:message1. Essa é a mensagem de entrada que você criou.
7. Em operation1, clique duas vezes na segunda <Nenhuma mensagem selecionada> e selecione tns:message2. Essa é a mensagem de saída que você criou.

Para adicionar a vinculação e o serviço:

1. Na barra de ferramentas da visualização Parceiro, clique no botão WSDL.
   A visualização WSDL aparece.
2. Clique com o botão direito do mouse no nó portType1 e escolha Adicionar > Vinculação e Porta de serviço.
   A caixa de diálogo Gerar vinculação e porta de serviço se abre.
3. O valor padrão do campo Tipo de vinculação é SOAP. Não altere o valor padrão.
4. O valor padrão do campo Subtipo de vinculação é Literal RPC. Não altere o valor padrão.
5. Clique em OK.
   A vinculação e o serviço são adicionados. Você criou com êxito o arquivo WSDL.
6. No menu principal do IDE, escolha Arquivo > Salvar.

início

Criando o processo comercial

Nesta seção, você adiciona um processo comercial do projeto do módulo BPEL. Use o BPEL Designer do IDE para configurar o processo comercial.

O processo comercial conterá as seguintes atividades:

• Atividade Receber. A atividade Receber aguarda que a mensagem chegue de um parceiro de serviço.
• Atividade Atribuir. A atividade Atribuir copia dados de uma variável de entrada para uma variável de saída.
• Atividade Responder. A atividade Responder envia uma resposta para o serviço de parceiro.

As atividades Receber e Responder interagem com um link de parceiro. Um link de parceiro é uma referência a um serviço Web externo com o qual um processo comercial interage.

Para criar o arquivo PartnerView.bpel:

1. Na janela Projetos, clique com o botão direito do mouse no nó Arquivos do processo no projeto PartnerView e escolha Novo > Processo BPEL.
   O assistente para Novo processo BPEL é aberto.
2. No campo Nome do arquivo, digite PartnerView.
3. Clique em Terminar.
   O BPEL Designer aparece com a visualização Design aberta. Uma cruz vermelha ao lado da caixa PartnerView indica que o processo comercial não é válido. A cruz vermelha permanecerá até que você adicione a atividade Receber mais adiante nesta seção.
4. Se a Paleta não estiver visível, então escolha Janela > Paleta no menu principal do IDE.

Para adicionar um link de parceiro:

1. Na janela Projetos, selecione o nó PartnerView.wsdl.
2. Arraste o nó PartnerView.wsdl da janela Projetos para uma parte vazia da área de design.
   A caixa de diálogo Criar novo link de parceiro é aberta.
3. Aceite os valores padrão e clique em OK.
   O IDE adiciona um link de parceiro chamado PartnerLink1.

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 PartnerView na área de design, entre as atividades Início do processo e Fim do processo.
   O IDE fornece pistas visuais que indicam onde você quer soltar a seleção.
   A atividade Receber1 é adicionada.
3. Clique duas vezes em Receber1 para editar as propriedades.
   A caixa de diálogo Editor de propriedades de Receber1 [Receber] se abre.
4. 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 em Criar.
   2. No campo Nome, altere o valor padrão para inputVar.
   3. Clique em OK.
6. Clique em OK para fechar a caixa de diálogo Editor de propriedades de Receber1 [Receber].
   O IDE adiciona uma conexão a partir da operação operation1 com 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 caixa PartnerView na área de design, entre as atividades Receber1 e Fim do processo.
   O IDE fornece pistas visuais que indicam onde você quer soltar a seleção.
   A atividade Responder1 é adicionada.
3. Clique duas vezes na atividade Responder1 para editar as propriedades.
   A caixa de diálogo Editor de propriedades de Responder1 [Responder] se abre.
4. 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 em Criar.
   3. No campo Nome, altere o valor padrão para outputVar.
   4. Clique em OK.
6. Clique em OK para fechar a caixa de diálogo Editor de propriedades de Responder1 [Responder].
   O IDE adiciona uma conexão da atividade Responder1 com a operação operation1.

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 caixa PartnerView na área de design, entre as atividades Receber1 e Responder1.
   O IDE fornece pistas visuais que indicam onde você quer soltar a seleção.
   A atividade Atribuir1 é adicionada.
3. Selecione a nova atividade Atribuir1.
4. Se a janela Mapeador BPEL não estiver visível, então escolha Janela > Outro > Mapeador BPEL no menu principal do IDE.
5. No painel esquerdo do Mapeador BPEL, expanda o nó inputVar.
   O nó inputType aparece.
6. No painel direito do Mapeador BPEL, expanda o nó outputVar.
   O nó resultType aparece.
7. No painel esquerdo, selecione o nó inputType e arraste o ponteiro para o nó resultType no painel direito.
   Um link conecta os nós.
8. No menu principal do IDE, escolha Arquivo > Salvar.

início

Criando e implantando a projeto de aplicação composta

Nesta seção, você cria um projeto de aplicação composta e adiciona o arquivo Java Archive (JAR) do projeto do módulo BPEL. Em seguida, implante o projeto de aplicação composta no servidor da aplicação Sun Java System.

Para criar o projeto da aplicação composta:

1. No menu principal do IDE, escolha Arquivo > Novo projeto.
   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 PartnerViewCompositeApp.
6. Clique em Terminar.
   A janela Projetos agora contém um nó de um projeto de aplicação composta chamado PartnerViewCompositeApp.

Para adicionar o arquivo JAR do projeto do módulo BPEL:

1. Na janela Projetos, clique com o botão direito do mouse no nó do projeto PartnerViewCompositeApp e escolha Adicionar módulo JBI no menu pop-up.
   A caixa de diálogo Selecionar projeto é aberta.
2. Selecione o projeto PartnerView. Este projeto é o projeto do módulo BPEL que você criou nas seções precedentes.
3. Clique em Adicionar arquivos JAR do projeto.
4. Na janela Projetos, expanda o nó PartnerViewCompositeApp e, em seguida, expanda o nó Módulos JBI.
   Observe que um nó PartnerView.jar foi adicionado.

Para implantar o projeto de aplicação composta:

1. Na janela Projetos, clique com o botão direito do mouse no nó PartnerViewCompositeApp e escolha Implantar projeto.
2. Observe a mensagem CONSTRUÇÃO BEM SUCEDIDA na janela Saída.

início

Testando a aplicação composta

Nesta seção, você realiza uma execução de teste para verificar se a aplicação composta funciona da forma esperada. O caso de teste que você criou chama a operação operation1 no arquivo PartnerView.wsdl.

Para adicionar um caso de teste:

1. Na janela Projetos, expanda o nó do projeto PartnerViewCompositeApp, clique com o botão direito do mouse no nó Teste e escolha Novo caso de teste no menu pop-up.
   O assistente para Novo caso de teste é aberto.
2. Na página Indicar o nome do caso de teste, defina o nome como PartnerViewTestCase e clique em Próximo.
3. Na página Selecionar o documento WSDL, expanda o nó PartnerView - Arquivos do processo, selecione PartnerView.wsdl e clique em Próximo.
4. Na página Selecionar a operação a ser testada, selecione operation1 e clique em Terminar.
   O nó PartnerViewTestCase é adicionado. O nó PartnerViewTestCase possui dois subnós: Entrada e Saída. O Editor de código-fonte contém uma aba do arquivo de entrada, Input.xml.
5. Localize a linha seguinte no arquivo Input.xml:
   <inputType>?string?</inputType>
6. Altere a linha para:
   <inputType>Hello World</inputType>
7. No menu principal do IDE, escolha Arquivo > Salvar.
8. Na janela Projetos, clique duas vezes no nó Saída
   O editor de código-fonte agora contém uma aba do arquivo de saída, Output.xml. Inicialmente, o arquivo de saída está vazio.

Para executar o caso de teste:

1. Na janela Projetos, clique com o botão direito do mouse no nó PartnerViewTestCase e escolha Executar no menu pop-up.
   Porque o arquivo de saída está vazio, o teste falha. A caixa de diálogo Sobrescrever saída vazia se abre para que você possa confirmar se deseja sobrescrever o arquivo Output.xml.
2. Clique em Sim.
3. Na janela Projetos, clique com o botão direito do mouse no nó PartnerViewTestCase e escolha Executar no menu pop-up.
   O teste é aprovado.
4. Visualize os resultados do teste no arquivo Output.xml.

início

Resumo

Neste tutorial, você explorou a visualização Parceiro do editor WSDL enquanto criou e implantou uma aplicação composta.

início

Veja também

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

---

>> Mais documentação do SOA

início