Refatoração com Inspecionar e Transformar no Editor Java do NetBeans IDE

O Editor Java do NetBeans IDE 7.1 apresenta uma funcionalidade de Inspecionar e Transformar, que é a ferramenta de refatoração para executar diversas inspeções e transformações de uma só vez em todos os escopos de arquivos selecionados. Ele também permite que um usuário defina uma inspeção personalizada.

Neste tutorial, você aprenderá a executar uma revisão de código usando inspeções com refatoração e um conjunto predefinido de inspeções, gerenciar configurações e criar inspeções personalizadas.

Conteúdo

O conteúdo desta página se aplica ao NetBeans IDE 8.0

Requisitos

Para concluir este tutorial, você precisa dos seguintes recursos e softwares.

Software ou Recurso Versão Necessária
NetBeans IDE Versão 8.0
Java Development Kit (JDK) Versão 7 ou 8

Configurando o Ambiente do Tutorial

Além do software necessário acima listado, você precisa descompactar o arquivo InspectTransform.zip na sua pasta de projeto do NetBeans e abri-lo no NetBeans IDE como segue:

O projeto é aberto no IDE

Executando Inspeções

A opção Inspeção Única na caixa de diálogo Inspecionar e Transformar (Refatorar > Inspecionar e Transformar) oferece uma ampla variedade de inspeções relativas a determinadas transformações de refatoração. A lista completa de tais operações está disponível na caixa de diálogo Gerenciar Inspeções após clicar no botão Procurar à direita da Inspeção Única.

Caixa de diálogo Gerenciar Inspeções

O campo Pesquisar permite verificar se uma inspeção necessária está disponível usando uma pesquisa por palavra-chave. Por exemplo, há diversas inspeções encontradas quando operator é pesquisado.

Pesquisar por palavra-chave

Cada inspeção tem uma descrição disponível no campo Descrição, na caixa de diálogo Gerenciar Inspeção.

Para executar uma inspeção a aplicar uma inspeção existente:

  1. Na janela Projetos, selecione o arquivo InspectTransform.java.
  2. Escolha Refatorar > Inspecionar e Transformar no menu do IDE.
  3. Na caixa de diálogo Inspecionar e Transformar, selecione a opção de Inspeção Simples e clique em Procurar.
  4. Na caixa de diálogo Gerenciar Inspeções, escolha a Designação substituível por designação de operador no nó Problemas de Designação.
  5. Clique em OK para fechar a caixa de diálogo Gerenciar Inspeções.
  6. Clique em Inspecionar na caixa de diálogo Inspecionar e Transformar.
    As alterações de refatoração sugeridas são exibidas no painel de visualização.

    Execução de inspeção única

  7. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.

início

Usando Configurações

Um conjunto de refatorações agrupadas constituem a configuração que pode ser executada em seu escopo de interesse, por exemplo, uma classe ou diversas classes, pacotes ou projetos. O IDE oferece as seguintes duas configurações predefinidas:

Migrar para JDK 5

A configuração Migrar para JDK 5 disponível no IDE por padrão incorpora essas operações de refatoração como importações estáticas, uso do loop for do JDK 5, demarcação e cancelamento de demarcação desnecessários e troca da aplicação Strings.

Migrar para configuração padrão JDK 5

Observação: A lista de refatorações na configuração pode ser modificada na lista Inspeções da caixa de diálogo Gerenciar Inspeções, ao selecionar e cancelar a seleção de itens sob o nó Suporte à Migração do JDK.

Migrar para JDK 7

A configuração Migrar para JDK 7 disponível no IDE por padrão incorpora essas operações de refatoramento como uso do operador diamante, tentar com conversão de recursos, uso de multicatch, trocar para aplicações String etc.

Converter para configuração default de JDK 7

Observação: A lista de refatorações na configuração pode ser modificada na lista Inspeções da caixa de diálogo Gerenciar Inspeções, ao selecionar e cancelar a seleção de itens sob o nó Suporte à Migração do JDK.

Para executar e aplicar a configuração padrão Migrar para JDK 7:

  1. Na janela Projetos, selecione o arquivo PredefinedSet.java.
  2. Escolha Refatorar > Inspecionar e Transformar no menu do IDE.
  3. Na caixa de diálogo Inspecionar e Transformar, selecione a opção Configuração e escolha o conjunto de inspeções Migrar para JDK 7 na lista drop-down.
  4. Clique em Inspecionar.
    As alterações que convertem o código para a sintaxe do JDK 7 são exibidas no painel Visualizar.

    Migrar para a refatoração de JDK 7 sugerida

  5. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.

Migrar para JDK 8

A configuração Migrar para JDK 8 disponível no IDE por padrão incorpora essas operações de refatoramento como conversão Lambda ou Referência de Membro, importações estáticas, uso de multicatch, troca da aplicação Strings etc.

Migrar para configuração padrão JDK 8

Observação: A lista de refatorações na configuração pode ser modificada na lista Inspeções da caixa de diálogo Gerenciar Inspeções, ao selecionar e cancelar a seleção de itens sob o nó Suporte à Migração do JDK.

Organizar Importações

A configuração Organizar Importações permite inspecionar a forma como estão organizadas as instruções de importação e refatorar o código, caso desejado. Por default, ela inclui uma inspeção única que verifica se as instruções de importação correspondem as regras de estilo do código especificado.

Observação: Para configurar as regras de estilo do código para instruções de importação:

  1. Escolha Ferramentas > Opções > Editor > Formatando, na barra de ferramentas principal do IDE.
  2. Selecione Java na lista drop-down Linguagem.
  3. Selecione Importações na lista drop-down Categoria.
  4. Especifique as opções disponíveis, conforme necessário.

    Configuração default de Organizar Importações

  5. Clique em OK para salvar suas edições.

Para executar e aplicar a configuração default Organizar Importações:

  1. Na janela Projetos, selecione o arquivo Import.java.
  2. Escolha Refatorar > Inspecionar e Transformar no menu do IDE.
  3. Na caixa de diálogo Inspecionar e Transformar, selecione a opção Configuração e escolha o item Organizar Importações.
  4. Clique em Inspecionar.
    O painel de visualização exibe uma ocorrência proposta para a seção Importar do arquivo Imports.java para alinhá-la com as regras de estilo de código especificadas.

    Refatoração Organizar Importações sugerida

  5. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.

início

Gerenciando Inspeções Personalizadas

Uma inspeção personalizada pode ser criada para instruir o IDE sobre quais estruturas de código devem ser encontradas e como transformá-las.

Observação: Para evitar a adição de uma inspeção duplicada no IDE, escolha Refatorar > Inspecionar e Transformar no menu principal, clique em Gerenciar ou Procurar e, na caixa de diálogo Gerenciar Inspeções, use o campo Pesquisar para procurar pela inspeção necessária, antes de criar uma nova inspeção.

Para criar uma inspeção personalizada:

  1. Escolha Refatorar > Inspecionar e Transformar no menu do IDE.
  2. Na caixa de diálogo Inspecionar e Transformar, clique em Gerenciar ou Procurar.
  3. Na caixa de diálogo Gerenciar Inspeções, clique em Nova.
    Um nó Personalizar > Inspeção é criado na lista Inspeções.

    InspectionSample criado

  4. (Opcional) Clique com o botão direito do mouse em Inspecionar, escolha Renomear no menu pop-up, especifique o nome necessário para sua inspeção personalizada (por exemplo, MyCustomInspection) e pressione Enter.
  5. Clique em Editar Script. A área de texto Script é exibida.

    Área de texto Script

  6. Digite a descrição e o código da inspeção na área de texto Script ou clique em Abrir no Editor e especifique o mesmo no arquivo MyCustomInspection.hint.

    Arquivo MyCustomInspection.hint

  7. Clique em Salvar abaixo da área de texto Script ou pressione Ctrl-S no Editor para salvar suas edições.
  8. Clique em OK para fechar a caixa de diálogo Gerenciar Inspeções ou feche o arquivo MyCustomInspection.hint no Editor.
    Sua inspeção personalizada está feita e pronta para ser aplicada.

Para executar a inspeção personalizada que você criou:

  1. Escolha Refatorar > Inspecionar e Transformar no menu do IDE.
  2. Na lista Inspecionar da caixa de diálogo Inspecionar e Transformar, especifique um arquivo, pacote ou projetos a serem inspecionados. Alternativamente, clique no botão na direita para abrir a caixa de diálogo Escopo Personalizado, para especificar o código personalizado a ser inspecionado.
  3. Selecione a opção Inspeção Única e escolha a inspeção MyCustomInspection.

    Mycustominspection selecionado

  4. Clique em Inspecionar.
    As alterações de refatoração sugeridas são exibidas no painel de exibição.
  5. Clique em Efetuar a Refatoração para aplicar as alterações, se necessário.

início

Resumo

Este tutorial cobre os usos mais frequentes da funcionalidade Inspecionar e Transformar. Observe que com a funcionalidade Inspecionar e Transformar, você também pode executar a refatoração personalizada no escopo do projeto, ou aplicar determinadas configurações de refatoração à diversos projetos abertos no IDE, etc..

início


Consulte Também

Para ver o material relacionado, consulte os seguintes documentos:

início

get support for the NetBeans

Support


By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2013, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo