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 irá iniciar automaticamente o AppServer 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 executador.
   

Observação: a implantação de uma aplicação no servidor da aplicação GlassFish iniciará automaticamente o servidor da aplicação GlassFish. Assim, 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 daquela 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. Da lista na página Escolher 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 guia 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 aceito 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 SynchronousSample.

Para criar o projeto SynchronousSample:

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

   

início

Criando o esquema XML

Nesta seção, você adiciona um novo arquivo do esquema XML ao projeto do módulo BPEL e, em seguida, adiciona os componentes do esquema XML ao esquema.

Para criar o SynchronousSample.xsd:

1. Na janela Projetos, expanda o nó do projeto SynchronousSample e clique com o botão direito do mouse no nó Processar arquivos e escolha Novo > Outro.
   O assistente para Novo arquivo se abre.
2. No assistente para Novo arquivo, adote o seguinte procedimento:
   
   1. Na página Escolher tipo de arquivo, na lista Categorias, selecione o nó XML e, na lista Tipos de arquivo, selecione o nó Esquema XML e clique em Próximo.
   2. No campo Nome do arquivo, digite SynchronousSample.
   3. Clique em Terminar.
   Na janela Projetos, o nó Processar arquivos agora contém um subnó rotulado SynchronousSample.xsd. O Editor de código-fonte agora contém uma aba do arquivo do esquema XML, SynchronousSample.xsd, com a visualização Esquema aberta.
3. Na visualização Esquema, clique no botão Design para abrir a visualização Design do editor do esquema XML.
   
   

   

Para adicionar um tipo complexo ao esquema XML:

1. Na Paleta da visualização Design, expanda a seção Componentes do esquema XML e selecione o ícone Tipo complexo.
   Se a janela Paleta não estiver visível, escolha Janela > Paleta no menu principal.
2. Arraste a sua seleção para a área de design do esquema, imediatamente abaixo do nó Tipos complexos.
   O IDE adiciona um nó de tipo complexo e o nome do tipo complexo (newComplexType) é selecionado e fica pronto para ser alterado.
3. Digite simpleProcess no novo nó e pressione Enter.
   A área de design agora mostra seu novo tipo complexo, chamado simpleProcess.
   
   

   

Para adicionar um componente local a simpleProcess:

1. Na seção Componentes de XML da Paleta, selecione o ícone Elemento e arraste a sua seleção para o nó simpleProcess na área de design do esquema.
   O IDE adiciona um nó de elemento chamado newElement.
2. Se a janela Propriedades não estiver visível, escolha Janela > Propriedades.
3. Na área de design do esquema, selecione o nó newElement.
4. Na janela Propriedades, selecione o campo de valor da propriedade Nome para torná-la editável e digite paramA.
5. Na janela Propriedades, na propriedade Definição, clique no botão de reticências.
   A caixa de diálogo Definição é aberta.
6. Na lista, expanda o nó Tipos incorporados e selecione o nó string.
7. Clique em OK.
   O IDE atualiza a visualização Design.
   
   

   

Para adicionar um elemento global:

1. Na seção Componentes de XML da Paleta, selecione o ícone Elemento e arraste a sua seleção para a área de design, imediatamente abaixo do nó Elementos.
   O IDE adiciona um componente newElement abaixo dos nós Elementos na área de design do esquema.
2. Na área de design do esquema da visualização do Design, selecione o nó do newElement.
3. Na janela Propriedades, selecione o campo de valor da propriedade Nome para torná-la editável e digite typeA.
4. Na janela Propriedades, na propriedade Definição, clique no botão de reticências.
   A caixa de diálogo Definição do elemento é aberta.
5. Na lista de tipos, expanda o nó Tipos complexos e selecione o nó do tipo complexo simpleProcess.
6. Clique em OK.
   Na visualização Design, o IDE agora mostra o tipo complexo simpleProcess selecionado ao lado do nó do elemento typeA.
   
   

   

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

início

Criando o documento WSDL

Nesta seção, você adiciona um arquivo WSDL ao seu projeto do módulo BPEL e, em seguida, configura os componentes do documento WSDL.

Para criar SynchronousSample.wsdl:

1. Na janela Projetos, expanda o nó do projeto SynchronousSample e clique com o botão direito do mouse no nó Processar arquivos e escolha Novo > Documento WSDL.
   O assistente para Novo documento WSDL é aberto.
2. Na página Nome e localização, adote o seguinte procedimento:
   
   1. No campo Nome do arquivo, digite SynchronousSample.
   2. Marque a caixa de verificação Importar arquivo(s) do esquema XML.
   3. No campo Esquema(s) XML, clique no botão Explorar.
      A caixa de diálogo Adicionar importação é aberta. Esta caixa de diálogo mostra os esquemas XML que podem ser importados.
   4. Expanda Por arquivo > SynchronousSample > Processar arquivos, selecione SynchronousSample.xsd.
      Certifique-se de que a caixa de verificação na coluna Importar esteja selecionada para a linha SynchronousSample.xsd.
      
      

      

   5. Clique em OK.
   6. Clique em Próximo.
   A página Configuração abstrata é aberta.
3. Na área Entrada da página Configuração abstrata, adote o seguinte procedimento:
   
   1. Na coluna Nome da parte da mensagem, clique duas vezes no valor padrão (part1) para tornar o campo editável.
   2. Digite inputType e pressione Enter.
   3. Na coluna Elemento ou Tipo, clique no botão de reticências.
      A caixa de diálogo Selecionar elemento ou tipo é aberta.
   4. Expanda Por arquivo > SynchronousSample > src/SynchronousSample.xsd > Elementos.
      Observação: talvez você tenha que rolar até a parte superior da lista na caixa de diálogo Selecionar elemento ou tipo para ver o nó Por arquivo.
   5. No nó Elementos, selecione o nó typeA e clique em OK.
4. Na área Saída da página Configuração abstrata, adote o seguinte procedimento:
   
   1. Na coluna Nome da parte da mensagem, clique duas vezes no valor padrão (part1) para tornar o campo editável.
   2. Digite resultType e pressione Enter.
   3. Na coluna Elemento ou Tipo, clique no botão de reticências.
      A caixa de diálogo Selecionar elemento ou tipo é aberta.
   4. Expanda Por arquivo > SynchronousSample > src/SynchronousSample.xsd > Elementos.
      Observação: talvez você tenha que rolar até a parte superior da lista na caixa de diálogo Selecionar elemento ou tipo para ver o nó Por arquivo.
   5. No nó Elementos, selecione typeA e clique em OK.
   A página Configuração abstrata concluída deve ser parecida com a mostrada abaixo.
   
   

   

5. Clique em Próximo.
   A página Configuração concreta é aberta.
6. Em Subtipo de vinculação, selecione o botão de opção Literal de documento.
7. Clique em Terminar.
   Na janela Projetos, o nó Processar arquivos agora contém um subnó rotulado SynchronousSample.wsdl.
   O Editor de código-fonte agora contém uma aba do arquivo do esquema XML, SynchronousSample.wsdl, com a visualização WSDL aberta.
   
   

   

início

Criando o processo BPEL

Nesta seção, crie um arquivo .bpel para o processo BPEL. Em seguida, adicione um link de parceiro e três atividades para o processo.

Para criar SynchronousSample.bpel:

1. Na janela Projetos, 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 SynchronousSample.
3. Clique em Terminar.
   Na janela Projetos, o nó Processar arquivos agora contém um subnó rotulado SynchronousSample.bpel.
   O Editor de código-fonte contém uma aba do processo BPEL, SynchronousSample.bpel, com a visualização Design do BPEL Designer aberta.
   
   

   

Para adicionar um link de parceiro:

1. Certifique-se de que a visualização Design do SynchronousSample.bpel seja a janela ativa do Editor de código-fonte.
2. Na janela Projetos, expanda o nó do projeto SynchronousSample, expanda o nó Arquivos do processo e selecione o nó SynchronousSample.wsdl.
3. Arraste a sua seleção (SynchronousSample.wsdl) da janela Projetos para a visualização Design.
   A caixa de diálogo Criar novo link de parceiro é aberta.
4. Aceite os padrões e clique em OK.
   O IDE adiciona uma caixa para o link de parceiro na área de design.
   
   

   

Para adicionar uma atividade Receber:

1. Certifique-se de que a visualização Design do SynchronousSample.bpel seja a janela ativa do Editor de código-fonte.
2. Na seção Serviço Web da Paleta, selecione o ícone Receber.
3. Arraste a sua seleção para a caixa do processo de SynchronousSample 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.
4. Clique duas vezes na atividade Receber1.
   O Editor de propriedades de Receber1 [Receber] é aberto.
5. Na aba Principal, altere o valor no campo Nome para início.
6. Na lista suspensa Link de parceiro, selecione PartnerLink1.
   O IDE preenche o campo Operação com SynchronousSampleOperation.
7. 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.
8. Clique em OK para fechar o Editor de propriedades de Receber1 [Receber].
   A visualização Design agora mostra uma conexão entre PartnerLink1 e a atividade início na caixa do processo do SynchronousSample.
   
   

   

Para adicionar uma atividade Responder:

1. Certifique-se de que a visualização Design do SynchronousSample.bpel seja a janela ativa do Editor de código-fonte.
2. Na seção Serviço Web da Paleta, selecione o ícone Responder.
3. Arraste a sua seleção para a área de design entre a atividade início 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.
4. Clique duas vezes na atividade Responder1.
   O Editor de propriedades de Responder1 [Responder] é aberto.
5. Na aba Principal, altere o valor no campo Nome para fim.
6. Na lista suspensa Link de parceiro, selecione PartnerLink1.
   O IDE preenche o campo Operação com SynchronousSampleOperation.
7. 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.
8. Clique em OK para fechar o Editor de propriedades de Responder1 [Responder].
   A visualização Design agora mostra uma conexão entre a atividade fim na caixa do processo do SynchronousSample e PartnerLink1.
   
   

   

Para adicionar uma atividade Atribuir:

1. Certifique-se de que a visualização Design do SynchronousSample.bpel seja a janela ativa do Editor de código-fonte.
2. Na seção Atividades básicas da Paleta, selecione o ícone Atribuir.
3. Arraste a seleção para a área de design entre as atividades início e fim.
   Esta ação coloca uma atividade Atribuir chamada Atribuir1 na visualização Design.
4. Selecione a nova atividade Atribuir1.
5. Se a janela Mapeador BPEL não estiver visível, escolha Janela > Mapeador BPEL no menu principal.
6. No painel da árvore de origem (o painel à esquerda) do Mapeador BPEL, em Variáveis, expanda inputVar > inputType.
   Um nó paramA aparece no nó inputVar.
7. No painel da árvore de destino (o painel à direita) do Mapeador BPEL, em Variáveis, expanda outputVar > resultType.
   Um nó paramA aparece no nó resultType.
8. No painel da árvore de origem, selecione o nó paramA e arraste a sua seleção para o nó paramA no painel de destino.
   Esta atribuição copia a declaração de entrada para a saída.
   
   

   

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

início

Criando e implantando a 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 de aplicação composta e o módulo JBI:

1. No menu principal, escolha Arquivo > Novo arquivo.
   O assistente para novo projeto é aberto.
2. Na lista Categorias, selecione o nó SOA e, na lista Projetos, selecione o nó Aplicação composta.
3. Clique em Próximo.
4. No campo Nome do projeto, digite SynchronousSampleApplication.
5. Clique em Terminar.
   A janela Projetos agora contém um nó do projeto de aplicação composta chamado SynchronousSampleApplication.
6. Na janela Projetos, clique com o botão direito do mouse no nó do projeto SynchronousSampleApplication e escolha Adicionar módulo JBI no menu pop-up.
   A caixa de diálogo Selecionar projeto é aberta.
7. Selecione o projeto SynchronousSample que você criou anteriormente neste tutorial e clique em Adicionar arquivos JAR do projeto.
   A caixa de diálogo Selecionar projeto se fecha.
8. Na janela Projetos, expanda o nó SynchronousSampleApplication e expanda o nó Módulos JBI.
   Observe que um nó SynchronousSample.jar foi adicionado.
   
   

   

Para implantar a aplicação composta:

• Clique com o botão direito do mouse no nó do projeto SynchronousSampleApplication e escolha Implantar projeto.
  Se uma mensagem semelhante à mensagem seguinte for exibida na janela Saída, então o deployment foi bem sucedido:
  CONSTRUÇÃO BEM SUCEDIDA (tempo total: 11 segundos)

início

Testando a aplicação composta

Você pode aprimorar o projeto da aplicação composta, adicionando casos de teste, vinculando à operação, fornecendo saída e usando o testador.

Para testar a aplicação composta SynchronousSampleApplication:

1. Na janela Projetos, expanda o nó do projeto SynchronousSampleApplication, 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. Aceite o nome do caso de teste padrão, TestCase1 e clique em Próximo.
3. Na página Selecionar o documento WSDL, expanda o nó SynchronousSample , selecione SynchronousSample.wsdl e clique em Próximo.
4. Na página Selecionar a operação a ser testada, selecione SynchronousSampleOperation e clique em Terminar.
   Observe o seguinte:
   
   • Na janela Projetos, em Teste, um novo nó TestCase1 foi adicionado.
   • O nó TestCase1 contém dois subnós: Entrada e Saída.
   • O Editor de código-fonte contém uma aba do arquivo de entrada, Input.xml.

   

   Observação: se o Editor de código-fonte não contiver uma aba para Input.xml, clique duas vezes no nó Entrada na janela Projetos para abrir o arquivo.
5. Na aba do Editor de código-fonte do arquivo Input.xml, adote o seguinte procedimento:
   
   1. Localize a seguinte linha:
      <syn:paramA>?string?<syn:paramA>.
   2. Substitua ?string? por Hello World.
      A linha deve ficar da seguinte forma:
      <syn:paramA>Hello World<syn:paramA>.
   3. No menu principal do , escolha Arquivo > Salvar todos.
6. Na janela Projetos, clique duas vezes no nó Saída em Teste > TestCase1 para examinar seu conteúdo.
   Inicialmente, o arquivo output.xml está vazio. Portanto, a primeira execução do teste preencherá output.xml com a saída real. As execuções de teste subseqüentes compararão a saída real com o conteúdo de output.xml.
7. Na janela Projetos, clique com o botão direito do mouse no nó TestCase1 e escolha Executar projeto no menu pop-up.
   Observação: a primeira execução é um caso especial porque Output.xml está vazio e a saída é gravada em Saída.
   Observe a mensagem de falha na janela Saída.
   A caixa de diálogo Sobrescrever saída vazia? é aberta.
8. Clique em Sim.
9. Na janela Projetos, clique com o botão direito do mouse no nó TestCase1 e escolha Executar projeto no menu pop-up.
   Após a primeira execução, Output não está mais vazio. O conteúdo do arquivo é preservado e não é sobrescrito pelo novo resultado.
   
   

   

início

Resumo

Neste tutorial, você criou um projeto do módulo BPEL simples chamado SynchronousSample e um projeto de Aplicação composta chamado SynchronousSampleApplication. Em seguida, criou um arquivo de esquema XML e um arquivo WSDL. Você aprendeu como criar e implantar um processo BPEL. Aprendeu também como criar e realizar a execução de teste de uma aplicação composta.

Após concluir as etapas neste tutorial, você construiu o projeto do Processo BPEL síncrono de exemplo que está disponível no IDE (Novo > Projeto > Exemplos > SOA > Processo BPEL síncrono).