Package org.brerp.base.util

Class WebServiceCepRepVirtual

java.lang.Object
org.brerp.base.util.WebServiceCepRepVirtual
public final class WebServiceCepRepVirtual extends Object
Ferramenta de busca de CEP, veja o método searchCep(String) para maiores informações.

Constroi um objeto WebServiceCepRepVirtual com os dados XML encapsulados, a partir da chamada do método estatico searchCep(String).

Objeto contem todas as informações do XML, além de informações referente ao resultado da pesquisa.

Esta ferramente depende diretamente do pacote org.dom4j para fazer o parse dos arquivos XML. O pacote dom4j.jar pode ser encontrado em dom4j.org

Exemplo de uso:
WebServiceCepRepVirtual cep = WebServiceCepRepVirtual.searchCep("13345-325");
//caso a busca ocorra bem, imprime os resultados.
if (cep.wasSuccessful()) {
    System.out.println("Cep: "+cep.getCep());
    System.out.println("Logradouro: "+cep.getLogradouroFull());
    System.out.println("Bairro: "+cep.getBairro());
    System.out.println("Cidade: "+ cep.getCidade()+"/"+ cep.cep());
//caso haja problemas imprime o código e msg de erro.
} else {
    System.out.println("Erro número: " + cep.getResulCode());
    System.out.println("Descrição do erro: " + cep.getResultText());
}

A resposta do console seria:

Cep: 13345325
Logradouro: Rua Cinco
Bairro: Jardim Rômulo Zoppi
Cidade: Indaiatuba/SP

Ultima revisão: 09/01/2009
Author:
Tomaz Lavieri

  • Constructor Details

    • WebServiceCepRepVirtual

      public WebServiceCepRepVirtual(String cep)
      Privado para que seja invocado apenas através de searchCep(String)
      Parameters:
      cep -

  • Method Details

    • searchCep

      public static WebServiceCepRepVirtual searchCep(String cep)
      Faz uma busca a partir do cep enviado, no site republicavirtual.com.br, retornando o resultado em um objeto WebServiceCepRepVirtual.

      Não se faz necessário formatações, a string pode ser enviada em qualquer formatação, pois só serão consideradas os primeiros 8 numeros da string.
      Por Exemplo:
      Uma String "14.568-910" é automaticamente passada para "14568910".
      Uma String "1%4#5?55%16a8&910" é automaticamente passada para "14555168", só levando em conta os primeiros 8 números.
      Parameters:
      cep - Número do cep a ser carregado. Só serão considerados os primeiros 8 números da String enviada. Todos os caracters não numéricos serão removidos, e a string serão truncada caso seja maior que 8 caracters.
      Returns:
      WebServiceCepRepVirtual contendo as informações da pesquisa.

    • getResulCode

      public int getResulCode()
      Informa o código do resultado da pesquisa.
      Códigos conhecidos:
      -1 : busca não realizada
      0 : cep não encontrado
      1 : cep encontrado
      -14 : Site não encontrado (pode ser por problemas na internet).
      -15 : Não foi possivel ler o documento xml
      -16 : Erro na formação da url
      -17 : Erro inesperado
      Returns:
      int Código do resultado.

    • getResultText

      public String getResultText()
      Informação textual sobre o resultado da pesquisa
      Returns:
      String contendo a descrição do resultado da pesquisa.

    • wasSuccessful

      public boolean wasSuccessful()
      Informa se o cep foi encontrado com sucesso.
      Returns:
      true - caso a pesquisa ache um resultado no banco.
      false - caso haja falhas, ou o cep enviado não esteja cadastrado.

    • isCepNotFound

      public boolean isCepNotFound()
      Informa se não existe o cep cadastrado.
      Returns:
      true - Caso o cep não tenha cido encontrado.
      false - Caso haja falhas, ou caso o cep esteja cadastrado.

    • hasException

      public boolean hasException()
      Informa se houve falhas na busca do cep
      Returns:
      true - Caso ocorra falhas
      false - Caso não haja falhas.

    • getException

      public Exception getException()
      Pega a exceção que ocorreu durante a busca, retorna null caso não haja exceções.
      Returns:
      Exception - Caso ocorra falhas
      null - Caso não haja falhas.

    • getBairro

      public String getBairro()
      Informa o bairro
      Returns:
      String contendo o nome bairro

    • getCidade

      public String getCidade()
      Informa a cidade
      Returns:
      String contendo o nome da Cidade

    • getUf

      public String getUf()
      Informa a Unidade Federativa
      Returns:
      String contendo o nome da Unidade Federativa

    • getLogradouro

      public String getLogradouro()
      Informa o logradouro.
      Returns:
      String contendo o nome do Logradouro

    • getLogradouroFull

      public String getLogradouroFull()
      Informa o logradouro junto com o tipo de logradouro.
      Returns:
      String contendo o tipo de Logradouro + nome do Logradouro.

    • getLogradouroType

      public String getLogradouroType()
      Informa o tipo do logradouro.
      Returns:
      String contendo o tipo de logradouuro.

    • getCep

      public String getCep()
      Informa o cep.
      Returns:
      String contendo o cep.