DEV Community: Nathan Silva

O que é Clean Architecture?

Nathan Silva — Wed, 27 Aug 2025 00:36:18 +0000

Neste post vou explicar da maneira mais burra e simplificada o que é Clean Architecture, pois é um tema meio complexo e cheio de variáveis. Logo, esse post é pra eu mesmo me relembrar de como são as coisas, mas isso talvez ajude voce também!

Objetivo da Arquitetura Limpa

Esse modelo de arquitetura de software, assim como os modelos de cebola e hexagonal buscam isolar as regras de negócio do mundo externo com camadas bem definadas. Isso faz com que a gente proteja o Core da nossa aplicação e não fique dependente de frameworks, bancos de dados, etc.

O que precisa ter sempre em mente é que as dependencias são sempre de fora pra dentro!!!!

Camadas

Abaixo segue a famosa imagem de representação

Entities / Enterprise Business Rules

Estão no mais profundo Core da aplicação, aonde irão encapsular as regras do negocio ou a lógica central.

UseCases / Interactores / Application Business Logic

Responsável por implementar de forma concreta as regras de negocio e manipular as entidades, e também a comunicação entre o Core da aplicação com a camada mais externa.

Interface Adapters

É camada é responsável por adaptar os dados entre o mundo externo(UI, Web, etc) para dentro da logica de negócio

Frameworks e drives

Camada de dispositivos externos que vão interagir com a aplicação. Vale destacar que ela deve ser substituída sem que exista impacto nas camadas internas.

Aqui mostra um resumo de dados que devem estar presentes em cada camada. Isso é uma regra, porém pode ser seguida.

Fonte: Jose Carlos Macoratti

Importante

Se liga ai mano, eu sempre ficava quebrando cabeça quando via um projeto novo e cada hora com um tipo de nome. A real é que não faz diferença nenhuma, o importante mesmo é a arquitetura do software, ou seja, a estrutura lógica.

Liberar consumo de API C#

Nathan Silva — Tue, 09 Jul 2024 23:55:22 +0000

Apesar de parecer simples liberar API para uso no visual studio, no meu caso sempre veio com algum problema que fizesse com que desse erro nas requisições pelo postman, dispositivo móvel ou por algum projeto.
Dito isso, eu fiquei quebrando cabeça pra resolver e abaixo eu listei algumas coisas que podem resolver esse problema.

CORS #1

A primeira coisa a ser feita é liberar o CORS(lá ele), mas antes vamos entender o que é e como funciona.

O que é?

CORS significa Cross-Origin Resource Sharing que consiste em um mecanismo que permite aplicações web façam requisições para um servidor em outro domínio além da aplicação que está hospedada.

Como funciona?

Em resumo, o CORS funciona como um validador de origem, afim de garantir segurança do usuário.

Algumas configurações

Access-Control-Allow-Origin: Especifica quais origens podem acessar os recursos.
Access-Control-Allow-Methods: Especifica quais métodos HTTP (GET, POST, etc.) são permitidos para a requisição.
Access-Control-Allow-Headers: Especifica quais cabeçalhos HTTP podem ser usados na requisição.
Access-Control-Allow-Credentials: Indica se os cookies e credenciais HTTP podem ser incluídos na requisição (usado em requisições com credenciais, como cookies de autenticação).

Resolução

No arquivo program.cs da API no visual Studio larga o seguinte código, só confere antes se você já não tinha adicionado algo antes:

`var builder = WebApplication.CreateBuilder(args);

builder.Services.AddControllers();
https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
builder.Services.AddCors(options =>
{
options.AddPolicy("AllowAll",
builder =>
{
builder.AllowAnyOrigin()
.AllowAnyMethod()
.AllowAnyHeader();
});
});

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
app.UseSwagger();
app.UseSwaggerUI();
}

app.UseHttpsRedirection();
app.UseCors("AllowAll");
app.UseAuthorization();
app.MapControllers();
app.Run();
`

Kestrel #2

Antes de fazer este passo recomendo que faça o passo anterior e teste

O que é?

Kestrel é um servidor integrado fornecido pelo ASP.NET Core e responsável por processar as requisições HTTP.

Como funciona?

Este servidor funciona otimizando e organizando as requisições que são feitas, a partir das configurações de porta, Ip e certificados SSL. Além disso, é importante que destacar que é multiplataforma.

