O projeto do módulo BPEL é um grupo de arquivos de origem que inclui arquivos BPEL, arquivos de interface do serviço Web (.wsdl) e arquivos do esquema XML (.). Em um projeto do módulo BPEL, você pode criar um processo comercial compatível com a especificação da linguagem WS-BPEL 2.0.
O projeto do módulo BPEL oferece suporte a apontar e clicar para o seguinte:
Uso do assistente para Novo projeto a fim de criar um novo projeto do módulo BPEL e um projeto de aplicação composta.
Importação de recursos WSDL para agir como serviços de parceiro no processo comercial.
Criando novos recursos WSDL, se necessário.
Importando recursos do esquema XML.
Adicionando atividades BPEL ao diagrama do processo comercial; definindo detalhadamente os elementos por meio das caixas de diálogo Editor de propriedades, janela Propriedades e ações de menu pop-up.
Adição ao código-fonte dos arquivos BPEL, WSDL e XSD.
Verificação e validação de código-fonte XML.
Construindo e adicionando o projeto como um módulo JBI a um projeto de aplicação composta.
Execução de teste dos processos BPEL por meio do envio de mensagens de amostra para o processo ou processos implantados.
Depuração de processos comerciais implantados
O procedimento típico a ser seguido ao construir um processo BPEL é:
Crie um projeto de aplicação composta.
Para processos de amostra, os projetos de aplicação composta são criados automaticamente para você.
Para os processos criados do zero, você deve criar manualmente o projeto de aplicação composta.
Implante o projeto de aplicação composta
no mecanismo de serviço BPEL.
Crie casos de teste.
Para processos de amostra, os casos de teste são criados automaticamente; para novos projetos, você precisa criar pelo menos um caso de teste.
No IDE, escolha Arquivo > Novo projeto no menu principal e, em seguida, realize estas etapas:
Em Categorias, selecione SOA.
Em Projetos, selecione Módulo BPEL e clique em Próximo.
Na página Nome e localização, indique o nome do projeto e especifique a localização do projeto, ou aceite os padrões.
Clique em Terminar.
A janela Projetos agora contém um nó de projeto do projeto do módulo BPEL.
Para criar um arquivo BPEL para o seu projeto, clique com o botão direito do mouse no nó Arquivos do processo e escolha Novo > Processo BPEL no menu pop-up.
Na caixa de diálogo Novo processo BPEL, especifique o nome do arquivo e a pasta. Clique em Terminar.
Para criar um arquivo WSDL para o seu projeto, clique com o botão direito do mouse no nó Arquivos do processo e escolha Novo > Documento WSDL no menu pop-up.
Na caixa de diálogo Novo documento WSDL, especifique o nome do arquivo e a pasta. Como opção, marque a caixa de verificação Importar arquivo(s) do esquema XML e procure um arquivo do esquema a ser importado. Clique em Terminar.
Explorando o projeto do módulo BPEL na janela Projetos
Um projeto do módulo BPEL típico contém um arquivo de origem BPEL, além de arquivos WSDL e XSD.
Observe os artefatos que você criou:
Na janela Projetos, expanda o nó BPELModule1 e o nó Arquivos do processo.
O nó Arquivos do processo contém estes itens:
newProcess.bpel, o processo BPEL
newWSDL.wsdl, a interface do serviço Web do processo.
Clique duas vezes no nó newProcess.bpel.
Observe o seguinte:
O diagrama newProcess.bpel é mostrado na visualização Design.
A visualização Design é a área em que você pode modelar visualmente os processos comerciais. O BPEL Designer gera automaticamente o código BPEL que corresponde ao design visual.
A visualização Código-fonte de newProcess.bpel pode ser chamada ao clicar no botão Código-fonte.
A Paleta de elementos BPEL se abre na visualização Design à direita da área de design.
A janela Propriedades de um elemento selecionado abaixo da Paleta é aberta.
A janela Navegador mostra a visualização lógica BPEL do processo BPEL.
A janela Mapeador BPEL é exibida na parte inferior (se ela não for exibida automaticamente, escolha Janela > Outro > Mapeador BPEL, no menu principal).
Clicar duas vezes no nó newWSDL.wsdl abre o Editor WSDL, no qual você pode exibir e modificar seu arquivo newWSDL.wsdl.
Propriedades de um projeto do módulo BPEL
Para abrir a caixa de diálogo Propriedades de um projeto do módulo BPEL, clique com o botão direito do mouse no nó do projeto do módulo BPEL e escolha Propriedades. A árvore no painel esquerdo mostra que é possível acessar três páginas:
Geral
Referências do projeto
Catálogo XML
A página Geral permite que você visualize o caminho para a pasta que contém os arquivos do projeto e visualize ou modifique o prefixo do mecanismo de serviço do projeto (tal como com.sun.bpelse).
A página Referências do projeto exibe outros projetos do módulo BPEL que são referenciados por seu projeto do módulo BPEL. Nessa página, você pode adicionar e remover projetos referenciados pelo projeto do módulo BPEL.
A página Catálogo XML exibe as entradas do catálogo XML usadas no projeto do módulo BPEL. Os catálogos XML oferecem informações de mapeamento que mapeiam uma entidade externa em um documento XML para um local real do documento ao qual se faz a referência. Nessa página, você pode remover as entradas do catálogo XML da lista de catálogos XML do seu projeto do módulo BPEL.
Um projeto do módulo BPEL não pode ser implantado diretamente. Você deve primeiro adicionar um projeto do módulo BPEL, como um módulo JBI, a um projeto de aplicação composta. Em seguida, pode implantar o projeto de aplicação composta. 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.
Criando projetos de aplicação composta
O assistente para Novo projeto guia você através das etapas necessárias para criar um projeto de aplicação composta.
Para criar um novo projeto de aplicação composta:
Escolha Arquivo > Novo projeto (Ctrl-Shift-N).
Na lista Categorias, selecione SOA e na lista Projetos, selecione Aplicação composta e clique em Próximo.
Na página Nome e localização, nomeie o projeto e especifique o local dos arquivos do projeto.
Para definir o novo projeto de aplicação composta como principal, deixe a caixa de verificação Definir como projeto principal marcada.
Clique em Terminar.
O novo projeto de aplicação composta aparece na janela Projetos. Para implantar e realizar execuções de teste do seu processo comercial, adicione o módulo BPEL como um módulo JBI ao projeto de aplicação composta.
Construindo um projeto do módulo BPEL
Quando um projeto é construído, o IDE compila o arquivo de origem BPEL e empacota o arquivo BPEL e os artefatos de serviço Web, incluindo arquivos WSDL e XSD, em um arquivo JAR. Você deve adicionar este arquivo JAR do projeto a um projeto de aplicação composta e, em seguida, implantá-lo no servidor JBI.
Siga este procedimento para construir um projeto do módulo BPEL:
Na janela Projetos, clique com o botão direito do mouse no nó do projeto do módulo BPEL e escolha Construir projeto.
Você também pode realizar uma limpeza na construção, clicando com o botão direito do mouse no nó do projeto do módulo BPEL na janela Projetos e escolhendo Limpar e construir projeto.
Observe a mensagem CONSTRUÇÃO BEM SUCEDIDA na janela Saída.
Adicionando módulos JBI a projetos de aplicação composta
Para adicionar um módulo JBI ao projeto de aplicação composta:
Na janela Projetos, clique com o botão direito do mouse no nó do projeto da aplicação composta e escolha Adicionar módulo JBI.
Na caixa de diálogo Selecionar projeto, selecione a pasta do projeto do módulo BPEL, verifique se o arquivo JAR do projeto apareceu na lista de arquivos JAR do projeto, e clique em Adicionar arquivos JAR do projeto.
Para verificar se o módulo BPEL foi adicionado como um módulo JBI, na janela Projetos, expanda Projeto de aplicação composta > Módulos JBI. Você deve ver o arquivo JAR do projeto do módulo BPEL.
A ação Implantar compila os arquivos no projeto de aplicação composta, empacota a BPEL compilada e os artefatos de serviço Web relacionados (incluindo arquivos WSDL e XSD) em um arquivo, e implanta-os no servidor da aplicação.
Para implantar um projeto de aplicação composta:
Clique com o botão direito do mouse no nó do projeto de aplicação composta e escolha Implantar projeto.
Na caixa de diálogo Aviso, verifique se o GlassFish V2 está selecionado e clique em OK.
O deployment foi bem-sucedido se aparecer a mensagem Construção bem-sucedida na janela Saída.
Se a janela de saída não estiver visível, escolha Janela > Saída > Saída.
Abra a janela Serviços e expanda Servidores > GlassFish V2> JBI > Composições de serviço para ver a composição de serviço implantada.
Se você não vir o projeto implantado, clique com o botão direito do mouse no nó Composições de serviço e escolha Atualizar.
A melhor forma de se familiarizar com a construção de diagramas BPEL é criar processos de amostra. Você pode criar seu processo BPEL modificando processos de amostra existentes.
Para obter amostras, o assistente de amostra para Novo projeto gera automaticamente ambos os tipos de projetos, módulo BPEL e aplicação composta, de forma que você não precise criar cada um desses projetos separadamente. O IDE adiciona automaticamente o projeto do módulo BPEL de amostra como um módulo JBI ao projeto de aplicação composta.
No BPEL Designer, você pode criar os seguintes processos de amostra:
Um processo síncrono se refere a um estilo de conversação no qual o cliente envia uma mensagem para o processo, espera por uma resposta, e continua a funcionar somente quando a resposta retorna. Quando você cria um processo de amostra síncrono, o IDE gera um processo de esqueleto com uma única operação síncrona e os arquivos WSDL e do esquema XML necessários.
Um processo de amostra assíncrono
Um processo assíncrono aplica-se a conversações de longa duração nas quais o cliente não espera por uma resposta do processo antes de continuar seu trabalho. Em vez de retornar o resultado de forma síncrona para o cliente, esse processo aceita a solicitação do cliente, realiza um trabalho que pode ser de longa duração e, em seguida, chama o cliente de forma assíncrona quando o trabalho é concluído. Quando você cria um processo assíncrono, o IDE gera um processo de esqueleto com uma operação assíncrona de entrada e uma de saída, e os arquivos WSDL e do esquema XML necessários.
Observe que qualquer processo específico pode consistir em um conjunto arbitrário de interações síncronas e assíncronas com um ou mais parceiros interativos.
Amostra de serviço de reserva de viagens
Esta amostra é um processo BPEL do mundo real construído com a maioria dos elementos BPEL e vários serviços Web de parceiro.
Junto com a amostra Serviço de reserva de viagens, o assistente cria outro projeto, Serviços de parceiro de reserva, uma implementação básica baseada em EJB e JMS dos três serviços de parceiro.
Criando um projeto do módulo BPEL amostra: Fluxo geral
Para criar um projeto do módulo BPEL de amostra:
Escolha Arquivo > Novo projeto (Ctrl-Shift-N).
Na lista Categorias, expanda o nó Amostras e selecione SOA.
Na lista Projetos, selecione o projeto de amostra que você deseja criar e clique em Próximo.
Na página Nome e localização, nomeie o projeto e especifique o local dos arquivos do projeto.
Clique em Terminar.
O assistente cria dois tipos de projetos para a amostra selecionada: um projeto do módulo BPEL de amostra em um projeto de aplicação composta de amostra. Você é livre para modificar o processo comercial de amostra e/ou adicionar processos BPEL ao módulo BPEL. Para implantar, fazer execução de teste e depurar o processo BPEL, use o projeto de aplicação composta.
