Adicionando serviços e combinando chamadas em uma classe

1. Pressione Alt-Insert e selecione Gerar cliente REST.
   
2. Para gerar um cliente REST, siga o mesmo procedimento da seção Mostrando seu status de usuário, mas selecione o serviço [statuses] > [update.{format}]. O IDE gera a classe interna Twitter_OAuth_update__format_JerseyClient, que é semelhante à classe Twitter_OAuth_user_timeline__format_JerseyClient.
   
3. Repita as etapas 1 e 2 acima, mas adicione um cliente ao serviço friends_timeline.{format}].
4. Altere o nome da classe original Twitter_OAuth_user_timeline__format_JerseyClient. Você transformará esta classe na classe geral do cliente que chamará os três serviços. Selecione uma instância do nome Twitter_OAuth_user_timeline__format_JerseyClient e pressione Ctrl-R ou clique com o botão direito do mouse e selecione Refatorar > Renomear. A caixa de diálogo Renomear classe se abre. Digite o novo nome TwitterClient.
   
5. Clique em Refatorar. O IDE substitui todas as instâncias do nome de classe.
   
6. Na janela Navegador, localize a classe Twitter_Oauth_friends_timeline__format_JerseyClient. Em tal classe, localize e clique duas vezes no método getFriendsTimeline.
   
7. O cursor do Editor se move para o método getFriendsTimeline. Recorte tal método (reproduzido abaixo).

   public <T> T getFriendsTimeline(Class<T> responseType, String since, String since_id, String page, String count) throws UniformInterfaceException {
         String[] queryParamNames = new String[]{"since", "since_id", "page", "count"};
         String[] queryParamValues = new String[]{since, since_id, page, count};
         return webResource.queryParams(getQueryOrFormParams(queryParamNames, queryParamValues)).accept(javax.ws.rs.core.MediaType.TEXT_XML).get(responseType);
   }

8. Cole o método getFriendsTimeline na classe interna TwitterClient, abaixo do método getUserTimeline.
9. Recorte e cole o método updateStatus do Twitter_OAuth_update__format_JerseyClient em TwitterClient, abaixo do método getFriendsTimeline.

Modificando os caminhos do recurso

Criando um TimerTask

1. Abra o TwitterJFrame na visualização Código-fonte do editor.
2. Encontre a declaração de classe e o construtor.

   public class TwitterJFrame extends javax.swing.JFrame {
   
       /** Cria novo formulário TwitterJFrame */
       public TwitterJFrame() {
           initComponents();
           try {
               initUserInfo();
           } catch (IOException ex) {
               Logger.getLogger(TwitterJFrame.class.getName()).log(Level.SEVERE, null, ex);
           }
       }

3. No corpo do método do construtor, acima de initComponents();, crie a instância da classe java.util.Timer. O parâmetro nomeia o segmentoTimer "Atualizador do Twitter" e especifica que não pode ser executado como um domínio.

   public class TwitterJFrame extends javax.swing.JFrame {
   
       /** Cria novo formulário TwitterJFrame */
       public TwitterJFrame() {
           Timer t = new Timer("Twitter Updater`", false);
           initComponents();
           try {
               initUserInfo();
           } catch (IOException ex) {
               Logger.getLogger(TwitterJFrame.class.getName()).log(Level.SEVERE, null, ex);
           }
       }
                       

4. Clique com o botão direito do mouse em qualquer lugar no editor e selecione Corrigir importações no menu de contexto ou pressione Ctrl-Shift-I. Uma caixa de diálogo é aberta e lhe oferece a opção de classes para a importação. Adicione uma declaração para java.util.Timer.
5. Abaixo da instância de Timer, crie um novo método Timer.scheduleAtFixedRate. Os parâmetros do método são um objeto TimerTask, o atraso antes que execute a tarefa por primeiro, e a frequência na qual ele executa a tarefa. Defina o método para esperar 30 segundos antes de executar pela primeira vez e executar novamente a cada 75 segundos. (O longo atraso inicial tem a finalidade de dar-lhe tempo para efetuar logon.) O código exato se encontra a seguir, em negrito. Uma linha vazia é deixada onde você coloca o código de execução. Observe que você tem de adicionar uma declaração de importação para java.util.TimerTask.

   public class TwitterJFrame extends javax.swing.JFrame {
   
       /** Cria novo formulário TwitterJFrame */
       public TwitterJFrame() {
           Timer t = new Timer("Atualizador do Twitter`", false);
           t.scheduleAtFixedRate(new TimerTask() {
   
   
           }, 30000, 75000);
           initComponents();
           try {
               initUserInfo();
           } catch (IOException ex) {
               Logger.getLogger(TwitterJFrame.class.getName()).log(Level.SEVERE, null, ex);
           }
        }

A colocação do código TimerTask agora esta completada. A seguir, você adiciona o código de execução.

Adicionando um método run com a operação getFriendsTimeline

Para exibir nomes de usuário e status, o aplicativo obtém primeiro estes dados do Twitter. O Twitter SaaS fornece a operação getFriendsTimeline para obter nomes de usuário e status. Para executar a operação getFriendscTimeline quando o aplicativo é executado, a operação precisa estar dentro de um método run. Finalmente, como o aplicativo exibe os nomes de usuário e status em uma JList, ele precisa adicionar os resultados de getFriendsTimeline como elementos de um objeto DefaultListModel.

Para adicionar um método de execução com a operação getFriendsTimeline:

1. Acima do construtor TwitterJFrame, crie um objeto DefaultListModel denominado statusListModel.

   public class TwitterJFrame extends javax.swing.JFrame {
   
       private DefaultListModel statusesListModel = new DefaultListModel();
   
   
       /** Cria novo formulário TwitterJFrame */
       public TwitterJFrame() {
                       

2. Clique com o botão direito do mouse em qualquer lugar no editor e selecione Corrigir importações no menu de contexto ou pressione Ctrl-Shift-I. Esta ação adiciona uma declaração de importação para DefaultListModel
3. No corpo do objeto TimerTask, crie um novo objeto executar. Use a anotação @Override para sobrepor o método run em main.

   public class TwitterJFrame extends javax.swing.JFrame {
   
       private DefaultListModel statuses = new DefaultListModel();
   
   
   
   
   
       /** Cria novo formulário TwitterJFrame */
       public TwitterJFrame() {
           Timer t = new Timer("Atualizador do Twitter`", false);
           t.scheduleAtFixedRate(new TimerTask() {
               @Override
               public void run(){
                
               }
           }, 1500, 75000);
           initComponents();
           try {
               initUserInfo();
           } catch (IOException ex) {
               Logger.getLogger(TwitterJFrame.class.getName()).log(Level.SEVERE, null, ex);
           }
       

4. Insira o seguinte código no corpo do método run.

   @Override
   public void run() {
       System.out.println("Timer Task está em execução");
       try {
           client.initOAuth();
           Statuses response = client.getFriendsTimeline(Statuses.class, null, null, null, "10");
           // Limpar o modelo da lista de modo que não repita o conteúdo da última execução de 
           statusesListModel.clear();
           // Criar uma objeto Status Type para cada status na lista Status e adicionar um elemento
           // ao modelo da lista para cada objeto status type 
           em (final StatusType st : response.getStatus()) {
               SwingUtilities.invokeLater(new Runnable() {
                   public void run() {
                       statusesListModel.addElement(st);
                   }
               });
           }
       } catch (UniformInterfaceException ex) {
       System.out.println("Exception when calling getFriendsTimeline = " + ex.getResponse().getEntity(String.class));
       }
   }

O código para obter o status da linha de tempo dos amigos do Twitter agora está completo. A seguir, você escreve uma nova classe que retorna um Component com elementos listados renderizados em componentes da GUI.

Criando um componente de renderização da célula da lista

Agora você tem o código que obtém os objetos Status da linha de tempo dos amigos do Twitter e que cria um elemento de lista para cada status. No entanto, você não pode exibir estes elementos de lista bruta em uma JList. É preciso passar os dados para os componentes da GUI. Para isso, crie um novo JPanel que implementa javax.swing.ListCellRenderer. Este JPanel retorna um objeto java.awt.Component com o nome de usuário e status passados no JLabels. Você pode personalizar a aparência dos JLabels no painel.

Para adicionar um componente de renderização da célula da lista:

1. Clique com o botão direito do mouse no nó do projeto e escolha Novo > Formulário JPanel. O assistente Novo formulário JPanel é aberto.
2. Nomeie o JPanel como Item e coloque-o no pacote twitterclient.
   
3. Clique em Terminar. O Item.java é aberto na visualização Desenho do editor.
4. Arraste e solte um rótulo e um painel de texto no JPanel. O rótulo exibirá o nome de usuário e o painel de texto exibirá a mensagem de status daquele usuário.
5. Posicione o rótulo e o painel de texto para que estejam de acordo com as suas preferências de exibição dos dados. Na imagem a seguir, o nome de usuário está no canto superior esquerdo e o texto do status está abaixo e um pouco indentado. O projeto de amostra tem os dados no canto superior esquerdo e o nome de usuário no canto inferior direito. Deixe espaço vazio suficiente no JPanel abaixo do painel de texto para que este possa ser expandido quando contiver texto mais longo.
   
6. Clique com o botão direito do mouse no elemento jLabel e selecione Propriedades no menu de contexto. Em Propriedades, é possível alterar a fonte, a cor, o alinhamento e outras qualidades. Defina a propriedade labelFor para apontar para jTextPane1. Isso aprimora a acessibilidade. Faça experiências com as propriedades do rótulo até estar satisfeito com a aparência. Na imagem a seguir, a cor da fonte está definida como azul na propriedade Primeiro plano.
   
7. Abra a caixa de diálogo Propriedades do JTextPane e faça experiências com sua aparência.
8. Alterne para a visualização Código-fonte para Item.java. Localize o bloco Código gerado e expanda o mesmo. Isto mostra o código gerado pelo IDE quando você seleciona as propriedades do JLabel e JTextPane.

   Na imagem a seguir, observe a configuração da cor azul para JLabel1. Você pode ver quais propriedades estão definidas para JTextPane?

   
9. Encontre a declaração de classe e adicione o código implements ListCellRenderer.

   public class Item extends javax.swing.JPanel implements ListCellRenderer {

10. Pressione Ctrl-Shift-I. Esta ação adiciona uma declaração de importação a javax.swing.ListCellRenderer. Aparece uma aviso informando ser necessário implementar todos os métodos abstratos.
11. Adicione algumas poucas linhas vazias entre o bloco do código gerado e as declarações de variáveis. Em tal espaço, adicione o seguinte código, que implementa o método abstrato getListCellRendererComponent. (Você pode copiar e colar o código ou pode tentar reproduzi-lo com o recurso autocompletar código). Este código substitui os textos do rótulo padrão "nome de usuário" e "texto" pelos objetos Texto, Usuário e Nome da tela, obtidos com a classe twitteroauth StatusType. O código retorna uma instância do componente com estes novos valores de texto JLabel.

    public Component getListCellRendererComponent(JList list, Object value, int index, boolean sel, boolean focus) {
            StatusType st = (StatusType) value;
            jTextPane1.setText(st.getText());
            jLabel1.setText("<html>" + st.getUser().getScreenName() + "</html>");
            return this;
                        }

12. Pressione Ctrl-Shift-I. Isso importa declarações para as classes StatusType e Component. Selecione a versão twitteroauth de StatusType. Salve o Item.java.

Agora você tem uma classe Item que retorna um objeto Componente com o nome de usuário e status exibidos em um JLabel e um JTextPane. A seguir, você modifica o TwitterJFrame para usar este componente.

Exibindo o componente no TwitterJFrame

Para poder exibir o objeto Componente criado no Item.java, a JList no TwitterJFrame tem de usar o Item.java como seu renderizador de célula.

1. Retorne ao TwitterJFrame. Na visualização Desenho, selecione JList. Clique com o botão direito do mouse e abra suas Propriedades.
   
2. Selecione a propriedade modelo. Pressione Ctrl-Espaço. O editor de propriedade personalizada é aberto, mostrando o texto padrão exibido na lista.
   
3. No menu suspenso "Definir a propriedade do modelo jLlist1 usando:" selecione Código personalizado. Aparece um campo de texto onde você digita as propriedades para jLabel1.setModel. Digite statusesListModel no campo e clique em OK.
   
4. Na caixa de diálogo Propriedades, selecione cellRenderer e pressione Ctrl-Espaço. O editor de propriedade personalizada é aberto.
5. No menu suspenso "Definir a propriedade cellRenderer do jList1 usando:" selecione Código personalizado. Aparece um campo de texto onde você digita as propriedades para jList1.cellRenderer. Digite new Item() e clique em OK.
   

Seu aplicativo cliente agora está completado! Salve todos os arquivos e execute o aplicativo. (Clique com o botão direito do mouse no nó do projeto e selecione Executar). O aplicativo é aberto, mostrando uma lista de mensagens de linha de tempo e um campo com seu próprio status.