Alexandre Costa

Tag: API

  • API First: Como aprendemos na prática

    Este artigo foi publicado em 2016. Ferramentas e versões citadas podem ter mudado desde então; a reflexão permanece.

    Fala galera!

    Hoje trago para discussão assunto que surgiu em uma retrospectiva do projeto que estamos concluindo.

    Por ter sido nosso primeiro grand projeto mobile fizemos o desenvolvimento de frontend e backend de forma paralela permitindo que ambos evoluissem de forma independente seguindo nossas especificações iniciais.

    Isto acelerou o desenvolvimento, mas causou um grande impacto nos testes integrados já que alguns aspectos técnicos da execução das APIs não haviam sido detectados.

    Outra constatação é que a própria interface do aplicativo poderia ter sido muito facilitada se a interação com o backend tivesse se iniciado mais cedo.

    Por isto comprovamos, infelimente da pior forma, que a abordagem de API First é extremamente importanteneste tipo de projeto.

    Para os novos desenvolvimento iremos tentar seguir o seguinte roteiro:

    • Fazer um planejamento inicial da aplicação utiliando o Storyboard;
    • Desenvolver as APIs já contemplando testes unitários e integrados;
    • Desenvolver as interfaces já apontando para os serviços, sejam eles mocks ou implementações finais;
    • Automatizar os testes de interface;

    E voces? Quais workflows tem utilizado no seu desenvolvimento móvel? Compartilhe com a gente aqui no comentários.

    Até a próxima!

  • Recurso do Visual Studio que facilita o uso de APIs JSON/XML

    Este artigo foi publicado em 2015. Ferramentas e versões citadas podem ter mudado desde então; a reflexão permanece.

    Fala galera!

    Estou trabalhando em um grande projeto de conversÃo das APIs de acesso ao Sonarqube para acesso via .NET.

    Como são diversos objetos que fazem parte do retorno da API a parte mais trabalhosa é o mapeamento dos retornos em JSON para classes POCO.

    Descobri hoje que é possível facilitar muito este trabalho com um recurso que foi introduzido no Visual Studio 2013.

    Para isto siga os seguintes passos:

    1. Copie o resultado de um chamada, tanto em JSON quanto em XML;
    2. Crie um novo arquivo para receber a classe, ou posicione o cursor no arquivo já existente;
    3. No menu Edit vá até Paste Special e selecione Paste JSON as classes ou Past XML as classes respectivamente;

    Voilá! Voce terá uma classe gerada baseada no conteúdo da área d transferencia pronta para receber os ajustes necessários.

    Abaixo o código convertido da [API de busca de CEP:

    public class Rootobject
 {
 public string bairro { get; set; }
 public string logradouro { get; set; }
 public string cep { get; set; }
 public string uf { get; set; }
 public string localidade { get; set; }
 }

    Até a próxima!