|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.lavieri.modelutil.cep.WebServiceCep
public final class WebServiceCep
Ferramenta de busca de CEP, veja o método searchCep(String)
para
maiores informações.
Constroi um objeto WebServiceCep
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:
WebServiceCep
cep = WebServiceCep
.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
Method Summary | |
---|---|
java.lang.String |
getBairro()
Informa o bairro |
java.lang.String |
getCep()
Informa o cep. |
java.lang.String |
getCidade()
Informa a cidade |
java.lang.Exception |
getException()
Pega a exceção que ocorreu durante a busca, retorna null caso não haja exceções. |
java.lang.String |
getLogradouro()
Informa o logradouro. |
java.lang.String |
getLogradouroFull()
Informa o logradouro junto com o tipo de logradouro. |
java.lang.String |
getLogradouroType()
Informa o tipo do logradouro. |
int |
getResulCode()
Informa o código do resultado da pesquisa. |
java.lang.String |
getResultText()
Informação textual sobre o resultado da pesquisa |
java.lang.String |
getUf()
Informa a Unidade Federativa |
boolean |
hasException()
Informa se houve falhas na busca do cep |
boolean |
isCepNotFound()
Informa se não existe o cep cadastrado. |
static WebServiceCep |
searchCep(java.lang.String cep)
Faz uma busca a partir do cep enviado, no site republicavirtual.com.br, retornando o resultado em um objeto WebServiceCep . |
boolean |
wasSuccessful()
Informa se o cep foi encontrado com sucesso. |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method Detail |
---|
public static WebServiceCep searchCep(java.lang.String cep)
WebServiceCep
.
String
"14.568-910" é automaticamente passada para
"14568910".
String
"1%4#5?55%16a8&910" é automaticamente passada para
"14555168", só levando em conta os primeiros 8 números.
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á truncada caso seja maior que 8 caracters.
WebServiceCep
contendo as informações da pesquisa.public int getResulCode()
public java.lang.String getResultText()
String
contendo a descrição do resultado da pesquisa.public boolean wasSuccessful()
public boolean isCepNotFound()
public boolean hasException()
public java.lang.Exception getException()
Exception
- Caso ocorra falhas
public java.lang.String getBairro()
String
contendo o nome bairropublic java.lang.String getCidade()
String
contendo o nome da Cidadepublic java.lang.String getUf()
String
contendo o nome da Unidade Federativapublic java.lang.String getLogradouro()
String
contendo o nome do Logradouropublic java.lang.String getLogradouroFull()
String
contendo o tipo de Logradouro + nome do Logradouro.public java.lang.String getLogradouroType()
String
contendo o tipo de logradouuro.public java.lang.String getCep()
String
contendo o cep.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |