<?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[Stories by Rafael Barbosa on Medium]]></title>
        <description><![CDATA[Stories by Rafael Barbosa on Medium]]></description>
        <link>https://medium.com/@rafaelbarbosadc?source=rss-d26c02885146------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/2*wFwaEpX325535VxCCNvUgg.jpeg</url>
            <title>Stories by Rafael Barbosa on Medium</title>
            <link>https://medium.com/@rafaelbarbosadc?source=rss-d26c02885146------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Sat, 21 Nov 2026 18:19:46 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@rafaelbarbosadc/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Criando uma API REST com Node.js + Express + Mongoose]]></title>
            <link>https://medium.com/@rafaelbarbosadc/criando-uma-api-rest-com-node-js-express-mongoose-f75a27e8cdc1?source=rss-d26c02885146------2</link>
            <guid isPermaLink="false">https://medium.com/p/f75a27e8cdc1</guid>
            <category><![CDATA[mongodb]]></category>
            <category><![CDATA[expressjs]]></category>
            <category><![CDATA[javascript]]></category>
            <category><![CDATA[api]]></category>
            <category><![CDATA[nodejs]]></category>
            <dc:creator><![CDATA[Rafael Barbosa]]></dc:creator>
            <pubDate>Mon, 10 Jun 2019 17:44:58 GMT</pubDate>
            <atom:updated>2019-06-10T18:07:57.051Z</atom:updated>
            <content:encoded><![CDATA[<p>Neste artigo, vamos aprender como criar uma API REST em NodeJS com Express e consumindo dados de um banco de dados não relacional MongoDB.</p><p>Uma API REST é uma <em>Application Programming Interface</em> que permite, através de métodos HTTP específicos, fazer um CRUD (Create, Read, Update, Delete) em um banco de dados. Ou seja, através dos métodos HTTP, uma aplicação pode se comunicar com outra, manipulando os seus dados. Isso é muito útil caso você tenha um mesmo banco de dados que sirva diferentes aplicações web, aplicativos mobile etc. Diferentes métodos fazem diferentes operações.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*CGAG1JXp9Go_X2py.jpg" /></figure><p>Vamos usar o NodeJS, que é a interpretação do Javascript em server-side. O Javascript é uma tendência forte no mundo da programação, tomando espaço no desenvolvimento web de muitas empresas reconhecidas como Uber, Netflix, PayPal, Trello, Linkedin etc. Juntamente com o NodeJS, usaremos o framework Express, que neste caso auxiliará na forma como nossos métodos HTTP vão se comunicar com o restante da aplicação e o Mongoose, um ORM que irá facilitar a manipulação de dados vindos do nosso banco MongoDB.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/520/0*fvgXcDD06wd8Ox43" /></figure><p>Para iniciar o projeto, você terá que ter as seguintes dependências instaladas:</p><ul><li><a href="https://nodejs.org/en/"><strong>NodeJS</strong></a></li><li><a href="https://www.npmjs.com/get-npm"><strong>Npm</strong></a> ou <a href="https://yarnpkg.com/pt-BR/"><strong>Yarn</strong></a></li><li><a href="https://www.mongodb.com/"><strong>MongoDB</strong></a> instalado e executando</li></ul><p>Tudo instalado e funcionando? Vamos pro código!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/220/0*9B4G60b1vVrDq7JF.gif" /><figcaption>Você depois de instalar tudo que precisa!</figcaption></figure><p>Em uma pasta da sua preferência, vamos iniciar o projeto com um dos nossos gerenciadores de dependência Npm ou Yarn usando o terminal em sistemas UNIX ou em caso de Windows, pode ser o CMD ou Poweshell. Eu usarei o Yarn, mas fique à vontade para usar o Npm.</p><pre>yarn init -y</pre><p>Ainda no nosso terminal, vamos adicionar as dependências do nosso projeto:</p><pre>yarn add express mongoose nodemon -D</pre><p>Aqui, estamos adicionando as dependências Express e Mongoose como dependências de produção do nosso projeto e o Nodemon como dependência de desenvolvimento. O Nodemon vai executar o script do nosso servidor e observará mudanças, reiniciando-o quando necessário, assim evitamos ter que toda vez parar o nosso servidor e iniciá-lo novamente. Feito isso, vamos deixar o nosso projeto com a seguinte estrutura de pastas, para facilitar o entendimento do nosso código:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/225/0*MYfd1a429ossL7v3" /><figcaption>Estrutura de pastas a ser utilizada!</figcaption></figure><p>No nosso arquivo <strong>database/config.js </strong>vamos criar a conexão com o banco, deixando dessa forma, sem esquecer de exportar nosso módulo:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/a5b5b65796481d2bc500b227b1c2a7b6/href">https://medium.com/media/a5b5b65796481d2bc500b227b1c2a7b6/href</a></iframe><p>Feito isso, no nosso arquivo <strong>server.js</strong> na raiz do nosso projeto, vamos importar e usar o express, conectar com o banco e usar as rotas no nosso projeto. Podemos usar a estrutura de classe para fazer isso, com funções específicas para cada uma das ações, com o resultado final ficando assim:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/afef8fea133b134ae4d244a0c8c9d8e8/href">https://medium.com/media/afef8fea133b134ae4d244a0c8c9d8e8/href</a></iframe><p>Perfeito! Agora precisamos criar nossos scripts para facilitar a inicialização do nosso projeto. Para fazer isso, você precisa criar no arquivo <strong>package.json</strong>, o atributo <strong>scripts</strong> e escrever os dois scripts, um para produção e um para desenvolvimento, que vai utilizar o Nodemon. Usaremos o de desenvolvimento durante a construção do nosso projeto. O código final fica assim:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/50bf6a032fde96900d7b14c402d97a57/href">https://medium.com/media/50bf6a032fde96900d7b14c402d97a57/href</a></iframe><p>Em seguida, execute o comando:</p><pre> yarn dev</pre><p>Se tudo estiver correto, você deve visualizar a seguinte mensagem no seu terminal: ‘Sua API REST está funcionando na porta 3001’. Isso significa que sua API está funcionando e você pode acessá-la usando o endereço <strong>localhost:3001</strong> no seu navegador. Ainda não temos nenhuma rota funcionando, então você não conseguirá visualizar nada.</p><p>Vamos agora criar nossa primeira rota. No arquivo <strong>routes.js</strong> na raiz do projeto, vamos importar o express e usar o seu método Router. Vamos criar uma rota GET para a URL principal do projeto, retornando uma mensagem de boas vindas. Não esqueça de exportar o módulo ao fim do código. O código deve estar assim:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/07ec597138066bc3878ac20305e901fb/href">https://medium.com/media/07ec597138066bc3878ac20305e901fb/href</a></iframe><p>Acessando a página principal da nossa aplicação, vemos a mensagem que criamos para retornar. A esta altura, você acaba de criar sua primeira rota na sua API. Parabéns!!!!</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fgiphy.com%2Fembed%2Fl0NhZ0aUSE8fXag12%2Ftwitter%2Fiframe&amp;url=https%3A%2F%2Fgiphy.com%2Fgifs%2Fomaze-chris-pratt-dinosaurs-l0NhZ0aUSE8fXag12&amp;image=https%3A%2F%2Fmedia.giphy.com%2Fmedia%2Fl0NhZ0aUSE8fXag12%2Fgiphy.gif&amp;key=d04bfffea46d4aeda930ec88cc64b87c&amp;type=text%2Fhtml&amp;schema=giphy" width="435" height="244" frameborder="0" scrolling="no"><a href="https://medium.com/media/29389c289eb67495db6f02f0dc7a942b/href">https://medium.com/media/29389c289eb67495db6f02f0dc7a942b/href</a></iframe><p>Vamos agora criar o schema do nosso banco no MongoDB. Podemos fazer isso no nosso arquivo <strong>app/Model/Hamburger.js</strong>. Nele, vamos importar o Mongoose e criar um novo schema, indicando quais campos são necessários ou não e informando qual o tipo de dado ele possui, usando os tipos literais do Javascript. Uma das vantagens do MongoDB é a flexibilidade dos dados inputados. Diferente de bancos SQL, nem todas as entradas precisam ter todos os dados preenchidos. Porém, ao fazer o schema, podemos definir quais são as informações imprescindíveis ao inserir o dado no banco adicionando o atributo <strong>required</strong> como true. O nosso código vai ficar assim:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/8bfcde3ba1337609c6f85f8cd02e5ac7/href">https://medium.com/media/8bfcde3ba1337609c6f85f8cd02e5ac7/href</a></iframe><p>Tendo nosso Model criado, podemos agora criar o Controller em <strong>app/controller</strong>. O Controller irá coordenar as ações referentes à esse Model. Vamos criar duas funções, a <strong>index</strong>, que irá mostrar os dados do nosso banco e a <strong>store</strong>, que será responsável por inserir os dados no nosso banco.</p><p>Agora, um ponto importante. Estamos usando um conceito da versão ES7 do Javascript chamado <strong>async await</strong>. Para entender melhor esse conceito, você pode ler esse <a href="https://braziljs.org/artigos/async-await-js-assincronamente-sincrono/">artigo</a> da BrazilJS. Para entender esse e outros conceitos de forma prática, recomendo fortemente os cursos da <a href="https://rocketseat.com.br/">Rocketseat</a>. Além de uma variedade legal de cursos gratuitos no módulo starter, eles oferecem um bootcamp intensivo de treinamento de tecnologias que estão no topo do mercado. Vale a pena conferir.</p><p>Voltando ao nosso código, na função store vamos usar o método <strong>create </strong>do Mongoose, que irá receber como parâmetro o corpo da nossa requisição. Já no método <strong>index</strong>, vamos usar o método find, que quando usado sem parâmetros, retorna todos os dados da nossa coleção.</p><p>O nosso Controller deve ficar dessa forma:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/fe42aea15e20aaf928d2e32ac522ef4a/href">https://medium.com/media/fe42aea15e20aaf928d2e32ac522ef4a/href</a></iframe><p>Certo, já temos nossas funções prontas. O que precisamos fazer é importar o nosso Controller no arquivo <strong>routes.js</strong>. Feito isso, podemos utilizar nossas funções do Controller como callback para as rotas. Vamos criar uma rota POST para adicionar dados ao nosso banco, que terá como callback a função <strong>store</strong> do nosso Controller. Também vamos adicionar uma rota GET, que irá mostrar todos os dados do nosso banco com o callback <strong>index</strong>. Nosso código do <strong>routes</strong>.js ficará assim:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/c440cdc967ca24422bf4f00c3852b1fc/href">https://medium.com/media/c440cdc967ca24422bf4f00c3852b1fc/href</a></iframe><p>Para fazer as requisições, você pode utilizar o <a href="https://www.getpostman.com/">Postman</a> ou o <a href="https://insomnia.rest/">Insomnia</a>. Eu utilizo o Insomnia. Podemos criar uma nova requisição clicando no botão “+” e em “New request”. Ali, escolhemos o nome da requisição e escolhemos o método (vamos iniciar pelo POST) e selecionando o corpo como um JSON. No nosso corpo, vamos escrever os atributos em formato de JSON, dessa forma:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/580/0*G4LlJtvMKrZ6D3fd" /><figcaption>Interface de requisição no Insomnia</figcaption></figure><p>Feito isso, vamos clicar em send para enviar a requisição. Voilá, você acaba de inserir um dado no banco e do lado direito podemos ver a resposta com os dados criados, inclusive timestamp de criação.</p><p>Feito isso, você pode criar uma requisição GET que irá para a mesma rota e testar. Ela irá lhe retornar os dados criados no banco.</p><p>Parabéns, você acaba de criar sua primeira API REST, utilizando o Express e Mongoose.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Fgiphy.com%2Fembed%2Fa2bVaOvWsRrgs%2Ftwitter%2Fiframe&amp;url=https%3A%2F%2Fgiphy.com%2Fgifs%2Face-ventura-funny-dancing-a2bVaOvWsRrgs&amp;image=https%3A%2F%2Fmedia.giphy.com%2Fmedia%2Fa2bVaOvWsRrgs%2Fgiphy.gif&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=giphy" width="435" height="301" frameborder="0" scrolling="no"><a href="https://medium.com/media/5eae2e84b7831f9776d3a3e04c773832/href">https://medium.com/media/5eae2e84b7831f9776d3a3e04c773832/href</a></iframe><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f75a27e8cdc1" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>