com.github.gilbertotorrezan.viacep.gwt

Class ViaCEPGWTClient

java.lang.Object

com.github.gilbertotorrezan.viacep.gwt.ViaCEPGWTClient

public class ViaCEPGWTClient
extends Object

Classe de acesso aos web services da ViaCEP para GWT. Utiliza RestyGWT para a comunicação e serialização de objetos Java. As chamadas utilizam CORS, e por padrão utilizam HTTPS. Para utilizar HTTP, ou outro host, utilize:

 
 ServiceRoots.add(ViaCEPGWTService.SERVICE_ROOT_KEY, "http://" + ViaCEPConstants.SERVICE_HOST);
 
 

Since:

v.1.0.0

Author:

Gilberto Torrezan Filho

See Also:

https://resty-gwt.github.io/, http://viacep.com.br

Field Summary

Fields

Modifier and Type	Field and Description
protected ViaCEPGWTService	service

Constructor Summary

Constructors

Constructor and Description
ViaCEPGWTClient() Construtor padrão.
ViaCEPGWTClient(ViaCEPGWTService service) Construtor que permite que seja setado um ViaCEPGWTService customizado.

Method Summary

Methods

Modifier and Type	Method and Description
void	getEndereco(String cep, org.fusesource.restygwt.client.MethodCallback<ViaCEPEndereco> callback) Executa a consulta de endereço a partir de um CEP.
void	getEnderecos(String uf, String localidade, String logradouro, org.fusesource.restygwt.client.MethodCallback<List<ViaCEPEndereco>> callback) Executa a consulta de endereços a partir da UF, localidade e logradouro
ViaCEPGWTService	getService() Retorna o ViaCEPGWTService utilizado por esse client.
void	setService(ViaCEPGWTService service) Seta um ViaCEPGWTService customizado para uso por esse client.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

service

protected ViaCEPGWTService service

Constructor Detail

ViaCEPGWTClient

public ViaCEPGWTClient()

Construtor padrão.

ViaCEPGWTClient

public ViaCEPGWTClient(ViaCEPGWTService service)

Construtor que permite que seja setado um ViaCEPGWTService customizado.

Method Detail

getEndereco

public void getEndereco(String cep,
               org.fusesource.restygwt.client.MethodCallback<ViaCEPEndereco> callback)

Executa a consulta de endereço a partir de um CEP.

Parameters:

cep - CEP da localidade onde se quer consultar o endereço. Precisa ter 8 dígitos - a formatação é feita pelo cliente. CEPs válidos (que contém 8 dígitos): "20930-040", "abc0 1311000xy z", "20930 040". CEPs inválidos (que não contém 8 dígitos): "00000", "abc", "123456789"

callback - O retorno da chamada ao webservice. Erros de validação de campos e de conexão são tratados no callback.

getEnderecos

public void getEnderecos(String uf,
                String localidade,
                String logradouro,
                org.fusesource.restygwt.client.MethodCallback<List<ViaCEPEndereco>> callback)

Executa a consulta de endereços a partir da UF, localidade e logradouro

Parameters:

uf - Unidade Federativa. Precisa ter 2 caracteres.

localidade - Localidade (p.e. município). Precisa ter ao menos 3 caracteres.

logradouro - Logradouro (p.e. rua, avenida, estrada). Precisa ter ao menos 3 caracteres.

callback - O retorno da chamada ao webservice. Erros de validação de campos e de conexão são tratados no callback.

getService

public ViaCEPGWTService getService()

Retorna o ViaCEPGWTService utilizado por esse client.

setService

public void setService(ViaCEPGWTService service)

Seta um ViaCEPGWTService customizado para uso por esse client.