Tutorial de início rápido do módulo do NetBeans

Instalando a amostra

Para ver o resultado final deste tutorial, instale o módulo de amostra e teste a barra de ferramentas do Google no IDE:

1. Baixe e descompacte o arquivo anexado.
2. No IDE, escolha Arquivo > Abrir projeto (Ctrl+Shift+O) e navegue para a localização do arquivo descompactado. Selecione o projeto do módulo e clique em Abrir pasta do projeto. O projeto de módulo se abre no IDE e você deve ver o seguinte na janela Projetos (expanda os nós, se necessário):
   
   
3. Clique com o botão direito do mouse no nó do projeto e escolha Instalar/Recarregar na plataforma de destino. Por padrão, a plataforma de destino é o IDE no qual está sendo desenvolvido o projeto de módulo. A plataforma de destino se abre e o módulo é instalado.
4. Verifique se o módulo está corretamente instalado, testando sua funcionalidade, como descrito abaixo em Usando o módulo.

Agora que você sabe qual será o resultado final, crie o módulo do zero e aprenda sobre cada parte enquanto a está criando.

Criando a ação

1. Clique com o botão direito do mouse no nó do projeto e escolha Nova > Ação (se Ação não estiver exibida, acesse-a escolhendo Outra, em seguida, no assistente para Novo arquivo em Categorias, selecione Desenvolvimento de módulo do NetBeans). Clique em Próximo.
2. No painel Tipo de ação, mantenha a configuração padrão, que permitirá que o IDE crie uma ação que subclassifique CallableSystemAction, como mostrado abaixo:
   
   
   
   Clique em Próximo.
3. No painel Registro com GUI, selecione Editar na lista suspensa Categoria. A lista suspensa Categoria controla onde uma ação é mostrada no editor de atalhos de teclado no IDE. Em seguida, desmarque Item de menu global e selecione Botão da barra de ferramentas global. Na lista suspensa Barra de ferramentas, selecione Editar, em seguida, na lista suspensa Posição, selecione Localizar... - AQUI, como mostrado abaixo:
   
   
   
   Clique em Próximo.
4. No painel Novo e localização, digite GoogleAction como o Nome da classe e Google Action como o Nome de exibição. Vá para um ícone que tenha uma dimensão de 16x16 pixels. Na verdade, você não verá o ícone - em vez disso, exibirá o formulário JPanel que criará na próxima seção. Entretanto, o assistente para Nova ação requer que você especifique um ícone. Portanto, o ícone poderia ser de qualquer dimensão, já que você não o usará. Clique em Terminar. Observe que GoogleAction.java é adicionado ao pacote org.myorg.googletoolbar na janela Projetos.

Criando o JPanel

1. Clique com o botão direito do mouse no nó do projeto e escolha Novo > Outro. Em Categorias, selecione Formulários GUI Java. Em Projetos, selecione Formulário JPanel. Clique em Próximo.
2. No painel Nome e localização, digite GooglePanel como o Nome da classe e selecione o painel na lista suspensa. Clique em Terminar. GooglePanel.java é adicionado ao pacote e é aberto na visualização Design no Editor de código-fonte.
3. Coloque o cursor no canto inferior direito do JPanel, em seguida, selecione o JPanel e arraste o cursor para redimensioná-lo, de forma que sua largura e cumprimento fiquem parecidos com os de uma barra de ferramentas, como mostrado abaixo:
   
   
4. Arraste um item JTextField e um item JLabel da Paleta (Ctrl+Shift+8) diretamente para o JPanel, em seguida, redimensione o JPanel e os outros dois itens, para que eles se encaixem. Finalmente, clique no JLabel e altere seu texto para Google:, em seguida, exclua o texto padrão no JTextField. Seu JPanel agora deve se parecer com a imagem mostrada abaixo:
   
   
5. Verifique se o Inspetor de propriedades está aberto (Janela > Navegação > Inspetor), em seguida, clique com o botão direito do mouse em JTextField e escolha Eventos > Tecla > keyTyped. Isso gera um método jTextField1KeyTyped() no código-fonte GooglePanel.java, que é exibido no Editor de código-fonte, como mostrado abaixo:
   
   
6. No Editor de código-fonte, na visualização Código-fonte do GooglePanel.java, preencha o método jTextField1KeyTyped(), da seguinte forma (texto inserido mostrado em negrito):

       
   private void jTextField1KeyTyped(java.awt.event.KeyEvent evt) {
       int i = evt.getKeyChar();
       if (i==10){//The ENTER KEY
           // exibimos a url do googlel.
           try{
               URLDisplayer.getDefault().showURL
                       (new URL("http://www.google.com/search?hl=en&q="+jTextField1.getText()+"&btnG=Google+Search"));
           } catch (Exception eee){
               return;//nothing much to do
           }
       }
   }

Se precisar, clique com o botão direito do mouse no Editor de código-fonte e escolha Formatar (Alt+Shift+F).

Resolvendo erros

Observe que várias linhas de código são sublinhadas em vermelho, indicando erros. Isso acontece porque pacotes necessários ainda não foram importados. Coloque o cursor sobre o ícone da lâmpada exibido na coluna imediatamente à esquerda da linha vermelha de URLDisplayer. É exibida uma dica de ferramenta, indicando o motivo do erro:

Para resolver isso, você precisa disponibilizar a classe HtmlBrowser.URLDisplayer, incluída no pacote org.openide.awt, para o seu projeto. Para isso, execute as seguintes etapas:

1. Clique com o botão direito do mouse no nó do projeto na janela Projetos e escolha Propriedades. Na caixa de diálogo Propriedades do projeto, selecione Bibliotecas sob o título Categorias. Em seguida, em Dependências de módulo, clique no botão Adicionar. A caixa de diálogo Adicionar dependência de módulo é exibida.
2. Na caixa de texto do filtro exibida na parte inferior da caixa de diálogo Adicionar dependência de módulo, comece a digitar URLDisplayer e observe que a seleção dos módulos retornados se estreita até que somente a listagem restante seja a API de utilitários de IU:
   
   
   
   Clique em OK, em seguida, clique em OK novamente para sair da caixa de diálogo Propriedades do projeto.
3. Clique com o botão direito do mouse no Editor de código-fonte e escolha Corrigir importações (Alt+Shift+F). A caixa de diálogo Corrigir todas as importações é exibida, listando os caminhos sugeridos para classes não reconhecidas:
   
   
   
   Clique em OK. O IDE cria as instruções de importação seguintes para GooglePanel.java:

   import java.net.URL;
   import org.openide.awt.HtmlBrowser.URLDisplayer;               
               

   Observe também que todos os erros desaparecem do Editor de código-fonte.

Substituindo getToolbarPresenter()

Como o JPanel que você criou é o componente real que exibirá a barra de ferramentas do Google, é preciso substituir o método getToolbarPresenter() na classe da ação. Em GoogleAction.java, faça o seguinte:

1. Abaixo da declaração da classe, declare e defina a variável seguinte:

   GooglePanel retValue = new GooglePanel();
               

2. Defina o método getToolbarPresenter() para retornar a variável retValue:

   public java.awt.Component getToolbarPresenter() {
       return retValue;
   }