Resolução

A configuração abaixo deve ser feita dentro do arquivo appsettings.json, sendo HTTP e/ou HTTPs. Lembrando que a porta vai alterar de acordo com o que você usa.

{ "Logging": { "LogLevel": { "Default": "Information", "Microsoft.AspNetCore": "Warning" } }, "AllowedHosts": "*", "Kestrel": { "Endpoints": { "Http": { "Url": "http://0.0.0.0:5111" }, "Https": { "Url": "https://0.0.0.0:5001", "Certificate": { "Path": "certificate.pfx", "Password": "password" } } } } }

Liberando portas no firewall

Siga os prints abaixo. Lembrando que faremos isso pra entrada e para saida.

Entrada

Saída

O que é e como usar o axios?

Nathan Silva — Tue, 09 Jul 2024 23:11:03 +0000

O que é?

Axios é uma biblioteca de JavaScript que permite fazer requisições HTTP de maneira simples e eficiente, em resumo é um cliente HTTP baseado em promises.

Como instalar?

yarn add axios

Comandos importantes Git

Nathan Silva — Thu, 27 Jun 2024 00:41:19 +0000

Como trocar de branch

git fetch
git checkout nome-branch

Diretivas Vuejs

Nathan Silva — Sat, 20 Apr 2024 17:58:36 +0000

v-if: Cria uma condição em uma tag
v-show: Boleano para exibir ou não um elemento.

Diferença entre v-show e v-if: O v-show apenas deixa o display do elemento como none, ou seja, o elemento html continua disponivel na DOM da página, porém sem estar visível. Já o v-if é responsável por uma renderização condicional, aonde caso não seja verdadeira simplesmente não exibe na tela e nem na DOM.

v-vind:href: Cria um link
v-for: Faz um looping de repetição

v-bind:key : Informa o indice de repetição da lista
props: É a ação de passar a informação do componente pai para o componente filho
emit: É possivel "ouvir" o evento de um componente filho no componente pai
v-on: Diretiva para pegar eventos de click/submit/mouseover/keyup/scroll e realizar uma ação. A forma simplificada é utilizando um @.

O v-on aceita modificadores em sua chamada, e por sua vez podem ser encadeados
@click.prevent
@click.once
@keyup.a
@click.prevent.once

v-html: Possibilita colocar elementos HTML dentro de determinadas tags. Caso a tag já possua outros elementos html dentro dele, o mesmo será substituido pelos valores que serão passados atravez da diretiva.

v-once: Executa o elemento HTML apenas uma vez, ou seja, não recebe mais atualizações de tela após a primeira execução.
<component :is="nome_componente": Funciona com um componente generico que pode se "transformar" qualquer coisa

Entendo o conceito de VueJS

Nathan Silva — Wed, 03 Apr 2024 00:43:57 +0000

O que é?

Resumindo o Vuejs é uma biblioteca javascript que busca manipular elementos HTML(DOM) por meio de lógicas de promogração feitas a partir do Javascript. Tudo que acontece na aplicação é feito a partir da instancia de Vue que faz o gerenciamento desses elementos por meio de valores e tags.

Exemplo inicial

Pra gente entender melhor como funciona tudo isso, vamos fazer ver esse exemplo abaixo. Nele estamos criando uma página básica em html com vue importado, uma tag div com id "app" e umas informações na tag script.

Idai? Bom, a grande jogada inicial esta nas informações fornecidas pelo console.log. Nele podemos ver que já estamos conseguindo capturar elementos existentes na DOM, e é ai que a brincadeira começa!

Conforme deu pra ver o nosso objeto "options" já está com o nosso app. Em projetos instalados por CLI é normal o elemento principal ser chamado de APP, o que eu to fazendo aqui é mostrando o parte inicial pra ficar bem claro o que está acontencendo.

Atributos reativos

Atributos reativos são simplesmente variáveis que serão enviadas para o HTML por meio do JavaScript. Com isso, poderemos "enviar" essas váriaveis para a DOM utilizar como bem entender por meio do que podemos chamar de "double mustache". Obs: Esses valores são enviados por meio da propriedade DATA.
Que raios é double mustache? É só abre e fecha chaves kkk. Exemplo: {{ pessoa_idade }}

Se liga nisso:

O primeiro faz referencia a variavel exportada lá na propriedade "data" do objeto "options", enquanto o segundo elemento é apenas um texto simples. Resultado:

Métodos

Assim como temos a possibilidade de utilizarmos váriaveis na DOM, também podemos fornecer funções pra serem executadas!

Com esse simples exemplo, obtemos o resultado de 9 e 5 exibidos diretamente no nosso HTML.

Além disso, podemos também utilizar as variaveis que estão dentro da propriedade "data" por meio da palavra reservada "this". O "this" faz referência a própria instância do VUE, o que permite utilizamos seus respectivos valores.

Como criar uma API com EntityFramework e SQL Server

Nathan Silva — Sat, 09 Mar 2024 01:38:54 +0000

Neste artigo irei mostrar como criar uma API simples utilizando EntityFramework com SQL server.

Preparando o ambiente

Vamos começar criando o projeto. Primeira coisa a ser feita é criar um projeto do tipo ASP.NET Core Web API.

Com o projeto criado a gente já pode testar com o Swagger uma das rotas padrões.

Pra esse tutorial a gente já vai fazer uma coisa mais "next level". Vamos dividir as nossas camadas de dados em API, DAL, BLL e Entity. Com isso vamos adicionar esses 3 projetos com o tipo Class.Library.

Instalando dependências

Agora é hora de utilizarmos o Nuget para adicionar alguns pacotes ao nosso projeto de DAL e API(futuramente os outros projetos também podem precisar desses pacotes). Tools > Nuget package manager > Manage package nuget for solution.

Ao tentar instalar, será solicitado outros pacotes, ai é só aceitar tudo.

Estruturando o projeto com classes

Agora que já temos nossas dependências instaladas, vamos criar uma classe na DAL que irá herdar o DbContext e fazer as ações necessárias.

Você vai notar que já tem algumas configurações do modelbuilder, mas eu estou basicamente informando quais vão ser os campos da minha tabela. De resto é tudo igual. Inclusive, essa é a minha classe Pessoa que foi criada no projeto de Entity.

Criando a conexão

No arquivo appSettings.json do projeto Asp.Net insera a string de conexão que leverá o nosso banco

"StringConnection" : "server=(local)\\SQL2019;database=vrsolicitacoes;integrated security=true;trustservercertificate=true"

Logo após isso, iremos até o Program.cs informar que utilizaremos esse caminho para usar o SqlServer.

Migrations

Agora vamos criar o nosso banco utilizando migration. Lá no Package Manager Console digite:

Add-Migration "Nome da migration aqui"

Depois disso é só rodar o seguinte comando
Update-Database

Nota

Se der o erro apresentado abaixo, basta trocar o projeto target para aquele que estiver com a classe que herda do dbContext.

Your target project '' doesn't match your migrations assembly 'DAL'. Either change your target project or change your migrations assembly.
Change your migrations assembly by using DbContextOptionsBuilder. E.g. options.UseSqlServer(connection, b => b.MigrationsAssembly("ApiVrSolicitacoes")). By default, the migrations assembly is the assembly containing the DbContext.
Change your target project to the migrations project by using the Package Manager Console's Default project drop-down list, or by executing "dotnet ef" from the directory containing the migrations project.

Como instalar o VueJS

Nathan Silva — Sat, 02 Mar 2024 21:10:19 +0000

Existem duas formas de instalar o VueJs em uma aplicação. Logo abaixo irei abordar os dois possíveis jeitos de fazer isso.

CDN

CDN é a sigla para Content Delivery Network. É forma mais comum de ser utilizada em pequenos projetos devido a sua facilidade na instalação.
De forma breve e resumida, o CDN armazena os dados de JavaScript, CSS e imagens referentes ao Vue e os retorna da maneira mais rápida possível.

Como instalar e adicionar o projeto?

Você pode encontrar o passo a passo mais explicativo acessando o site VueJs. Rolando um pouco a gente vai pegar apenas o link principal fornecido e adicionar ao nosso projeto.(Fica tranquilo que eu vou mostrar)

<script src="https://unpkg.com/vue@3/dist/vue.global.js"></script>

Agora vamos ao Visual Studio Code!
Crie um arquivo simples de HTML e adicione o script passado anteriormente

CLI

Esse método de instalação é mais ideial dos dois, pois é possível configurar o projeto de forma rápida e completa de maneira simples.
Primeira coisa ser feita é baixar o NodeJs

Após a instalação, precisamos garantir que está tudo certo com o Node e o Npm. Para isso, abra o CMD e digite os códigos para verificar a versão de instalação de acordo com a imagem.

Agora que já está tudo certo, abra novamente o terminal e digite o seguinte código para instalar o Vue de forma global.

npm install -g @vue/cli

Depois disso é criar um projeto. Entre na pasta desejada, abra o terminal e digite o comando abaixo:

vue create nome_produto

IMPORTANTE. Se for um projeto já criado ou se tiver sido baixado do github bastante digitar o codigo abaixo antes.

npm install

Depois de instalado para rodar o server é só rodar o seguinte código:

npm run serve

Ai é selecionar a versão do Vue e está pronto!
Espero que tenham gostado :)

Como manter o estado de uma tela ao chamar deeplink no xamarin C#

Nathan Silva — Fri, 01 Mar 2024 13:53:53 +0000

O que é deeplink?

De forma resumida, o deeplink são chamadas de aplicativos para outros aplicativos para a realização de ações especificas.
Exemplo: No ifood, quando terminamos de selecionar os nossos produtos e finalizamos com a forma de pagamento Cartao Nubank e finalizamos o aplicativo do banco é aberto já mostrando os valores e informações. Ao fazer o pagamento, o app da nubank retorna ao ifood finalizando assim o pedido.

Problema

Nesse contexto, ao fazer essa chamada para um app externo, pode ser o que o app de origem seja "destruído" e juntamente com ele todas as informações armazenadas em memória. Abaixo eu vou mostrar como podemos manter o estado do aplicativo de origem e retornar ao ponto em que paramos.

Solução 1

Primeiramente vamos ter certeza que de que toda a informação vinda do Bundle está sendo perdida. No método OnCreate na Intent, verifique se o valor do parâmetro está vazio.

Se estiver nulo, vá para a solução 2, caso contrário siga o passo abaixo!

Como ainda estamos com algumas informações do Bundle armazenadas, basta a gente salvar o estado do que quisermos e posteriormente restaurar o estado. Vamos usar o metodo para salvar o estado.

protected override void OnSaveInstanceState(Bundle outState) { base.OnSaveInstanceState(outState); // Salvar os dados da tela no Bundle outState.PutString("MeuValor", meuValor); }

Em seguida, basta chamar o metodo para restaurar esse estado

protected override void OnRestoreInstanceState(Bundle savedInstanceState) { base.OnRestoreInstanceState(savedInstanceState); teste = savedInstanceState.GetString("MeuValor"); }

Solução 2

Se o Bundle está vindo zerado(null) então esta é a solução: Usaremos um artifício de persistência de dados temporárias no dispositivo para armazenar as informações que julgamos importantes.

Adicione o bloco de código abaixo:

protected override void OnSaveInstanceState(Bundle outState) { base.OnSaveInstanceState(outState); // Salvar o valor de "MinhaVariavel" no SharedPreferences GetPreferences(FileCreationMode.Private).Edit().PutString("TextoQualquer", MinhaVariavel).Apply(); }

Neste caso, não será necessário sobrescrever o método OnRestoreInstanceState, mas sim inserir um trecho dentro do OnCreate

MinhaVariavel= GetPreferences(FileCreationMode.Private).GetString("TextoQualquer", "");

Entendendo o que foi feito

O método GetPreferences o Android cria automaticamente um arquivo de preferências compartilhadas para você, associado à atividade atual, ou seja, ele persiste os dados temporariamente. Além disso, caso queira tornar essas informações visíveis a nivel global da aplicação, você pode utilizar o GetSharedPreferences.

Usando o GetSharedPreferences

A sintaxe muda um pouco, o sentido principal ainda é o mesmo.

protected override void OnSaveInstanceState(Bundle outState) { base.OnSaveInstanceState(outState); // Salvar o valor de "MinhaVariavel" no SharedPreferences ISharedPreferencesEditor editor = GetSharedPreferences("MeusEstados", FileCreationMode.Private).Edit(); editor.PutString("stringVariavel", MinhaVariavel); editor.Apply(); }

Agora é só ir no onCreate!

MinhaVariavel = GetSharedPreferences("MeusEstados", FileCreationMode.Private).GetString("stringVariavel", "");

Caso queira saber mais sobre essas diferenças Clique aqui!

Até a próxima! :D