Conectando componentes Vinculação com o editor CASA
Contribuição de Vince Genovese Manutenção de
Dezembro de 2007
Esta publicação se aplica à versão do NetBeans IDE 6.0.
Este tutorial mostra como usar o editor CASA (Composite Application Service Assembly) para criar conexões entre pontos finais do componente Vinculação.
Para obter mais informações sobre como trabalhar com o NetBeans IDE, consulte a página Suporte e documentação no site do NetBeans.
Antes de começar, baixe e instale o software seguinte:
NetBeans 6.0
Selecione a opção Download completo. 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.
Este tutorial mostra como usar o editor CASA para modificar a configuração de uma aplicação composta para fornecer uma conexão entre duas vinculações WSDL.
Um recurso chave de aplicações compostas é a habilidade de desacoplar um consumidor de serviço do provedor de serviços. Para casos de uso simples, essa desacoplagem pode ser implantada por meio do recurso de conexão BC-com-BC do editor CASA. Esses casos de uso simples não requerem a lógica de processamento por BPEL, XSLT ou JAVA. Por exemplo, se você deseja rotear solicitações de serviço recebidas de um endereço de ponto final externo para um serviço localizado em uma rede interna, é possível conectar dois pontos finais diretamente no CASA como mostrado neste tutorial.
A aplicação composta que você configura e constrói neste tutorial é a aplicação composta de amostra síncrona fornecida com a distribuição do NetBeans IDE 6.0. O tutorial ilustra o seguinte:
Construindo uma aplicação composta de dentro do editor CASA
Adicionando um novo ponto final WSDL à aplicação composta
Conectando o novo ponto final WSDL a um ponto final WSDL existente na aplicação composta
Modificando as propriedades do novo ponto final WSDL
Implantando a aplicação composta
Executando um caso de teste da aplicação composta
Observe o seguinte:
Uma das portas WSDL deve ser definida com um tipo de porta conhecido
Os pontos finais de consumo e fornecimento da mesma porta WSDL não podem ser vinculados.
Esta seção ilustra como conectar os pontos finais da vinculação WSDL na aplicação de amostra síncrona.
Para criar e construir o projeto da aplicação de amostra síncrona, que é fornecido com o NetBeans 6.0:
No NetBeans IDE, selecione a aba Projetos para exibir a janela Projetos.
No menu Arquivo, selecione Novo projeto.
Na lista Categorias da janela Novo projeto, selecione Amostras > SOA > Processo BPEL síncrono e clique em Próximo.
Para o Nome do projeto, especifique SynchronousSample-BC-BC
Aceite a localização padrão ou especifique uma localização alternativa por meio do botão Explorar.
Clique em Terminar para criar o projeto.
Os projetos seguintes aparecem na janela Projetos:
SynchronousSample-BC-BC, o projeto BPEL
SynchronousSample-BC-BCApplication, o projeto de aplicação composta
Clique com o botão direito do mouse em SynchronousSample-BC-BCApplication na janela Projetos e selecione Editar configuração da aplicação.
O editor CASA se abre no NetBeans IDE, exibindo a visualização Design da aplicação de amostra síncrona.
No editor CASA, selecione o ícone Construir projeto para construir a aplicação composta.
Quando a construção é concluída com êxito, a visualização Design exibe um ponto final da porta WSDL, um módulo JBI, e a conexão entre o ponto final e o módulo JBI.
Para criar uma nova porta WSDL e conectá-la a uma porta existente:
Na janela Paleta, selecione a vinculação WSDL soap e arraste-a para a área Portas WSDL.
Selecione o ponto final de consumo casaPort1 e arraste-o para o ponto final de fornecimento port1.
Clique no ícone Editar da vinculação SOAP casaPort1 e edite a propriedade location, especificando o endereço SOAP seguinte:
http://localhost:18183/service
Clique em OK e, em seguida, em Fechar.
Selecione o ícone Salvar tudo para salvar suas alterações.
Executar um caso de teste da aplicação composta
Para criar um conjunto de teste:
Na janela Projetos, expanda SynchronousSample-BC-BCApplication, clique com o botão direito do mouse em Teste e escolha Novo caso de teste.
Especifique BC-BC-Test como o nome do caso de teste e clique em Próximo.
Expanda o nó SynchronousSample-BC-BC, selecione o arquivo SynchronousSample-bc-bcApplication.wsdl, e clique em Próximo.
O arquivo WSDL da aplicação composta contém as vinculações WSDL configuradas pelo editor CASA.
Em casaBinding1, selecione operation1 e clique em Terminar.
O arquivo input.xml é exibido.
Em input.xml, substitua ?string? por Hello BC-BC e salve o arquivo.
Para implantar e testar a aplicação composta:
Na janela Projetos, clique com o botão direito do mouse no nó SynchronoussampleBC-BCApplication, e selecione Implantar.
Caso você não tenha especificado um servidor da aplicação, selecione GlassFish V2.
O servidor da aplicação deve estar sendo executado antes que a aplicação composta seja implantada. Se o iniciador da aplicação não tiver sido iniciado anteriormente, aguarde que o servidor da aplicação seja iniciado automaticamente.
Depois que o servidor da aplicação se inicia, a aplicação composta é implantada.
A janela Saída informa-lhe quando a aplicação composta foi implantada com êxito.
Na janela Serviços do NetBeans IDE, expanda o nó servidores > GlassFish V2 > JBI > Composições de serviço.
Observe que a composição de serviço SynchronousSample-BC-BCApplication foi implantada.
Talvez você tenha primeiro que clicar com o botão direito do mouse nos nós Composições de serviço e selecionar Atualizar para visualizar a Composição de serviço.
Para executar o caso de teste:
Na janela Projetos, clique com o botão direito do mouse no caso de teste BC-BC-Test e selecione Executar.
Como essa é a primeira vez que o caso de teste é executado, a saída é um caso de teste vazio. Na caixa de diálogo Sobrescrever saída vazia, selecione Sim.
No nó BC-BC-Test, clique duas vezes em Saída para abrir o arquivo Output.xml a partir do caso de teste.
No arquivo Output.xml, dentro do corpo do envelope SOAP, observe a string Hello BC-BC.
