Trabalhando com o Rastreamento de Problemas no NetBeans IDE

No NetBeans IDE, você pode trabalhar com rastreadores de problema e realizar tarefas comuns tais como pesquisar e atualizar problemas e relatar novos problemas. Se o seu projeto estiver sob controle de versão, você pode atualizar os problemas como parte do processo de confirmação. Neste tutorial o IDE será usado para abrir uma amostra de projeto de um repositório com controle de versão. Após abrir o projeto, você aprenderá como exibir os problemas do projeto, relatar um novo problema, aplicar um arquivo de patch anexado a um problema e solucionar um problema quando confirma as alterações. Esse tutorial demonstrará como registrar e usar um rastreador de problemas externo no IDE.

Assista o Vídeo sobre o Uso do Rastreamento de Problemas Integrado no NetBeans IDE.

Conteúdo

O conteúdo desta página se aplica ao NetBeans IDE 6.9, 7.0 e 7.1

Para seguir este tutorial, são necessários os recursos e o software a seguir.

Software ou Recurso Versão Necessária
NetBeans IDE 6.9, 7.0, 7.1
Java Development Kit (JDK) versão 6
Projeto de amostra do Jogo de Anagramas  

Observação.Este tutorial requer o sistema de controle de versão do Subversion. Para obter mais detalhes sobre o uso do Subversion no IDE, consulte a seção sobre configuração do Subversion no Tour Guiado do Subversion.

Abrindo o Projeto de Amostra

Para fins de demonstração, este tutorial usa o projeto de amostra Jogo de Anagramas para demonstrar como trabalhar com um rastreador de problemas no IDE. Os códigos-fonte do exemplo de projeto Jogo de Anagramas existem como um projeto do NetBeans em um repositório do Subversion e há um rastreador de problema do Bugzilla para o projeto. As tarefas demonstradas neste tutorial podem ser usadas com qualquer rastreador de problemas (Bugzilla, JIRA) e sistemas de controle de versão (Subversion, Mercurial) suportados.

Caso a localização do repositório do projeto seja conhecida, será possível usar o assistente Check-out para fazer check-out dos códigos-fonte diretamente do repositório. Siga as etapas a seguir para efetuar check-out dos códigos-fonte do projeto diretamente usando o assistente Efetuar Check-out.

  1. Selecione Equipe > Subversion > Efetuar Check-out, para abrir o assistente de Check-out.
  2. Digite https://svn.kenai.com/svn/anagram-game~subversion para o URL do repositório. Clique em Próximo.
  3. No assistente, clique em Procurar para especificar pasta do repositório e selecione Jogo de Anagramas. Clique em OK.
  4. Especifique a localização da pasta local para repositório local.
  5. Clique em Finalizar.

    Quando você clica em Finalizar, o IDE inicializa a pasta local como um repositório Subversion e verifica os códigos-fonte do projeto.

  6. Clique em Abrir Projeto na caixa de diálogo exibida quando o check-out for concluído.

Após clicar em Abrir Projeto, o projeto é aberto como um projeto NetBeans na janela Projetos.

Observação. Este tutorial demonstra como trabalhar com os rastreamentos de pilha e aplicar um patch que está anexado a um problema. Para executar essas tarefas, será necessário efetuar check-out dos códigos-fonte do projeto.

Registrando um Rastreador de Problemas

O IDE permite registrar qualquer quantidade de rastreadores de problemas suportados. Após registrar o rastreador, o nome do rastreador é adicionado à lista drop-down Rastreador de Problemas nas caixas de diálogo de confirmações e forms do problema, permitindo a exibição atualização e criação de problemas a partir do IDE. É possível registrar um rastreador de problemas Bugzilla ou JIRA existente, com o IDE na janela Serviços.

Observação. Para usar um rastreador de problemas JIRA, você deve fazer download do plug-in de suporte JIRA do Centro de Atualização. Para obter mais informações, consulte a FAQ sobre NetBeans Como obtenho e instalo o plug-in JIRA no NetBeans?

Execute as etapas a seguir para registrar um rastreador de problemas do projeto Jogos de Anagramas.

  1. Clique com o botão direito do mouse no nó Rastreadores de Problemas na janela Serviços e escolha Criar Rastreador de Problemas.
  2. Selecione o Conector do rastreador de problemas.
    (O Jogo de Anagramas usa um rastreador Bugzilla).
  3. Digite Jogo de Anagramas para o rastreador de problemas.

    O nome é usado para identificar o rastreador de problemas nas janelas e caixas de diálogo do IDE.

  4. Especifique o URL do rastreador de problemas.
    (O URL do rastreador de problemas do Jogo de Anagramas é http://kenai.com/bugzilla/)
  5. Clique em Validar para testar a conexão do rastreador de problemas. Clique em OK.
Tela da caixa de diálogo Criar Rastreador de Problemas

Quando você clica em OK, o IDE adiciona um nó para o novo rastreador de problemas no nó Rastreadores de Problemas na janela Serviços.

Tela da janela Serviços registrados que mostra o rastreador de problemas registrado

Depois de adicionar o rastreador de problemas, você pode clicar com o botão direito do mouse no rastreador para realizar as seguintes tarefas.

  • Localizar problemas existentes
  • Reportar um novo problema
  • Editar os detalhes do rastreador de problemas
  • Remover o rastreador de problemas da lista

Você também pode localizar e reportar problemas selecionando a tarefa no menu Equipe.

Localizando e Exibindo Problemas

Nesta seção, você usará a janela Localizar Problemas no IDE para recuperar uma lista de problemas abertos do projeto Jogo de Anagramas. O rastreador de problemas associado com o projeto Jogo de Anagramas contém alguns exemplos de problemas. Você também pode abrir a janela Localizar Problemas selecionando a tarefa no menu Equipe.

Procurando Problemas e Salvando Consultas de Pesquisas

Neste exercício, você usará o form Localizar Problemas para procurar todos os novos problemas de prioridade P1.

  1. Escolha Equipe > Localizar Problemas no menu principal para abrir a janela Localizar Problemas.

    Como alternativa, clique com o botão direito do mouse no nó rastreador de problemas na janela Serviços e escolha Localizar Problemas.

  2. Selecione Jogo de Anagramas na lista drop-down Rastreador de Problemas.
  3. Selecione anagram-game da lista Produto.
  4. Especifique critérios de pesquisa ao selecionar Novo como Status e P1 como a Prioridade. Clique em Pesquisar.
    Tela do form Localizar Problemas

    Quando você clica em Pesquisar, o IDE pesquisa todos os problemas que correspondem ao critério e exibe uma lista de resultados na parte inferior do form.

    Tela dos resultados da pesquisa no form Localizar Problemas
  5. Clique em Salvar essa consulta na parte inferior da guia Localizar Problemas.
  6. Digite Problemas P1 novos como nome da consulta na caixa de diálogo Salvar Consulta. Clique em Salvar.

    Quando você clica em Salvar, o IDE abre a guia Consulta que exibe os resultados da consulta.

    Tela da janela de Consulta que mostra os resultados da consulta salva

Após salvar a consulta, é possível executar a consulta novamente a qualquer momento a partir da guia Localizar Problemas ao clicar no nome exibido próximo à Minhas Consultas. Clique duas vezes em um problema na lista para abri-lo em uma nova guia.

Na guia Consulta, você pode adotar o procedimento seguinte para modificar a lista de problemas.

  • Clique no cabeçalho de uma coluna para classificar a ordem na qual os problemas serão listados
  • Filtre os resultados exibidos usando a lista drop-down Filtro
  • Recupere a lista mais recente de problemas clicando em Atualizar

Clique em Modificar Consulta na guia Consulta para modificar os critérios da pesquisa salva.

Exibindo e Atualizando um Problema

Neste exercício, você exibirá e, em seguida, modificará os detalhes de um dos problemas do projeto Jogo de Anagramas.

Você pode exibir e atualizar um problema no IDE clicando duas vezes no problema na lista de resultados da pesquisa. Não é necessário ser membro de um projeto ou ter efetuado log-in para exibir o problema, mas se quiser atualizar o problema para solucioná-lo, adicionar comentários, alterar a prioridade, etc., você deve estar registrado com o rastreador de problemas do projeto e deve efetuar log-in.

Quando for adicionado como um membro do projeto Kenai, você é registrado automaticamente no rastreador de problemas do projeto e pode modificar os problemas e enviar novos problemas.

  1. Abra a lista de problemas do projeto.
  2. Clique duas vezes no problema n° 257 Erro tipográfico em StaticWordLibrary para exibir os detalhes do problema na janela principal.
  3. Faça quaisquer alterações nos detalhes do problema e adicione um comentário. Clique em Enviar Alterações.

Quando você clica em Enviar Alterações, o IDE se conecta ao rastreador de problemas para atualizar os detalhes do problema. É enviado um e-mail à pessoa que está fazendo as alterações, ao licenciado e a quaisquer endereços de copiados no problema.

Observação. Neste tutorial, você não estará apto a submeter as alterações a este problema porque você não é um membro do projeto Jogo de Anagramas.

Tela de abertura do problema na janela Problemas

Reportando um Novo Problema

Esta seção mostra como enviar um novo problema do projeto Jogo de Anagramas de dentro do IDE.

Você pode usar o form Reportar um Novo Problema do IDE para enviar um novo problema a um rastreador de problemas registrado. Você pode abrir o form escolhendo Equipe > Reportar um Problema no menu principal e, em seguida, escolhendo o rastreador de problemas na lista drop-down do form.

Observação. Para reportar um problema você deve ser registrado com o rastreador de problema e você deverá ter efetuado log-in. Se não tiver efetuado log-in, será solicitado que você efetue log-in ao enviar um problema.

Para reportar um novo problema do projeto Jogo de Anagramas, realize as etapas seguintes.

  1. Escolha Equipe > Reportar Problema no menu principal para abrir a janela Reportar um Novo Problema.
  2. Selecione o rastreador na lista drop-down Rastreador de Problemas.
  3. Selecione o projeto na lista drop-down Produto.
  4. Especifique os detalhes, o resumo e a descrição do problema. Clique em Enviar Problema.

Quando você clica em Enviar Problema, o IDE envia o problema para o rastreador.

Observação. Neste exemplo você não estará apto a submeter os problemas porque você não é um membro do projeto.

Trabalhando com Rastreamentos de Pilha

Quando a descrição de um problema contém um rastreamento de pilha que faz referência ao código-fonte de um projeto, você pode ir diretamente do problema para a linha do código-fonte local. O rastreamento de pilha copiado no problema pode ser usado da mesma forma que um rastreamento de pilha da janela Saída.

Observação. Para navegar para linhas do código-fonte de um rastreamento de pilha, os códigos-fonte do projeto devem ser submetidos a check-out e o projeto deve estar aberto no IDE.

  1. Abra o problema 1446 Não é Possível Iniciar o Jogo de Anagrama devido a NullPointerException.

    O problema 1446 do projeto Jogo de Anagramas afirma que um NullPointerException é lançado quando a aplicação é executada.

  2. Na descrição do problema, clique na linha seguinte do rastreamento de pilha.
    com.toy.anagrams.ui.Anagrams$2.windowOpened(Anagrams.java:72)

    A descrição do problema contém uma cópia do rastreamento de pilha que foi copiado da janela Saída.

    Tela do problema mostrando o rastreamento de pilha

Quando você clica na linha no rastreamento de pilha, o IDE abre o arquivo local no editor e coloca o cursor na linha indicada no código-fonte.

Observação. O IDE pode abrir o arquivo local porque você fez check-out de códigos-fonte anteriormente neste tutorial.

Você pode reproduzir a exceção iniciando a aplicação Jogo de Anagramas e, em seguida, exibindo a saída na janela Saída. Na janela Saída, você deve ver uma saída semelhante à seguinte.

Tela da janela de saída que mostra rastreamento de pilha

Abrindo e Aplicando um Arquivo de Patch

Nesta seção, você exibirá um arquivo de patch anexado e, em seguida, aplicará o patch.

O problema 1446 reporta que ocorre um NullPointerException quando a aplicação Jogo de Anagramas é executada. Um arquivo de patch, que contém a correção do NullPointerException, é anexado ao problema. Quando um arquivo de patch estiver anexado a um problema, é possível abrir e aplicar o patch diretamente a partir da janela do problema.

  1. Abra o problema 1446 Não é Possível Iniciar o Jogo de Anagrama devido a NullPointerException.
  2. Clique no nome do arquivo de patch que está anexado ao problema.
    Tela da janela de problemas mostrando o patch anexado

    Quando você clica no nome do arquivo, o IDE abre o arquivo no editor. Você pode observar que o patch faz as seguintes alterações em StaticWordLibrary.java.

    -    static WordLibrary DEFAULT;
    +    final static WordLibrary DEFAULT = new StaticWordLibrary();

    Feche o arquivo de patch.

  3. Na janela do problema, clique em aplicar ao lado do nome do arquivo de patch anexado para abrir a caixa de diálogo Aplicar Patch.
  4. Expanda o projeto Jogo de Anagramas e selecione o diretório Pacotes de Código-fonte na caixa de diálogo Aplicar Patch. Clique em Aplicar.
    Tela da caixa de diálogo Aplicar Patch

    Observação. Quando aplicar um patch, você precisa selecionar o diretório ou arquivo de acordo com a localização-raiz quando o patch foi criado. Neste caso, você precisa especificar o diretório Pacotes de Código-fonte como a localização-raiz ao aplicar o patch.

Quando você clica em Aplicar, o IDE aplica o patch e modifica StaticWordLibrary.java. Você pode abrir o arquivo no editor para exibir as alterações. Se observar a janela Projetos, poderá ver que o IDE marca o arquivo como modificado.

Integração com o Controle de Versão

Nesta seção, você atualiza um problema como parte do processo de confirmar alterações nos códigos-fonte do projeto Jogo de Anagramas.

O IDE integra suporte ao controle de versão de código-fonte (usando Subversion ou Mercurial) e os rastreadores de problemas suportados. O suporte integrado permite atualizar os problemas em um rastreador de problemas registrado como parte do processo de confirmação.

O Kenai oferece repositórios de controle de versão dedicados como um dos serviços disponíveis para projetos hospedados. Quando você abriu o projeto Jogo de Anagramas Game do Kenai e fez check-out dos códigos-fonte do projeto, o IDE associou automaticamente o projeto a um rastreador de problemas do projeto.

Para obter detalhes sobre como usar o Subversion no NetBeans IDE, consulte Tour Guiado do Subversion.

Para obter mais informações sobre o suporte Kenai para sistemas de controle de versão, consulte a documentação do Kenai em Gerenciamento de Código-fonte.

Este exercício demonstra como atualizar um problema como parte do processo de confirmação.

  1. Expanda o pacote com.toy.anagrams.lib do nó Pacotes de Código-fonte na janela Projetos.
    Tela da janela Projetos que mostra o projeto sob controle de versão

    O Jogo de Anagramas Game já está em um repositório com controle de versão. Os nomes dos arquivos de código-fonte modificados que precisam ser confirmados no repositório estão em azul. O emblema nos diretórios indica que eles contêm arquivos que precisam ser confirmados.

  2. Clique com o botão direito do mouse no arquivo StaticWordLibrary.java e escolha Subversion > Submeter para abrir a caixa de diálogo Confirmar.
  3. Informe uma Mensagem de Confirmação que descreve a confirmação.
  4. Expanda o painel Atualizar Problema na caixa de diálogo Confirmar.
    Tela da caixa de diálogo Confirmar
  5. Selecione o rastreador de problemas do projeto Jogo de Anagramas da lista drop-down (se não estiver selecionado).
  6. Digite 1446 no campo Problema.

    As alterações em StaticWordLibrary.java que você está confirmando corrigirão a exceção reportada no problema 1446.

    Você pode digitar o id do problema (1446) ou algum texto contido na descrição do problema (NullPointerException) no campo Problema. O IDE exibirá uma lista de problemas que corresponde ao texto.

  7. Marque a caixa de seleção Resolver como CORRIGIDO.

    Selecionar Resolver como CORRIGIDO altera o status do problema para Resolvido.

  8. (Opcional) Selecione Adicionar detalhes para confirmar mensagem ou problema para adicionar mais detalhes. É possível clicar em modificar para abrir uma caixa de diálogo que permite a modificação de como os detalhes adicionais são formatados.
  9. Clique em Confirmar.

Quando você clica em Confirmar, o IDE envia as alterações ao repositório e atualiza o problema. Você será solicitado a fornecer um nome de usuário e uma senha se não tiver efetuado log-in.

Observação. Neste exemplo você não estará apto a confirmar as alterações porque você não é um membro do projeto.

Este tutorial descreveu como você pode usar o IDE para trabalhar com rastreadores de problemas. O suporte integrado a rastreadores de problemas Bugzilla e JIRA permite exibir, atualizar e reportar problemas no IDE. Em projetos hospedados no Servidor de Equipe e associados a um rastreador de problemas que também está hospedado no Servidor de Equipe, é possível trabalhar com os problemas do projeto no painel Equipe.

Em outros projetos, é possível registrar os rastreadores de problemas Bugzilla ou JIRA com o IDE e, a seguir, usar os itens do menu Equipe para exibir e reportar problemas.


Consulte Também

Para obter mais informações sobre o uso do NetBeans IDE em um ambiente colaborativo, consulte os seguintes tutoriais:

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