<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Desenvolvimento com Node.js - Medium]]></title>
        <description><![CDATA[Uma série de posts que exploram de forma prática o desenvolvimento de aplicações com o Node.js. - Medium]]></description>
        <link>https://medium.com/desenvolvimento-com-node-js?source=rss----1f88727a121f---4</link>
        <image>
            <url>https://cdn-images-1.medium.com/proxy/1*TGH72Nnw24QL3iV9IOm4VA.png</url>
            <title>Desenvolvimento com Node.js - Medium</title>
            <link>https://medium.com/desenvolvimento-com-node-js?source=rss----1f88727a121f---4</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Wed, 18 Nov 2026 15:31:41 GMT</lastBuildDate>
        <atom:link href="https://medium.com/feed/desenvolvimento-com-node-js" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Testes de integração para aplicações Node.js com Mocha e Chai]]></title>
            <link>https://medium.com/desenvolvimento-com-node-js/testes-de-integra%C3%A7%C3%A3o-para-aplica%C3%A7%C3%B5es-node-js-com-mocha-e-chai-610a1ba15e1b?source=rss----1f88727a121f---4</link>
            <guid isPermaLink="false">https://medium.com/p/610a1ba15e1b</guid>
            <category><![CDATA[nodejs]]></category>
            <category><![CDATA[chai]]></category>
            <category><![CDATA[mocha]]></category>
            <category><![CDATA[integration-testing]]></category>
            <dc:creator><![CDATA[Giuliana Bezerra]]></dc:creator>
            <pubDate>Fri, 31 May 2019 20:16:11 GMT</pubDate>
            <atom:updated>2022-09-25T17:18:53.377Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/348/1*TPgqiC-pFMY_ig-hBoMamw.png" /></figure><p>No ciclo de vida de uma aplicação existem diversas tarefas. Uma das mais importantes é o teste. Afinal, de que adianta programar um sistema se não é possível atestar o seu funcionamento? A melhor forma de checar se um sistema funciona é testando-o, preferencialmente de forma automatizada. Essa automação é possível através da implementação de <strong>Testes de Unidade</strong>. O problema é que <a href="https://www.toptal.com/nodejs/nodejs-guide-integration-tests">esse tipo de teste nem sempre é eficaz</a>, muitas vezes os erros ocorrem durante a integração do sistema com componentes externos. É aí que entram os <a href="https://blog.caelum.com.br/unidade-integracao-ou-sistema-qual-teste-fazer/"><strong>Testes de Integração</strong></a>. Então, como podemos criar esses testes para aplicações Node.js? Para isso vamos utilizar dois módulos: <a href="https://mochajs.org/">Mocha</a> e <a href="https://www.chaijs.com/">Chai</a>.</p><blockquote>💡 Se você ainda acha que testes não são importantes, recomendo a leitura <a href="https://blog.umbler.com/br/qualidade-de-software-1-7-motivos-para-considerar-o-teste-de-software-indispensavel/">desse artigo</a><em>.</em></blockquote><h3>Pré requisitos</h3><p>O leitor precisa estar familiarizado com a linguagem Javascript e o <a href="https://medium.com/@giu.drawer/come%C3%A7ando-a-desenvolver-com-o-node-js-74b70af01a0d">Node.js</a>. Para seguir o tutorial será necessário baixar <a href="https://github.com/giuliana-bezerra/servico-nodejs">esse projeto</a> e iniciá-lo com o comando <em>npm start</em>.</p><h3>Estrutura do Projeto</h3><p>Vamos começar abrindo o <a href="https://github.com/giuliana-bezerra/servico-nodejs">nosso projeto</a> no <a href="https://code.visualstudio.com/">Visual Studio Code</a>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/309/1*gdOmHuKVYnIUKOgKWrSkjw.png" /></figure><p>Iremos criar o diretório <em>test/integration </em>para adicionar os testes de integração:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/308/1*6cExlwV5fhIINX14NDc9dA.png" /></figure><p>Essa é a estrutura necessária para começarmos a implementar os testes de integração no nosso projeto Node.js. Simples, não é mesmo?</p><h3>Mocha como framework de testes</h3><p>O Mocha é um framework de testes que fornece a estrutura necessária para rodar um teste automatizado. Então, como podemos utilizá-lo? Primeiro, precisamos adicioná-lo como dependência do projeto:</p><pre>$ npm install mocha@6.1.4 --save-dev --save-exact</pre><blockquote>💡 O mocha é um módulo para testes utilizado apenas durante o desenvolvimento. Por isso, foi utilizada a opção <em>save-dev</em>. A opção save-exact é para garantir que a versão descrita nesse tutorial será a instalada na sua máquina.</blockquote><p>Feito isso, precisamos implementar o teste de fato. Iremos assumir aqui que o escopo dos testes será o serviço de criação de usuário. Então, vamos criar um arquivo chamado <em>usuario.js </em>dentro do diretório <em>test/integration</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/305/1*GqKgkiYVtNjS4LSkMndkeQ.png" /></figure><p>Precisamos descrever quem será testado, e cada cenário de teste. Para isso, podemos utilizar o código abaixo como template:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/21735c3e6e8eebab87d5c4a3d8636d47/href">https://medium.com/media/21735c3e6e8eebab87d5c4a3d8636d47/href</a></iframe><p>O <em>describe </em>descreve a API testada e cada um dos serviços. Já o <em>it </em>vai descrever cada cenário de teste do serviço descrito. Por exemplo, na nossa API nós definimos que existem os seguintes cenários de execução do serviço de criação de usuário:</p><ol><li>O usuário é cadastrado com sucesso</li><li>O usuário já existe e por isso o sistema irá obtê-lo a partir da sua localização existente</li><li>Os dados de criação do usuário não foram passados corretamente ou são inválidos</li></ol><p>O <em>it</em> recebe como argumento uma função com o parâmetro <em>done</em>. Esse objeto é uma função utilizada para informar ao Mocha quando o teste será concluído. Por isso, foi necessário chamar o <em>done() </em>dentro de cada cenário de teste<em>.</em></p><p>Para finalizar a configuração do Mocha, vamos criar um arquivo <em>mocha.opts </em>dentro do diretório <em>test </em>para informar que existem arquivos de teste dentro de subdiretórios do <em>test</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/546/1*N7ttJqyKb3GXTjc9zvZTNg.png" /></figure><p>Será possível executar o teste criado com o comando abaixo (<strong>lembre de iniciar o projeto com o npm start antes de rodar os testes!</strong>):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/725/1*Q6gVj92gohjHiHlOtg2ZlQ.png" /></figure><p>Podemos adicionar esse comando no <em>package.json </em>e executar os testes apenas com o comando <em>npm test</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/655/1*PFBXHNra7tXKiDc_j5S7jw.png" /></figure><p>Os testes passaram pois nenhuma lógica está sendo avaliada. Precisaremos fazer requisições à API e validar as respostas obtidas. Para isso, vamos utilizar o <a href="https://www.chaijs.com/">Chai</a>.</p><h3>Chai como biblioteca de asserção</h3><p>O Chai é um módulo que possui diversas funções de asserção que permitem validar se os retornos do teste estão de acordo com o esperado. Para utilizá-lo no nosso projeto, vamos primeiro instalá-lo:</p><pre>$ npm install chai@4.2.0 --save-dev --save-exact</pre><p>Agora, vamos começar a implementar os cenários de teste utilizando o Chai. O primeiro cenário descreve uma situação em que o usuário é criado com sucesso. Isso significa que o serviço é chamado com todos os dados necessários para criar um usuário válido. Vamos então descrever esses dados válidos num arquivo <a href="https://www.json.org/json-pt.html">JSON</a> chamado <em>data.json</em>,<em> </em>criado no diretório <em>test/integration</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0784913b330df9ffd3902ebf97e2bcba/href">https://medium.com/media/0784913b330df9ffd3902ebf97e2bcba/href</a></iframe><p>Vamos importar esse arquivo no teste para que seja possível utilizar esse dado:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/987cbf2e5f5f9e4f7c3344a6e9f9b344/href">https://medium.com/media/987cbf2e5f5f9e4f7c3344a6e9f9b344/href</a></iframe><p>Para fazer uma chamada POST à API, vamos precisar de um cliente HTTP. O Chai também provê um cliente através do módulo <a href="https://www.chaijs.com/plugins/chai-http/">chai-http</a>:</p><pre>$ npm install chai-http@4.3.0 --save-dev --save-exact</pre><p>Agora vamos fazer a chamada à API utilizando esse módulo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/f9f01f9be57af4b4100622cd1c1534f9/href">https://medium.com/media/f9f01f9be57af4b4100622cd1c1534f9/href</a></iframe><p>A primeira coisa que fizemos foi importar os módulos <em>chai</em> e <em>chai-http</em>. Para utilizar o <em>chai-http</em>, é necessário utilizar a função <em>use </em>do objeto <em>chai</em>. Também utilizamos a função <em>should </em>para ter acesso as operações desse estilo de assertiva. Feitas as importações, a chamada à API é bastante simples. A partir do objeto <em>chai </em>é feita<em> </em>uma<em> request </em>com o método <em>post </em>enviando como corpo da requisição um <em>USUARIO_VALIDO</em>. A resposta é tratada pela função <em>end</em>, que recebe como argumento um objeto de erro e a resposta. O que declaramos dentro dessa função são as assertivas de como esperamos que a nossa API funcione. O que dissemos no teste desse cenário foi:</p><ol><li>Não deve haver erros</li><li>A resposta deve ter um corpo</li><li>O código retornado deve ser 201</li><li>O corpo deve ter uma propriedade <em>error </em>igual a <em>0</em></li><li>O corpo da resposta deve estar no seguinte formato:</li></ol><pre>{&quot;error&quot;:0,&quot;payload&quot;:{&quot;comments&quot;:{&quot;nome&quot;:&quot;Rachel Green&quot;,&quot;_id&quot;:&quot;&lt;Alguma coisa&gt;&quot;}}}</pre><p>A implementação desse cenário foi concluída. Vamos executar os testes e verificar se estão passando:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/674/1*_lwdFZEhHiz_lZVstNmxqQ.png" /></figure><p>Para visualizar o cenário em que o teste não passa, vamos modificar o serviço de criação do usuário (localizado em controllers/usuario/create.js) para retornar o <em>comments </em>vazio:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0e60973cfd5694c06776ff9a062cf019/href">https://medium.com/media/0e60973cfd5694c06776ff9a062cf019/href</a></iframe><p>Salve o arquivo e execute os testes novamente:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/682/1*A3eF5OfcudhmvTnMmyx8yw.png" /></figure><p>O log informa claramente que o teste 1 falhou pois era esperado que um objeto vazio tivesse a propriedade <em>_id</em>.</p><h3>Conclusão</h3><p>Nesse post vimos como elaborar testes de integração para projetos Node.js utilizando os módulos Mocha e Chai. A documentação de ambos é excelente e pode servir de guia durante a implementação dos testes. Como exercício, eu deixo a implementação dos outros dois cenários de teste que não foram cobertos. Afinal, a prática leva a perfeição!</p><p>Se você gosta do meu conteúdo, não deixe de conferir o meu <a href="https://shorturl.at/hkmY6">canal do Youtube</a>, onde falo sobre desenvolvimento de software. Espero te ver por lá! 😉</p><h3>Referências</h3><ul><li><a href="https://mochajs.org/">Documentação do Mocha</a></li><li><a href="https://www.chaijs.com/">Documentação do Chai</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=610a1ba15e1b" width="1" height="1" alt=""><hr><p><a href="https://medium.com/desenvolvimento-com-node-js/testes-de-integra%C3%A7%C3%A3o-para-aplica%C3%A7%C3%B5es-node-js-com-mocha-e-chai-610a1ba15e1b">Testes de integração para aplicações Node.js com Mocha e Chai</a> was originally published in <a href="https://medium.com/desenvolvimento-com-node-js">Desenvolvimento com Node.js</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Debugando uma aplicação Node.js]]></title>
            <link>https://medium.com/desenvolvimento-com-node-js/debugando-uma-aplicacao-node-js-7b82fba396ec?source=rss----1f88727a121f---4</link>
            <guid isPermaLink="false">https://medium.com/p/7b82fba396ec</guid>
            <category><![CDATA[vscode]]></category>
            <category><![CDATA[debugging]]></category>
            <category><![CDATA[nodejs]]></category>
            <dc:creator><![CDATA[Giuliana Bezerra]]></dc:creator>
            <pubDate>Fri, 31 May 2019 15:34:04 GMT</pubDate>
            <atom:updated>2022-09-25T17:28:25.038Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/600/1*EEC-VNz6OKbC2_SFXGLiUg.jpeg" /></figure><p>Debugar é tão importante quanto codificar. Muita vezes, é até uma tarefa mais demorada do que o próprio desenvolvimento. Se nenhuma ferramenta que facilite esse trabalho for utilizada, o processo de debug pode ser doloroso e traumatizante.</p><p>Muitos desenvolvedores Node.js debugam o seu código backend da seguinte forma:</p><pre>console.log(&#39;Var 1:&#39; + var1);<br>...<br>console.log(&#39;Aqui deu erro&#39;);<br>...<br>console.log(&#39;Entrou aqui!&#39;);</pre><p>É muito comum encontrar no código de produção esses logs de teste, visto que o desenvolvedor adicionará inúmeros para tentar validar um comportamento ou identificar um erro.</p><p>Mas fique tranquilo, existe uma forma melhor! E para isso vamos utilizar a ferramenta de Debug do <a href="https://code.visualstudio.com/">Visual Studio Code</a>. Nesse post vamos configurar o Debug num projeto Node.js para inspecionar o retorno de um serviço REST.</p><blockquote><em>💡 </em>Você sabe de onde veio o termo bug e o que ele é? Veja <a href="https://www.techtudo.com.br/noticias/2019/01/o-que-e-bug-entenda-a-origem-da-palavra-e-conheca-exemplos.ghtml">esse artigo</a>.</blockquote><h3>Pré requisitos</h3><p>É importante que o leitor tenha experiência com o Node.js na <a href="https://medium.com/desenvolvimento-com-node-js/criando-servicos-com-nodejs-432c11b5d50d">construção de serviços</a>. Também é necessário baixar <a href="https://github.com/giuliana-bezerra/servico-nodejs">esse projeto</a> para utilizarmos no processo de debug.</p><h3>Habilitando o debug</h3><p>Abra o <a href="https://github.com/giuliana-bezerra/servico-nodejs">projeto</a> no Visual Studio Code:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/675/1*wF_vCo-UxduD172iDAsVgg.png" /></figure><p>Veja que existe um menu lateral com um inseto (bug). Clique nele para configurar a depuração:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/668/1*ImIH-EdzbxeUVPpfxMMDTg.png" /></figure><p>O Visual Studio Code precisa de uma arquivo de configuração para configurar o debug. Para isso, clique na engrenagem para “Configurar ou corrigir launch.json”:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/849/1*PbsvgblTWCBqxi_RkcqQ9A.png" /></figure><p>É necessário informar o ambiente de debug. No nosso caso, vamos selecionar o <em>Node.js</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*AwYRKNmszVsMuKLReKZv9Q.png" /></figure><p>Será criado um arquivo <em>launch.json</em> que configura os parâmetros de debug para o projeto. Vamos manter o arquivo com as opções mais básicas, que já foram geradas por padrão. Só precisamos corrigir o parâmetro <em>program</em>, pois o nosso programa é iniciado com o arquivo <em>server.js</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e7e5c9d88875125c6fe7582ff69ec9d7/href">https://medium.com/media/e7e5c9d88875125c6fe7582ff69ec9d7/href</a></iframe><p>Volte ao menu do debug e pressione o botão verde <em>Iniciar Depuração</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uyKijOPO1EtiTefW9zQrRw.png" /></figure><h3>Debugando o projeto</h3><p>Com o debug executando, vamos utilizá-lo para inspecionar os dados retornados pelo serviço de criação de usuário. Para isso, abra o arquivo <em>create.js </em>e adicione um <em>breakpoint </em>passando o mouse ao lado dos números de linha do arquivo e clicando com o botão esquerdo para visualizar um marcador vermelho:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PHfx1R486ruRgxwI0kvzQg.png" /></figure><p>Agora só precisamos chamar o serviço para executar essa função. Vou utilizar aqui o <em>curl</em> no terminal, por questões de simplicidade:</p><pre>$ curl -XPOST -H &#39;Content-Type: application/json&#39; <a href="http://localhost:9999/api/usuario">http://localhost:9999/api/usuario</a> -d &#39;{&quot;nome&quot;:&quot;Phoebe Buffay&quot;}&#39; -v</pre><pre>Note: Unnecessary use of -X or --request, POST is already inferred.<br>*   Trying 127.0.0.1...<br>* TCP_NODELAY set<br>* Connected to localhost (127.0.0.1) port 9999 (#0)<br>&gt; POST /api/usuario HTTP/1.1<br>&gt; Host: localhost:9999<br>&gt; User-Agent: curl/7.58.0<br>&gt; Accept: */*<br>&gt; Content-Type: application/json<br>&gt; Content-Length: 24<br>&gt; <br>* upload completely sent off: 24 out of 24 bytes</pre><p>O Visual Studio Code vai aparecer para você exatamente no breakpoint que você selecionou:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/719/1*ppeADeSVFkZvISWpc9UCSA.png" /></figure><p>Se você passar o mouse em cima das variáveis, será possível inspecionar os seus valores atuais:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/664/1*6l-aEiOZecppd6rHy2oHWw.png" /></figure><p>Você pode executar passo a passo o código utilizando as setas azuis de navegação no topo da tela:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/662/1*J0qV4bGM2F6bVKg7Ka_9VA.png" /></figure><p>Você também pode selecionar uma expressão e executá-la clicando com o botão direito do mouse, menu <em>Depurar: Avaliar</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/664/1*ZyltQ1L3bLiYdd-CvEyXiA.png" /></figure><h3>Conclusão</h3><p>Esse post demonstrou de forma simples como configurar e utilizar a ferramenta de debug do Visual Studio Code para depurar programas Node.js no seu dia a dia.</p><p>É interessante que você explore as outras features dessa ferramenta até se sentir confortável com ela. Você vai perceber como o seu debug de projetos Node.js será mais eficiente.</p><p>Se você gosta do meu conteúdo, não deixe de conferir o meu <a href="https://shorturl.at/hkmY6">canal do Youtube</a>, onde falo sobre desenvolvimento de software. Espero te ver por lá! 😉</p><h3>Referências</h3><ul><li><a href="https://code.visualstudio.com/docs/editor/debugging">https://code.visualstudio.com/docs/editor/debugging</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7b82fba396ec" width="1" height="1" alt=""><hr><p><a href="https://medium.com/desenvolvimento-com-node-js/debugando-uma-aplicacao-node-js-7b82fba396ec">Debugando uma aplicação Node.js</a> was originally published in <a href="https://medium.com/desenvolvimento-com-node-js">Desenvolvimento com Node.js</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Upload de imagem com o Node.js]]></title>
            <link>https://medium.com/desenvolvimento-com-node-js/upload-de-imagem-com-o-node-js-3c0fff6c6c61?source=rss----1f88727a121f---4</link>
            <guid isPermaLink="false">https://medium.com/p/3c0fff6c6c61</guid>
            <category><![CDATA[expressjs]]></category>
            <category><![CDATA[image]]></category>
            <category><![CDATA[nodejs]]></category>
            <category><![CDATA[multer]]></category>
            <category><![CDATA[upload]]></category>
            <dc:creator><![CDATA[Giuliana Bezerra]]></dc:creator>
            <pubDate>Fri, 31 May 2019 13:11:53 GMT</pubDate>
            <atom:updated>2022-09-25T17:08:47.902Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/620/1*5kd9w2w1JgwMu58xipM_VQ.png" /></figure><p>Quem nunca precisou desenvolver um sistema que suporte upload de imagem? Um exemplo comum é permitir ao usuário que adicione um avatar dele no sistema. Eu tive essa necessidade recentemente e encontrei algumas dificuldades para desenvolver essa <em>feature </em>simples. Existem várias soluções para esse problema, e por isso tive o trabalho de avaliar cada uma delas. Com base nas minhas pesquisas, resolvi elaborar esse post para apresentar uma solução que eu julgo a mais adequada. Iremos construir um serviço de upload de avatares e um frontend simples para testar esse upload.</p><p>Se você ainda não leu o meu post sobre <a href="https://medium.com/@giu.drawer/criando-servicos-com-nodejs-432c11b5d50d">desenvolvimento de serviços com o Node.js</a>, recomendo a leitura antes de prosseguir.</p><p><strong>Disclaimer: Por questões de simplicidade, nesse post o upload será para um <em>storage</em> local e não um de terceiros (</strong><a href="https://aws.amazon.com/pt/media-sharing/"><strong>amazon</strong></a><strong>, </strong><a href="https://cloudinary.com/"><strong>cloudinary</strong></a><strong>…). Apesar disso, a solução poderá ser facilmente adaptada para esses storages.</strong></p><h3>Requisitos</h3><p>O leitor deve estar familiarizado com a <a href="https://medium.com/@giu.drawer/criando-servicos-com-nodejs-432c11b5d50d">construção de serviços com o Node.js</a> e Javascript.</p><h3>Configuração</h3><p>É necessário instalar o <a href="https://nodejs.org/en/download/">Node.js</a> e o <a href="https://code.visualstudio.com/">Visual Studio Code</a> (pode ser outro editor) para prosseguir.</p><h3>Criação do Projeto Backend</h3><p>Vamos criar um projeto chamado <strong>Upload Avatar Backend</strong>, que irá conter apenas o serviço de upload de avatar. Para isso, vamos definir a seguinte estrutura:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/178/1*K1EUsJlmU-o7m5WdOuc1ew.png" /><figcaption>Estrutura do projeto Upload Avatar Backend.</figcaption></figure><p>Vamos utilizar as dependências básicas de um projeto <em>Node.js</em> com <em>Express</em>,<em> </em>e uma dependência nova, que será discutida mais a frente:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7900e9423b4485934f8d0375a11444fd/href">https://medium.com/media/7900e9423b4485934f8d0375a11444fd/href</a></iframe><p>O arquivo server.js irá apenas chamar o <em>app.js</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a0c3a7fab748fe17a9603da4bdba459e/href">https://medium.com/media/a0c3a7fab748fe17a9603da4bdba459e/href</a></iframe><p>O <em>app.js </em>irá de fato iniciar o nosso serviço. O que é necessário fazer é apenas definir a rota do serviço de upload que iremos construir:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/e9073ad90a316ca85316a7a46b9e7453/href">https://medium.com/media/e9073ad90a316ca85316a7a46b9e7453/href</a></iframe><blockquote><em>💡 </em>A habilitação do <a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Controle_Acesso_CORS">CORS</a> é necessária para o nosso teste local pois tanto o frontend como o backend estarão rodando na mesma máquina, com o mesmo IP. Dessa forma, é necessário desabilitar essa segurança para testar a nossa aplicação. No ambiente produtivo, se as aplicações precisassem ficar na mesma máquina (incomum) seria adicionado o IP da máquina ao invés do * no header Access-Control-Allow-Origin.</blockquote><p>Para configurar a rota, vamos adicionar na pasta <em>routes </em>o arquivo <em>index.js</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a08770db95e3438934997f7b176afb90/href">https://medium.com/media/a08770db95e3438934997f7b176afb90/href</a></iframe><p>Foi definida uma rota para <em>/api</em>, então precisamos adicionar dentro de <em>routes</em> a pasta <em>api </em>com o arquivo<em> index.js</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/de82019416d48822a280554cf5525414/href">https://medium.com/media/de82019416d48822a280554cf5525414/href</a></iframe><p>Como o recurso manipulado será um avatar, vamos criar dentro de <em>api </em>uma pasta <em>avatar</em> que irá conter um arquivo <em>index.js </em>que configura a operação de upload:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/eaf2b2d4fe9a8e2aee75e3ac65dee3e6/href">https://medium.com/media/eaf2b2d4fe9a8e2aee75e3ac65dee3e6/href</a></iframe><blockquote><em>💡</em>A boa prática aqui é apenas chamar um controller com a operação, separando assim a lógica da operação da definição da rota.</blockquote><p>A operação será definida no <em>controller</em> de gravação, que deverá ser criado em <em>/controllers/avatar/record.js</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b23e9d144e11aa50a45d66cff4806e0f/href">https://medium.com/media/b23e9d144e11aa50a45d66cff4806e0f/href</a></iframe><p>Aqui é que mora a solução de fato. Para armazenar os arquivos, vamos utilizar a biblioteca <a href="https://www.npmjs.com/package/multer"><em>multer</em></a>,<em> </em>que sabe lidar com dados binários de imagem (<em>multipart/form-data</em>). No <em>multer</em>, tudo que você precisa é informar o diretório onde as imagens serão armazenadas, no meu caso eu escolhi o <em>public/uploads</em>. O <em>single </em>vai receber o formulário contendo a imagem, com o identificador <em>avatar </em>e salvá-la no diretório de destino especificado. Para que o <em>frontend</em> consiga referenciar a imagem é retornada uma URL com a sua localização. Simples, não é?</p><p>O problema é que o servidor não está “servindo” a pasta que contém as imagens, ele apenas configura as rotas. Para adicionar esse configuração é necessária apenas uma linha no nosso arquivo <em>app.js</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/cb6a997c8260af1b1574882b0000628a/href">https://medium.com/media/cb6a997c8260af1b1574882b0000628a/href</a></iframe><p>Com essa mudança, se quisermos acessar uma imagem do backend é necessário apenas utilizar o endereço <a href="http://localhost:7755/public/uploads/nomedaimagem.extensao."><em>http://localhost:7755/public/uploads/nomedaimagem</em>.</a></p><blockquote><em>💡</em>Você deve ter se perguntado: por que o serviço não salvou a imagem no banco de dados?</blockquote><blockquote>Essa era uma estratégia comumente utilizada para manipular arquivos binários, mas essa solução se torna impraticável a longo prazo visto que o tamanho do arquivo é grande e isso prejudica o desempenho da base de dados. A estratégia ideal é salvar uma URL para a imagem e referenciá-la no frontend. Assim, apenas uma String é salva na base, o que não compromete o desempenho da aplicação.</blockquote><h3>Criação do Projeto Frontend</h3><p>Essa é a parte mais simples e não é o foco desse artigo. O <em>frontend</em> criado aqui servirá apenas para testar a nossa solução de upload, do ponto de vista do cliente do serviço.</p><p>A estrutura do projeto é praticamente a mesma, com a diferença de não haver rotas:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/182/1*8php-62_6WCBIhDGQL5Ajw.png" /><figcaption>Estrutura do projeto Upload Avatar Frontend.</figcaption></figure><p>A única dependência do projeto é o <em>Express</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/1ec2f19db36992fca8b767cb2c472bb1/href">https://medium.com/media/1ec2f19db36992fca8b767cb2c472bb1/href</a></iframe><p>O arquivo <em>server.js </em>chama o <em>app.js</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a0c3a7fab748fe17a9603da4bdba459e/href">https://medium.com/media/a0c3a7fab748fe17a9603da4bdba459e/href</a></iframe><p>O <em>app.js </em>irá disponibilizar a página HTML que permitirá o upload do avatar:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0f68e38bf3ef0f77fe6cf87b77220aa4/href">https://medium.com/media/0f68e38bf3ef0f77fe6cf87b77220aa4/href</a></iframe><p>Agora só falta criar a página <em>index.html </em>dentro da pasta <em>public</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/d544115b33f6e3acec7c0827197ae608/href">https://medium.com/media/d544115b33f6e3acec7c0827197ae608/href</a></iframe><p>A página contém apenas o formulário de upload. A lógica do <em>submit</em> é disparada pelo <em>listener </em>que passa como <em>payload</em> para o nosso serviço <em>backend</em> um formulário do tipo <em>multipart</em>/<em>form-data </em>contendo o arquivo que foi carregado com o identificador <em>avatar</em>.</p><blockquote><em>💡</em>O identificador “avatar” deverá ser usado no backend pelo método single do multer. É importante que os identificadores estejam iguais, caso contrário o multer não irá encontrar o arquivo da imagem na requisição.</blockquote><h3>Testando</h3><p>Suba os dois projetos com o comando <em>npm start </em>e acesse o endereço do <em>frontend</em>: <a href="http://localhost:7756:"><em>http://localhost:7756</em></a>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/319/1*_PBYs31awbcp6N5kZ4nmTQ.png" /></figure><p>Informe um arquivo e pressione <em>Upload</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/327/1*xPqDwIH2EP8svIJZ7rSQNw.png" /></figure><p>Veja que a imagem é carregada! Se você inspecionar a imagem (botão direito do mouse em cima da imagem -&gt; Inspecionar), verá que o <em>src</em> está apontando para a URL gerada para o avatar, que está sendo provida pelo servidor backend:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/756/1*KztFAymTQ4hKnLq0JPNIPw.png" /></figure><h3>Conclusão</h3><p>Vimos nesse post como construir um serviço de upload de avatares/imagens usando o Node.js. Nosso serviço armazena a imagem localmente e disponibiliza a mesma através de uma URL.</p><p>É possível estender essa implementação utilizando outros tipos de armazenamento, que são suportados pelo multer, caso seja interessante utilizar um <em>storage</em> pago, por exemplo. O importante aqui foi mostrar o caso mais simples, para que o leitor seja capaz de adaptar a solução conforme desejado.</p><p>Se você gosta do meu conteúdo, não deixe de conferir o meu <a href="https://shorturl.at/hkmY6">canal do Youtube</a>, onde falo sobre desenvolvimento de software. Espero te ver por lá! 😉</p><h3>Referências</h3><ul><li>Projeto Backend: <a href="https://github.com/giuliana-bezerra/upload-avatar-backend">https://github.com/giuliana-bezerra/upload-avatar-backend</a></li><li>Projeto Frontend: <a href="https://github.com/giuliana-bezerra/upload-avatar-frontend">https://github.com/giuliana-bezerra/upload-avatar-frontend</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3c0fff6c6c61" width="1" height="1" alt=""><hr><p><a href="https://medium.com/desenvolvimento-com-node-js/upload-de-imagem-com-o-node-js-3c0fff6c6c61">Upload de imagem com o Node.js</a> was originally published in <a href="https://medium.com/desenvolvimento-com-node-js">Desenvolvimento com Node.js</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Express para gerenciamento de rotas no Node.js]]></title>
            <link>https://medium.com/desenvolvimento-com-node-js/express-para-gerenciamento-de-rotas-no-node-js-10dc7600adb1?source=rss----1f88727a121f---4</link>
            <guid isPermaLink="false">https://medium.com/p/10dc7600adb1</guid>
            <category><![CDATA[nodejs]]></category>
            <category><![CDATA[routing]]></category>
            <category><![CDATA[expressjs]]></category>
            <category><![CDATA[javascript]]></category>
            <dc:creator><![CDATA[Giuliana Bezerra]]></dc:creator>
            <pubDate>Fri, 31 May 2019 13:03:26 GMT</pubDate>
            <atom:updated>2022-09-25T17:07:37.782Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5iBRAzvciOL9dBtzuhIcOA.png" /></figure><p>Todo container web precisa ser capaz de responder adequadamente a uma requisição de usuário. Essa resposta depende do caminho digitado no navegador (URL). Cada caminho irá direcionar o usuário para uma página específica ou executar uma operação específica no servidor. Esse gerenciamento dos caminhos, ou rotas, disponíveis na aplicação é chamado de <strong><em>roteamento</em></strong>.</p><p>No <a href="https://medium.com/@giu.drawer/come%C3%A7ando-a-desenvolver-com-o-node-js-74b70af01a0d">Node.js</a>, esse controle pode ser feito utilizando um código Javascript semelhante ao código abaixo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/bba7bb58920ac6fbe7a5e493de2f9d6a/href">https://medium.com/media/bba7bb58920ac6fbe7a5e493de2f9d6a/href</a></iframe><p>Para cada rota disponível, é feito um condicional que carrega o código HTML respectivo daquela rota. Dá para perceber que essa estratégia não é das melhores, já que esse código tende a crescer bastante e será complexo de manter com tantos <a href="https://www.treinaweb.com.br/blog/complexidade-ciclomatica-analise-estatica-e-refatoracao/">caminhos alternativos</a>. É para resolver esse problema de forma mais elegante que iremos utilizar o módulo <a href="https://expressjs.com/"><strong>Express</strong></a>:</p><blockquote>O Express é um framework web projetado para construir aplicações e APIS.</blockquote><p>Nesse post iremos utilizar o Express para construir um projeto Node.js configurando as rotas da aplicação.</p><h3>Pré requisitos</h3><p>Recomendo a leitura <a href="https://medium.com/@giu.drawer/come%C3%A7ando-a-desenvolver-com-o-node-js-74b70af01a0d">desse post</a> para introdução ao Node.js e configuração do ambiente.</p><h3>Criação do Projeto</h3><p>O processo de criação de projetos é muito simples. Quando você instala o Node.js, você também instala o seu gerenciador de pacotes, que é o famoso <strong>npm</strong>. É com ele que iremos criar o projeto no diretório <em>projetoexpress</em>, através do comando abaixo (digite no terminal de sua preferência):</p><pre>$ mkdir projetoexpress &amp;&amp; cd projetoexpress<br>$ npm init</pre><blockquote>💡 Nesse post, os comandos utilizados no terminal são compatíveis com o bash do Ubuntu. Se você utiliza o Windows, sugiro a utilização de um <a href="https://www.felipefialho.com/blog/2017/usando-o-terminal-do-linux-no-windows">terminal compatível</a>.</blockquote><p>O <em>npm </em>irá solicitar algumas informações sobre o projeto, é necessário preenchê-las conforme forem sendo requisitadas. Caso queira manter as definições padrão, é só apertar <strong>Enter</strong> para todas as opções:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/930/1*0K5GoHxLwqvbapiK0RbuCw.png" /></figure><p>O comando irá criar um arquivo chamado <em>package.json</em>, que irá conter os metadados do projeto e suas dependências.</p><h3>Instalação do Express</h3><p>Vamos utilizar o <em>npm </em>para instalar o Express no nosso projeto Node.js. Para isso, execute o comando abaixo na pasta <em>projetoexpress</em>:</p><pre>$ npm install express@4.17.1 --save-exact</pre><p>Esse comando instala o módulo <strong><em>Express</em></strong><em> </em>na versão exata <strong><em>4.17.1</em></strong> e salva essa informação no arquivo <strong><em>package.json</em></strong>. Isso é importante pois se outro desenvolvedor baixar o nosso projeto ele precisa instalar as dependências utilizando o arquivo <em>package.json </em>(isso é feito apenas executando o <em>npm install </em>no diretório do arquivo <em>package.json</em>). Mas como é que o npm instala as dependências? Ele simplesmente cria um diretório chamado <em>node_modules </em>e coloca nele todo o código javascript das dependências do projeto, tanto as diretas como as transitivas (dependências das dependências).</p><blockquote>💡 Você deve ter observado que foi criado um arquivo chamado package-lock.json como resultado da operação de install. Esse arquivo mantém as versões instaladas de cada dependência. Isso evita problemas de compatibilidade em casos nos quais as versões das dependências no package não sejam especificadas precisamente. Para saber mais sobre esse arquivo, recomendo a leitura <a href="https://medium.com/trainingcenter/tudo-que-voc%C3%AA-queria-saber-sobre-o-package-lock-json-mas-estava-com-vergonha-de-perguntar-e70589f2855f">desse post</a>.</blockquote><blockquote>💡 O diretório node_modules é criado pelo npm install de acordo com o seu sistema operacional. Por isso, ao compartilhar projetos é comum excluir esse diretório, visto que o projeto pode não funcionar em diferentes plataformas. O procedimento correto é que o usuário baixe o projeto sem o diretório node_modules e execute o comando npm install para que as dependências sejam baixadas de acordo com o seu sistema operacional.</blockquote><h3>Estrutura do Projeto</h3><p>Nosso projeto Node.js terá a seguinte estrutura:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/300/1*dsVRGsrOUGFDPrx0_ewjdw.png" /></figure><p>O diretório <em>src </em>irá conter o código fonte da aplicação contido no subdiretório <em>app</em>, e as configurações no subdiretório <em>config</em>. O arquivo <em>server.js </em>será o arquivo que criará o servidor da aplicação.</p><h3>Configuração do servidor Express</h3><p>Vamos agora utilizar o Express de fato! Ele será configurado no arquivo <em>server.js</em>, e o primeiro passo é adicionar o código que utiliza esse módulo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5c0c0f1978b6c24eb8c6b16dd4046c21/href">https://medium.com/media/5c0c0f1978b6c24eb8c6b16dd4046c21/href</a></iframe><p>Esse módulo retorna uma função, e por isso temos que invocá-la para configurar a aplicação:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0607d837e1bb3156494737c9c134fff3/href">https://medium.com/media/0607d837e1bb3156494737c9c134fff3/href</a></iframe><p>Falta um detalhe. É necessário informar em qual porta o Express irá escutar requisições, e isso é feito utilizando a função <em>listen</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a6d167ce98aed23fc908d87ba017c2e6/href">https://medium.com/media/a6d167ce98aed23fc908d87ba017c2e6/href</a></iframe><p>A função <em>listen </em>pode receber uma função como argumento que pode ser usada para informar ao desenvolvedor que o servidor foi iniciado com sucesso. Podemos fazer isso modificando o código da seguinte forma:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/fd0f2918b7ce3a25c4ecac3186155c96/href">https://medium.com/media/fd0f2918b7ce3a25c4ecac3186155c96/href</a></iframe><p>Agora, inicie o servidor com o comando abaixo e observe a mensagem exibida:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/658/1*mUiuGGIiHzxYT0Q0XgKydQ.png" /></figure><h3>Configurando uma rota</h3><p>Até agora nós apenas criamos um servidor Express, que escuta requisições na porta 3000. O problema é que ainda não dissemos o que ele deve fazer quando receber uma requisição. Essa configuração é feita declarando rotas na nossa aplicação e adicionando uma lógica de execução para cada uma dessas rotas.</p><p>Vamos então definir uma rota padrão para a aplicação, que é a rota “/” (é ativada ao digitar o <a href="http://localhost:3000).">http://localhost:3000).</a> Isso será feito através do objeto <em>app</em>, que contém um método para cada <a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Methods">verbo HTTP</a>. Como a operação GET é por padrão disparada ao digitar um endereço no navegador, vamos configurar a rota com esse verbo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/843d20f8ffe64c6ba8972d94a20541d1/href">https://medium.com/media/843d20f8ffe64c6ba8972d94a20541d1/href</a></iframe><p>O <em>get </em>recebe uma <a href="https://developer.mozilla.org/pt-BR/docs/Glossario/Callback_function">função callback</a> como parâmetro, que irá configurar a resposta através do parâmetro <em>res </em>(abreviação de response). Esse parâmetro possui a operação <em>send, </em>que irá receber o HTML que deve ser retornado quando a rota for requisitada.</p><p>Inicie ou reinicie o servidor (utilize o comando <em>npm start </em>no terminal) e acesse o endereço dessa rota no seu navegador:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/308/1*N8IhRjWK1o4PClSXFRC63Q.png" /></figure><blockquote>💡 O comando npm start é utilizado para iniciar um projeto Node.js. Por padrão, executar esse comando significa executar o comando: node server.js. Também é possível <a href="https://docs.npmjs.com/misc/scripts">configurar um script de inicialização diferente no arquivo package.json</a>.</blockquote><h3>Utilizando o Router</h3><p>No nosso exemplo definimos uma rota dentro do arquivo <em>server.js</em>. O projeto funciona, mas semanticamente está confuso. O propósito do arquivo <em>server.js </em>é apenas criar o servidor, e não configurar as suas rotas. Isso deve ser feito em outro contexto, por questões de boas práticas. Com essa finalidade, vamos então criar um contexto adequado para a configuração das rotas utilizando a feature de <strong>módulos</strong> do Node.js.</p><p>A função <strong><em>require</em></strong><em> </em>permite a utilização de diferentes módulos dentro do nosso projeto. Mas e para os códigos internos que desenvolvemos, como podemos reutilizá-los no próprio projeto? Vamos entender como isso funciona analisando o nosso arquivo <em>server.js</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/0607d837e1bb3156494737c9c134fff3/href">https://medium.com/media/0607d837e1bb3156494737c9c134fff3/href</a></iframe><p>As linhas acima fazem duas coisas: importam o módulo Express e chamam a função que retorna o app. Sempre que precisarmos utilizar o Express, vamos ter que escrever essas duas linhas. Para encapsular essa lógica de configuração do Express, vamos criar um módulo que executa essas operações. Isso será feito criando um arquivo chamado <em>custom-express.js </em>na pasta <em>config </em>do projeto:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/24c0d93851689792ff20969437e54582/href">https://medium.com/media/24c0d93851689792ff20969437e54582/href</a></iframe><p>Veja que copiamos as duas linhas mas isso não foi suficiente. Para exportar a variável <em>app, </em>que precisa ser utilizada para configurar o servidor, é necessário utilizar o <strong><em>module.exports</em></strong>. Isso faz com que a importação desse módulo retorne o objeto <em>app</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c0ef0b1d5d00a10338f530bd2af0382e/href">https://medium.com/media/c0ef0b1d5d00a10338f530bd2af0382e/href</a></iframe><p>Veja que foi simples modificar o arquivo <em>server.js</em>, pois será retornado o <em>app </em>construído pelo módulo que criamos. Como o módulo é local, tivemos que passar o caminho completo até ele a partir do diretório do arquivo <em>server.js</em>.</p><p>Agora, vamos deixar esse módulo encarregado de configurar as rotas. Para isso, vamos começar criando um diretório <em>routes </em>dentro do diretório <em>app</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/155/1*6nsUvyymgo9H7ZkGVvI_NA.png" /></figure><p>No diretório <em>routes</em>, vamos adicionar um arquivo <em>index.js </em>com o código da rota que tínhamos implementado no arquivo <em>server.js</em>,<em> </em>adicionando algumas pequenas modificações:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/516dc7320c51f7be3c241a0a58a844a4/href">https://medium.com/media/516dc7320c51f7be3c241a0a58a844a4/href</a></iframe><p>A primeira mudança notável foi na primeira linha onde nós utilizamos a classe <a href="https://expressjs.com/pt-br/4x/api.html#router"><em>Router</em></a><em> </em>do módulo Express. Essa classe retorna um roteador que nos permite configurar todas as rotas da nossa aplicação Node.js chamando os métodos respectivos de cada verbo HTTP. No nosso caso, mantivemos o <em>get </em>e o HTML retornado. No final, como já foi explicado, é necessário retornar essas rotas configuradas utilizando o <em>module.exports</em>.</p><p>E agora, onde vamos dizer que essas rotas precisam ser utilizadas? No <em>custom-express.js</em>, que é o nosso módulo customizado da aplicação:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7e81a9576e11d43b0f9fb2e801bc6b45/href">https://medium.com/media/7e81a9576e11d43b0f9fb2e801bc6b45/href</a></iframe><p>Utilizamos o método <em>use </em>para utilizar as rotas declaradas em <em>routes. </em>Esse método permite que nós reusemos as rotas declaradas em outros lugares do nosso projeto. Assim conseguimos separar as responsabilidades em seus contextos específicos.</p><p>Nossa solução evoluiu bastante, mas falta um detalhe. Vamos voltar ao <em>index.js </em>do <em>routes</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/516dc7320c51f7be3c241a0a58a844a4/href">https://medium.com/media/516dc7320c51f7be3c241a0a58a844a4/href</a></iframe><p>A lógica de retorno da rota está declarada no arquivo de roteamento. O problema é que o <em>index.js </em>está com duas responsabilidades: declarar a rota e a lógica executada. O ideal é que separemos a lógica num objeto específico do tipo <strong><em>controller</em></strong>. Para isso, vamos criar um novo diretório chamado <em>controllers </em>no projeto:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/165/1*vYhMV376-t-jJqMe_kd-8A.png" /></figure><p>Nessa pasta, vamos criar um arquivo chamado <em>get.js </em>para adicionar a lógica de retorno das requisições para o endereço / (endereço padrão):</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/175ba76233fd766c3b1e856c5073ec29/href">https://medium.com/media/175ba76233fd766c3b1e856c5073ec29/href</a></iframe><p>Nós exportamos uma função que retorna o HTML padrão para requisições no endereço /. Agora, vamos usar esse controlador no nosso <em>index.js </em>do <em>routes</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/2786694a04e291d7569ba7a84ceaddaf/href">https://medium.com/media/2786694a04e291d7569ba7a84ceaddaf/href</a></iframe><p>O nosso projeto está pronto, de acordo com as boas práticas, e pode ser testado reiniciando o servidor (<em>npm start</em>):</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/308/1*N8IhRjWK1o4PClSXFRC63Q.png" /></figure><h3>Conclusão</h3><p>Nesse post, vimos como construir uma aplicação Node.js utilizando o Express para o gerenciamento de rotas. Nós evoluímos nossa solução para a adoção de boas práticas de desenvolvimento visando melhorar a manutenibilidade do sistema. Com o conteúdo apresentado aqui, espero que você seja capaz de desenvolver suas aplicações Node.js utilizando o Express. Em caso de dúvidas ou sugestões, deixe um comentário!</p><p>Se você gosta do meu conteúdo, não deixe de conferir o meu <a href="https://shorturl.at/hkmY6">canal do Youtube</a>, onde falo sobre desenvolvimento de software. Espero te ver por lá! 😉</p><h3>Referências</h3><ul><li><a href="https://cursos.alura.com.br/course/nodejs-fundamentos">https://cursos.alura.com.br/course/nodejs-fundamentos</a></li><li><a href="https://expressjs.com/pt-br/guide/routing.html">https://expressjs.com/pt-br/guide/routing.html</a></li><li><a href="https://expressjs.com/pt-br/4x/api.html#router">https://expressjs.com/pt-br/4x/api.html#router</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=10dc7600adb1" width="1" height="1" alt=""><hr><p><a href="https://medium.com/desenvolvimento-com-node-js/express-para-gerenciamento-de-rotas-no-node-js-10dc7600adb1">Express para gerenciamento de rotas no Node.js</a> was originally published in <a href="https://medium.com/desenvolvimento-com-node-js">Desenvolvimento com Node.js</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Começando a desenvolver com o Node.js]]></title>
            <link>https://medium.com/desenvolvimento-com-node-js/come%C3%A7ando-a-desenvolver-com-o-node-js-74b70af01a0d?source=rss----1f88727a121f---4</link>
            <guid isPermaLink="false">https://medium.com/p/74b70af01a0d</guid>
            <category><![CDATA[nodejs]]></category>
            <category><![CDATA[web-development]]></category>
            <category><![CDATA[javascript]]></category>
            <dc:creator><![CDATA[Giuliana Bezerra]]></dc:creator>
            <pubDate>Fri, 31 May 2019 13:01:32 GMT</pubDate>
            <atom:updated>2022-09-25T17:18:05.506Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/590/1*fNupPKgIWNxCNy2Gb72eBg.png" /></figure><p>Uma das primeiras coisas que precisamos escolher ao iniciar o desenvolvimento de um projeto web é o servidor que será utilizado. E essa escolha depende, dentre outros fatores, da linguagem de programação que será adotada. Quando essa linguagem é o Javascript, o <a href="https://nodejs.org/en/">Node.js</a> é uma escolha bem comum.</p><blockquote>O Node.js é um container web de execução de código Javascript. Ele é usado para desenvolvermos projetos com Javascript e disponibilizarmos os mesmos na web.</blockquote><p>Mas então, como o Node.js funciona? Vamos esclarecer isso através da prática.</p><h3>Pré requisitos</h3><p>É importante que o leitor possua conhecimento na linguagem Javascript, pois iremos implementar código Javascript para o Node.js executar. Além disso, se você nunca utilizou um container web, recomendo <a href="https://www.escolalinux.com.br/blog/servidor-web-o-que-e-e-como-escolher-um-para-seu-site">essa leitura</a> antes de prosseguir.</p><h3>Instalação</h3><p>A instalação é bem simples. Se você estiver no Windows, basta baixar o instalador no <a href="https://nodejs.org/en/download/">site oficial</a> e executá-lo. Caso você esteja no Linux, como eu, pode utilizar um <a href="https://nodejs.org/en/download/package-manager/">gerenciador de pacotes</a> de acordo com a sua distribuição. Como eu uso o Ubuntu, precisei rodar apenas o seguinte comando:</p><pre>$ curl -fsSL https://deb.nodesource.com/setup_14.x | sudo -E bash -<br>$ sudo apt-get install -y nodejs</pre><pre>$ npm -v <br>6.14.13<br> <br>$ node -v <br>v14.17.1</pre><h3>Alô, mundo</h3><p>Vamos começar com o exemplo mais básico de desenvolvimento. Para isso, utilize o seu editor de texto favorito (o meu é o <a href="https://code.visualstudio.com/">Visual Studio Code</a>) e crie um diretório chamado <em>alomundo </em>contendo um arquivo chamado<em> index.js</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/699/1*njq1ftQgguCeQoOY5VlxuQ.png" /></figure><p>O arquivo <em>index.js </em>é um arquivo que contém um código Javascript (extensão <em>.js</em>). O Node.js será capaz de executar esse código através do seguinte comando (digite no terminal de sua preferência):</p><pre>$ node index.js</pre><pre>Alô, mundo!</pre><p>O que aconteceu? O Node executou o código Javascript no <strong>lado do servidor</strong> (na sua máquina, nesse caso). Esse detalhe é importante pois ao codificar no Node, você não poderá utilizar variáveis e funções que existem no lado do cliente (nos navegadores). Para mostrar isso na prática, vamos modificar o código do <em>index.js </em>adicionando um simples <em>alert</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/637/1*KJHSHdxYU7S1jwULPLTLZw.png" /></figure><p>O resultado da execução será:</p><pre>$ node index.js</pre><pre>ReferenceError: alert is not defined</pre><p>Esse mesmo código executaria em um navegador web pois a função <em>alert</em> existe no contexto do cliente, mas não no servidor Node.js.</p><blockquote>💡 Nesse <a href="https://node.green/">link</a>, é possível verificar as features da linguagem Javascript suportadas em cada versão do Node.js.</blockquote><h3>Configuração do Servidor</h3><p>No exemplo anterior, executamos um código Javascript com o Node.js mas não configuramos essa execução em um servidor. Por isso, o código foi executado e a sua execução no Node.js finalizada. Se quisermos disponibilizar operações na web de forma contínua precisamos configurar um servidor Node.js. Para realizar essa configuração, vamos começar criando um arquivo chamado <em>server.js </em>na raiz do projeto:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/662/1*HwTcAbd8LQrGg43RpuCWQA.png" /></figure><p>Agora precisamos criar o servidor de fato. Poderíamos realizar a nossa própria implementação de um servidor HTTP, mas é bem mais simples utilizar uma implementação existente, concorda? Isso é feito através do uso de módulos.</p><blockquote>Módulos no Node.js são um conjunto de operações e dados que podem ser utilizados por outras aplicações.</blockquote><p>Felizmente o Node.js já disponibiliza por padrão um módulo <em>http</em> que permite criar um servidor. Os módulos no Node.js podem ser utilizados através da função <strong><em>require</em></strong>, que recebe como parâmetro o nome do módulo. Como nós queremos utilizar o módulo <em>http</em>, o código implementado será:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/100ecf48bfc081af265d90dab274d214/href">https://medium.com/media/100ecf48bfc081af265d90dab274d214/href</a></iframe><blockquote>💡 Utilizando módulos podemos empacotar operações e utilizar as mesmas nos nossos projetos, promovendo assim o reuso de código e facilitando o desenvolvimento. Afinal, é bem mais simples utilizar um módulo já desenvolvido e testado para um propósito específico do que criar esse código do zero no seu projeto, não é mesmo?</blockquote><p>Nas versões mais novas do Node.js, podemos utilizar os módulos com a sintaxe do <a href="https://medium.com/@matheusml/o-guia-do-es6-tudo-que-voc%C3%AA-precisa-saber-8c287876325f">ES6</a> e deixar o nosso código aderente as versões mais novas do javascript. Para isso, vamos utilizar o <em>import </em>ao invés do <em>require</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/2cacd39bf3195e7ae17e8c890d8273ab/href">https://medium.com/media/2cacd39bf3195e7ae17e8c890d8273ab/href</a></iframe><p>A constante <em>http </em>vai conter todas as operações declaradas no módulo. Vamos utilizar então a operação que cria um servidor:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/f1f1d96a73a8c1622a1b48c852e7fafb/href">https://medium.com/media/f1f1d96a73a8c1622a1b48c852e7fafb/href</a></iframe><p>Tudo quase pronto, mas está faltando um detalhe. Se você já trabalhou com servidores como o <a href="http://www.jboss.org/">Jboss</a> e <a href="http://tomcat.apache.org/">Tomcat</a>, sabe que todos eles ouvem requisições em uma porta específica. Precisamos informar essa porta para o servidor, e isso é feito através da função <em>listen</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/3356c96923a8937cb77ad5f7bcf69c0f/href">https://medium.com/media/3356c96923a8937cb77ad5f7bcf69c0f/href</a></iframe><p>Agora sim! O servidor vai executar na porta 3000 e atender as requisições HTTP que chegarem nessa porta. Mas o que o servidor vai fazer quando receber uma requisição? Precisamos implementar essa lógica também, caso contrário, quando um cliente tentar acessar o servidor, nada será retornado por ele. Vamos então retornar um código HTML para o cliente. Para isso, vamos adicionar uma função como parâmetro da função <em>createServer</em>. Essa função recebe como argumento a requisição e a resposta da chamada HTTP. Para retornar um código HTML, vamos utilizar a resposta e sua função <em>end</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/10ab0846dcd461e9e5aedff80bd3651b/href">https://medium.com/media/10ab0846dcd461e9e5aedff80bd3651b/href</a></iframe><p>A função <em>end </em>recebe como parâmetro o HTML que será retornado pelo servidor quando o cliente acessar o endereço e porta configurados.</p><p>Inicie o servidor novamente (comando <strong><em>node server.js</em></strong>)<em> </em>e abra no navegador o endereço <a href="http://localhost:3000:">http://localhost:3000:</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/305/1*nsWJaNmz8rJgSwvdS_UTwA.png" /></figure><h3>Conclusão</h3><p>Nesse post vimos como é possível iniciar o desenvolvimento de um projeto Javascript com o Node.js. Em posts futuros, iremos explorar outras funcionalidades mais avançadas dessa tecnologia.</p><p>Se você gosta do meu conteúdo, não deixe de conferir o meu <a href="https://shorturl.at/hkmY6">canal do Youtube</a>, onde falo sobre desenvolvimento de software. Espero te ver por lá! 😉</p><h3>Referências</h3><ul><li><a href="https://cursos.alura.com.br/course/nodejs-fundamentos">https://cursos.alura.com.br/course/nodejs-fundamentos</a></li><li><a href="https://www.opus-software.com.br/node-js/">https://www.opus-software.com.br/node-js/</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=74b70af01a0d" width="1" height="1" alt=""><hr><p><a href="https://medium.com/desenvolvimento-com-node-js/come%C3%A7ando-a-desenvolver-com-o-node-js-74b70af01a0d">Começando a desenvolver com o Node.js</a> was originally published in <a href="https://medium.com/desenvolvimento-com-node-js">Desenvolvimento com Node.js</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Criando serviços com NodeJS]]></title>
            <link>https://medium.com/desenvolvimento-com-node-js/criando-servicos-com-nodejs-432c11b5d50d?source=rss----1f88727a121f---4</link>
            <guid isPermaLink="false">https://medium.com/p/432c11b5d50d</guid>
            <category><![CDATA[nodejs]]></category>
            <category><![CDATA[rest]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[expressjs]]></category>
            <dc:creator><![CDATA[Giuliana Bezerra]]></dc:creator>
            <pubDate>Fri, 31 May 2019 13:00:24 GMT</pubDate>
            <atom:updated>2022-09-25T17:15:10.284Z</atom:updated>
            <content:encoded><![CDATA[<h3>Criando serviços com Node.js</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/435/1*_ouduoG57dSy_d4PBds8Ig.png" /></figure><p>Construir serviços é uma tarefa rotineira dos desenvolvedores <em>backend</em>. É bastante comum expor APIs externa ou internamente utilizando <a href="https://condessalovelace.blogspot.com/2018/07/boas-praticas-na-construcao-de-servicos.html">serviços REST</a>. Tendo em vista essa crescente demanda de construção de serviços, elaborei esse post para explicar como, e de forma simples, podemos construir um serviço REST. Existem inúmeras tecnologias que visam facilitar essa tarefa, e nesse post iremos utilizar o <a href="https://nodejs.org/en/">Node.</a>js com o <a href="https://expressjs.com/pt-br/">Express</a> para construir um serviço <a href="https://pt.wikipedia.org/wiki/CRUD">CRUD</a> de usuário.</p><h3>Requisitos</h3><p>O leitor deve estar familiarizado com a linguagem Javascript, Node.js e Express. Para saber um pouco mais sobre o Node.js, recomendo a leitura <a href="https://medium.com/@giu.drawer/come%C3%A7ando-a-desenvolver-com-o-node-js-74b70af01a0d">desse post</a>. No que diz respeito ao Express, recomendo a leitura <a href="https://medium.com/desenvolvimento-com-node-js/express-para-gerenciamento-de-rotas-no-node-js-10dc7600adb1">desse post</a>.</p><h3>Criação do Projeto</h3><p>Nesse etapa será necessário utilizar editor para o desenvolvimento. Você pode usar algum de sua preferência, eu irei utilizar aqui o <a href="https://code.visualstudio.com/">Visual Studio Code</a>, que é uma das mais populares ferramentas para desenvolvimento com Javascript.</p><p>Vamos começar então criando uma pasta chamada <strong>servico-nodejs</strong> no editor:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*DIzoXi21IrO7qaV6L8g4pQ.png" /><figcaption>servico-nodejs no Visual Studio Code.</figcaption></figure><p>A estrutura de um projeto no Node.js costuma seguir um padrão, baseado nas boas práticas de desenvolvimento. Vamos adotar o seguinte padrão:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/295/1*AdwtSkKb5VMNGs4YkpCQew.png" /><figcaption>Estrutura do projeto servico-nodejs.</figcaption></figure><blockquote>💡 Nosso projeto exemplo é simples, por isso sua estrutura ficou pequena. Em serviços mais robustos também poderíamos ter uma pasta middleware, model , utils, entre outras. O importante é manter um padrão lógico de organização do código, para que qualquer desenvolvedor saiba onde encontrar cada artefato do projeto.</blockquote><h3>Configuração das Dependências</h3><p>Todo projeto Node.js possui um arquivo chamado <em>package.json</em> que configura as dependências do projeto. Para o nosso exemplo inicial, vamos precisar do <a href="https://www.npmjs.com/package/express">Express</a>, que irá nos ajudar a configurar o servidor, e do <a href="https://www.npmjs.com/package/nodemon">Nodemon</a>, para facilitar o desenvolvimento evitando a reinicialização do servidor sempre que mudarmos um arquivo. O arquivo terá o seguinte conteúdo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/8222e32c14d83d8331780dc475ba3969/href">https://medium.com/media/8222e32c14d83d8331780dc475ba3969/href</a></iframe><p>Feito isso, execute o comando abaixo para baixar as dependências:</p><pre>$ npm install</pre><pre>added 266 packages from 167 contributors and audited 2357 packages in 19.03s<br>found 0 vulnerabilities</pre><h3>Configuração do Servidor</h3><p>Para executar o servidor, vamos editar o arquivo <em>server.js </em>que irá apenas chamar o módulo app:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/7d2583fef0895e237ad0eb9f4ea545e9/href">https://medium.com/media/7d2583fef0895e237ad0eb9f4ea545e9/href</a></iframe><p>O <em>require </em>indica uma dependência com o conteúdo do arquivo <em>app.js</em>, dessa forma precisamos editá-lo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/43c40c8df0c419a22f7cd55b0d68d6ea/href">https://medium.com/media/43c40c8df0c419a22f7cd55b0d68d6ea/href</a></iframe><p>Configuramos o Express para disponibilizar as rotas dos serviços configurados na porta 9999 e utilizar o corpo da requisição no formato JSON (módulo <a href="https://www.npmjs.com/package/body-parser">body-parser</a>).</p><h3>Definição das rotas</h3><p>Essa é a etapa em que definimos as <em>URLs</em> dos serviços e o que fazer quando uma delas for requisitada. Vamos então começar criando um arquivo <em>index.js </em>na pasta <em>routes</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/603fc07581bdba72dd602e172b232fdc/href">https://medium.com/media/603fc07581bdba72dd602e172b232fdc/href</a></iframe><blockquote>💡Sempre que tivermos uma pasta importada como dependência usando o require, precisamos de um arquivo de entrada, que por padrão é um index.js.</blockquote><p>A rota inicial é configurada por um objeto <em>Router</em>,<em> </em>que permite informar uma rota e quem irá responder por ela. No nosso exemplo, criamos uma rota <em>/api </em>que irá conter os serviços disponibilizados pela aplicação. Além disso, para testes, colocamos uma mensagem ‘Connected!’ caso o usuário faça uma requisição ao endereço <a href="http://localhost:9999/"><em>http://localhost:9999</em></a><em> </em>com o verbo GET.</p><h3>Definição das APIs</h3><p>No padrão REST, definimos APIs baseadas em recursos. Como nesse post estamos criando um serviço de cadastro de usuário, vamos utilizar o recurso <strong><em>usuario</em></strong>,<em> </em>pois ele será o objeto manipulado pelo serviço.</p><p>Para configurar o recurso <em>usuario</em>, vamos criar uma pasta <em>api</em> dentro da pasta <em>routes</em>, e adicionar o arquivo <em>index.js </em>para configurar a rota até o recurso:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/1f0cb85e0f68c6f43f9754bd14c9fe36/href">https://medium.com/media/1f0cb85e0f68c6f43f9754bd14c9fe36/href</a></iframe><p>Agora, vamos definir a rota para esse recurso criando uma pasta <em>usuario </em>dentro da pasta <em>api</em>.<em> </em>Dentro da pasta <em>api</em>, vamos adicionar um arquivo <em>index.js </em>que irá configurar as operações feitas pelo serviço:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/97b1714fb630b2c2ae483dc984d081c4/href">https://medium.com/media/97b1714fb630b2c2ae483dc984d081c4/href</a></iframe><p>Configuramos as URLs de acesso a cada funcionalidade do recurso usuário, usando os verbos HTTP adequados para cada operação CRUD (Criação, Remoção, Update, Delete). O <em>:id </em>representa o identificador do usuário que é informado na URL para obter, atualizar, e remover o mesmo. Cada URL configurada irá responder invocando o controlador adequado à operação.</p><blockquote>💡 A <a href="https://medium.com/desenvolvimento-com-node-js/express-para-gerenciamento-de-rotas-no-node-js-10dc7600adb1">separação da lógica do serviço do seu roteamento</a> é uma boa prática, por isso nós utilizamos controladores vinculados às rotas, ao invés de implementar a lógica do serviço diretamente.</blockquote><h3>Configurando o banco de dados</h3><p>Por questões de simplicidade, os dados dos usuário serão salvos num banco de dados de arquivo. Para isso, vamos criar uma pasta na raiz do projeto chamada <em>data</em> contendo um arquivo vazio chamado <em>data.db</em>:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/127/1*AZq9ilu8As93ENtC1Ci_uw.png" /><figcaption>Arquivo data.db</figcaption></figure><p>Para utilizar esse arquivo como banco de dados, vamos configurar o <a href="https://github.com/louischatriot/nedb">nedb</a> criando uma pasta <em>config</em> contendo o arquivo <em>database.js</em> com o seguinte conteúdo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/ade1194ea0d6d5de59a9a901eadcf8f6/href">https://medium.com/media/ade1194ea0d6d5de59a9a901eadcf8f6/href</a></iframe><p>Como iremos utilizar a dependência <em>nedb</em>, temos que adicioná-la ao projeto utilizando o seguinte comando:</p><pre>$ npm install nedb --save</pre><p>Pronto! O banco de dados está configurado e poderá ser utilizado pelos <em>controllers</em>.</p><h3>Criando os Controllers</h3><p>Agora sim vamos implementar a lógica dos serviços, que estará localizada nos <em>controllers</em>. Vamos então criar a pasta do recurso <em>usuario </em>dentro da pasta <em>controllers </em>para adicionar os arquivos de cada operação configurada nas rotas:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/244/1*OruV5c-br88O_4BSNIReEQ.png" /><figcaption>Controllers do recurso usuario.</figcaption></figure><p>Feito isso, vamos editar o nosso arquivo <em>controllers/usuario/get.js </em>para recuperar o usuário do banco de arquivo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/6ebd4a853bedfebdf62b56560314a7fe/href">https://medium.com/media/6ebd4a853bedfebdf62b56560314a7fe/href</a></iframe><blockquote>💡 Observe que é muito importante tratar cada código HTTP de retorno, para que o cliente do serviço saiba o que está sendo informado a respeito do recurso manipulado. Se quiser saber mais sobre cada código HTTP, acesse <a href="https://developer.mozilla.org/pt-BR/docs/Web/HTTP/Status">esse link</a>.</blockquote><p>O serviço irá retornar os usuários encontrados no arquivo <em>data.db</em> com o id informado na URL. Para testarmos efetivamente, precisamos criar o serviço de persistência de usuários. Para isso, vamos editar o arquivo <em>controllers/usuario/create.js</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c9b1a70311c89e4182118a6e93c83c49/href">https://medium.com/media/c9b1a70311c89e4182118a6e93c83c49/href</a></iframe><p>Finalmente, para iniciar o serviço, falta adicionar as operações <em>update </em>e <em>delete</em>:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a99136766f7df5b0c6bfbf2a2a911b10/href">https://medium.com/media/a99136766f7df5b0c6bfbf2a2a911b10/href</a></iframe><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/1f9342118f5c23189438a6917bd9b25e/href">https://medium.com/media/1f9342118f5c23189438a6917bd9b25e/href</a></iframe><h3>Executando o serviço</h3><p>Com o projeto salvo, vamos finalmente testar os serviços criados. Para isso, devemos rodar o comando abaixo:</p><pre>$ npm start</pre><pre>&gt; nodemon server</pre><pre>[nodemon] 1.19.0<br>[nodemon] to restart at any time, enter `rs`<br>[nodemon] watching: *.*<br>[nodemon] starting `node server.js`<br>Banco data.db pronto para uso<br>Server running on port 9999</pre><p>Conforme configurado nos arquivos de rota, a url até o recurso usuário é <a href="http://localhost:9999/api/usuario."><em>http://localhost:9999/api/usuario</em>.</a> Você pode consumir o serviço para cada operação da seguinte forma:</p><ul><li><strong>Recupera o usuário: GET /api/usuario/:id</strong></li></ul><pre>$ curl <a href="http://localhost:9999/api/usuario/8uHCfkxRW90s1vk">http://localhost:9999/api/usuario/</a>8qSJB2sqsOmJzzDw -v</pre><ul><li><strong>Cria um usuário: POST /api/usuario</strong></li></ul><pre>$ curl -XPOST -H &#39;Content-Type: application/json&#39; <a href="http://localhost:9999/api/usuario">http://localhost:9999/api/usuario</a> -d &#39;{&quot;nome&quot;:&quot;Phoebe Buffay&quot;}&#39; -v</pre><ul><li><strong>Atualiza um usuário: PUT /api/usuario/:id</strong></li></ul><pre>$ curl -XPUT -H &#39;Content-Type: application/json&#39; <a href="http://localhost:9999/api/usuario/fThc8EJZTHKpRKk">http://localhost:9999/api/usuario/fThc8EJZTHKpRKk</a>  -d &#39;{&quot;nome&quot;:&quot;Mônica Geller Bing&quot;}&#39; -v</pre><ul><li><strong>Remove um usuário: DELETE /api/usuario/:id</strong></li></ul><pre>$ curl -XDELETE <a href="http://localhost:9999/api/usuario/8uHCfkxRW90s1vkU">http://localhost:9999/api/usuario/</a>OrtFSthcSZ6jEnGh -v</pre><h3>Conclusão</h3><p>Esse post demonstrou como construir um serviço REST utilizando o Node.js. Construímos um serviço simples, passo a passo, explicando o papel de cada componente na solução. Espero que agora você seja capaz de construir os seus próprios serviços REST com o Node.js, sem maiores dificuldades. E se tiver dúvidas, adicione um comentário!</p><p>Se você gosta do meu conteúdo, não deixe de conferir o meu <a href="https://shorturl.at/hkmY6">canal do Youtube</a>, onde falo sobre desenvolvimento de software. Espero te ver por lá! 😉</p><h3>Referências</h3><ul><li>Projeto Elaborado: <a href="https://github.com/giuliana-bezerra/servico-nodejs">https://github.com/giuliana-bezerra/servico-nodejs</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=432c11b5d50d" width="1" height="1" alt=""><hr><p><a href="https://medium.com/desenvolvimento-com-node-js/criando-servicos-com-nodejs-432c11b5d50d">Criando serviços com NodeJS</a> was originally published in <a href="https://medium.com/desenvolvimento-com-node-js">Desenvolvimento com Node.js</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>