Refatorando em um projeto do módulo BPEL usando NetBeans Enterprise Pack

Este tutorial explora a refatoração no NetBeans Enterprise Pack. O NetBeans IDE com NetBeans Enterprise Pack oferece suporte à refatoração de arquivos de origem do esquema XML, do Business Process Execution Language (BPEL) e do Web Service Description Language (WSDL). Você pode usar a refatoração para renomear e excluir seguramente componentes locais e globais. O IDE garantirá que uma ação de renomeação ou exclusão segura seja propagada na árvore do projeto. Isso significa que você não terá que alterar as referências manualmente. A refatoração reduz a complexidade de ter que fazer alterações nos arquivos do esquema XML e WSDL, além de reduzir repetições desnecessárias. Os recursos de refatoração do IDE mostram-lhe as partes afetadas do projeto e fazem todas as alterações necessárias no código. Neste tutorial, você irá rever a funcionalidade de refatoração em um projeto do módulo BPEL.

superior

Criando o projeto SynchronousSample

Para este tutorial, usaremos o projeto de amostra do processo BPEL síncrono.

1. No menu principal do IDE, escolha Arquivo > Novo projeto.
2. Na lista Categorias, expanda o nó Amostras e selecione o nó Service Oriented Architecture.
3. Na lista Projetos, selecione Processo BPEL síncrono.
4. Clique em Próximo.
5. Aceite os padrões de Nome do projeto, SynchronousSample e Local do projeto ou altere os valores de acordo com as suas preferências.
6. Clique em Finalizar.
   A janela Projetos agora contém dois nós de projeto: um nó do projeto do módulo BPEL chamado SynchronousSample e um projeto de aplicativo composto chamado SynchronousSampleApplication.

superior

Renomeando componentes do esquema XML

1. Na janela Projetos, expanda o nó do projeto SynchronousSample e o nó Arquivos do processo.
2. Clique duas vezes no nó SynchronousSample.xsd.
   O IDE abre a exibição Esquema do arquivo do esquema XML.
3. Na exibição Esquema, na primeira coluna, selecione o nó Elementos.
   O IDE mostra o elemento typeA na segunda coluna da exibição.
4. Na segunda coluna, selecione o nó typeA, clique com o botão direito do mouse e escolha Refatorar > Renomear.
   A caixa de diálogo Renomear se abre.
5. No campo Novo nome, digite typeB.
6. Verifique se a caixa de seleção Visualizar todas as alterações está marcada e clique em Próximo.
   A caixa de seleção Visualizar todas as alterações especifica que você deseja rever as alterações de refatoração antes de aplicá-las.
   A janela Refatoração de XML se abre na parte inferior do IDE.
   Observação: Antes de prosseguir para a próxima etapa, reveja as informações abaixo em Explorando a janela Refatoração de XML.
7. Na janela Refatoração de XML, clique em Fazer refatoração para executar a ação de renomeação.
   Quando a refatoração estiver concluída, typeA foi renomeado para typeB e todas as referências a esse componente do esquema foram alteradas para refletir o novo nome.

Explorando a janela Refatoração de XML

Vamos explorar a janela Refatoração de XML, já que ela é exibida depois que a ação Renomear no menu Refatorar é iniciada.

Clique para aumentar

Observe o seguinte:

• A barra de status informa-lhe que dois usos do elemento typeA foram encontrados.
• O painel de árvore da janela mostra todos os usos do elemento typeA.
  Se você selecionar um nó no painel de árvore, o IDE realçará o nó correspondente no painel gráfico.
• O painel gráfico mostra uma representação gráfica das informações no painel da árvore.
  Se você selecionar um nó no painel gráfico, o IDE realçará o nó correspondente no painel de árvore.
  Você pode expandir e recolher os nós de arquivo no painel gráfico, selecionando o nó, clicando com o botão direito do mouse e escolhendo Recolher ou Expandir no menu pop-up.
• A lista de arquivos em que o IDE encontrou os usos de typeA inclui o arquivo SynchronousSample.wsdl porque contém referências ao elemento typeA .

Navegando até as exibições do editor do esquema XML a partir da janela Refatoração de XML

Você pode usar o menu pop-up do botão direito do mouse no painel gráfico para navegar até outras exibições do editor do esquema XML.

• No painel gráfico da janela Refatoração de XML, selecione um dos nós Referências de "typeA", clique com o botão direito do mouse e escolha Ir para origem.
  O IDE abre o arquivo SynchronousSample.xsd na exibição Fonte do editor e realça a primeira linha do bloco do elemento typeA.
• No painel gráfico da janela Refatoração de XML, selecione o nó typeA, clique com o botão direito do mouse e escolha Ir para > Esquema.
  A guia do editor do arquivo SynchronousSample.xsd torna-se ativa com o nó typeA realçado na segunda coluna da exibição Esquema.

Dicas de produtividade

Use as informações abaixo para efetuar mais ou menos zoom, girar e arrastar o painel gráfico da janela Refatoração de XML.

• Para efetuar menos zoom: clique com o botão direito do mouse no gráfico e arraste para cima.
• Para efetuar mais zoom: clique com o botão direito do mouse no gráfico e arraste para baixo.
• Para girar: clique e arraste em qualquer direção.
• Para arrastar um nó: clique e arraste o nó.

Se você arrastar um nó para fora da área de exibição, poderá trazê-lo de volta usando um dos seguintes métodos:

• Gire na direção do nó até que ele esteja visível na área de exibição novamente.
• Efetue menos zoom até que o nó esteja visível na área de exibição.
• Clique no botão Atualizar na barra de ferramentas da janela Refatoração de XML.

superior

Renomeando componentes WSDL

1. Na janela Projetos, expanda o nó do projeto SynchronousSample e o nó Arquivos do processo.
2. Clique duas vezes no nó SynchronousSample.wsdl.
   Se o arquivo já estiver aberto no IDE, a guia do SynchronousSample.wsdl fica ativa no editor.
   Se o arquivo não estava aberto no IDE, o IDE abrirá a exibição WSDL do editor WSDL do arquivo WSDL.
3. Se a exibição WSDL não estiver na exibição ativa, clique no botão WSDL na barra de ferramentas do editor.
4. Na exibição WSDL, no nó Mensagens > responseMessage, selecione o nó resultType.
5. Clique com o botão direito do mouse na seleção e escolha Refatorar > Renomear.
   A caixa de diálogo Renomear se abre.
6. No campo Novo nome, digite outputType.
7. Deixe a caixa de seleção Visualizar todas as alterações marcada e clique em Próximo.
   A caixa de seleção Visualizar todas as alterações especifica que você deseja rever as alterações de refatoração antes de aplicá-las.
   A janela Refatoração de XML se abre na parte inferior do IDE.
   

   

Observe que a janela Refatoração de XML mostra os usos de resultType, neste caso, um.
A lista de arquivos que contém os usos inclui SynchronousSample.bpel, que contém referências à mensagem resultType.
Observação: Explorando a janela Refatoração de XML fornece informações adicionais sobre a janela Refatoração de XML.
8. Na janela Refatoração de XML, clique em Fazer refatoração para executar a ação de renomeação.
   Quando a refatoração estiver concluída, resultType foi renomeado para outputType e todas as referências a esse componente do esquema foram alteradas para refletir o novo nome.

superior

Excluindo componentes com segurança

Quando você usa a função Excluir da refatoração para excluir um componente com usos em vários arquivos do projeto, o IDE encontrará todos os usos desse componente no projeto e mostrará uma visualização prévia da ação de refatoração, mesmo que você opte por não visualizar as alterações. Quando você usa a função Excluir da refatoração para excluir um componente com usos em um único arquivo do projeto, você não pode excluir o componente sem visualizar a ação de refatoração.

Excluindo componentes com referências

Neste procedimento, você usará a função Excluir da refatoração para ver se o IDE força você a rever as alterações de refatoração dos componentes referenciados em outros arquivos do seu projeto.

1. Se o arquivo SynchronousSample.xsd não estiver aberto no IDE, abra-o agora.
2. Na primeira coluna da exibição Esquema, selecione o nó Elementos e na segunda coluna, clique com o botão direito do mouse no nó typeB e escolha Refatorar > Excluir com segurança.
   A caixa de diálogo Exclusão segura se abre.
3. Limpe a caixa de seleção Visualizar todas as alterações e clique em Próximo.
   Embora você tenha limpado a caixa de seleção Visualizar todas as alterações, a caixa de diálogo Exclusão segura agora está atualizada para mostrar um aviso.
4. Clique em Localizar usos.
   A janela Usos de XML mostra todos os usos de typeB, neste caso, dois usos, conforme mostrado na barra de status.
   Os dois usos estão no arquivo SynchronousSample.wsdl.
5. Clique em Executar exclusão novamente de typeB.
   A caixa de diálogo Exclusão segura se abre novamente.
6. Na caixa de diálogo Exclusão segura, clique em Cancelar.
   Observação: Neste ponto, você está cancelando a ação de exclusão porque você usará esse elemento para revisar a funcionalidade de desfazer e refazer na refatoração.

Excluindo componentes sem referências

Neste procedimento, você criará um novo componente do esquema que não possui referências e, em seguida, usará a refatoração para excluir esse componente do esquema.

1. Na primeira coluna da exibição Esquema de SynchronousSample.xsd, selecione o nó Elementos, clique com o botão direito do mouse e escolha Adicionar elemento no menu pop-up.
   A caixa de diálogo Elemento se abre.
2. Aceite os padrões na caixa de diálogo Elemento e clique em OK.
   A segunda coluna da exibição Esquema agora possui um nó de elemento chamado newElement.
3. Na segunda coluna da exibição Esquema, clique com o botão direito do mouse no nó newElement e escolha Refatorar > Excluir com segurança.
   A caixa de diálogo Exclusão segura se abre.
4. Limpe a caixa de seleção Visualizar todas as alterações e clique em Próximo.
   O IDE executa a refatoração e exclui newElement.

superior

Desfazendo e refazendo as ações de refatoração

Depois de realizar uma ação de refatoração, você pode desfazer essa ação. Se decidir que quer "desfazer" a ação de desfazer, refaça a ação.

Observação: Para refazer as ações de refatoração, você deve chamar a ação no menu Refatoração exibido no menu pop-up, não no menu Editar do IDE.

1. Para desfazer a exclusão segura do componente do esquema newElement, na segunda coluna da exibição Esquema de SynchronousSample.xsd, clique com o botão direito do mouse no nó typeB e escolha Refatorar > Desfazer [Exclusão segura].
   O IDE reverte a exclusão segura anterior que você chamou no menu Refatoração e restaura newElement.
2. Na segunda coluna da exibição Esquema de SynchronousSample.xsd, clique com o botão direito do mouse no nó typeB e escolha Refatorar > Renomear.
   A caixa de diálogo Renomear se abre.
3. No campo Novo nome, digite typeA.
4. Limpe a caixa de seleção Visualizar todas as alterações e clique em Próximo.
   O IDE renomeia o elemento typeB para typeA.
5. Para desfazer a ação Renomear da refatoração, na segunda coluna, selecione o nó typeA, clique com o botão direito do mouse e escolha Refatorar > Desfazer [Renomear].
   O IDE reverte a renomeação que você chamou no menu Refatoração e restaura o nome do elemento typeB.
6. Para verificar se a última ação Desfazer funcionou corretamente, na segunda coluna da exibição Esquema, clique com o botão direito do mouse no nó typeB e escolha Localizar usos.
   A janela Usos de XML se abre. Observe que todas as referências se referem corretamente a typeB.
   No painel de árvore da janela Usos de XML, clique duas vezes nos nós inputType e outputType para ver as referências na exibição Fonte.

superior

Resumo

Neste tutorial, você explorou a refatoração no NetBeans Enterprise Pack. Você criou um novo projeto do módulo BPEL e usou a funcionalidade de refatoração para renomear e excluir componentes com e sem referências. Você também aprendeu como desfazer e refazer ações de refatoração.

superior