Canducci ZipCode and AddressCode
Instalação do Pacote
PM> Install-Package Canducci.Zip
Utilização
Busca de CEP
Para a busca de dados de um determinado número de CEP instancie a classe ZipCodeLoad e no seu método Find ou FindAsync passe o número e se a resposta estiver satisfatória os dados estão na classe de resultado ZipCodeResult, exemplo:
IZipCodeLoad zipCodeLoad = new ZipCodeLoad();
ZipCodeResult result0 = zipCodeLoad.Find("01001000");
if (result0) // ou result0.IsValid
{
ZipCodeItem zipCodeItem = result0; //ou zipCodeItem zipCodeItem = result0.Value;
}A saída da classe ZipCodeItem é a seguir:
ZipCodeItem.Zip // cep
ZipCodeItem.Address // logradouro
ZipCodeItem.District // bairro
ZipCodeItem.City // localidade
ZipCodeItem.Uf // uf
ZipCodeItem.Ibge // Ibge
ZipCodeItem.Complement // complemento
ZipCodeItem.Gia // gia
ZipCodeItem.Siafi // siafi
ZipCodeItem.Ddd // ddd
Busca de uma lista de CEP
IAddressCodeLoad addressCodeLoad = new AddressCodeLoad();
AddressCode addressCode = AddressCode.Parse(ZipCodeUf.SP, "SÃO PAULO", "AVE");
AddressCodeResult result1 = addressCodeLoad.Find(addressCode);
if (result1) // ou result1.IsValid
{
AddressCodeItem items = result1; // ou AddressCodeItem items = result1.Value;
}Note que a saída da classe AddressCodeItem é uma enumeração (List<>) de ZipCodeItem, ou seja, List<ZipCodeItem>.
Lista de Unidade Federativa
Tanto no objeto de instancia das classes AddressCodeLoad e ZipCodeLoad existe um método de extensão que retorna um IDictionary<string, string> que pode ser utilizado em suas telas para padronização da informação, exemplo:
IZipCodeLoad zipCodeLoad = new ZipCodeLoad();
IAddressCodeLoad addressCodeLoad = new AddressCodeLoad();
System.Collections.Generic.IDictionary<string, string> items0_List = zipCodeLoad.UFToList();
System.Collections.Generic.IDictionary<string, string> items1_List = addressCodeLoad.UFToList();
Essas duas variaveis (items0_List e items1_List) são da mesma instância e são geradas a partir do Enum ZipCodeUf o mesmo para facilitar na criação de suas interfaces de programação.
Aplicação MVC Core
No exemplo do controller TestController tem dois métodos:
[HttpPost]
public async Task<IActionResult> Index([FromBody] ZipCodeData data)
{
if (ModelState.IsValid)
{
if (ZipCode.TryParse(data.Value, out ZipCode zipCode))
{
ZipCodeResult zipCodeResult = await ZipCodeLoad.FindAsync(zipCode);
return Json(zipCodeResult);
}
}
return Json(new { IsValid = false });
}
[HttpPost]
public async Task<IActionResult> Address([FromBody] AddressCodeData data)
{
if (AddressCode.TryParse(ParseZipCodeUf(data.Uf), data.City, data.Address, out AddressCode addressCode))
{
AddressCodeResult addressCodeResult = await AddressCodeLoad.FindAsync(addressCode);
return Json(addressCodeResult);
}
return Json(new { IsValid = false });
}
private ZipCodeUf ParseZipCodeUf(string uf) => Enum.Parse<ZipCodeUf>(uf);com o código que retornar um json para Front-End de como utilizar o pacote Canducci.Zip e nesse link todo o projeto exemplo.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent