The latest articles on DEV Community by Cynthia Raphaella 💙 (@cynthiaraphaela). https://dev.to/cynthiaraphaela https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Fuser%2Fprofile_image%2F476974%2F2142d77b-4dd8-4250-9712-6c99606930ce.jpg https://dev.to/cynthiaraphaela en Cynthia Raphaella 💙 Tue, 16 Mar 2021 17:57:13 +0000 https://dev.to/cynthiaraphaela/polly-uma-biblioteca-para-resiliencia-em-aplicacoes-net-3ko3 https://dev.to/cynthiaraphaela/polly-uma-biblioteca-para-resiliencia-em-aplicacoes-net-3ko3 <p><a href="https://media.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2Fm6se7vmg17gnqbdeq739.jpeg" class="article-body-image-wrapper"><img src="https://media.dev.to/dynamic/image/width=800%2Cheight=%2Cfit=scale-down%2Cgravity=auto%2Cformat=auto/https%3A%2F%2Fdev-to-uploads.s3.amazonaws.com%2Fuploads%2Farticles%2Fm6se7vmg17gnqbdeq739.jpeg" alt="Polly — biblioteca para tratamento de falhas em .Net"></a></p> <p>Aplicações complexas e com múltiplas dependências são suscetíveis a falhas. Normalmente existe uma preocupação em evitar que essas falhas aconteçam, mas também é importante saber se recuperar quando elas acontecem (sim, elas vão acontecer). Polly é uma biblioteca para aplicações .NET que foca em resiliência e tratamento de falhas.</p> <p>Polly implementa diferentes padrões, que são chamados de Policies. Na <a href="https://github.com/App-vNext/Polly#resilience-policies" rel="noopener noreferrer">documentação</a> são apresentados os diferentes tipos e um resumo do uso de cada um deles. O livro <a href="https://www.goodreads.com/book/show/1069827.Release_It_" rel="noopener noreferrer">Release It</a> apresenta muitos desses conceitos com mais detalhes.</p> <h2> Configurando o Polly </h2> <p>Configurar o Polly é bem simples, a biblioteca está disponível no <a href="https://www.nuget.org/packages/Polly" rel="noopener noreferrer">NuGet</a> e depois de instalada já está pronta para ser utilizada.</p> <p><code>dotnet add package Polly --version 7.2.1</code></p> <h2> Retry Policy </h2> <p>Considerando os diferentes padrões disponíveis na biblioteca Polly, o Retry é o que eu mais utilizo. Esse padrão considera que a maioria das falhas que acontecem são transientes e que vão ser corrigidas automaticamente depois de um certo tempo. O Retry executa novamente um comportamento dada uma condição e é composto por algumas partes:</p> <ul> <li>Uma condição que irá determinar uma possível repetição</li> <li>Uma função que pode ser executada múltiplas vezes. Essa função pode ser síncrona ou assíncrona</li> <li>O número máximo de vezes que a operação irá ser repetida. No caso do <em>RetryForever</em>, esse parâmetro não é necessário e a execução vai se repetir até a condição ser falsa</li> <li>Um tempo de espera entre execuções <em>(WaitAndRetry)</em>. Essa estratégia pode ajudar a aguardar o sistema se estabilizar</li> </ul> <p>O <em>Retry</em> é muito útil para se recuperar de tratar falhas pontuais, como por exemplo:</p> <ul> <li>Uma dependência externa indisponível</li> <li>O banco não respondeu</li> <li>Um token expirado</li> </ul> <h2> Um cenário de uso do Retry </h2> <p>Considerando como exemplo uma aplicação que tem um carrinho de compras, um dos requisitos é calcular o frete. Essa aplicação tem uma dependência externa que traduz o CEP em um endereço. A dependência não é muito estável e em alguns momentos retorna erros. Nesse cenário, o <em>Retry</em> pode ser utilizado para lidar com esse caso de falha. Abaixo temos um exemplo dessa implementação.</p> <div class="ltag_gist-liquid-tag"> </div> <p>No código estamos usando um método chamado <em>‘HandleTransientHttpError’</em>, disponível em uma <a href="https://github.com/App-vNext/Polly.Extensions.Http/blob/master/README.md" rel="noopener noreferrer">biblioteca de extensões do Polly</a>, esse método agrupa algumas condições de falha comuns com o uso do <em>HttpClient</em>. Internamente, essa condição valida se o retorno de uma requisição é um erro com um status code maior que 500 (indica um erro), 408 (timeout) ou uma exceção do tipo <em>HttpRequestException</em>.</p> <p>Essa <em>policy</em> criada executa a chamada para a dependência externa até duas vezes <em>(retryCount)</em> se o resultado da chamada se encaixar na condição descrita acima. Como esse Retry é do tipo <em>WaitAndRetry</em>, então antes de executar novamente, a <em>Policy</em> vai aguardar um tempo determinado.</p> <p>O parâmetro de duração é configurado através de uma função, no exemplo acima, a Policy vai aguardar a quantidade de segundos relativa ao número daquela execução: na primeira tentativa um segundo, na segunda tentativa dois segundos.</p> <p>Esse é um exemplo onde Polly pode ser utilizado para lidar com falhas em aplicações .NET. O código é simples e reutilizável e evita a implementação de uma camada de complexidade extra para lidar com falhas.</p> <h2> Referências </h2> <ul> <li>Neste <a href="https://github.com/App-vNext/Polly-Samples" rel="noopener noreferrer">repositório</a> existem vários exemplos práticos do uso do Polly</li> <li> <a href="https://github.com/App-vNext/Polly/wiki/Retry" rel="noopener noreferrer">Wiki</a> do Retry com mais detalhes</li> </ul> dotnet polly retrypolicy csharp