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 7.1 e posterior

Requisitos

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

Software ou Recurso Versão Necessária
NetBeans IDE Versão 7.1 ou uma versão mais recente
Java Development Kit (JDK) Versão 6 ou 7

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 é fornecida com uma descrição disponível no campo Descrição da caixa de diálogo Gerenciar Inspeções ou quando uma inspeção está sendo selecionada na lista drop-down Inspeção Única mostrada na tela abaixo.

Descrição de 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.
Clique aqui para exibir em tela cheia; Ctrl+Clique para download (3.2 MB).

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:

Converter para JDK 7

A configuração Converter para JDK 7 disponível no IDE, por default incorpora tais operações de refatoração como o uso do operador diamante, tentar com conversão de recursos, uso de multicatch e trocar para aplicações String.

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 os nós JDK 1.5 e posteriores.

Para executar e aplicar a configuração default Converter 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 de Converter para JDK 7 da 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.

    Converter para a refatoração de JDK 7 sugerida

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

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 duas ocorrências propostas para a seção Importar no arquivo Imports.java, para que fique de acordo 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.
Clique aqui para exibir em tela cheia; Ctrl+Clique para download, 5.2 MB.

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.
Clique aqui para exibir em tela cheia; Ctrl+Clique para download, 1.7 MB.

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