Java Orientado a Objetos: Como criar uma Agenda em Java

A ideia inicial para a criaç�o desse projeto da Agenda � que ela possua alguns aspectos e funcionalidades na qual contenha classes que possam ser desmembradas em diversas atribuiç�es, como por exemplo, na criaç�o de contatos b�sicos, contatos comerciais, telefone e contatos de email.

Descriç�o das Classes a serem Utilizadas

Na Figura 1 temos especificado todas as classes do projeto.

Figura 1. Diagrama de classe representando todas as classes que existir�o no projeto, exceto a principal.

Fique por dentro de tudo que acontece sobre Java na DevMedia e tamb�m confira o Checklist Programador Java.

A classe Agenda � respons�vel por possuir campos e m�todos cuja finalidade � buscar os registros e tamb�m fazer a inserç�o.

A classe ContatoBasico cont�m campos prim�rios a serem herdados e m�todos de envio e recebimento de dados.

A classe Contato cont�m campos para um poss�vel controle residencial ou pessoal do usu�rio, que por sua vez herda as funcionalidades da classe ContatoBasico e cont�m o m�todo para obter os dados e a idade.

A classe ContatoComercial cont�m campos que se destinam para um controle comercial, esta herda as funcionalidades da classe ContatoBasico e cont�m o m�todo para obter os dados.

A classe Econtato � destinada para o controle mais aprofundado contendo campos de vinculaç�es para o contato como email, por exemplo, tamb�m essa classe herda as funcionalidades s� que da classe Contato e cont�m os m�todos de obtenç�o de dados.

Por fim, temos a classe Telefone que cont�m campos que discriminam o contato telef�nico do usu�rio e cont�m o m�todo para obtenç�o dos dados. Essa classe ser� enunciada apenas na classe Principal (Main) e na classe ContatoBasico.

Iniciando o Projeto

Inicialmente, ser� criada uma nova aplicaç�o Java, isso ap�s ter aberto o ambiente de desenvolvimento Netbeans. No menu principal, v� em Arquivo e selecione a opç�o Java -> Aplicaç�o Java, como mostra a Figura 2.

Figura 2. Tela para criaç�o de um Novo Projeto Java.

Ap�s isso, � s� clicar no bot�o: Pr�ximo. Ent�o aparecer� a seguinte tela, como mostra a Figura 3.

Figura 3. Tela de configuraç�o para o Nome do Projeto, Localizaç�o do Projeto e criaç�o da classe Principal.

Nota: Nesse caso, foi necess�rio mudar o nome da Classe Principal para Main.

Ap�s ter clicado no bot�o Finalizar, aparecer� a classe principal Main e com isso j� � poss�vel criar as classes adicionais para dentro do projeto. As classes ficar�o todas na mesma raiz e ter�o os seguintes nomes: Agenda.java, Contato.java, ContatoBasico.java, ContatoComercial.java, EContato.java e Telefone.java, que podem ser visualizadas de acordo com a Figura 4.

Figura 4. Layout das classes criadas e tamb�m da classe principal.

Implementando o Projeto

Primeiramente, ao começar o projeto ser� implementada a classe Telefone.java, como est� especificado na Listagem 1.

Listagem 1. Classe Telefone.


  packageappagenda;
  public class Telefone
  {   private String numero;
       private String tipo;
       publicTelefone(String numero, String tipo)
      {   this.numero = numero;
           this.tipo = tipo;
      }
      public String getTelefone()
      {   return numero+" "+tipo;
       }
  }

Vamos entender o c�digo acima: na classe Telefone s�o criados dois campos: nome e telefone. Ambos s�o do tipo String e de visibilidade private. Em seguida � criado o construtor Telefone (String numero, String tipo) que ser� respons�vel por apontar a nova criaç�o dos objetos. Finalmente, � criado o m�todo getTelefone() do tipo String que retornar� os valores dos dois campos concatenados.

Ap�s ter feito a classe Telefone, ser� implementado dentro da classe ContatoBasico.java os c�digos descritos na Listagem 2.Essa classe cont�m dados b�sicos como nome e telefone que possam ser herdados para as outras classes futuramente.

Listagem 2. Classe abstrata referente ao ContatoBasico.


  Package appagenda;
   
  import java.util.ArrayList;
   
  abstract public class ContatoBasico
  {   protected String nome;
      Protected ArrayList<Telefone>telefones;
      public ContatoBasico()
      {  nome="";
         telefones=new ArrayList();
      }
      public ContatoBasico(String nome)
      {  this.nome = nome;
          telefones=new ArrayList();
      }
      public String getNome() { return nome; }
      public void setNome(String nome) { this.nome = nome;}
      public void setTelefone(Telefonetf)
      {  telefones.add(tf);
      }
      public String getDados()
      {   String s=nome+"\n";
           for(Telefone t:telefones)
           {  s+=t.getTelefone()+"\n";
           }
           return s;
      }
  }

Esse c�digo cont�m uma classe que � abstrata, na qual ela � impedida de ser instanciada, mas d� mais consist�ncia ao sistema e tem a funç�o de servir como herança de atributos e m�todos, que ser�o recursos fundamentais no decorrer do projeto.

Anteriormente, � criado uma importaç�o do ArrayList, que significa uma coleç�o de vetores armazenados numa Lista.

Logo em seguida s�o criados os campos nome (do tipo String) e telefones (do tipo ArrayList -isso � uma refer�ncia para a classe Telefone) e ambos com visibilidade protected.

Ap�s isso s�o criados os construtores ContatoBasico() e ContatoBasico(String nome), que v�o ser respons�veis por apontarem a nova criaç�o dos objetos.

O m�todo public String getNome() { return nome; } serve para encapsular o campo nome, obtendo seu valor, dentro de uma String e fazer seu retorno.

O m�todo public void setNome(String nome) { this.nome = nome;} � respons�velpor fazer o encapsulamentos do campo nome e tamb�m de enviar o seu valor.

O m�todo setTelefone(Telefone tf) � respons�vel por receber o conte�do do campo que est� contido na classe Telefone e adicionar para o campo telefones.

Por fim, o m�todo getDados() � do tipo String e cont�m uma String que recebe o nome e o telefone do respectivo contato e faz o retorno dessa vari�vel.

Ap�s ter implementado a classe abstrata ContatoBasico, agora � proposto implementar a classe Contato.java descrita na Listagem 3. Por essa classe fazer parte de uma herança, ela receber� dois dados: nome e data de nascimento.

Listagem 3. Classe Contato que herda da classe ContatoBasico e exibe a data de nascimento de modo formatado e faz c�lculos referentes a idade da pessoa.


  Package appagenda;
   
  Import java.util.Calendar;
  Import java.util.GregorianCalendar;
   
  public class Contato extends ContatoBasico
  {
    protected Calendar dtnasc;
    publicContato(String nome, Calendar dtnasc)
      {   super(nome);
           this.dtnasc = dtnasc;
      }
      @Override 
       public String getDados()
       { returnsuper.getDados()+"Nascido em "+
          dtnasc.get(Calendar.DATE)+"/"+
          dtnasc.get(Calendar.MONTH) + "/"+
          dtnasc.get(Calendar.YEAR) + "\nIdade: ";
      }
      public intgetIdade()
      {   Calendar hoje=new GregorianCalendar();
            intidade=hoje.get(Calendar.YEAR)-dtnasc.get(Calendar.YEAR);
            hoje.set(Calendar.YEAR, dtnasc.get(Calendar.YEAR));
            if(hoje.before(dtnasc))
              idade--;
              return idade;
   
      }
  }

Logo no in�cio do c�digo s�o criadas duas importaç�es: java.util.Calendar e java.util.GregorianCalendar, que fazem refer�ncias para as datas e convers�es e, com isso, podemos manipular no decorrer da implementaç�o da classe.

Ap�s, � inserido o c�digo extends ContatoBasico, que significa uma herança para a classe ContatoBasico, onde as informaç�es servir�o para a classe Contato.

Logo ap�s � criado um campo de data do nascimento (dtnasc) do tipo calendar e de visibilidade protected.

Tamb�m � criado o construtor Contato(String nome, Calendar dtnasc) que ser� respons�vel por apontar a nova criaç�o dos objetos. Nesse construtor h� a propriedade super, na qual faz refer�ncia para a vari�vel nome decorrente da classe ContatoBasico.

Como h� uma herança, � preciso um m�todo @Override (sobrescrita) que receber� o nome de getDados(), cujo tipo � String e cont�m um padr�o de retorno onde busca os dados da herança (super) concatenando com a data de nascimento, m�s e o ano que est�o previamentes no registro em mem�ria.

E finalmente, o m�todo getIdade(), do tipo int, � respons�vel por fazer uma convers�o da data em mem�ria em padr�es do ano, cuja finalidade � fazer um c�lculo para saber a idade do usu�rio que est� presente no registro.

Agora vamos implementar a classe Contato com o nome de Contato Comercial.java, como descrito na Listagem 4. Al�m dessa classe fazer parte de uma herança, ela receber� dois campos: atividade e funcion�rio.

Listagem 4. Classe ContatoComercial sendo herdada da classe ContatoBasico e exibe a atividade e o funcion�rio.


  Package appagenda;
   
  public class ContatoComercial extends ContatoBasico
  {
    protected String atividade;
    protected String funcionario;
   
    publicContatoComercial(String nome, String atividade, String funcionario)
    {   super(nome);
         this.atividade=atividade;
         this.funcionario=funcionario;
    }
    @Override
     public String getDados()
     {  String s=super.getDados();
         s+=atividade+"\n"+" contato Sr(a): "+funcionario;
         return s;
      }
  }

Logo no in�cio do c�digo inserimos extends ContatoBasico, que significa uma herança para a classe ContatoBasico, onde as informaç�es servir�o para a classe ContatoComercial.

Logo ap�s s�o criados dois campos: um com o nome atividade e do tipo String, e outro com o nome funcion�rio e do tipo String, ambos com visibilidade protected.

Em seguida � criado o construtor ContatoComercial(String nome, String atividade, String funcionario) que ser� respons�vel por apontar a nova criaç�o dos objetos. Nesse construtor h� a propriedade super, na qual faz refer�ncia para a vari�vel nome decorrente da classe ContatoBasico.

E finalmente, como h� uma herança, � preciso de um m�todo @Override (sobrescrita), que neste caso receber� o nome de getDados(), cujo tipo � String, e cont�m um padr�o de retorno onde busca os dados da herança (super) concatenando com a atividade e o funcion�rio que est�o previamentes no registro em mem�ria.

Ap�s ter implementado a classe ContatoComercial, agora � proposto implementar a classe EContato.java que est� descrita na Listagem 5. Al�m dessa classe fazer parte de uma herança, ela receber� dois campos: email e homepage.

Listagem 5. Classe EContato sendo herdada da classe Contato e exibe o email e a homepage.


  Package appagenda;
  import java.util.Calendar;
   
  public class EContato extends Contato
  {  protected String email,homepage;
      public EContato(String nome, Calendar dtnasc, String email, String hp)
      {  super(nome,dtnasc);
          this.email=email;
          homepage=hp;
     }
      @Override
      public String getDados() {
        return super.getDados()+"email: "+email+"\nhomepage:"+homepage+"\nIdade: ";
      }
      public String getEmail() {
        return email;
      }
      public String getHomepage() {
         return homepage;
      }
  }

Antes, � criada a importaç�o java.util.Calendar, que faz refer�ncia para as datas e convers�es. Em seguida � inserido o c�digo extends Contato que significa uma herança para a classe Contato, onde as informaç�es servir�o para a classe EContato.

Logo depois s�o criados dois campos: um com o nome email e outro com o nome homepage, ambos do tipo String e de visibilidade protected.

Ap�s � criado o construtor EContato(String nome, Calendar dtnasc, String email, String hp) que ser� respons�vel por apontar a nova criaç�o dos objetos. Nesse construtor h� a propriedade super, na qual faz refer�ncia para as vari�veis nome e dtnasc, decorrentes da classe Contato.

Como h� uma herança, � preciso do m�todo @Override (sobrescrita), que neste caso recebe o nome de getDados(), cujo tipo � String, e cont�m um padr�o de retorno onde busca os dados da herança (super) concatenando com o email e a homepage que est�o previamentes no registro em mem�ria.

O m�todo getEmail() - que � do tipo String, � respons�vel por retornar o valor do campo email. E, finalmente, o m�todo getHomepage(), do tipo String, � respons�vel por retornar o valor do campo homepage.

Na Listagem 6 ser� implementado os c�digos da classe respons�vel por �moldar� a maioria das funcionalidades do projeto.

Listagem 6. Classe Agenda e suas funcionalidades.


  Package appagenda;
   
  Import java.util.ArrayList;
   
  public class Agenda
  {   private ArrayList<ContatoBasico>contatos;
      Agenda()
      {   contatos=new ArrayList();
      }
      public void inserir(ContatoBasico c)
      {   contatos.add(c);
      }
      Public ContatoBasicobuscar(String nome)
      {   for(int i=0;i<contatos.size();i++)
          {   ContatoBasico c=contatos.get(i);
               if(c.getNome().equalsIgnoreCase(nome))
                 return contatos.get(i);
          }
          return null;
      }
      Public ContatoBasicobuscar(intpos)
      {   if(pos>=0 &&pos<contatos.size())
          {   returncontatos.get(pos);
          }
          return null;
      }
      Public EContatobuscarEmail(String email)
      {   for(int i=0;i<contatos.size();i++)
          {   if(contatos.get(i) instanceofEContato)
              {
                EContato c=(EContato)contatos.get(i);
                if(c.getEmail().equalsIgnoreCase(email))
                return (EContato)contatos.get(i);
              }
          }
          return null;
      }
      Public Contato[] buscarGeral(String palavraChave)
      {   ArrayList<ContatoBasico>todos=new ArrayList();
           for(int i=0;i<contatos.size();i++)
            {   ContatoBasico c=contatos.get(i);
                 if(c.getDados().contains(palavraChave))
                   todos.add(c);
             }
             Contato[] vet=new Contato[todos.size()];
   
              return (todos.toArray(vet));
       }
       Public Contato[] buscarTodos()
      {   Contato[] vet=new Contato[contatos.size()];
   
           return (contatos.toArray(vet));
      }
      Public intgetQuantidade()
     {  returncontatos.size();
      }    
  }

Essa classe Agenda � considerada uma das classes que mais operam no projeto, pois cont�m m�todos que servem para fazer consultas via registros que foram previamente colocados na mem�ria, buscar a quantidade de contatos e tamb�m fazer a inserç�o de registros.

Anteriormente, � criado uma importaç�o do ArrayList (que significa uma coleç�o de vetores armazenados numa Lista).

Logo em seguida � criado o campo contatos do tipo ArrayList< ContatoBasico> (isso � uma refer�ncia para a classe ContatoBasico) e com visibilidade protected.

Ap�s � criado o construtor Agenda() que cont�m a declaraç�o inicial do recebimento do ArrayList para a vari�vel contatos.

O m�todo inserir(ContatoBasico c) � respons�vel por controlar toda a inserç�o de dados para a mem�ria, sempre de acordo com o par�metro nome vindo da classe abstrata ContatoBasico.

O m�todo buscar(String nome), do tipo ContatoBasico, � respons�vel por realizar uma busca de todos os dados nos quais se referem ao registro do ContatoBasico atrav�s do nome informado.

O m�todo buscar(intpos), do tipo ContatoBasico,� quem faz uma busca de todos os dados nos quais se referem ao registro do ContatoBasico atrav�s da posiç�o informada.

O m�todo buscarEmail(String email), do tipo Econtato, � respons�vel por buscar os dados do registro referentes a pesquisa feita por email do contato.

O m�todo buscarGeral(String palavraChave), do tipo Contato[] (vetorizado), � respons�vel por fazer uma busca de todos os registros do contato de acordo com os caracteres inseridos para a pesquisa. Neste caso, n�o h� distinç�o para a busca, sendo tanto o Contato quanto ContatoBasico.

O m�todo buscarTodos(), do tipo Contato[] (vetorizado), � quem faz a busca de todos os registros, sem que o usu�rio afirme algum valor sequer para a pesquisa.

O m�todo intgetQuantidade() � respons�vel por retornar a quantidades de registros existentes na mem�ria.

Agora vamos escrever a nossa classe principal, a classe Main, que � implementada de acordo com a Listagem 7.

Listagem 7. Classe Principal do Projeto, onde se localizam o controle de dados para o usu�rio e a ocorr�ncia de eventos.


  Package appagenda;
   
  Import java.util.GregorianCalendar;
   
  public class Main
  {   static void mostraDados(ContatoBasicoobj)
      {  System.out.println(obj.getDados());
          if(objinstanceofContato)
            System.out.println(((Contato)obj).getIdade());
            System.out.println("xxxxxxxxxxxxxxxxxxxxxxxxxx");
      } 
       public static void main(String[] args) 
       {   Agenda a;
            a=new Agenda();
   
            Contato cb;
             cb=new Contato("Teste",newGregorianCalendar(1980,10,28));
             cb.setTelefone(new Telefone("3333-5555","Telefone residencial"));
             cb.setTelefone(new Telefone("99111-1111","Telefone celular"));
             a.inserir(cb);
   
             ContatoComercial cc;
             cc=new ContatoComercial("Lanchonete", "Lanches", "Lan");
             cc.setTelefone(new Telefone("2222-0000","Telefone residencial"));
             a.inserir(cc);
   
            a.inserir(new EContato("Exemplo",newGregorianCalendar(1975,2,22),
                  "exemplo@gmail.com","www.exemplo.com.br"));
   
            ContatoBasicoobj=a.buscar("Teste"); //pesquisa por nome
   
            if(obj!=null)
              mostraDados(obj);
              elseSystem.out.println("Contato nao encontrado!");
           }
  }

O primeiro passo � a importaç�o java.util.GregorianCalendar; que faz refer�ncia para as datas e convers�es.

O m�todo mostraDados(ContatoBasicoobj) recebe os dados da classe ContatoBasico e envia para o objeto objconvertendo os dados para o tipo Contato e concatenando com a idade.

Finalmente, o m�todo principal do projeto - main(String[] args) - � respons�vel por receber as classes Agenda, Contato (que insere na mem�ria um novo contato contendo: nome, data, telefone residencial, telefone celular), ContatoComercial (que insere na mem�ria um novo contato comercial contendo: nome, telefone residencial), EContato (que insere na mem�ria um novo email para contato e um ano de acordo com o nome) e a classe ContatoBasico � instanciada recebendo o valor da pesquisa e o tipo da pesquisa, onde no exemplo � a pesquisa por nome.

Se o objeto obj for diferente de null, quer dizer que retornou resultados, mostrando dados do objeto no console System.out.println, sen�o, � impresso uma mensagem simples dizendo que o contato n�o foi encontrado.

Podemos ver a execuç�o do projeto na Figura 5.

Figura 5. Tela de exibiç�o do resultado em console onde cont�m os dados do contato de nome: �Teste�, telefone residencial, telefone celular, data de nascimento e idade.

Java Orientado a Objetos: Como criar uma Agenda em Java

Veja nesse artigo como desenvolver uma agenda bem simples e básica em Java OO utilizando a IDE Netbeans.Conheça mais sobre a linguagem de programação JAVA e também recursos da programação orientada a objetos.

Iniciando o Projeto

Implementando o Projeto

Artigos relacionados