Para criar o seu próprio projeto BPEL, você pode criar seu próprio módulo BPEL do zero ou começar criando processos de amostra.
O projeto BPEL fornece a integração NetBeans Enterprise Pack/tempo de execução, ativando o suporte a apontar e clicar para o seguinte:
Uso do assistente para Novo projeto a fim de criar um novo projeto BPEL e um projeto de aplicativo composto.
Importação de recursos WSDL para agir como serviços de parceiro no processo comercial.
Criação de novos recursos WSDL, se necessário.
Importação de recursos do esquema XML.
Adição ao diagrama do processo comercial, além da definição de elementos por meio dos editores de propriedades e ações de menu pop-up. Se necessário, adicione elementos às tarefas de serviços da Web ou realize atividades básicas.
Adição ao código-fonte dos arquivos BPEL, WSDL e XSD.
Verificação e validação de código-fonte XML.
Construção e implantação do projeto no tempo de execução BPEL no servidor de aplicativos.
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 é:
Construa o projeto do módulo BPEL. Use o BPEL Designer para criar o projeto.
Crie um projeto de aplicativo composto. Crie o projeto, caso não o tenha feito antes; para processos de amostra, projetos de aplicativo composto são criados automaticamente.
Adicione o módulo BPEL como um módulo JBI ao projeto de aplicativo composto.
(Opcional) Construa o projeto de aplicativo composto.
Verifique se o servidor de aplicativos foi iniciado.
Implante o projeto de aplicativo composto
Crie casos de teste. Para processos de amostra, os cenários de teste são criados automaticamente; para novos projetos, você precisa criar pelo menos um cenário de teste.
Execute um ou todos os casos de teste.
Implantar e testar requer que o servidor de aplicativos esteja em execução.
As etapas de construção, implantação e execução de teste são específicas da integração do tempo de execução. Desta vez, não há padrões para essas tarefas na comunidade do servidor BPEL, sendo assim, essas tarefas são necessariamente específicas de um determinado fornecedor de servidor.
Você pode usar o IDE para criar um novo projeto BPEL. Para fazê-lo:
No IDE, no menu principal, escolha Arquivo > Novo projeto e realize as seguintes etapas:
Em Categorias, selecione Service Oriented Architecture.
Em Projetos, selecione Módulo BPEL.
Clique em Próximo.
Preencha os campos Nome do projeto, Local do projeto e Pasta do projeto ou aceite os padrões.
Clique em Finalizar.
A janela Projetos agora contém um nó de 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, pasta e espaço de nome de destino. Clique em Finalizar.
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 > WSDL no menu pop-up.
Na caixa de diálogo Novo WSDL BPEL, especifique o nome do arquivo, pasta e espaço de nome de destino. Como opção, marque a caixa de seleção Importar arquivo(s) do esquema XML e procure um arquivo do esquema a ser importado. Clique em Finalizar.
Explorando o projeto BPEL na janela Projetos
Um projeto de 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 da Web do processo.
Clique duas vezes no nó newProcess.bpel. Observe o seguinte:
O editor de fontes contém uma guia para newProcess.bpel.
O diagrama newProcess.bpel é 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 Propriedades de um elemento selecionado abaixo da Paleta é aberta.
A janela Navegador mostra a exibição lógica BPEL do processo BPEL.
A janela Mapeador BPEL é exibida na parte inferior (se ela não for exibida automaticamente, escolha Janela > 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 você tem acesso a duas páginas:
Geral
(Construir) > Referências do subprojeto
A página Geral permite exibir o caminho da pasta que contém os arquivos do projeto, exibir ou modificar o prefixo do mecanismo de serviço do projeto (tal como com.sun.bpelse) e fornecer alias e descrições para a unidade de composição e para a subcomposição do aplicativo do projeto.
A página Referências do subprojeto é exibida somente para os projetos do módulo BPEL que podem conter subprojetos. Ela lhe permite exibir, adicionar, remover e reordenar os subprojetos (arquivos .jar) referenciados pelo projeto do módulo BPEL.
Um projeto BPEL não pode ser implantado diretamente. Você deve primeiro adicionar um projeto BPEL, como um módulo JBI, em um projeto de aplicativo composto. Em seguida, pode implantar o projeto de aplicativo composto. A implantação do projeto torna a composição de serviço disponível no servidor de aplicativos, permitindo, portanto, que suas unidades de serviço sejam executadas. Para obter mais informações sobre projetos de aplicativo composto, consulte a seção O tempo de execução BPEL.
Criando projetos de aplicativo composto
O assistente para Novo projeto guia você através das etapas necessárias para criar um projeto de aplicativo composto.
Para criar um novo projeto de aplicativo composto:
Escolha Arquivo > Novo projeto (Ctrl-Shift-N).
Na lista Categorias, selecione Service Oriented Architecture e na lista Projetos, selecione Aplicativo composto e clique em Próximo.
Na página Nome e local, nomeie o projeto e especifique o local dos arquivos do projeto.
Para definir o novo projeto de aplicativo composto como principal, deixe a caixa de seleção Definir como projeto principal marcada.
Clique em Finalizar. O novo projeto de aplicativo composto aparece na janela Projetos. Para implantar e realizar execução de teste no processo comercial, adicione um módulo BPEL como módulo JBI ao projeto de aplicativo composto.
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 da Web, incluindo arquivos WSDL e XSD, em um arquivo JAR. Você deve adicionar este arquivo JAR do projeto a um projeto de aplicativo composto 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 módulo BPEL e escolha Construir projeto.
Observe a mensagem CONSTRUÇÃO BEM-SUCEDIDA na janela Saída.
Você também pode realizar uma limpeza na construção, clicando com o botão direito do mouse no nó do módulo BPEL na janela Projetos e escolhendo Limpar e construir projeto.
Adicionando módulos JBI a projetos de aplicativo composto
Para adicionar um projeto do módulo JBI ao projeto de aplicativo composto:
Na janela Projetos, clique com o botão direito do mouse no nó do projeto do aplicativo composto 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 aplicativo composto > Módulos JBI. Você deve ver o arquivo JAR do projeto do módulo BPEL.
Implantando um projeto de aplicativo composto no servidor JBI
A ação Implantar compila os arquivos no projeto de aplicativo composto, empacota o BPEL compilado e os artefatos de serviço da Web (incluindo arquivos WSDL e XSD) em um arquivo, e implanta-os no servidor JBI.
Você pode implantar o projeto de aplicativo composto:
Clique com o botão direito do mouse no nó do projeto de aplicativo composto e escolha Implantar projeto.
Na caixa de diálogo Aviso, verifique se o Servidor de aplicativos Sun Java está selecionado e clique em OK.
A implantação foi bem-sucedida se aparecer a mensagem sucesso na janela Saída:
Se a janela Saída não estiver visível, escolha Janela > Saída.
Alterne para a janela Tempo de execução e expanda Servidores > Servidor de aplicativos Sun Java System > JBI, clique com o botão direito do mouse no nó Composições de serviço, e
escolha Atualizar. Você deve ver a composição de serviço implantada.
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 amostras para Novo projeto gera automaticamente ambos os tipos de projetos, módulo BPEL e aplicativo composto, de forma que você não precise criar cada um desses projetos separadamente. Entretanto, para implantar o aplicativo de amostra, você precisa adicionar manualmente o módulo BPEL como um módulo JBI ao projeto de aplicativo composto.
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 da 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 BPEL de amostra: Fluxo geral
Para criar um projeto BPEL de amostra:
Escolha Arquivo > Novo projeto (Ctrl-Shift-N).
Na lista Categorias, expanda o nó de amostras e selecione Service Oriented Architecture.
Na lista Projetos, selecione o projeto de amostra que você deseja criar e clique em Próximo.
Na página Nome e local, nomeie o projeto e especifique o local dos arquivos do projeto.
Clique em Finalizar. O assistente cria dois tipos de projetos para a amostra selecionada: um projeto do módulo BPEL e um projeto de aplicativo composto 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, adicione o projeto BPEL de amostra como um módulo JBI ao projeto de aplicativo composto.
