<?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 Nuno Filipe on Medium]]></title>
        <description><![CDATA[Stories by Nuno Filipe on Medium]]></description>
        <link>https://medium.com/@nunofilipe_16451?source=rss-fbcb3903cce------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/0*HiUVfAzFDve5RorK</url>
            <title>Stories by Nuno Filipe on Medium</title>
            <link>https://medium.com/@nunofilipe_16451?source=rss-fbcb3903cce------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 09:02:47 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@nunofilipe_16451/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[Criar um projeto REST API com loopback no windows, primeiros passos]]></title>
            <link>https://medium.com/@nunofilipe_16451/criar-um-projeto-rest-api-com-loopback-no-windows-primeiros-passos-9e0b16402815?source=rss-fbcb3903cce------2</link>
            <guid isPermaLink="false">https://medium.com/p/9e0b16402815</guid>
            <category><![CDATA[loopback]]></category>
            <dc:creator><![CDATA[Nuno Filipe]]></dc:creator>
            <pubDate>Tue, 09 Apr 2019 19:10:56 GMT</pubDate>
            <atom:updated>2019-04-09T19:24:53.533Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/768/1*dDlS2N4Obph48uyPpUuY5w.jpeg" /></figure><p>Loopback é uma framework criada para Node.Js orientada para criação de APIs. Loopback possibilita a rápida e completa prototipação da API, desde as funcionalidades até documentação, de maneira extremamente rápida.</p><p>Este tutorial visa demonstrar como é fácil criar uma REST API com autenticação usando apenas a linha de comandos.</p><h4>Requisitos para instalação no windows:</h4><ol><li>Node.Js</li><li>Git</li><li>Python</li><li>Microsoft Visual Studio com C++</li></ol><p>Saber mais <a href="https://loopback.io/doc/en/lb2/Installing-on-Windows.html#install-compiler-tools"><strong><em>aqui</em></strong></a>.</p><ol><li>Instalar Node.Js — <a href="https://nodejs.org/en/"><strong><em>link</em></strong></a>.</li><li>Instalar Git — <a href="https://git-scm.com/download"><strong><em>link</em></strong></a>.</li><li>Instalar python — é recomendado que seja instalada a versão 2.7.3 na localização standard, fica o <a href="https://www.python.org/downloads/release/python-273/#download"><strong><em>link</em></strong></a>, no meu caso que tenho win10–64 baixei ‘Windows X86–64 MSI Installer (2.7.3)’.</li><li>Instalar Microsoft Visual Studio — a partir do menu de instalação do mesmo adicionar o módulo de C++, fica o <a href="https://visualstudio.microsoft.com/pt-br/vs/community/?rr=https%3A%2F%2Fduckduckgo.com%2F"><strong><em>link</em></strong></a>.</li></ol><h4>Instalação do LoopBack</h4><p>A versão nativa do ‘npm ’que é adicionada na instalação do Node.Js não é a mais recomendada para windows, para instalar a ultima versão, abra a linha de comandos como administrador e digite o comando:</p><pre>npm install -g npm</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/506/1*HlRl2NnaOdd7VMil0SzRLA.png" /><figcaption>npm</figcaption></figure><p><strong>Instalar LoopBack CLI:</strong></p><pre>npm install -g loopback-cli</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/432/1*gnMkX_uJ1B-ltKz5wlf1rQ.png" /><figcaption>loopback-cli</figcaption></figure><p>O processo de instalação pode ser desafiante, acontece que por uma razão ou por outra, o instalador pode não encontrar os recursos que necessita e no lugar que espera encontrar. No meu caso para além de todos os requisitos anteriores, tive de criar as pastas ‘C:\OpenSSL-Win64\lib’, <a href="https://github.com/ReadyTalk/win32/blob/master/msvc/lib/libeay32.lib"><strong><em>baixar </em></strong></a>um ficheiro chamado ‘libeay32.lib’ e colocá-lo nessa diretoria…</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/906/1*nB-TOdWt3vu7gpEn_6EaSQ.png" /><figcaption>libeay32.lib</figcaption></figure><p>Se tudo correu bem na instalação, poderá passar á criação de um projeto numa pasta á sua escolha. <br>Abra a linha de comandos no caminho pretendido e digite:</p><pre>lb</pre><p>A framework fornecerá um menu onde pode especificar o nome da aplicação, o nome da diretoria (pasta do projeto), a versão do LoopBack a usar e tipo de aplicação a gerar (por exemplo servidor com autenticação). Escolhidas as opções, a framework gerará a seguir todos os ficheiros e pastas necessários á aplicação.</p><p>Veja o exemplo onde foi criada uma app com autenticação chamada ‘Livros_App’ …</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/973/1*DaDdPwo3iBVrNfSGtUuFnQ.png" /><figcaption>lb</figcaption></figure><p>Se abrir a pasta do projeto com o VS Code veja o que o LoopBack criou:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/928/1*Ztz_U0xg1Hq3BYj23v5PuA.png" /><figcaption>VS-server.js</figcaption></figure><p>Se na linha de comandos fizer ‘node .’ para correr a aplicação, poderá ler na consola (terminal) o porto onde o servidor está á escuta e o endereço onde pode encontrar a sua aplicação (cliente).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*4xDfYJJGPlR7u_1GqUhN8w.png" /><figcaption>porto</figcaption></figure><p>No browser se digitar: <a href="http://localhost:3000/explorer">http://localhost:3000/explorer</a> encontrará a sua aplicação!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*nMJ_EdRYI6eFgL91CeBsiA.png" /><figcaption>User</figcaption></figure><p>Se explorar, verificará que a framework criou para si todas as rotas do ‘user ’ incluindo as de autenticação.</p><p>Entre outras opções o LoopBack permite-lhe fácilmente criar modelos usando apenas a linha de comandos. Este tutorial não exemplifica esta opção mas fica o comando:</p><pre>lb model</pre><p>E é tudo, fiquem bem!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=9e0b16402815" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Criar uma app REST API com CRUD + Node.js + MongoDB + EJS]]></title>
            <link>https://medium.com/@nunofilipe_16451/criar-uma-app-rest-api-com-crud-node-js-mongodb-ejs-7802098cbe9e?source=rss-fbcb3903cce------2</link>
            <guid isPermaLink="false">https://medium.com/p/7802098cbe9e</guid>
            <category><![CDATA[mongodb]]></category>
            <category><![CDATA[rest-api]]></category>
            <category><![CDATA[ejs]]></category>
            <category><![CDATA[nodejs]]></category>
            <category><![CDATA[geolocation]]></category>
            <dc:creator><![CDATA[Nuno Filipe]]></dc:creator>
            <pubDate>Sun, 07 Apr 2019 20:34:28 GMT</pubDate>
            <atom:updated>2019-05-15T08:39:59.204Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/300/1*6DL9gdn0hFDiMrK2Fw7E1g.png" /></figure><p>Este é um projeto de aprendizagem que os autores desejam publicamente partilhar. Iremos criar uma <strong>REST API</strong> com <strong>CRUD</strong>, <strong>Node.js</strong> e <strong>MongoDB<em>. </em></strong>O <em>front-end</em> da aplicação será criado com <strong>EJS</strong>. Na reta final do projeto a <em>app </em>será alojada num serviço da <em>cloud </em>(<strong>HEROKU</strong>).</p><p>A intenção é criar uma aplicação que permita aos utilizadores inserirem pontos de interesse genéricos na base de dados (<em>mongoDB</em>), a base de dados crescerá com a inserção de registos de vários utilizadores em vários locais geográficos.</p><p>Com um simples click a <em>app</em> devolverá os 10 pontos de interesse mais próximos de si num raio de 300 km.</p><p>Para guardar a nossa localização (as coordenadas geográficas do ponto de interesse que queremos inserir na base de dados), faremos uso da API <strong><em>navigator-geolocation,</em></strong> para renderizar os mapas de cada ponto de interesse da B.D. usaremos a API <strong><em>static-maps da Google.</em></strong></p><h3>O que é uma REST API ?</h3><p>Muito suscintamente uma <strong><em>REST API</em></strong> é uma <strong><em>API </em></strong>que permite a interoperabilidade entre sistemas usando <strong><em>JSON </em></strong>ou <strong><em>XML </em></strong>e os métodos <strong><em>GET</em></strong>, <strong><em>POST</em></strong>, <strong><em>PUT</em></strong>, <strong><em>DELETE </em></strong>do protocolo <strong><em>HTTP</em></strong>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8fs1-c9FsGV_zQa2xaid7w.png" /><figcaption>REST API</figcaption></figure><h3>Requisitos para criação do projeto</h3><p>No momento para o desenvolvimento deste projeto é necessário ter instalado o <em>Node.js.</em> Mais tarde será necessário criar uma base de dados <em>mongoDB </em>no <em>mLab</em>, tal será assinalado oportunamente.</p><h3>Vamos começar …</h3><h4>. <strong>Iniciar projeto</strong></h4><p>Criar uma pasta de nome ‘<strong>PontosInteresse_App</strong>’.</p><p>Abrir a linha de comando na posição onde se encontra a pasta criada e executar o comando:</p><pre><strong>npm init -y</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/638/1*2mBf6DC0y88-uOzwy3wZyQ.jpeg" /><figcaption>npm init</figcaption></figure><p>O comando criará o ficheiro ‘<strong>package.json</strong>’. Este ficheiro guarda informações sobre o projeto e também sobre as dependências (pacotes) do mesmo.</p><h4><strong>. Instalação de pacotes necessários</strong></h4><p>Para este projeto vamos precisar de instalar os módulos:</p><ul><li><strong>express.js<em> </em>— </strong>uma <em>framework </em>para <em>Node </em>que permite o desenvolvimento de aplicações web de uma forma muito simples — Saber mais <a href="https://expressjs.com/">aqui</a></li><li><strong>body-parser — </strong>pacote usado para manipular solicitações <em>JSON</em>.</li><li><strong>mongoose</strong> — biblioteca <em>NodeJs</em> para inter-agir com a B.D. <em>MongoDb</em></li><li><strong>ejs<em> </em></strong>— template engine para criar o <em>front-end </em>da <em>app</em></li></ul><p>Para instalar estes pacotes usaremos o comando:</p><pre><strong>npm install --save express body-parser mongoose ejs</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/837/1*atRn_W_KgROHOxIfZTJuYQ.jpeg" /><figcaption>fig.1 — ver dependências no ficheiro package.json</figcaption></figure><h4><strong>. Criar servidor com Node.js</strong></h4><p>Dentro da pasta ‘<strong>PontosInteresse_App</strong>’ criar o ficheiro ‘<strong>app.js’</strong> (como indicado na fig.1)</p><pre>// associar as dependências instaladas<br><strong>const express = require(&#39;express&#39;);</strong></pre><pre>// inicializar app express<br><strong>const app = express();</strong></pre><pre><strong>let port = 5000;</strong></pre><pre>// servidor á escuta no porto 5000<br>// &#39;process.env.port&#39;: caso usemos Heroku<br><strong>app.listen(process.env.port || port, () =&gt;{<br>  console.log(&#39;Servidor em execução no porto: &#39;+ port);<br>});</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/986/1*19sbG0Okdove6v4PV71TdA.jpeg" /><figcaption>fig.2 — servidor</figcaption></figure><h3>Organização da Aplicação (MVC)</h3><p>A nossa aplicação deverá seguir o “<em>design</em>” <strong>MCV</strong>. <strong>M </strong>de <strong><em>M</em></strong><em>odel </em>(parte do código que representa os dados da aplicação), <strong>V</strong> de <strong><em>V</em></strong><em>iew </em>(<em>layouts</em>) e <strong>C</strong> de <strong>C</strong><em>ontrollers </em>(parte lógica da <em>app </em>a forma como a <em>app </em>lida com as solicitações recebidas e as respostas enviadas).</p><p>Existem também as <strong><em>Routes </em></strong>que indicam ao cliente (<em>browser </em>ou<em> app mobile</em>) qual o <em>controller </em>a usar, de acordo com o <em>url/path</em> solicitado.</p><h4><strong>. Dentro da nossa pasta ‘PontosInteresse_App’ vamos então criar a seguinte estrutura de pastas e ficheiros:</strong></h4><ul><li><strong>\controllers\apiController.js</strong></li><li><strong>\models\PImodel.js</strong></li><li><strong>\routes\api.js</strong></li><li><strong>\views\PItemplate.ejs</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/222/1*VsvNQl5PPsMzu_2E6kATwA.jpeg" /><figcaption>fig.3 — MVC + R</figcaption></figure><h4><strong><em>. </em>Criar um end-point de teste usando controlador ‘apiController.js’, rota ‘api.js’ e aplicação principal ‘app.js’</strong></h4><p>No ficheiro ‘<strong>\controllers\apiControllers.js</strong>’ colocar o seguinte código:</p><pre><strong>exports.test = function (req, res) {<br>  res.send(‘Olá! Teste ao Controller’);<br>};</strong></pre><p>No ficheiro ‘<strong>\routes\api.js</strong>’ colocar o seguinte código:</p><pre><strong>const express = require (‘express’);<br>const router = express.Router();</strong></pre><pre>// importa controlador &#39;apiController.js&#39; da pasta: <br>// ‘../controllers/apiController’<br><strong>const apiController = require(‘../controllers/apiController’);</strong></pre><pre>// url do teste será: <a href="http://localhost:5000/api/teste">http://localhost:5000/api/teste</a><br><strong>router.get(‘/teste’, apiController.test);</strong></pre><pre><strong>module.exports = router;</strong></pre><p>No ficheiro ‘<strong>app.js</strong>’ acrescentar o seguinte código:</p><pre>...<br>// ‘END POINT INVÁLIDO!’<br><strong>app.get(‘/’, function(req, res){<br>  res.send(‘END POINT INVÁLIDO!’);<br>});</strong></pre><pre>// todo o url começado por ‘/api’ chama as rotas em ‘./routes/api’<br><strong>const routes = require(‘./routes/api’);<br>app.use(‘/api’, routes);<br>...</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7atBfxtGmHLUhoqWE5K8Uw.jpeg" /><figcaption>fig.4 — app.js</figcaption></figure><p>Testar <em>end-point </em>no navegador:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/601/1*ISB73ZsVgJm6FRiwxfudBw.jpeg" /><figcaption>fig.5 — teste no navegador</figcaption></figure><h4><strong>. Criar o protótipo das rotas e controladores da aplicação</strong></h4><p>No ficheiro ‘<strong>\controllers\apiControllers.js</strong>’ acrescentar o seguinte código:</p><pre>...<br>// TODO: listar pontos de interesse da BD<br><strong>exports.details = function (req, res) {<br>  res.send({type: ‘GET’});<br>};</strong></pre><pre>// TODO: adicionar novo ponto de interesse<br><strong>exports.add = function (req, res) {<br>  res.send({type: ‘POST’});<br>};</strong></pre><pre>// TODO: atualizar ponto de interesse<br><strong>exports.update = function (req, res) {<br>  res.send({type: ‘PUT’});<br>};</strong></pre><pre>// TODO: apagar ponto de interesse<br><strong>exports.delete = function (req, res) {<br>  res.send({type: ‘DELETE’});<br>};</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5MyrpyWSXuBlbBg6GZUlFQ.jpeg" /><figcaption>fig.6 — apiControllers.js</figcaption></figure><p>No ficheiro ‘<strong>\routes\api.js</strong>’ colocar o seguinte código:</p><pre>...<br>// url do teste será: <a href="http://localhost:5000/api/teste">http://localhost:5000/api/teste</a><br><strong>router.get(‘/teste’, apiController.test);</strong></pre><pre>// TODO: listar pontos de interesse da BD<br><strong>router.get(‘/details’,apiController.details);</strong></pre><pre>// TODO: adicionar novo ponto de interesse<br><strong>router.post(‘/interest’,apiController.add);</strong></pre><pre>// TODO: atualizar ponto de interesse<br><strong>router.put(‘/interest/:id’,apiController.update);</strong></pre><pre>// TODO: apagar ponto de interesse<br><strong>router.delete(‘/interest/:id’,apiController.delete);</strong></pre><pre><strong>module.exports = router;</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/963/1*k6GuccKOvQUN-yiKLq_1DA.jpeg" /><figcaption>fig.6 — api.js</figcaption></figure><p>Testar a rota ‘<strong>/api/details</strong>’ no navegador</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/607/1*hudyCgHO-ctTfUTouqB-YA.jpeg" /><figcaption>fig.7 — teste no navegador</figcaption></figure><h4>. Testar a API no Postman</h4><p>O <em>Postman </em>é uma aplicação que permite realizar testes ás <em>REST-APIs</em> que se encontram na fase de desenvolvimento. O <em>Postman </em>permite fazer requisições <em>HTTP </em>como <em>POST </em>e <em>PUT </em>a partir de uma interface gráfica.</p><p>Por se tratar de uma aplicação para o <em>Chrome</em>, o <em>Postman </em>é facilmente instalado a partir da <em>Chrome Web Store</em>, link <a href="https://chrome.google.com/webstore/category/apps">aqui</a>.</p><p>A titulo de exemplo vamos testar o <em>end-point</em>: ‘<strong>http://localhost:5000/api/interest/randomId</strong>’ com metodo <em>PUT</em>. De notar que os métodos <em>PUT </em>e <em>DELETE </em>têm um <em>query id</em> que aqui foi designado aleatóriamente como ‘<strong>randomId</strong>’.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/995/1*73YNdZQA0-dafByTYMw6nA.jpeg" /><figcaption>fig.8 — postman</figcaption></figure><p>Vamos agora tratar do <em>POST request</em> usando um <em>middleware </em>(<em>body-parser</em>)<em> </em>que permita ao servidor na resposta ao pedido devolver os dados da mensagem enviada. <em>Middleware </em>é todo o código disparado entre o pedido e a resposta.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*b_nvxLb-jQVpNkA3nRny_Q.png" /><figcaption>fig.9 — middleware</figcaption></figure><p>No ficheiro ‘<strong>\controllers\apiControllers.js</strong>’ atualizar a função ‘<strong>create</strong>’:</p><pre>...<br>// adicionar novo ponto de interesse<br><strong>exports.create = function (req, res) {<br>  console.log(‘You made a POST request: ‘, req.body);<br>  res.send({<br>   type: ‘POST’,<br>   name: req.body.name,<br>   rank: req.body.rank });<br>};</strong><br>...</pre><p>No ficheiro ‘<strong>app.js</strong>’ acrescentar o seguinte código:</p><pre>...<br><strong>const bodyParser = require(‘body-parser’);</strong></pre><pre>// este middleware deve estar acima das routes-handlers!<br><strong>app.use(bodyParser.json());<br>...</strong></pre><p>Criar um <em>objeto JSON </em>para passar no campo <em>Body </em>do <em>Postman</em></p><pre><strong>{<br>   &quot;name&quot;: &quot;nuno&quot;,<br>   &quot;rank&quot;: &quot;noob&quot; <br>}</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gEXk8wedQwAq5uYUqiqwgA.png" /><figcaption>fig.9— postman</figcaption></figure><p>Notar que ao clicar ‘<em>Send</em>’ obtenho na resposta o <em>objeto JSON</em> enviado.</p><h4>. Criar uma base de dados no mLab</h4><p>Comecemos por instalar o pacote ‘<em>mongoose’ </em>que permite converter os dados da B.D. em objetos <em>JavaScript </em>para que possam ser utilizados na aplicação. Fornece-nos ainda métodos que facilitam a inter-acção com os dados na B.D. e criação de modelos e <em>Schemas</em>.</p><pre><strong>npm install mongoose -save</strong></pre><p>É necessário criar uma conta no <a href="https://mlab.com/"><em>mLab</em></a><em> </em>, nessa conta foi criado um <em>cluster </em>designado de ‘<strong>nodeJsCluster</strong> ’ uma B.D. de nome ‘<strong>test</strong>’, uma coleção ‘<strong>PontosInteresse </strong>’, e uma password ‘<strong>nnn</strong>’. No final é necessário copiar a ‘<em>connection string’</em> fornecida para podermos efetuar a ligação da <em>app</em> com a B.D.</p><p>Saber mais <a href="https://medium.com/@cristianop1998/cria%C3%A7%C3%A3o-de-uma-aplica%C3%A7%C3%A3o-crud-utilizando-node-js-e-mongodb-ubuntu-18-04-parte-2-2-2083fe18c2fe">aqui</a>.</p><h4>. Estabelecer a ligação com a B.D.</h4><p>No ficheiro ‘<strong>app.js</strong>’ acrescentar o seguinte código:</p><pre>...<br><strong>const mongoose = require(‘mongoose’);</strong></pre><pre>// Ligar á B.D.: &#39;test&#39;-&gt;user da BD, ´nnn´-&gt;pass<br><strong>mongoose.connect(‘mongodb+srv://test:nnn@nodejscluster-art2k.mongodb.net/test?retryWrites=true’);</strong></pre><pre>// Confirma ligação na consola<br><strong>mongoose.connection.on(‘connected’, function () {<br>  console.log(‘Connected to Database ‘+’test’);<br>});</strong></pre><pre>// Mensagem de Erro<br><strong>mongoose.connection.on(‘error’, (err) =&gt; {<br>  console.log(‘Database error ‘+err);<br>});<br>...</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*F2M7bo2qrwV5nH9xOOs3_w.png" /><figcaption>fig.10 — app.js</figcaption></figure><p>Se corrermos a aplicação com</p><pre><strong>node app.js</strong></pre><p>Confirmamos a ligação na consola com a mensagem ‘<em>Connected to Database test</em>’</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LUlNZa7fSpB_uDgKZ0c5gA.png" /><figcaption>fig.11 — msg consola</figcaption></figure><h4>. Criar um Modelo para B.D. baseado num <em>Schema</em></h4><p>Vamos criar um modelo baseado num <em>Schema </em>que será a representação dos dados a enviar e manipular na B.D.</p><p>No ficheiro ‘<strong>\models\PImodel.js</strong>’ colocar o seguinte código:</p><pre><strong>const mongoose = require(‘mongoose’);<br>const Schema = mongoose.Schema;</strong></pre><pre>// PI Schema<br><strong>const PISchema = new Schema({<br>  name: {<br>  type: String,<br>  required: [true, ‘*Campo obrigatório!’]<br>  },<br>  details: {<br>  type: String<br>  },<br>  status: {<br>  type: Boolean,<br>  default: true<br>  }<br>// TODO: geo location<br>});</strong></pre><pre>// criar Modelo_PI baseado em PISchema: ‘PontosInteresse’-&gt;nome da // coleção<br><strong>const PI = mongoose.model(‘PontosInteresse’, PISchema);</strong></pre><pre>// exportar Modelo_PI<br><strong>module.exports = PI;</strong></pre><h3>Operações do CRUD</h3><p>Vamos criar as operações <strong><em>CRUD</em></strong><em>: </em><strong><em>c</em></strong><em>reate, </em><strong><em>r</em></strong><em>ead, </em><strong><em>u</em></strong><em>pdate, </em><strong><em>d</em></strong><em>elete.</em></p><p><strong>CREATE</strong></p><h4>. Criar um Ponto de Interesse (PI) na base dados</h4><p>No ficheiro ‘<strong>\controllers\apiControllers.js</strong>’ atualizar a função ‘<strong>create</strong>’:</p><pre>// importar modelo<br><strong>const PI = require(&#39;../models/PImodel&#39;);</strong></pre><pre>// adicionar novo ponto de interesse<br><strong>exports.create = function (req, res) {</strong><br>  // cria novo ‘pi’ na BD a partir do request, depois, devolve o<br>  //‘pi’ criado ao cliente<br><strong>  PI.create(req.body).then(function(pi){<br>  res.send(pi);<br>  });</strong><br><strong>};</strong></pre><p>Teste no <em>postman</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gjD1iVubBOLTCYY8Xmwjpw.png" /><figcaption>fig.12 — postman</figcaption></figure><p>Confirmar criação de Ponto de Interesse no <em>mongoDB</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*TaN8wdvYQrl8684kF4HbqQ.png" /><figcaption>fig.13 — mongoDB</figcaption></figure><h4>. Criar <em>middleware </em>para tratar erros ocorridos nas rotas</h4><p>Se tentarmos inserir um documento na coleção da B.D. cujo campo obrigatório (name) seja nulo o <em>front-end</em> da aplicação fica á espera de uma resposta que nunca chega pois ocorreu um erro na <em>route-handlers</em>.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WjESlw8Wkzx6zoGkgFkVvw.png" /><figcaption>fig.14 — middleware</figcaption></figure><p>Podemos resolver isto da seguinte forma…</p><p>No ficheiro ‘<strong>\controllers\apiControllers.js</strong>’ editar a função ‘<strong>create</strong>’:</p><pre>// ocorrido um erro, ‘next’ chama proximo middleware (ver ‘app.js’)<br><strong>exports.create = function (req, res, next) {<br>  PI.create(req.body).then(function(pi){<br>    res.send(pi);<br>  }).catch(next);<br>};</strong></pre><p>No ficheiro ‘<strong>app.js</strong>’ acrescentar:</p><pre>// error handling middleware<br><strong>app.use(function(err, req, res, next){<br>   console.log(err);</strong><br>  // ‘res.status(422)’-&gt;muda o status<br><strong>  res.status(422).send({error: err.message});<br>});</strong></pre><p>Ter atenção á ordem do <em>middleware</em>!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ofeRHj6qKwCylLbCvqIWoA.png" /><figcaption>fig.15–app.js</figcaption></figure><p>Teste no <em>postman</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_-_-Nv_kiSVIGqcjRNoPcg.png" /><figcaption>fig.16–postman</figcaption></figure><p>Notar a mudança do <em>Status </em>para 422 e a mensagem de erro devolvida!</p><p><strong>DELETE</strong></p><h4>. Apagar um Ponto de Interesse (PI)</h4><p>Para apagar um documento (<strong>PI</strong>) da coleção temos de passar na rota o ‘<strong>id </strong>’que o identifica.</p><p>No ficheiro ‘<strong>\controllers\apiControllers.js</strong>’ editar a função ‘<strong>delete</strong>’:</p><pre>// ‘_id:’-&gt;nome da propriedade na BD, <br>// ‘req.params.id’-&gt;devolve-me o parametro id na req<br><strong>exports.delete = function (req, res, next) {<br>  // apaga ‘pi’ da BD, depois, devolve o ‘pi’ apagado ao cliente<br>  PI.findByIdAndRemove({_id: req.params.id}).then(function(pi){<br>    res.send(pi);<br>  }).catch(next);<br>};</strong></pre><p>Se criarmos um ‘<strong>PI </strong>’ no <em>postman </em>(ver fig.12) poderemos copiar o ‘<strong>_id </strong>’que nos é devolvido na resposta. Se em seguida mudarmos o método de <em>POST </em>para <em>DELETE </em>e passarmos o ‘<strong>_id </strong>’ copiado para a rota, fazendo ‘<strong>Send</strong>’ apagaremos o documento na B.D.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jr6F_I3Ip7fnHcT3tNbZzg.png" /><figcaption>fig.17 — postman</figcaption></figure><p><strong>UPDATE</strong></p><h4>. Atualizar um (PI)</h4><p>Á semelhança da função ‘<strong>delete </strong>’ para atualizar um documento da coleção (<strong>PI</strong>) temos de passar na rota o ‘<strong>id </strong>’que o identifica e no <em>body </em>as propriedades a atualizar.</p><p>No ficheiro ‘<strong>\controllers\apiControllers.js</strong>’ editar a função ‘<strong>update</strong>’:</p><pre>// atualiza ‘pi’ da BD com as propriedades em ‘req.body’<br>// depois, procura de novo na BD o ‘pi’ atualizado (senão manda o pi // não atualizado!)<br>// depois, devolve o ‘pi’ atualizado ao cliente<br><strong>exports.update = function (req, res, next) {<br>   IP.findByIdAndUpdate({_id: req.params.id},<br>                    req.body).then(function(){<br>     IP.findOne({_id: req.params.id}).then(function(ip){<br>       res.send(ip);<br>     });<br>   }).catch(next);<br>};</strong></pre><p>Se criarmos um ‘<strong>PI </strong>’ no <em>postman </em>(ver fig.12) poderemos copiar o ‘<strong>_id </strong>’que nos é devolvido na resposta. Se em seguida mudarmos o método de <em>POST </em>para <em>PUT </em>e passarmos o ‘<strong>_id </strong>’ copiado para a rota, fazendo ‘<strong>Send</strong>’ atualizaremos o documento na B.D.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*i_0BoKy-v1EdPea91TEIdQ.png" /><figcaption>fig.18 — postman</figcaption></figure><p><strong>READ</strong></p><h4>. Listar Pontos de Interesse perto da localização do utilizador da app</h4><p>O <em>mongoDB </em>trata da geolocalização usando <a href="http://geojson.org/"><em>GeoJson </em></a>que é um método de guardar dados geográficos em formato <em>json</em>.</p><p>O <em>mongoDB </em>pode usar como geolocalização o método <strong>2D </strong>ou <strong>2D Sphere</strong>. Imaginem que querem medir a distancia entre 2 pontos diferentes no globo, pontos A e B, o método 2D mede a distancia em linha reta no plano enquanto que o método 2D Sphere toma em conta a curvatura da Terra.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*g0V0SL99W3y3kI21-TIP6Q.png" /><figcaption>fig.19–2D, 2D SPHERE</figcaption></figure><p>Passaremos á atualização do modelo ‘<strong>PImodel.js</strong>’ para incluir dados de geolocalização e usaremos 2D Sphere.</p><p>No ficheiro ‘<strong>\models\PImodel.js</strong>’ editar o modelo da seguinte forma:</p><pre>...<br>// geolocation Schema<br><strong>const GeoSchema = new Schema({<br>  type: {<br>    type: String,<br>    default: ‘Point’<br>  },<br>  coordinates: {<br>    type: [Number],<br>    index: ‘2dsphere’<br>  }<br>});</strong></pre><pre>// PI Schema<br><strong>const PISchema = new Schema({<br>  name: {<br>    type: String,<br>    required: [true, ‘*Campo obrigatório!’]<br>  },<br>  details: {<br>    type: String<br>  },<br>  status: {<br>    type: Boolean,<br>    default: true<br>  },<br>  geometry: GeoSchema<br>});<br>...</strong></pre><p>No ficheiro ‘<strong>\controllers\apiControllers.js</strong>’ editar a função ‘<strong>details</strong>’:</p><pre>// procura todos os doc. na BD, guarda em ‘pi’ <br>// depois devolve ‘pi’ ao cliente<br><strong>exports.details = function (req, res) {<br>   PI.find({}).then(function(pi){<br>   res.send(pi);<br>   });<br>};</strong></pre><p>Teste no <em>postman</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*eqlv2WFgCLD9lAl12CsudQ.png" /><figcaption>fig.20 — Postman-listAll</figcaption></figure><p>Os ‘<strong>PIs’</strong> listados foram introduzidos previamente usando o <em>end-point</em> correspondente (<em>CREATE </em>— ver fig.12).</p><p>Notar que aqui a rota utilizada foi: ‘<strong>/api/details</strong>’.</p><p>Conseguimos, no momento, listar todos os documentos da coleção no entanto não é isto que pretendemos.</p><p>Queremos passar uma latitude e longitude e depois procurar por PIs que estejam próximos desses parâmetros. Esses parâmetros são passados no browser (cliente) e denominam-se por parâmetros url e não devem ser confundidos com parâmetros de request como o ‘<strong>_id</strong>’ que passamos no <em>DELETE </em>ou <em>UPDATE</em>.</p><p>Parâmetros url começam por ‘<strong>?</strong>’ e um exemplo pode ser: <strong>www.pontosinteresse.com/api/details?lng=56.45&amp;lat=43.37</strong></p><p><strong>‘lng=56.45&amp;lat=43.37’ — ‘lng</strong>’ e ‘<strong>lat</strong>’ são os nomes atribuídos ás variáveis. ‘<strong>56.45</strong>’ e ‘<strong>43.37</strong>’ são o valor que as variáveis tomam.</p><p>Desta forma quando fizermos um <em>GET-REQUEST </em>ao servidor vamos passar um parâmetro de longitude e latitude e a <em>query </em>á B.D. vai ter em conta esses valores e devolver os PIs próximos dessa gama de valores.</p><p>A <em>query </em>á B.D. vai ser feita usando ‘<strong><em>$geoNear aggregation stage’</em></strong><em>. </em>Saber mais <a href="https://docs.mongodb.com/manual/reference/operator/aggregation/geoNear/#definition">aqui</a>.</p><p><strong>Passemos ao código…</strong></p><p>No ficheiro ‘<strong>\controllers\apiControllers.js</strong>’ editar a função ‘<strong>details</strong>’:</p><pre>// listar PIs baseado na distancia relativa aos valores de lng e lat <br>// passados pelo cliente<br><strong>module.exports.details = (req, res, next) =&gt;{<br>  let lng = parseFloat(req.query.lng);<br>  let lat = parseFloat(req.query.lat);<br>  const maxDist = 100000;<br>PI.aggregate([{<br>  ‘$geoNear’: {<br>    “near”: { ‘type’: ‘Point’,<br>    “coordinates“: [parseFloat(lng), parseFloat(lat)] },<br>    “spherical”: true,<br>    “distanceField”: ‘dist’,<br>    “limit”: 3,<br>    “maxDistance”: maxDist<br>  }<br> }])<br>    .then(pi =&gt; res.send(pi))<br>    .catch(next);<br>};</strong></pre><p>Explicação de alguns pontos do código:</p><ul><li><em>‘</em><strong><em>near</em></strong><em>’: </em><strong><em>{ ‘type’: ‘Point’,</em></strong> — porque procuramos um ponto no mapa</li><li><em>‘</em><strong><em>coordinates</em></strong><em>’:</em><strong><em> [parseFloat(lng), parseFloat(lat)] }</em></strong> — array de coordenadas cujos valores são recebidos através de <em>‘</em><strong><em>req.query.x</em></strong><em>’</em> (‘<em>x</em>’-variável passada na <em>query string</em>), estes valores recebidos são <em>strings </em>mas queremos números pelo que fazemos o <em>parse </em>destes valores.</li><li><strong><em>‘spherical ’</em></strong><em>:‘</em><strong><em>true </em></strong><em>’— </em>define que a distancia medida deverá ter em conta a curvatura da Terra.</li><li><em>‘</em><strong><em>distanceField</em></strong><em>’: ‘</em><strong><em>dist</em></strong><em>’,</em> — distancia calculada entre o PI na B.D. e o ponto passado pelo cliente (‘<strong>lng</strong>’ e ‘<strong>lat</strong>’).</li><li><em>‘</em><strong><em>limit</em></strong><em>’: ‘</em><strong><em>3</em> </strong>’— max. nº de documentos a devolver será 3.</li><li><em>‘</em><strong><em>maxDistance</em></strong><em>’:‘</em><strong><em>maxDist’</em></strong><em>— </em>define o raio de pontos a procurar (PIs na base de dados), relativamente ao ponto passado pelo cliente (‘<strong>lng</strong>’ e ‘<strong>lat</strong>’). O valor de <em>‘</em><strong><em>maxDist’ </em></strong>é em metros!</li></ul><p><strong>Teste no <em>Postman</em></strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9BRKifg40_yf8buN1utfxQ.png" /><figcaption>fig.21 — Postman-part.1</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*6JMXKUIjK2oUHLlTTYLNUA.png" /><figcaption>fig.22 — Postman-part.2</figcaption></figure><p>Introduzida a rota ‘<strong>/api/details/</strong>’ com os parâmetros ‘<strong>?lng=-80 &amp; lat=25</strong>’ e feito o <em>GET-REQUEST,</em> obtivemos tres PIs ordenados da distancia menor para a maior em relação á longitude e latitude providenciadas pelo cliente.</p><h3>CRIAÇÃO DO FRONT-END COM EJS</h3><p>Vamos usar o <em>template-engine</em> EJS (<em>Embedded Javascript</em>) para criar o nosso <em>front-end</em>, para tal comecemos por configurar isso mesmo no ficheiro ‘<strong>app.js</strong>’.</p><pre>// Configuração da view engine<br><strong>app.set(&#39;view engine&#39;, &#39;ejs&#39;);</strong></pre><p>Agora o nosso projeto sabe que vamos usar <em>EJS </em>para os nossos <em>templates</em>. De seguida queremos implementar a possibilidade de servir ficheiros estáticos ao cliente a partir do servidor, para tal vamos acrescentar um novo <em>middleware </em>no ficheiro ‘<strong>app.js</strong>’ com <em>express e </em>criar as pastas ‘<strong>/public/assets’</strong> que receberão os ficheiros estáticos que pretendemos servir.</p><pre><strong>app.use(express.static(‘public’));</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FEweg5CDmr2jVZTonARM4g.png" /><figcaption>view-engine + staticFiles-middleware</figcaption></figure><p>Se pretender por exemplo fazer um <em>GET </em>de um ficheiro ‘<strong>styles.css</strong>’ cujo caminho esteja referenciado em ‘<strong>createPI.ejs</strong>’ (‘<em>&lt;link rel=”stylesheet” type=”text/css” href=”/assets/styles.css</em>”&gt;’) a partir da rota ‘<strong>/</strong>’, o pedido chega ao servidor, encontra este <em>middleware , </em>verifica que é um ficheiro estático e serve esse ficheiro a partir da pasta ‘<strong>/public/assets/img.jpg</strong>’ .</p><p>Vamos então criar o ficheiro ‘<strong>createPI.ejs’</strong> dentro da pasta ‘<strong>/views</strong>’. Este ficheiro receberá o HTML que iremos renderizar e testar na rota ‘<strong>/api/teste</strong>’.</p><p>Atualizar o controlador ‘<strong>/controllers/apiController.js’ </strong>com o seguinte código:</p><pre>// exporta function &#39;test&#39;, chamada em &#39;/routes/api.js&#39;<br><strong>exports.test = function (req, res) {</strong><br>  // res.send(‘Olá! Teste ao Controller’);<br>  <strong>res.render(‘PI’);</strong><br><strong>};</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*CF2mrjre4WvnlBLrBX9VEQ.png" /><figcaption>apiController.js</figcaption></figure><p>Editar ‘<strong>views/createPI.ejs’:</strong></p><pre><strong>&lt;!DOCTYPE &lt;html&gt;<br>&lt;html lang=”en”&gt;<br>&lt;head&gt;<br>  &lt;meta charset=”UTF-8&quot;&gt;<br>  &lt;title&gt;TESTE&lt;/title&gt;<br>  &lt;link rel=”stylesheet” type=”text/css”<br>    href=”/assets/colocoAquiMeu.css”&gt;<br>&lt;/head&gt;<br>&lt;body&gt;<br>  &lt;h2&gt;HeaderTitulo&lt;h2&gt;<br>  &lt;form action=”/colocoAquRotaAredireccionarNoSubmit”<br>     method=”POST”&gt;<br>    &lt;input type=”text” placeholder=”placeholder01&quot; name=”name01&quot;&gt;<br>    &lt;input type=”text” placeholder=”placeholder02&quot; name=”name02&quot;&gt;<br>    &lt;input type=”text” placeholder=”placeholder03&quot; name=”name03&quot;&gt;<br>    &lt;button type=”submit”&gt;Submit&lt;/button&gt;<br>  &lt;/form&gt;<br>&lt;/body&gt;<br>&lt;/html&gt;</strong></pre><p>Testar no browser com: ‘<strong>http://localhost:5000/api/teste’</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/788/1*pssenFqaiRGCBPQXeBGwDA.png" /><figcaption>teste no browser</figcaption></figure><p>O <em>Express</em> não consegue interpretar os dados passados a partir do elemento ‘<strong>&lt;form&gt;’. </strong>O <em>bodyParser-middleware </em>que temos usado até agora serviu-nos para fazer o <em>parse </em>de objetos <em>JSON . </em>Para fazer <em>parse </em>de dados do elemento ‘<strong>&lt;form&gt;’ </strong>temos de reconfigurar<strong> </strong>o <em>bodyParser</em>.</p><p>Em ‘<strong>app.js’ </strong>editar:</p><pre>// antes -&gt; app.use(bodyParser.json());<br><strong>app.use(bodyParser.urlencoded({ extended: true }));</strong></pre><h4>OPERAÇÕES CRUD NO FRONT-END</h4><h4><strong>. CREATE</strong></h4><p>Vamos criar uma rota raiz ‘<strong>/</strong>’ em ‘<strong>app.js’</strong> e renderizar o <em>template </em>‘/<strong>views/createPI.ejs’.</strong></p><p>Em ‘<strong>app.js’ </strong>adicionar o seguinte código:</p><pre>// rota raiz: renderiza a pagina onde criamos novo PI<br><strong>app.get(&#39;/&#39;, function (req, res) {<br>  res.render(&#39;createPI&#39;);<br>});</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*f3NM8RAx3k-6mm3HrGf2eA.png" /><figcaption>app.js</figcaption></figure><p>Em ‘<strong>views/createPI.ejs’ </strong>vamos criar os <em>inputs </em>com os campos de ‘<strong>PI </strong>’ . A rota ‘<strong>/api/interest</strong>’ (rota onde é adicionado novo ‘<strong>PI </strong>’ na B.D.) é chamada ao clicar ‘<strong>Submit</strong>’.</p><p>Atualizar ‘<strong>views/createPI.ejs’:</strong></p><pre><strong>&lt;!DOCTYPE &lt;html&gt;<br>&lt;html lang=”en”&gt;<br>&lt;head&gt;<br>  &lt;meta charset=”UTF-8&quot;&gt;<br>  &lt;title&gt;TESTE&lt;/title&gt;<br>  &lt;link rel=”stylesheet” type=”text/css”<br>    href=”/assets/colocoAquiMeu.css”&gt;<br>&lt;/head&gt;<br>&lt;body&gt;<br>  &lt;h2&gt;Criar Ponto Interesse&lt;h2&gt;</strong><br>  &lt;%# &quot;/api/interest&quot;-&gt; rota de criação de novo registo %&gt;<br><strong>  &lt;form action=”/api/interest” method=”POST”&gt;<br>    &lt;input type=”text” placeholder=”name&quot; name=”name&quot;&gt;<br>    &lt;input type=”text” placeholder=”details&quot; name=”details&quot;&gt;<br>    &lt;input type=”text” placeholder=”longitude&quot; name=”lng&quot;&gt;<br>    &lt;input type=&quot;text&quot; placeholder=&quot;latitude&quot; name=&quot;lat&quot;&gt;<br>    &lt;button type=”submit”&gt;Submit&lt;/button&gt;<br>  &lt;/form&gt;<br>&lt;/body&gt;<br>&lt;/html&gt;</strong></pre><p>Os atributos ‘<strong><em>name</em></strong>’ dos <em>inputs </em>receberão os valores do cliente (<em>browser</em>) e estes serão passados para o <em>body </em>no <em>request.</em></p><p>A função ‘<strong>create<em> </em></strong><em>’ </em>em ‘<strong>apiController.js’ </strong>será chamada na rota ‘<strong>/api/interest</strong>’ ao clicar ‘<strong>Submit</strong>’. Devemos atualizar esta função de forma a que no <em>request </em>esta recolha os dados enviados no <em>body</em>,<em> </em>crie um novo documento na B.D.(baseado nos dados recolhidos) e redireccione para uma rota que liste os pontos de interesse (PIs).</p><p>Em ‘<strong>/controllers/apiController.js’ </strong>atualizar:</p><pre><strong>exports.create = function (req, res, next) {</strong><br>  // inicializar variaveis com os valores do &#39;req.body&#39;<br><strong>  let nm = req.body.name;<br>  let dt = req.body.details;<br>  let lng = req.body.lng;<br>  let lat = req.body.lat;</strong><br>  // criar variavel baseada no modelo &#39;PImodel&#39; para receber dados<br>  // do formulario (request)<br><strong>  let data = {<br>    name: nm,<br>    details: dt,<br>    status: true,<br>    geometry: {&quot;type&quot;: &quot;point&quot;, &quot;coordinates&quot;: [lng, lat]}<br>  };</strong><br>  // cria novo &#39;pi&#39; na BD a partir do request, depois, envia msg<br>  // para o cliente (Browser)<br><strong>  PI.create(data).then(function(pi){<br>    res.send(&#39;Documento criado com sucesso!&#39;);</strong><br>   // res.redirect(&#39;/api/listall&#39;);<strong><br>  }).catch(next);<br>};</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1016/1*kMHAD-C8-vXVNJkVqmS__A.png" /><figcaption>apiController.js</figcaption></figure><p>Para verificar o funcionamento, reiniciamos o servidor e preenchemos o formulário. Após carregar-mos no botão ‘<strong>S<em>ubmit</em></strong>’, deverá aparecer a mensagem de sucesso: ‘‘Documento criado com sucesso!<strong>’</strong>’.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/839/1*LHyPl1Uph93bqjVx2tXTjA.png" /><figcaption>Browser-criar PI</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/719/1*ka9rOuZIGhEbXvVWmVtsnQ.png" /><figcaption>Browser-mensagem</figcaption></figure><h4>. READ</h4><p>Vamos criar uma rota onde possamos listar os pontos de interesse (PIs), criados.</p><p>Em ‘<strong>/routes/api.js’ </strong>adicionar o seguinte código:</p><pre>// listar todos os pontos de interesse da BD<br><strong>router.get(&#39;/listAll&#39;,apiController.listAllPIs);</strong></pre><p>Em ‘<strong>/controllers/apiController.js’ </strong>adicionar o seguinte código:</p><pre>// listar todos os pontos de interesse da BD<br><strong>exports.listAllPIs = function (req, res, next) {<br>  PI.find({}).then(function(pi){<br>    res.render(&#39;listPIs&#39;, {pis: pi});<br>  }).catch(next);<br>};</strong></pre><p>Esta função vai procurar todos os documentos na B.D. e passá-los para o template ‘<strong>listPIs.ejs</strong>’.</p><p>‘<strong>pis</strong>’ em ‘<strong>{pis: pi}’ </strong>é a propriedade que vai receber os documentos e terá de ser posteriormente referenciada no <em>template </em>para a exibição dos dados.</p><p>Vamos então criar o <em>template </em>‘<strong>/views/‘listPIs.ejs’’:</strong></p><pre><strong>&lt;!DOCTYPE html&gt;<br>&lt;html lang=&quot;en&quot;&gt;<br>&lt;head&gt;<br>  &lt;meta charset=&quot;UTF-8&quot;&gt;<br>  &lt;title&gt;Lista PIs&lt;/title&gt;<br>&lt;/head&gt;<br>&lt;body&gt;<br>  &lt;h2&gt;Lista de Pontos de Interesse&lt;h2&gt;<br>  &lt;table border=&quot;1&quot;&gt;<br>    &lt;thead&gt;<br>      &lt;tr&gt;<br>        &lt;td&gt;Name&lt;/td&gt;<br>        &lt;td&gt;Details&lt;/td&gt;<br>        &lt;td&gt;Status&lt;/td&gt;<br>      &lt;/tr&gt;<br>    &lt;/thead&gt;<br>    &lt;tbody&gt;<br>      &lt;% pis.forEach(function(data) { %&gt;<br>        &lt;tr&gt;<br>          &lt;td&gt;&lt;%= data.name %&gt;&lt;/td&gt;<br>          &lt;td&gt;&lt;%= data.details %&gt;&lt;/td&gt;<br>          &lt;td&gt;&lt;%= data.status %&gt;&lt;/td&gt;<br>        &lt;/tr&gt;<br>     &lt;% }) %&gt;<br>   &lt;/tbody&gt;<br>   &lt;button&gt;&lt;a href=&quot;/&quot;&gt;Back&lt;/a&gt;&lt;/button&gt;<br>&lt;/body&gt;<br>&lt;/html&gt;</strong></pre><p>De notar que os dados dos documentos são recebidos e manipulados a partir do objeto <strong>‘pis’, </strong>com um<strong> </strong>ciclo ‘<strong><em>forEach’.</em></strong> Dos dados retiraremos os atributos ‘<strong>name</strong>’, ‘<strong>details</strong>’ e ‘<strong>status</strong>’ (atributos de ‘<strong>PI</strong>’).</p><p>Queremos que, ao criar um novo ponto de interesse sejamos redireccionados para a rota ‘<strong>/api/listall</strong>’, para tal basta editar a função ‘<strong>create’ </strong>em ‘<strong>/controllers/apiController.js’ </strong>:</p><pre><strong>exports.create = function (req, res, next) {</strong><br>  ...<br>  // cria novo &#39;pi&#39; na BD a partir do request, depois, redirecciona<br>  // para rota &#39;/api/listall&#39;<br>  PI.create(data).then(function(pi){<strong>    </strong><br>     <strong>res.redirect(&#39;/api/listall&#39;);<br></strong>  }).catch(next);<br><strong>};</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1015/1*rijBL0631SAFwnL1FZ6MJA.png" /><figcaption>apiController.js</figcaption></figure><p>Vamos criar um ponto de interesse a partir do <em>Browser</em>:</p><p>. Preenchimento dos campos:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/837/1*Bcxt2eBUAV9cNEDuCTX_5Q.png" /><figcaption>Browser-Criar PI</figcaption></figure><p>. Depois de clicar ‘<strong>submit</strong>’:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/722/1*0kpiErX9DyiU8-ukOBhDHA.png" /><figcaption>Browser — Listar Pontos de Interesse</figcaption></figure><p>NOTA: Previamente apagámos todos os documentos da base de dados e de seguida inserimos este, daí o resultado exibido na figura (faremos isto recorrentemente ao longo do trabalho).</p><h4>. Listar Pontos de Interesse perto da localização do utilizador da app</h4><p>Em seguida vamos listar apenas os pontos de interesse próximos de uma determinada localização, conseguimos fazer isso na rota ‘<strong>/api/details</strong>’, queremos agora renderizar essa informação.</p><p>Em ‘<strong>controllers/apiController.js’ </strong>editar a função ‘<strong>details’ </strong>da seguinte forma:</p><pre>// listar PIs baseado na distancia relativa aos valores de lng e lat <br>// passados pelo cliente<br><strong>module.exports.details = (req, res, next) =&gt;{<br></strong>  let lng = parseFloat(req.query.lng);<br>  let lat = parseFloat(req.query.lat);<br>  const maxDist = 100000;<br>PI.aggregate([{<br>  ‘$geoNear’: {<br>    “near”: { ‘type’: ‘Point’,<br>    “coordinates“: [parseFloat(lng), parseFloat(lat)] },<br>    “spherical”: true,<br>    “distanceField”: ‘dist’,<br>    “limit”: 3,<br>    “maxDistance”: maxDist<br>  }<strong><br> </strong>}])<strong><br>    .then(pi =&gt; res.render(&#39;listPIs&#39;, {pis: pi}))</strong><br>    .catch(next);<br><strong>};</strong></pre><p>Introduzimos mais alguns documentos na B.D… Ao fazer a listagem dos pontos de interesses a partir do <em>Browser </em>encontramos:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/648/1*HryEEVImUd5QyLyT_5KkNw.png" /><figcaption>Browser — listall</figcaption></figure><p>Façamos a listagem dos pontos de interesse próximos da longitude = -80.87 e latitude = 25.80 num raio de 100 Km (valor <em>hardcoded </em>definido na função ‘<strong>details’</strong>).</p><p>Passamos esses parametros a partir de uma <em>query string</em> na rota ‘<strong>/api/details/’:</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/720/1*a12F7yPjCNanU4hQjXMaCg.png" /><figcaption>Browser — details</figcaption></figure><p>De notar que o “Restaurante Rodizio” não foi listado pois este encontra-se fora do limite (100 km) <strong>.</strong></p><h4><strong>. UPDATE</strong></h4><p>Antes de passar á operação <strong>update, </strong>decidimos renomear algumas rotas, criar a rota ‘<strong>api/edit/:id</strong>’ e atualizar o código em conformidade.</p><p>Em ‘<strong>\routes\apis</strong>’ fizemos:</p><pre>const express = require (&#39;express&#39;);<br>const router = express.Router();const apiController = require(&#39;../controllers/apiController&#39;);</pre><pre>// rota de testes<br>router.get(&#39;/teste&#39;, apiController.test);</pre><pre>// criar novo ponto de interesse<br>router.post(&#39;/create&#39;,apiController.create);</pre><pre>// listar um pontos de interesse por id (para editar)<br><strong>router.get(&#39;/edit/:id&#39;,apiController.edit);</strong></pre><pre>// listar todos os pontos de interesse da BD<br>router.get(&#39;/listAll&#39;,apiController.listAll);</pre><pre>// detalhes dos pontos de interesse proximos da lng/lat introduzidas<br>router.get(&#39;/details&#39;,apiController.details);</pre><pre>// atualizar ponto de interesse<br><strong>router.post(&#39;/update/:id&#39;,apiController.update);</strong></pre><pre>// apagar ponto de interesse<br><strong>router.get(&#39;/delete/:id&#39;,apiController.delete);</strong></pre><pre>module.exports = router;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/802/1*nxkCUmwkghZZbP9DD6NWOA.png" /><figcaption>api.js</figcaption></figure><p>Notar a criação de uma rota ‘<strong>api/edit/:id</strong>’ que será usada para listar um ponto de interesse baseado num ‘<strong>id’ </strong>e exibido num <em>template </em>‘<strong>editPI.ejs</strong>’ (a criar). Os dados recebidos (num formulário) serão submetidos como ‘<strong>POST</strong>’ na rota ‘<strong>/api/update/</strong>’.</p><p>Em ‘<strong>\controllers\apiControllers.js</strong>’ vamos criar a função ‘<strong>edit’ </strong>e atualizar a função ‘<strong>update’:</strong></p><pre>// listar um ponto de interesse por id (para editar)<br><strong>exports.edit = function (req, res, next) {<br>  PI.findOne({_id: req.params.id}).then(function(pi){<br>    res.render(&#39;editPI&#39;, {pi: pi});<br>  }).catch(next);<br>};</strong></pre><pre>// atualiza &#39;pi&#39; da BD com os valores do formulário<br><strong>exports.update = function (req, res, next) {<br>  PI.findByIdAndUpdate({_id: req.params.id},<br>      req.body).then(function(){<br>    res.redirect(&#39;/api/listall&#39;);<br>}).catch(next);<br>};</strong></pre><p>Em ‘<strong>\views</strong>’ vamos criar um ficheiro ‘<strong>editPI.ejs</strong>’ e adicionar seguinte código:</p><pre><strong>&lt;!DOCTYPE html&gt;<br>&lt;html lang=&quot;en&quot;&gt;<br>&lt;head&gt;<br>  &lt;meta charset=&quot;UTF-8&quot;&gt;<br>  &lt;title&gt;Edit PI&lt;/title&gt;<br>&lt;/head&gt;<br>&lt;body&gt;<br>&lt;h2&gt;Edit&lt;/h2&gt;<br>  &lt;form action=&quot;/api/update/&lt;%= pi._id %&gt;&quot; method=&quot;POST&quot;&gt;<br>    &lt;input type=&quot;text&quot; value=&quot;&lt;%= pi.name %&gt;&quot; name=&quot;name&quot;&gt;<br>    &lt;input type=&quot;text&quot; value=&quot;&lt;%= pi.details %&gt;&quot; name=&quot;details&quot;&gt;<br>    &lt;input type=&quot;text&quot; value=&quot;&lt;%= pi.status %&gt;&quot; name=&quot;status&quot;&gt;<br>    &lt;br /&gt;<br>    &lt;button&gt;&lt;a href=&quot;/api/listall&quot;&gt;List All&lt;/a&gt;&lt;/button&gt;<br>    &lt;button type=&quot;submit&quot;&gt;Edit&lt;/button&gt;<br>  &lt;/form&gt;<br>&lt;/body&gt;<br>&lt;/html&gt;</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/704/1*Ub3o67IRmJgJQkzEwOSc4Q.png" /><figcaption>editPI.js</figcaption></figure><p>Notar que, na submissão do formulário (botão ‘<strong>edit’</strong>) chama a rota ‘<strong>/api/update/</strong>’ e os dados do formulário serão passados como ‘<strong>POST</strong>’ que a função ‘<strong>update</strong>’, em ‘<strong>\controllers\apiControllers.js</strong>’, recebe para fazer a atualização do documento na base de dados.</p><p>Vamos atualizar o template ‘<strong>listPIs.ejs</strong>’ de forma a que a partir deste, possamos fazer o <em>update </em>e posteriormente o <em>delete, </em>de um ponto de interesse á escolha.</p><pre>&lt;!DOCTYPE html&gt;<strong><br></strong>&lt;html lang=&quot;en&quot;&gt;<br>&lt;head&gt;<br>  &lt;meta charset=&quot;UTF-8&quot;&gt;<br>  &lt;title&gt;Lista PIs&lt;/title&gt;<br>&lt;/head&gt;<br>&lt;body&gt;<br>  &lt;h2&gt;Lista de Pontos de Interesse&lt;h2&gt;<br>  &lt;table border=&quot;1&quot;&gt;<br>    &lt;thead&gt;<br>      &lt;tr&gt;<br>        &lt;td&gt;Name&lt;/td&gt;<br>        &lt;td&gt;Details&lt;/td&gt;<br>        &lt;td&gt;Status&lt;/td&gt;<br>      &lt;/tr&gt;<br>    &lt;/thead&gt;<br>    &lt;tbody&gt;<br>      &lt;% pis.forEach(function(data) { %&gt;<br>        &lt;tr&gt;<br>          &lt;td&gt;&lt;%= data.name %&gt;&lt;/td&gt;<br>          &lt;td&gt;&lt;%= data.details %&gt;&lt;/td&gt;<br>          &lt;td&gt;&lt;%= data.status %&gt;&lt;/td&gt;<br><strong>          &lt;td&gt;&lt;a href=&quot;/api/edit/&lt;%= data._id %&gt;&quot;&gt;Edit&lt;/a&gt; | <br>              &lt;a href=&quot;/api/delete/&lt;%= data._id %&gt;&quot;&gt;Delete&lt;/a&gt;&lt;/td&gt;</strong><br>        &lt;/tr&gt;<br>     &lt;% }) %&gt;<br>   &lt;/tbody&gt;<br>   &lt;button&gt;&lt;a href=&quot;/&quot;&gt;Back&lt;/a&gt;&lt;/button&gt;<br>&lt;/body&gt;<br>&lt;/html&gt;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/909/1*ba3cFYWEQHja2uEAT4ycfQ.png" /><figcaption>listPIs.ejs</figcaption></figure><p>Notar as rotas referenciadas pelos links: ‘<strong>/api/edit/id</strong>’ e ‘<strong>/api/delete/id’ </strong>para os botões ‘<strong>Edit</strong>’ e ‘<strong>Delete</strong>’. O ‘<strong>id</strong>’ é passado no ciclo <em>forEach</em> através do objeto ‘<strong>pis</strong>’ que é propriedade do objeto anónimo na função ‘<strong>listAll</strong>’ em ‘<strong>\controller\apiController.js</strong>’.</p><h4><strong>. DELETE</strong></h4><p>Já temos a referencia á rota ‘<strong>/api/delete/:id</strong>’<strong> </strong>no <em>template </em>‘<strong>listPIs.ejs</strong>’ precisamos apenas editar a função ‘<strong>delete</strong>’ de forma a que esta nos redireccione para a rota ‘<strong>/api/listall</strong>’ quando a operação for bem sucedida.</p><p>Em ‘<strong>\controllers\apiControllers.js</strong>’ editar a função ‘<strong>delete</strong>’ da seguinte forma:</p><pre>// apaga &#39;pi&#39; da BD, depois, redirecciona para &#39;/api/listall&#39;<br><strong>exports.delete = function (req, res, next) {</strong><br>  // &#39;req.params.id&#39;-&gt;devolve-me o parametro id na req<br>  <strong>PI.findOneAndDelete({_id: req.params.id}).then(function(pi){</strong><br><strong>    console.log(&quot;Registo eliminado com sucesso!&quot;);<br>    res.redirect(&#39;/api/listall&#39;);<br>  }).catch(next);<br>};</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/835/1*vaRfZ5LuOcclVtjisnzAPw.png" /><figcaption>apiController.js</figcaption></figure><p><strong>TESTAR AS OPERAÇÕES</strong></p><p>. <strong>Criar </strong>um ponto de interesse</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/824/1*zzDE_CY7MEnxUoE6acsolA.png" /><figcaption>Browser-criar PI</figcaption></figure><p>. <strong>Listar </strong>pontos de interesse (ao clicar ‘<strong>submit</strong>’)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/774/1*1eND8IvREdC7lYslxKSEkA.png" /><figcaption>Browser — listall</figcaption></figure><p>. <strong>Editar </strong>(Restaurante Gaucho)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/607/1*ruVyJiiBr1kzZDLkcAWVog.png" /><figcaption>Browser-editar</figcaption></figure><p>. <strong>Atualizar </strong>(Restaurante Gaucho ao clicar ‘<strong>Edit</strong>’)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/846/1*-gI0OOeNJ5P5S7kvJI3Pfg.png" /><figcaption>Browser-atualizar</figcaption></figure><p>. <strong>Apagar </strong>(Restaurante Gaucho ao clicar ‘<strong>Delete</strong>’)</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/772/1*v_I6aJKFDspPwSKrTTmiag.png" /><figcaption>Browser — Delete</figcaption></figure><p>. <strong>Listar </strong>Restaurantes próximos de<strong> lng=-80.87 &amp; lat=25.80</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/719/1*HJh991TTtuwVallzgePmCA.png" /><figcaption>Browser — Details</figcaption></figure><h4>Optimizar código</h4><p>Antes de passarmos á próxima fase do tutorial, fizemos algumas alterações no código, nos seguintes ficheiros:</p><ul><li><strong>\views\createPI.ejs :</strong></li></ul><pre>&lt;html lang=”en”&gt;<br>&lt;head&gt;<br>  &lt;meta charset=”UTF-8&quot;&gt;<br>  &lt;title&gt;TESTE&lt;/title&gt;<br>  &lt;link rel=”stylesheet” type=”text/css”<br>    href=”/assets/colocoAquiMeu.css”&gt;<br>&lt;/head&gt;<br>&lt;body&gt;<br>  &lt;h2&gt;Criar Ponto Interesse&lt;h2&gt;<br>  &lt;form action=”/api/interest” method=”POST”&gt;<br>    &lt;input type=”text” placeholder=”name&quot; name=”name&quot;&gt;<br>    &lt;input type=”text” placeholder=”details&quot; name=”details&quot;&gt;<br><strong>    &lt;input type=”text” placeholder=”longitude&quot;<br>       name=”geometry.coordinates[0]&quot;&gt;<br>    &lt;input type=&quot;text&quot; placeholder=&quot;latitude&quot;<br>       name=&quot;geometry.coordinates[1]&quot;&gt;</strong><br>    &lt;button type=”submit”&gt;Submit&lt;/button&gt;<br>  &lt;/form&gt;<br>&lt;/body&gt;<br>&lt;/html&gt;</pre><p>Estas alterações permitem simplificar a função ‘<strong>create’ </strong>no controlador.</p><ul><li><strong>/controllers/apiController.js </strong>:</li></ul><pre><strong>exports.create = function (req, res, next) {</strong><br>  PI.create(<strong>req.body</strong>).then(function(pi){<br>    res.redirect(&#39;/api/listall&#39;);<br>  }).catch(next);<br><strong>};</strong></pre><ul><li><strong>\views\editPI.js :</strong></li></ul><pre>&lt;!DOCTYPE html&gt;<br>&lt;html lang=&quot;en&quot;&gt;<br>&lt;head&gt;<br>  &lt;meta charset=&quot;UTF-8&quot;&gt;<br>  &lt;title&gt;Edit PI&lt;/title&gt;<br>&lt;/head&gt;<br>&lt;body&gt;<br>&lt;h2&gt;Edit&lt;/h2&gt;<br>  &lt;form action=&quot;/api/update/&lt;%= pi._id %&gt;&quot; method=&quot;POST&quot;&gt;<br>    &lt;input type=&quot;text&quot; value=&quot;&lt;%= pi.name %&gt;&quot; name=&quot;name&quot;&gt;<br>    &lt;input type=&quot;text&quot; value=&quot;&lt;%= pi.details %&gt;&quot; name=&quot;details&quot;&gt;<br>    &lt;input type=&quot;text&quot; value=&quot;&lt;%= pi.status %&gt;&quot; name=&quot;status&quot;&gt;<br><strong>      &lt;input type=&quot;text&quot; value=&quot;&lt;%= pi.geometry.coordinates[0] %&gt;&quot;<br>         name=&quot;geometry.coordinates[0]&quot;&gt;<br>      &lt;input type=&quot;text&quot; value=&quot;&lt;%= pi.geometry.coordinates[1] %&gt;&quot;<br>         name=&quot;geometry.coordinates[1]&quot;&gt;<br>&lt;button type=&quot;submit&quot;&gt;Update&lt;/button&gt;</strong><br>  &lt;/form&gt;<br>&lt;/body&gt;<br>&lt;/html&gt;</pre><p>Estas alterações permitem-nos editar também a latitude e longitude.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/982/1*jabX1bhCYtglYjBVnT0JVw.png" /><figcaption>Browser — Edit</figcaption></figure><ul><li><strong>\views\listPIs.js :</strong></li></ul><pre>&lt;!DOCTYPE html&gt;<strong><br></strong>&lt;html lang=&quot;en&quot;&gt;<br>&lt;head&gt;<br>  &lt;meta charset=&quot;UTF-8&quot;&gt;<br>  &lt;title&gt;Lista PIs&lt;/title&gt;<br>&lt;/head&gt;<br>&lt;body&gt;<br>  &lt;h2&gt;Lista de Pontos de Interesse&lt;h2&gt;<br>  &lt;table border=&quot;1&quot;&gt;<br>    &lt;thead&gt;<br>      &lt;tr&gt;<br>        &lt;td&gt;Name&lt;/td&gt;<br>        &lt;td&gt;Details&lt;/td&gt;<br>        &lt;td&gt;Status&lt;/td&gt;<br>      &lt;/tr&gt;<br>    &lt;/thead&gt;<br>    &lt;tbody&gt;<br>      &lt;% pis.forEach(function(data) { %&gt;<br>        &lt;tr&gt;<br>          &lt;td&gt;&lt;%= data.name %&gt;&lt;/td&gt;<br>          &lt;td&gt;&lt;%= data.details %&gt;&lt;/td&gt;<br>          &lt;td&gt;&lt;%= data.status %&gt;&lt;/td&gt;<br><strong>          &lt;td&gt;&lt;%= data.geometry.coordinates[0] %&gt;&lt;/td&gt;<br>          &lt;td&gt;&lt;%= data.geometry.coordinates[1] %&gt;&lt;/td&gt;<br>          &lt;td&gt;&lt;a href=&quot;/api/edit/&lt;%= data._id %&gt;&quot;&gt;Edit&lt;/a&gt; |<br>              &lt;a onclick=&quot;confirmation(&#39;Delete<br>                record?!&#39;,&#39;/api/delete/&lt;%= data._id %&gt;&#39;)&quot; href=#<br>                 &gt;Delete&lt;/a&gt;&lt;/td&gt;<br>        &lt;/tr&gt;<br>     &lt;% }) %&gt;<br>     &lt;/tbody&gt;<br>     &lt;button&gt;&lt;a href=&quot;/&quot;&gt;Back&lt;/a&gt;&lt;/button&gt;</strong></pre><pre><strong>&lt;script&gt;<br>function confirmation(msg, url) {<br>  if(confirm(msg)) {<br>    window.location.href = url;<br>  }else{ false; }<br>}<br>&lt;/script&gt;</strong></pre><pre>&lt;/body&gt;<br>&lt;/html&gt;</pre><p>Estas alterações permitem-nos listar a latitude e longitude e invocar uma <em>box-confirm </em>ao clicar em ‘<strong>delete’.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ezdZBttTaLhe1ZpXpHX5Zw.png" /><figcaption>Browser — Delete</figcaption></figure><h3>Criar e listar Pontos de Interesse baseado na localização do dispositivo usando HTML Geolocation API</h3><p>No momento conseguimos criar um ponto de interesse introduzindo manualmente as coordenadas latitude e longitude, vamos de seguida implementar a ‘<strong><em>HTML Geolocation API’ </em></strong>que nos irá permitir capturar a posição geográfica do utilizador e guardá-la na base de dados, na submissão do formulário.</p><p>A propósito da API assinalar que esta é mais precisa em dispositivos com GPS e que atualmente só funciona em sites seguros como https.</p><h4>Uso da HTML Geolocation API</h4><p>Usaremos o método getCurrentPosition() para obter a posição do utilizador. Criaremos um evento ‘<strong><em>onclick</em></strong>’ que associaremos ao botão ‘<strong><em>submit</em></strong><em>’ </em>esse evento chamará uma função que capturará a longitude e latitude do dispositivo usado pelo utilizador.</p><p>Em ‘<strong>/views/createPI.ejs</strong>’ adicionar o seguinte código:</p><p><strong>No formulário fazer:</strong></p><pre>&lt;%# &quot;/api/create&quot;-&gt; rota de criação de novo registo %&gt;<br><strong>&lt;form id=&quot;frm&quot; </strong>action=&quot;/api/create&quot; method=&quot;POST&quot;<strong>&gt;</strong><br><strong>  </strong>&lt;input type=&quot;text&quot; placeholder=&quot;name&quot;<strong> value=&quot;MeuPI&quot; </strong>name=&quot;name&quot;&gt;<strong><br> </strong> &lt;input type=&quot;text&quot; placeholder=&quot;details&quot;<strong> value=&quot;Detalhes&quot;<br>     </strong>name=&quot;details&quot;&gt;<br>  &lt;input type=&quot;text&quot; <strong>id=&quot;input_lng&quot;</strong> placeholder=&quot;longitude&quot;<br>     name=&quot;geometry.coordinates[0]&quot;&gt;<br>  &lt;input type=&quot;text&quot; <strong>id=&quot;input_lat&quot;</strong> placeholder=&quot;latitude&quot;<br>     name=&quot;geometry.coordinates[1]&quot;&gt;<br>  &lt;input type=&quot;button&quot;<strong> onclick=&quot;onSubmitClk()&quot; </strong>value=&quot;Submit&quot;&gt;<br><strong>&lt;/form&gt;<br></strong>&lt;%# elemento onde vai ser renderizado a msg erro %&gt;<br><strong>&lt;div id=&quot;map&quot;&gt;&lt;/div&gt;</strong></pre><p>Adicionámos valores <em>hardcoded</em> nos ‘<em>inputs’ </em>de <strong><em>name </em></strong>e <strong><em>details </em></strong>apenas para agilizar os testes e <strong><em>ids</em> </strong>para o <strong>&lt;form&gt;</strong>, <strong><em>longitude </em></strong>e <strong><em>latitude</em></strong> para referenciarmos numa das funções (no <em>script</em>).</p><p>Adicionámos também um ‘<strong>&lt;div id=”map”&gt;&lt;/div&gt;’ </strong>que será o elemento onde vai ser renderizado a msg erro.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rxtpJKUHQGpGR27q1kCJXg.png" /><figcaption>create.ejs</figcaption></figure><p><strong>Adicionar uma tag ‘&lt;script&gt;’ e passar o seguinte código:</strong></p><pre><strong>&lt;script&gt;</strong></pre><pre><strong>function setLngLat(lng, lat){<br>  </strong>// passa os valores de longitude e latitude nos inputs com<br>  // ids:&#39;input_lng&#39; e &#39;input_lat&#39;<br>  <strong>document.getElementById(&#39;input_lng&#39;).setAttribute(&#39;value&#39;, lng);<br>  document.getElementById(&#39;input_lat&#39;).setAttribute(&#39;value&#39;, lat);<br></strong>  // faz a submissão do formulário de id=<strong>&quot;</strong>frm<strong>&quot;<br>  document.getElementById(&quot;frm&quot;).submit();<br>}</strong></pre><pre><strong>function getGeoPos(callback){</strong><br>  // parametro para &#39;getCurrentPosition()&#39;<br>  <strong>function local(posicion){<br>    var lng = posicion.coords.longitude;<br>    var lat = posicion.coords.latitude;<br>    </strong>// verifica se é função de callback <strong>   <br>    if (typeof callback === &#39;function&#39;) {<br>      callback(lng, lat);<br>  }<br> }</strong><br>// chamada á API-HTML_Geolocation que devolve a posição da maquina<br><strong>navigator.geolocation.getCurrentPosition(local);</strong><br><strong>}</strong></pre><pre><strong>function onSubmitClk(){<br>  getGeoPos(setLngLat);<br>}</strong></pre><pre><strong>&lt;/script&gt;</strong></pre><p>A função ‘<strong>setLngLat’ </strong>passa os valores de valores de longitude e latitude na submissão do formulário.</p><p>A função ‘<strong>getGeoPos(callback)’ </strong>obtém a posição geográfica do dispositivo a partir da API. Recebe a função ‘<strong>setLngLat(lng, lat)’ </strong>como <em>calback</em> uma vez que as operações de recolha das coordenadas (longitude e latitude) e de submissão desses valores no formulário têm de ser assíncronas, a primeira tem de ser completada antes de ocorrer a segunda, caso contrário os valores inseridos serão vazios (nulos).</p><p>A função <strong>‘onSubmitClk()’ </strong>é a função chamada no evento ‘<em>onclick’ </em>do botão ‘<em>submit’.</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*unQwpkpET25ev7tvl2Gy8w.png" /><figcaption>create.ejs</figcaption></figure><p><strong>Obter latitude e longitude para <em>query-string</em> da rota:”/api/details/?lng=</strong>valorLng<strong>&amp;lat=</strong>valorLat<strong>”:</strong></p><p>Queremos criar um botão de nome ‘<strong>Near ’ </strong>que nos encaminhe para o <em>end point ‘</em><strong>/api/details/’</strong><em> </em>e passar uma<em> query-string </em>com<em> </em>valores da latitude e longitude do dispositivo. Recordamos que é comparando com esses valores que os 3 pontos de interesse mais próximos (<em>hardcoded</em>) num raio de 100km (<em>hardcoded</em>) são devolvidos ao utilizador (rever função ‘<strong>details’ </strong>em ‘<strong>\controllers\apiControllers.js</strong>’).</p><p><strong>Criar botão:</strong></p><pre><strong>&lt;button&gt;&lt;a onclick=&quot;onNearClk(&#39;/api/details/&#39;)&quot; href=# &gt;Near&lt;/a&gt;&lt;/button&gt;</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*X2vwqHV9o17LadISW1fqgw.png" /><figcaption>create.ejs</figcaption></figure><p><strong>Criar função ‘onNearClk’:</strong></p><pre>// Obter latitude e longitude para query-string da rota:&quot;/api/details/?lng=lng&amp;lat=lat&quot;<br><strong>function onNearClk(url){<br>  </strong>// &#39;getElementById(&#39;map&#39;)&#39;-&gt;referencia elemento onde vai<br>   // renderizar a mensagem<br>   <strong>var output = document.getElementById(&#39;map&#39;);</strong></pre><pre>// Verificar se navegador suporta geolocalização<br>  <strong> if (!navigator.geolocation) {<br>     output.innerHTML = &quot;&lt;p&gt;Your current browser does not support<br>     Geolocation&lt;/p&gt;&quot;;<br>   }else{<br>    </strong>// parametro para &#39;getCurrentPosition()&#39;<br><strong>    function local(posicion){<br>      const lat = posicion.coords.latitude;<br>      const lng = posicion.coords.longitude;<br>      location.href = url+&#39;?lng=&#39;+lng+&#39;&amp;&#39;+&#39;lat=&#39;+lat;<br>    }</strong><br>    // parametro para &#39;getCurrentPosition()&#39;<br>    <strong>function error(){<br>      output.innerHTML = &quot;&lt;p&gt;Unhable to find your location&lt;/p&gt;&quot;;<br>    }<br>   </strong>// chamada á API-HTML_Geolocation que devolve a posição do<br>   // dispositivo<br><strong>   navigator.geolocation.getCurrentPosition(local, error);<br>  }<br>}<br>&lt;/script&gt;</strong></pre><p>De notar que a função de <em>callback </em>‘<strong>local’ </strong>passará os valores de latitude e longitude para o atributo ‘<strong>href’ </strong>da <em>anchor ‘</em><strong>&lt;a&gt;’ </strong>na execução do evento ‘<strong><em>onClick ’</em></strong>onde a função ‘<strong>onNearClk(url)’ </strong>é chamada.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yJEolpDUryajcCu-0HEdGg.png" /><figcaption>create.ejs</figcaption></figure><p>Criámos este mesmo botão com as mesmas funcionalidade na <em>view </em>‘<strong>listPI.ejs’</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*C9KcyUUHSWBl5Z0MV6Ud7g.png" /><figcaption>listPI.ejs</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*B5BwX_PxRl_HwZmTZjxUmQ.png" /><figcaption>listPI.ejs</figcaption></figure><h4><strong>Testar o código:</strong></h4><ul><li><strong>Criar PI</strong></li><li><strong>Listar PIs próximos</strong></li></ul><p><strong>. Criar PI:</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/822/1*V0rpE3Fb691FZGZuGBpJKQ.png" /><figcaption>browser — criar PI</figcaption></figure><p>De notar que os campos <strong>Nome </strong>e <strong>Detalhes </strong>aparecem preenchidos. Ao clicar ‘<strong>submit ’ </strong>(sem preencher os campos restantes) encontraremos na lista de Pontos de Interesse, um registo com a longitude e latitude da nossa localização atual, no nosso caso temos:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*njYpX9uyup2N8Dj8up4GJg.png" /><figcaption>browser — lista PIs</figcaption></figure><p>Ao clicar no botão ‘<strong>Near’ </strong>obteremos a lista dos <strong>3</strong> pontos de interesse mais próximos num raio de <strong>100 km. </strong>De assinalar que de momento só existem 2 registos um correspondente á zona de Lisboa e outro á zona da Guarda (separados por mais de 100 km!).</p><p><strong>. Lista de PIs próximos</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/841/1*S6WakWCwwAT6i8oST21j0w.png" /><figcaption>browser — list near</figcaption></figure><p>Reparem na query string no navegador, os valores representam a nossa localização atual.</p><h3>Renderizar o mapa das localizações com API Google Maps</h3><p>Conseguimos captar a nossa posição geográfica atual, pretendemos a seguir renderizar um mapa a partir das coordenadas recebidas, para isso usaremos o ‘Google Maps Static API’.</p><p>Para usar o ‘Google Maps Static API’ são necessários realizar os seguintes passos:</p><p><strong>. Criar um projeto em </strong><a href="https://console.developers.google.com/projectselector2/apis/dashboard?supportedpurview=project&amp;project&amp;folder&amp;organizationId"><strong>Console Developers da Google</strong></a><strong>.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*RTy3SvJ9VNg5hNcmJLMNBw.png" /><figcaption><a href="https://console.developers.google.com/projectselector2/apis/dashboard?supportedpurview=project&amp;project&amp;folder&amp;organizationId"><strong>Console Developers da Google</strong></a></figcaption></figure><p><strong>. Seguir: ‘biblioteca’&gt; ‘Maps JavaScript API’ &gt; ‘Maps Static API’ &gt;‘Ativar’</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/997/1*DWjskXCfK8T0VoZesIuFAA.png" /><figcaption><a href="https://console.developers.google.com/projectselector2/apis/dashboard?supportedpurview=project&amp;project&amp;folder&amp;organizationId"><strong>Console Developers da Google</strong></a></figcaption></figure><p><strong>. Seguir: ‘Credenciais’ &gt; ‘criar credenciais’ &gt; ‘chave de API’</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GDix6hpim4xvcqJqGza7Sw.png" /><figcaption><a href="https://console.developers.google.com/projectselector2/apis/dashboard?supportedpurview=project&amp;project&amp;folder&amp;organizationId"><strong>Console Developers da Google</strong></a></figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1020/1*LadRpYZ2vw5A6OJAEo3CVQ.png" /><figcaption><a href="https://console.developers.google.com/projectselector2/apis/dashboard?supportedpurview=project&amp;project&amp;folder&amp;organizationId"><strong>Console Developers da Google</strong></a></figcaption></figure><p><strong>. Copiar chave da API e guardá-la</strong></p><p><strong>. Voltar a ‘Maps Static API</strong>’ <strong>e clicar ‘Gerenciar’</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/870/1*BHU_5Ty3NzBcaLqjG4oeWQ.png" /><figcaption><a href="https://console.developers.google.com/projectselector2/apis/dashboard?supportedpurview=project&amp;project&amp;folder&amp;organizationId"><strong>Console Developers da Google</strong></a></figcaption></figure><p><strong>. Seguir: ‘chave secreta de assinatura do URL’ &gt; ‘Permitir uso sem assinatura’.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Ak6xB4IP6zNxStH3nE5XSg.png" /><figcaption><a href="https://console.developers.google.com/projectselector2/apis/dashboard?supportedpurview=project&amp;project&amp;folder&amp;organizationId"><strong>Console Developers da Google</strong></a></figcaption></figure><p><strong>. Voltar a ‘Maps JavaScript API’ e ativar.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/908/1*T_IiHFCQwYYQeRbyBm9XFQ.png" /><figcaption><a href="https://console.developers.google.com/projectselector2/apis/dashboard?supportedpurview=project&amp;project&amp;folder&amp;organizationId"><strong>Console Developers da Google</strong></a></figcaption></figure><p>Existem várias outras opções que podem ser configuradas e convém que sejam exploradas, mas neste projeto não vamos utilizar.</p><p>Para ter acesso completo aos recursos da API, a Google pede para ativar ‘<strong><em>billing’ </em></strong>no projeto criado, aceder á pagina <a href="https://console.cloud.google.com/projectselector2/billing/enable?redirect=https:%2F%2Fdevelopers.google.com%2Fmaps%2Fdocumentation%2Fmaps-static%2Fusage-and-billing%3FdialogOnLoad%3Dbilling-enabled&amp;_ga=2.21059195.1557725644.1557058083-2126903607.1557054392"><strong>aqui</strong></a><strong>!</strong></p><p><strong>. Seguir: ‘Selecionar ’(projeto)&gt; ‘Criar conta de faturamento’ &gt; ‘Aceitar condições’ &gt; (preencher os campos)</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*zz5CEdfFD6_YeONgzsZStA.png" /><figcaption><em>billing</em></figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kgzdv_TD4jBVtwlPtfN8Xg.png" /><figcaption><em>billing</em></figcaption></figure><p>Saber mais <a href="https://developers.google.com/maps/documentation/maps-static/usage-and-billing"><strong>aqui</strong></a><strong>!</strong></p><p>De momento, no nosso projeto, não temos ativado o ‘<strong>billing</strong>’ isso impede-nos de renderizar mapas que refiram outras posições geográficas para além da nossa atual e impede ainda a utilização do parâmetro <strong><em>zoom </em></strong>na chamada da API (outros comportamentos imprevistos podem também ocorrer).</p><h4>Implementação da <strong>Google Maps Static API</strong></h4><p>Passemos ao código. <br>Em ‘<strong>views/details.ejs</strong>’ editar HTML assim:</p><pre>&lt;tbody&gt;</pre><pre>&lt;% pis.forEach(function(data) { %&gt;<br>  &lt;tr&gt;<br>    &lt;td&gt;&lt;%= data.name %&gt;&lt;/td&gt;<br>    &lt;td&gt;&lt;%= data.details %&gt;&lt;/td&gt;<br>    &lt;td&gt;&lt;%= data.status %&gt;&lt;/td&gt;<br>    &lt;td&gt;&lt;%= data.geometry.coordinates[0] %&gt;&lt;/td&gt;<br>    &lt;td&gt;&lt;%= data.geometry.coordinates[1] %&gt;&lt;/td&gt;<br>    &lt;td&gt;&lt;a href=&quot;/api/edit/&lt;%= data._id %&gt;&quot;&gt;Edit&lt;/a&gt;<br>    <strong>&lt;td&gt;&lt;a onclick=&quot;onShowMapClck(<br>         &#39;&lt;%= data.geometry.coordinates[0]%&gt;&#39;,<br>         &#39;&lt;%= data.geometry.coordinates[1]%&gt;&#39;,&#39;&lt;%= data.name %&gt;&#39;)&quot;<br>         href=#&gt;Show Map&lt;/a&gt;<br>  &lt;/tr&gt;<br>&lt;% }) %&gt;</strong></pre><pre>&lt;/tbody&gt;<br>&lt;button&gt;&lt;a href=&quot;/&quot;&gt;Back&lt;/a&gt;&lt;/button&gt;<br>&lt;%# tag que vai receber o nome do PI ao clicar &#39;Show map&#39; %&gt;<br><strong>&lt;p id=&quot;name&quot;&gt;&lt;/p&gt;</strong><br>&lt;%# elemento onde vai ser renderizado o mapa %&gt;<br><strong>&lt;div id=&quot;map&quot;&gt;&lt;/div&gt;</strong></pre><pre>&lt;%# referenciar API-GOOGLE_STATIC_MAP %&gt;<br><strong>&lt;script src=&quot;https://maps.googleapis.com/maps/api/js?key=MINHA_API_KEY&quot;&gt;<br>&lt;/script&gt;</strong></pre><p>Notar que criámos um evento que chamará uma função ‘<strong>onShowMapClck(lng, lat, name)’ </strong>que receberá como argumentos a ‘<strong>longitude</strong>’, <strong>latitude </strong>e o ‘<strong>nome ’</strong>dos <strong>PIs </strong>próximos num raio de 100 km (<em>hardcoded</em>).</p><p>Criámos ainda as tags ‘<strong>&lt;p id=”name”&gt;&lt;/p&gt;</strong>’<strong> </strong>e<strong> </strong>‘<strong>&lt;div id=”map”&gt;&lt;/div&gt;</strong>’ para receberem o nome do PI e o mapa a renderizar…</p><p>Na tag ‘<strong>&lt;script&gt;</strong>’<strong> </strong>referenciamos a ‘<strong>Google Maps Static API’</strong>,<strong> </strong>no valor ‘<strong>key</strong>’<strong> </strong>passamos a chave que foi gerada para o nosso projeto.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*pw7UMLQo5pMJgJ390YWDwg.png" /><figcaption>details.ejs</figcaption></figure><p>No mesmo ficheiro vamos definir a função ‘<strong>onShowMapClck(lng, lat, name)’ </strong>que é chamada no evento do botão ‘<strong>Show Map</strong>’, acrescentar:</p><pre><strong>&lt;script&gt;</strong></pre><pre><strong>function onShowMapClck(lng, lat, name){<br></strong>  // &#39;getElementById(&#39;map&#39;)&#39;-&gt;referencia elemento onde vai<br>  // renderizar o mapa<strong><br>  var outMap = document.getElementById(&#39;map&#39;);<br>  var outName = document.getElementById(&#39;name&#39;);</strong></pre><pre>// guarda imagem a partir da chamada á API-GOOGLE_STATIC_MAP<strong><br>var imgURL = &quot;https://maps.googleapis.com/maps/api/staticmap?center=&quot;+lat+&quot;,&quot;+lng+&quot;&amp;size=600x300&amp;markers=color:red%7C&quot;+lat+&quot;,&quot;+lng+&quot;&amp;key=MINHA_API_KEY&quot;;</strong></pre><pre><strong>  </strong>// renderizar o mapa<strong><br>  outMap.innerHTML =&quot;&lt;img src=&#39;&quot;+imgURL+&quot;&#39;&gt;&quot;;<br>  </strong>// passar o nome de PI<strong><br>  outName.innerHTML = name;<br>}</strong></pre><pre><strong>&lt;/script&gt;</strong></pre><p>A função recebe como argumentos ‘<strong>longitude</strong>’ e ‘<strong>latitude ’</strong>que são passados como valores para a <strong><em>query-string</em></strong> de uma <strong><em>URL</em> </strong>que referencia a ‘Google Maps Static API’. Não esquecer de passar no valor ‘<strong>key</strong>’, a chave gerada para o nosso projeto. O objeto ‘<strong>imgURL</strong>’ vai ser passado para a <strong>‘&lt;div id=”map”&gt;</strong>&lt;<strong>/div&gt;</strong>’ que é onde o mapa será renderizado.</p><p>O argumento ‘<strong>name</strong>’ serve para passar na tag ‘<strong>&lt;p id=”name”&gt;&lt;/p&gt;</strong>’ o nome do ponto de interesse seleccionado.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*i4-L5-9ogpF0_pYXOJSwRQ.png" /><figcaption>details.ejs</figcaption></figure><p>Deixo de seguida um link de documentação | <a href="https://developers.google.com/maps/documentation/javascript/tutorial">link</a>.</p><h4>Testar o código:</h4><p><strong>. Ir para a página ‘http://localhost:5000/’</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/842/1*BiIsqvazpnBxdTAS5MMMrA.png" /><figcaption>browser — <strong>localhost:5000/</strong></figcaption></figure><p><strong>. Criar novo Ponto de Interesse clicando botão ‘Submit’.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9t4NSxTLAP3cHSUlXeHsUg.png" /><figcaption>browser — list</figcaption></figure><p><strong>. Clicar ‘Near’ e na página de ‘detalhes’ clicar ‘show map’.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/917/1*qPMivYmMjN5fT0YT3CbDFQ.png" /><figcaption>browser — render map</figcaption></figure><p><strong>. Eis o resultado que mostrou quando estávamos no ‘Café Ponto de Encontro’ a mais de 100 km de Lisboa.</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*D_LtU0lEie8Hu3oUumGp6g.png" /><figcaption>browser — render map</figcaption></figure><p><strong>Nota:</strong> O resultado exibido é referente ao estado da B.D. na altura, desde então já foram criados e apagados vários registos.</p><h3>Criação de um sistema de autenticação login e registo com Passport</h3><p>Vamos em seguida criar um sistema de login e registo. Usaremos um módulo chamado <strong>Passport </strong>que é um <em>middleware </em>de autenticação criado para <strong>Node.js</strong></p><p>Para esta parte do projeto necessitaremos acrescentar as seguintes dependencias:</p><ul><li><strong>“bcryptjs”—</strong> usado para encriptação de passwords (<em>hashing</em>)</li><li><strong>“connect-flash”— </strong>usado para uso de mensagens <em>flash</em></li><li><strong>“express-ejs-layouts”—</strong>para complementar <strong>ejs </strong>que não possui <em>layouts</em></li><li><strong>“express-session”— </strong>usado para uso de mensagens <em>flash</em></li><li><strong>“passport” — </strong><em>middleware </em>de autenticação</li><li><strong>“passport-local”— </strong>a<strong> </strong>estratégia de autenticação <em>passport </em>que iremos usar(usa base de dados local).</li></ul><p>No terminal aberto na localização do projeto fazer:</p><pre><strong>npm install --save bcryptjs connect-flash express-ejs-layouts express-session passport passport-local</strong></pre><p>Consultar ‘<strong>package.json</strong>’:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/867/1*WBEZGENs4mmNixP5Iapz3g.png" /><figcaption>package.json</figcaption></figure><p>Vamos incluir os módulos instalados em ‘<strong>app.js’:</strong></p><pre>// incluir as dependências instaladas<br>const express = require(&#39;express&#39;);<br>const bodyParser = require(&#39;body-parser&#39;);<br>const mongoose = require(&#39;mongoose&#39;);<br><strong>const expressLayouts = require(&#39;express-ejs-layouts&#39;);<br>const passport = require(&#39;passport&#39;);<br>const flash = require(&#39;connect-flash&#39;);<br>const session = require(&#39;express-session&#39;);</strong></pre><pre>const app = express();<br>...</pre><p><strong>Necessitamos criar <em>middleware </em>para<em>:</em></strong></p><ul><li><strong><em>Express session</em></strong></li><li><strong><em>ExpressLayouts</em></strong></li><li><strong><em>Connect flash</em></strong></li><li><strong><em>Global variables</em></strong></li><li><strong><em>Route-handlers</em></strong></li><li><strong><em>Passport</em></strong></li></ul><h4>. ExpressLayouts middleware</h4><p>. Em ‘<strong>app.js’ </strong>adicionar o seguinte código:</p><pre>// define &#39;/views/layout&#39; como main-layout! (é renderizada na raiz)<br><strong>app.use(expressLayouts);</strong></pre><h4>. Route-handlers middleware</h4><p>. Em ‘<strong>app.js’ </strong>adicionar o seguinte código:</p><pre>...<br>// ROUTE-HANDLERS middleware<br>const api = require(&#39;./routes/api&#39;);<strong><br>const users = require(&#39;./routes/users&#39;);<br>const index = require(&#39;./routes/index&#39;);<br>app.use(&#39;/api&#39;, api);<br>app.use(&#39;/users&#39;, users);<br>app.use(&#39;/&#39;, index);<br>...</strong></pre><p>De notar que os ficheiros ‘<strong>users.js</strong>’ e ‘<strong>index.js’ </strong>estão por criar! Serão criados posteriormente.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MVABhJL9ac31ViTCrX8i9A.png" /><figcaption>ExpressLayouts + Route-handlers middleware</figcaption></figure><h4>. Express session middleware</h4><p>. Em ‘<strong>app.js’ </strong>adicionar o seguinte código:</p><pre>...<br>// Express session middleware<br><strong>app.use(<br>  session({<br>  secret: &#39;secret&#39;,<br>  resave: true,<br>  saveUninitialized: true<br> })<br>);<br></strong>...</pre><h4>. Passport middleware</h4><p>. Em ‘<strong>app.js’ </strong>adicionar o seguinte código:</p><pre>// Passport middleware<br><strong>app.use(passport.initialize());<br>app.use(passport.session());</strong></pre><h4>. Connect flash middleware</h4><p>. Em ‘<strong>app.js’ </strong>adicionar o seguinte código:</p><pre>// Connect flash middleware<br><strong>app.use(flash());</strong></pre><h4>. Global variables middleware</h4><p>. Em ‘<strong>app.js’ </strong>adicionar o seguinte código:</p><pre>// Global variables middleware<br><strong>app.use(function(req, res, next) {</strong><br>  // ‘res.locals’-&gt;é a forma de criar variáveis ou funções globais<br><strong>  res.locals.success_msg = req.flash(‘success_msg’);<br>  res.locals.error_msg = req.flash(‘error_msg’);</strong><br>  // passport tem as suas próprias flash-msgs<br>  // que passa em ‘flash(‘error’)’, assim faço overwrite<br><strong>  res.locals.error = req.flash(‘error’);<br>  next();<br>});</strong></pre><p>A ordem do <em>middleware </em>é importante, como já anteriormente referimos! Adicionar o <em>middleware </em>assim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*opm0q_HJxL3mmHO3hKIOrQ.png" /><figcaption>middleware</figcaption></figure><h4>. Acrescentar os ficheiros necessários a esta parte do projeto</h4><p>Criar os seguintes ficheiros:</p><ul><li>/config/<strong>auth.js</strong> —receberá código para autenticação das rotas</li><li>/config/<strong>passport.js</strong> —receberá código para <em>Passport-local-strategy</em></li><li>/controller/<strong>indexController.js</strong> — controlador para a rota ‘<strong>index.js’</strong>.</li><li>/controller/<strong>usersContoller.js</strong> — controlador para a rota ‘<strong>users.js’</strong>.</li><li>/public/<strong>assets </strong>— para receber ficheiros externos como ‘<strong>styles.css</strong>’.</li><li>/routes/<strong>index.js </strong>— rota para página<strong> ‘Home’</strong>.</li><li>/routes/<strong>users.js </strong>— rotas para para páginas ‘<strong>Login ’</strong>e ‘<strong>Register</strong>’.</li><li>/views/<strong>dashboard.ejs </strong>— página dashboard-teste.</li><li>/views/<strong>layout.ejs </strong>— <em>layout </em>que recebe o ‘<strong>&lt;body&gt;’</strong> das restantes páginas.</li><li>/views/<strong>login.ejs </strong>— página de Login.</li><li>/views/<strong>register.ejs</strong> — página de Register.</li><li>/views/<strong>welcome.ejs</strong> — página Home.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/219/1*BgXCwb6eyAo0xUNZMC4RtA.png" /><figcaption>estrutura de pastas e ficheiros</figcaption></figure><h4>. Estruturar o nosso layout</h4><p>Antes de passar ao código, vamos ao site de <a href="https://bootswatch.com/"><em>bootswatch</em></a> escolher um tema (<em>journal</em>) e copiar o endereço do CSS a partir do botão ‘<strong>Download</strong>’(fazer right-click+copiar endereço) para passar como referencia na tag ‘<strong>&lt;link&gt;</strong>’</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*SJh67zZujqAMj_NVETe8Lg.png" /><figcaption>site-bootswatch</figcaption></figure><p>Vamos a <a href="https://fontawesome.com/start"><em>fontawesome</em></a><em> </em>copiar a <em>tag </em>‘<strong>&lt;link&gt;</strong>’.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mP4_vIX6__-wfaTSwWUC1g.png" /><figcaption>site-fontawsome</figcaption></figure><p>Para usar flash-messages necessitamos dos <em>scripts </em>em <a href="https://getbootstrap.com/docs/4.3/getting-started/introduction/"><em>bootstrap dismissable alerts</em></a><em> </em>navegar para a pagina e guardar os scripts.</p><p>Em <strong>/views/layout.ejs </strong>acrescentar o seguinte código:</p><pre><strong>&lt;!DOCTYPE html&gt;<br>&lt;html lang=&quot;en&quot;&gt;</strong></pre><pre><strong>&lt;head&gt;<br>  &lt;meta charset=&quot;UTF-8&quot; /&gt;<br>  &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1.0&quot; /&gt;<br>  &lt;meta http-equiv=&quot;X-UA-Compatible&quot; content=&quot;ie=edge&quot; /&gt;</strong><br>  &lt;%# FONTAWSOME %&gt;<br>  <strong>&lt;link rel=&quot;stylesheet&quot; href=&quot;https://use.fontawesome.com/releases/v5.6.3/css/all.css&quot; integrity=&quot;sha384-UHRtZLI+pbxtHCWp1t77Bi1L4ZtiqrqD80Kn4Z8NTSRyMA2Fd33n5dQ8lWUE00s/&quot; crossorigin=&quot;anonymous&quot;&gt;</strong><br>  &lt;%# BOOTSWATCH %&gt;<br>  <strong>&lt;link rel=&quot;stylesheet&quot; href=&quot;https://bootswatch.com/4/journal/bootstrap.min.css&quot;&gt;</strong></pre><pre><strong>  &lt;title&gt;Pontos de Interesse App&lt;/title&gt;<br>&lt;/head&gt;<br>&lt;body&gt;</strong><br>  &lt;%# output das views que queremos mostrar %&gt;<br>  <strong>&lt;div class=&quot;container&quot;&gt;&lt;%- body %&gt;&lt;/div&gt;</strong></pre><pre>  &lt;%# bootstrap dismissable alerts %&gt;<br>  <strong>&lt;script src=&quot;https://code.jquery.com/jquery-3.3.1.slim.min.js&quot;<br>integrity=&quot;sha384-q8i/X+965DzO0rT7abK41JStQIAqVgRVzpbzo5smXKp4YfRvH+8abtTE1Pi6jizo&quot;crossorigin=&quot;anonymous&quot;&gt;<br>  &lt;/script&gt;</strong></pre><pre><strong>  &lt;script src=&quot;https://cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.6/umd/popper.min.js&quot; integrity=&quot;sha384-wHAiFfRlMFy6i5SRaxvfOCifBUQy1xHdJ/yoi7FRNXMRBu5WHdZYu1hA6ZOblgut&quot;<br>crossorigin=&quot;anonymous&quot;&gt;<br>  &lt;/script&gt;</strong></pre><pre><strong>  &lt;script<br>src=&quot;https://stackpath.bootstrapcdn.com/bootstrap/4.2.1/js/bootstrap.min.js&quot; integrity=&quot;sha384-B0UglyR+jN6CkvvICOB2joaf5I4l3gm9GU6Hc1og6Ls7i6U/mkkaduKaBhlAXv9k&quot;<br>crossorigin=&quot;anonymous&quot;&gt;<br> &lt;/script&gt;</strong></pre><pre><strong>&lt;/body&gt;<br>&lt;/html&gt;</strong></pre><h4>. Navegar até pagina Home</h4><p>Ir para ‘<strong>/views/welcome.ejs’ </strong>e acrescentar o seguinte código:</p><pre><strong>&lt;div class=&quot;row mt-5&quot;&gt;<br>  &lt;div class=&quot;col-md-6 m-auto&quot;&gt;<br>    &lt;div class=&quot;card card-body text-center&quot;&gt;<br>     &lt;h1&gt;&lt;i class=&quot;fab fa-node-js fa-3x&quot;&gt;&lt;/i&gt;&lt;/h1&gt;<br>     &lt;p&gt;Create an account or login&lt;/p&gt;<br>     &lt;a href=&quot;/users/register&quot; class=&quot;btn btn-primary btn-block mb-2&quot;&gt;Register&lt;/a&gt;<br>     &lt;a href=&quot;/users/login&quot; class=&quot;btn btn-secondary btn-block&quot;&gt;Login&lt;/a&gt;<br>    &lt;/div&gt;<br>  &lt;/div&gt;<br>&lt;/div&gt;</strong></pre><p>A tag<strong> ‘&lt;i class=&quot;fab fa-node-js fa-3x&quot;&gt;&lt;/i&gt;’ </strong>coloca o icone de nodeJS na página.</p><p>Em ‘<strong>/routes/index.js</strong>’ acrescentar o seguinte código:</p><pre><strong>const express = require (‘express’);</strong></pre><pre><strong>const router = express.Router();</strong></pre><pre><strong>// importa controlador<br>const indexController = require(‘../controllers/indexController’);</strong></pre><pre><strong>// index-route (Home-page)<br>router.get(‘/’, indexController.index);</strong></pre><pre><strong>// create-route<br>router.get(‘/create’, indexController.create);</strong></pre><pre><strong>module.exports = router;</strong></pre><p>Em ‘<strong>controllers/indexController.js</strong>’:</p><pre>// exporta f.teste, chamada em /routes/index<br><strong>exports.index = function (req, res) {<br>  res.render(&#39;welcome&#39;);<br>};</strong></pre><pre>// página &#39;create&#39;<br><strong>exports.create = function (req, res) {<br> res.render(&#39;createPI&#39;);</strong><br>};</pre><p>Quando no browser introduzimos o endereço: <a href="http://localhost:5000/">http://localhost:5000</a>/:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*WS5ER93MUGDDZHoJMapd7Q.png" /><figcaption>home page</figcaption></figure><h4>. Navegar até pagina Register:</h4><p>Ir para ‘<strong>/views/register.ejs’ </strong>e acrescentar o seguinte código:</p><pre><strong>&lt;div class=&quot;row mt-5&quot;&gt;</strong></pre><pre><strong>&lt;div class=&quot;col-md-6 m-auto&quot;&gt;</strong></pre><pre><strong>&lt;div class=&quot;card card-body&quot;&gt;<br>  &lt;h1 class=&quot;text-center mb-3&quot;&gt;<br>    &lt;i class=&quot;fas fa-user-plus&quot;&gt;&lt;/i&gt; Register<br>  &lt;/h1&gt;<br>  &lt;form action=&quot;/users/register&quot; method=&quot;POST&quot;&gt;<br>  &lt;div class=&quot;form-group&quot;&gt;<br>  &lt;label for=&quot;name&quot;&gt;Name&lt;/label&gt;<br>  &lt;input <br>   type=&quot;name&quot;<br>   id=&quot;name&quot;<br>   name=&quot;name&quot;<br>   class=&quot;form-control&quot;<br>   placeholder=&quot;Enter Name&quot;<br>   value=&quot;&lt;%= typeof name != &#39;undefined&#39; ? name : &#39;&#39; %&gt;&quot;<br>  /&gt;<br>&lt;/div&gt;<br>&lt;div class=&quot;form-group&quot;&gt;<br>  &lt;label for=&quot;email&quot;&gt;Email&lt;/label&gt;<br>  &lt;input<br>   type=&quot;email&quot;<br>   id=&quot;email&quot;<br>   name=&quot;email&quot;<br>   class=&quot;form-control&quot;<br>   placeholder=&quot;Enter Email&quot;<br>   value=&quot;&lt;%= typeof email != &#39;undefined&#39; ? email : &#39;&#39; %&gt;&quot;<br>  /&gt;<br>&lt;/div&gt;<br>&lt;div class=&quot;form-group&quot;&gt;<br>  &lt;label for=&quot;password&quot;&gt;Password&lt;/label&gt;<br>  &lt;input<br>   type=&quot;password&quot;<br>   id=&quot;password&quot;<br>   name=&quot;password&quot;<br>   class=&quot;form-control&quot;<br>   placeholder=&quot;Create Password&quot;<br>   value=&quot;&lt;%= typeof password != &#39;undefined&#39; ? password : &#39;&#39; %&gt;&quot;<br>  /&gt;<br>&lt;/div&gt;<br>&lt;div class=&quot;form-group&quot;&gt;<br>  &lt;label for=&quot;password2&quot;&gt;Confirm Password&lt;/label&gt;<br>  &lt;input<br>   type=&quot;password&quot;<br>   id=&quot;password2&quot;<br>   name=&quot;password2&quot;<br>   class=&quot;form-control&quot;<br>   placeholder=&quot;Confirm Password&quot;<br>   value=&quot;&lt;%= typeof password2 != &#39;undefined&#39; ? password2 : &#39;&#39; %&gt;&quot;<br>/&gt;<br>&lt;/div&gt;<br>&lt;button type=&quot;submit&quot; class=&quot;btn btn-primary btn-block&quot;&gt;<br>  Register &lt;/button&gt;<br>&lt;/form&gt;</strong></pre><pre><strong>&lt;p class=&quot;lead mt-4&quot;&gt;Have An Account? <br>  &lt;a href=&quot;/users/login&quot;&gt;Login&lt;/a&gt;&lt;/p&gt;</strong></pre><pre><strong>&lt;/div&gt;<br>&lt;/div&gt;<br>&lt;/div&gt;</strong></pre><p>Assinalar que no atributo dos inputs — Exemplo: ‘<strong>value=”&lt;%= typeof name != ‘undefined’ ? name : ‘’ %&gt;”</strong>’ diz que se existir um ‘nome ’no ‘<strong>form</strong>’ manter o ‘nome ’mesmo que a autenticação falhe.</p><p>Em ‘<strong>/routes/users.js</strong>’ acrescentar o seguinte código:</p><pre><strong>const express = require (&#39;express&#39;);<br>const router = express.Router();</strong></pre><pre>// importa controlador<br><strong>const usersController = require(&#39;../controllers/usersController&#39;);</strong></pre><pre>// Register Page<br><strong>router.get(&#39;/register&#39;, usersController.GETregister);</strong></pre><pre><strong>module.exports = router;</strong></pre><p>Em ‘<strong>controllers/usersController.js</strong>’ acrescentar o seguinte código:</p><pre>// register<br><strong>exports.GETregister = function (req, res) {<br>  res.render(&#39;register&#39;);<br>};</strong></pre><p>Ao clicar no botão ‘<strong>Register</strong>’ renderiza a página assim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JDusADi7K0GCQkXLbcq-FQ.png" /><figcaption>página register</figcaption></figure><h4>. Navegar até á página Login:</h4><p>Ir para ‘<strong>/views/login.ejs’ </strong>e acrescentar o seguinte código:</p><pre><strong>&lt;div class=&quot;row mt-5&quot;&gt; <br>  &lt;div class=&quot;col-md-6 m-auto&quot;&gt;<br>    &lt;div class=&quot;card card-body&quot;&gt;<br>      &lt;h1 class=&quot;text-center mb-3&quot;&gt;<br>        &lt;i class=&quot;fas fa-sign-in-alt&quot;&gt;/i&gt;  Login&lt;/h1&gt;<br>      &lt;form action=&quot;/users/login&quot; method=&quot;POST&quot;&gt;<br>       &lt;div class=&quot;form-group&quot;&gt;<br>         &lt;label for=&quot;email&quot;&gt;Email&lt;/label&gt;<br>         &lt;input <br>          type=&quot;email&quot; <br>          id=&quot;email&quot;<br>          name=&quot;email&quot;<br>          class=&quot;form-control&quot;<br>          placeholder=&quot;Enter Email&quot;/&gt;<br>      &lt;/div&gt;<br>      &lt;div class=&quot;form-group&quot;&gt;<br>       &lt;label for=&quot;password&quot;&gt;Password&lt;/label&gt;<br>       &lt;input<br>        type=&quot;password&quot;<br>        id=&quot;password&quot;<br>        name=&quot;password&quot;<br>        class=&quot;form-control&quot;<br>        placeholder=&quot;Enter Password&quot;/&gt;<br>    &lt;/div&gt;<br>    &lt;button type=&quot;submit&quot; class=&quot;btn btn-primary btn-block&quot;&gt;Login&lt;/button&gt;<br>&lt;/form&gt;<br>&lt;p class=&quot;lead mt-4&quot;&gt;<br>No Account? &lt;a href=&quot;/users/register&quot;&gt;Register&lt;/a&gt;<br>&lt;/p&gt;<br>&lt;/div&gt;<br>&lt;/div&gt;<br>&lt;/div&gt;</strong></pre><p>Em ‘<strong>/routes/users.js</strong>’ acrescentar o seguinte código:</p><pre>const express = require (&#39;express&#39;);<br>const router = express.Router();</pre><pre>// importa controlador<br>const usersController = require(&#39;../controllers/usersController&#39;);</pre><pre>// Login Page<br><strong>router.get(&#39;/login&#39;, usersController.GETlogin);</strong></pre><pre>// Register Page<br>router.get(&#39;/register&#39;, usersController.GETregister);</pre><pre>module.exports = router;</pre><p>Em ‘<strong>controllers/usersController.js</strong>’ acrescentar o seguinte código:</p><pre>// login<br><strong>exports.GETlogin = function (req, res) {<br>  res.render(&#39;login&#39;);<br>};</strong></pre><pre>// register<br>exports.GETregister = function (req, res) {<br>  res.render(&#39;register&#39;);<br>};</pre><p>Ao clicar no botão ‘<strong>Login</strong>’ renderiza a página assim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dh8FXaAT0Yfb9LIGp8wS8g.png" /><figcaption>pagina login</figcaption></figure><h4>. Validação dos campos no formulário Registo</h4><p>Em ‘<strong>/routes/users.js</strong>’ editar o código como:</p><pre>const express = require (&#39;express&#39;);<br>const router = express.Router();</pre><pre>// importa controlador: &#39;usersController&#39;<br>const usersController = require(&#39;../controllers/usersController&#39;);</pre><pre>// render da Login-Page<br>router.get(&#39;/login&#39;, usersController.login);</pre><pre>// render da Register-Page<br>router.get(&#39;/register&#39;, usersController.GETregister);</pre><pre>// registo na BD<br><strong>router.post(&#39;/register&#39;, usersController.POSTregister);</strong></pre><pre><strong>module.exports = router;</strong></pre><p>Em ‘<strong>controllers/usersController.js</strong>’ acrescentar o seguinte código:</p><pre>// login<br>exports.login = function (req, res) {<br>  res.render(&#39;login&#39;);<br>};</pre><pre>// GETregister<br>exports.GETregister = function (req, res) {<br>  res.render(&#39;register&#39;);<br>};</pre><pre>// POSTregister-form(validação)<br><strong>exports.POSTregister = function (req, res) {</strong><br>  // os valores de req.body são separados individualmente em<br>  // variáveis<br>  <strong>const { name, email, password, password2 } = req.body;<br>  let errors = [];</strong> // array de erros</pre><pre>  // verificar se todos os campos estão preenchidos<br>  <strong>if (!name || !email || !password || !password2) {<br>    errors.push({ msg: &#39;Please enter all fields&#39; });<br>  }</strong><br>  <br>  // verificar se as passes são iguais<br>  <strong>if (password != password2) {<br>    errors.push({ msg: &#39;Passwords do not match&#39; });<br>  }</strong></pre><pre>  // verificar tamanho da pass<br>  <strong>if (password.length &lt; 3) {<br>    errors.push({ msg: &#39;Password must be at least 6 characters&#39; });<br>  }</strong></pre><pre>  // Se há erros..<br>  <strong>if (errors.length &gt; 0) {</strong><br>    // render da página com os valores do &#39;form&#39; + erros<br>    <strong>res.render(&#39;register&#39;, {<br>      errors,<br>      name,<br>      email,<br>      password,<br>      password2<br>  });<br>  } else {<br>  res.send(&#39;REGISTER_SUCESSO!&#39;);<br>  }<br>};</strong></pre><p>Ao preencher os campos do registo, com todos os campos preenchidos, passwords iguais e passwords com mínimo de 3 carateres, então não tem erros e envia mensagem <strong>‘REGISTER_SUCESSO!’</strong>.</p><p>Caso haja erros, no momento, a página não os assiná-la.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*yDKHK6rKe8k_WDYhys2lAA.png" /><figcaption>register</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/726/1*92zc2rThFwzZMuA_p3pitA.png" /><figcaption>register-success</figcaption></figure><h4>. Passar mensagens de erro para o utilizador</h4><p>Para passar mensagens de erro de cada vez que a validação falha temos de criar uma pasta que nomearemos de ‘<strong>partials</strong>’ em ‘<strong>\views</strong>’, que receberá um ficheiro ‘<strong>messages.ejs</strong>’ onde são tratados os erros. Esse ficheiro será incluído no template ‘<strong>register.ejs</strong>’ e ‘<strong>login.ejs</strong>’ com</p><pre> <strong>&lt;% include ./partials/messages %&gt;</strong></pre><p>Vamos começar por incluir o template ‘<strong>messages.ejs</strong>’ em ‘<strong>register.ejs</strong>’ e ‘<strong>login.ejs</strong>’.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/903/1*NA6GfnRfAjBMgSiJfl6srw.png" /><figcaption>register.ejs</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Kjb7ztQry-2Y7uFrBnJz2w.png" /><figcaption>login.ejs</figcaption></figure><p>Em seguida adicionar o seguinte código em ‘<strong>\views\messages.ejs</strong>’:</p><pre>&lt;%# &#39;typeof&#39; devolve tipo da variavel, &#39;undefined&#39;-&gt;errors_vazio! %&gt;<strong>&lt;% if(typeof errors != &#39;undefined&#39;){ %&gt;<br>  &lt;% errors.forEach(function(error) { %&gt;<br>    &lt;%= error.msg %&gt;<br>  &lt;% }); %&gt;<br>&lt;% } %&gt;</strong></pre><p>Agora ao clicar no botão ‘<strong>Register</strong>’ da aplicação, se o formulário tiver erros, esses erros são exibidos no topo do formulário.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-JEDgGAn4gXMkWBwSmYdvA.png" /><figcaption>register</figcaption></figure><p>Notar que o campo nome está vazio e as passwords não coincidem!</p><h4><strong>Alerts Bootstrap</strong></h4><p>Vamos melhorar o aspeto das msgs com o ‘<strong>bootstrap-alert’</strong> <em>markup.</em></p><p>Ir até <a href="https://getbootstrap.com/"><em>getbootstrap.com</em></a><em> &gt; get started &gt; components &gt; alerts &gt; dismissing (</em><a href="https://getbootstrap.com/docs/4.3/components/alerts/#dismissing"><em>link</em></a><em>) </em>copiar a ‘<strong>&lt;div&gt;’</strong> de exemplo exibida e passar para o nosso código assim:</p><pre>&lt;%# &#39;typeof&#39; devolve tipo variavel, &#39;undefined&#39;-&gt;errors_vazio! %&gt;<br>&lt;% if(typeof errors != &#39;undefined&#39;){ %&gt;<br>  &lt;% errors.forEach(function(error) { %&gt;<br><strong>    &lt;div class=&quot;alert alert-warning alert-dismissible fade show&quot;<br>role=&quot;alert&quot;&gt;</strong><br>     &lt;%= error.msg %&gt;<br><strong>     &lt;button type=&quot;button&quot; class=&quot;close&quot; data-dismiss=&quot;alert&quot; aria-label=&quot;Close&quot;&gt; &lt;span aria-hidden=&quot;true&quot;&gt;&amp;times;&lt;/span&gt;&lt;/button&gt;<br>   &lt;/div&gt;<br>  &lt;% }); %&gt;<br>&lt;% } %&gt;</strong></pre><p>Ao clicar no botão ‘<strong>Register</strong>’ da aplicação, se o formulário tiver erros, esses erros são exibidos assim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/598/1*aTVIo8LPncK8MmvrLUfTog.png" /><figcaption>register</figcaption></figure><h4>. Criar modelo user</h4><p>Vamos criar o modelo ‘<strong>user</strong>’ para receber os dados do formulário e guardar na Base de Dados.</p><p>Na pasta ‘<strong>/models</strong>’ criar um ficheiro designado por ‘<strong>user.js’</strong> e adicionar o seguinte código:</p><pre><strong>const mongoose = require(&#39;mongoose&#39;);</strong></pre><pre><strong>const UserSchema = new mongoose.Schema({<br>  name: {<br>    type: String,<br>    required: true<br>  },<br>email: {<br>    type: String,<br>    required: true<br>  },<br>password: {<br>    type: String,<br>    required: true<br>  },<br>date: {<br>    type: Date,<br>    default: Date.now<br>}<br>});</strong></pre><pre><strong>const User = mongoose.model(&#39;User&#39;, UserSchema);</strong></pre><pre><strong>module.exports = User;</strong></pre><p>Em seguida vamos importar o modelo em ‘<strong>controller\userController.js</strong>’ para podermos fazer operações na base de dados. Adicionar:</p><pre>// importar modelo User<br><strong>const User = require(&#39;../models/User&#39;);</strong></pre><h4>. Criar novo ‘user’ com password encriptada</h4><p>Para proceder á encriptação da password temos de primeiro importar ‘<strong>bcryptjs’.</strong></p><p><strong>E</strong>m ‘<strong>controller\userController.js</strong>’ adicionar:</p><pre><strong>const bcrypt = require(&#39;bcryptjs&#39;);</strong></pre><p>No mesmo ficheiro editar a função ‘<strong>POSTregister</strong>’ desta forma:</p><pre>// POSTregister-form(validação)<br><strong>exports.POSTregister = function (req, res) {</strong><br>  // os valores de req.body são separados individualmente em<br>  // variáveis<br>  const { name, email, password, password2 } = req.body;<br>  let errors = []; // array de erros</pre><pre>// verificar se todos os campos estão preenchidos<br>  if (!name || !email || !password || !password2) {<br>    errors.push({ msg: &#39;Please enter all fields&#39; });<br>  }<br>  <br>  // verificar se as passes são iguais<br>  if (password != password2) {<br>    errors.push({ msg: &#39;Passwords do not match&#39; });<br>  }</pre><pre>// verificar tamanho da pass<br>  if (password.length &lt; 3) {<br>    errors.push({ msg: &#39;Password must be at least 6 characters&#39; });<br>  }</pre><pre>// Se há erros..<br>  if (errors.length &gt; 0) {<br>    // render da página com os valores do &#39;form&#39; + erros<br>    res.render(&#39;register&#39;, {<br>      errors,<br>      name,<br>      email,<br>      password,<br>      password2<br>  });<strong><br>  } else {</strong><br>  // procura User_Duplicado, dps devolve o &#39;user&#39;<br>  <strong>User.findOne({ email: email }).then(user =&gt; {</strong><br>  // se &#39;user&#39; já existe renderiza &#39;register.ejs&#39;com erro<br>  <strong>if (user) {<br>    errors.push({ msg: &#39;Email already exists&#39; });<br>    res.render(&#39;register&#39;, {<br>      errors,<br>      name,<br>      email,<br>      password,<br>      password2<br>  });</strong><br>  // senão há user_duplicado cria novo_user<br>  <strong>} else {<br>  const newUser = new User({<br>    name,<br>    email,<br>    password<br>  });</strong><br>  // encripta passw e guarda novo_user<br>  <strong>bcrypt.genSalt(10, (err, salt) =&gt; {<br>    bcrypt.hash(newUser.password, salt, (err, hash) =&gt; {<br>      if (err) throw err;<br>      newUser.password = hash;<br>      newUser<br>       .save()<br>       .then(user =&gt; {<br>          res.redirect(&#39;/users/login&#39;);<br>      })<br>       .catch(err =&gt; console.log(err));<br>    });<br>  });<br>}<br>});<br>}<br>};</strong></pre><p>Vamos criar um user a partir do formulário:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/656/1*4gK17boekMxLivSpH6T0hQ.png" /><figcaption>criar user</figcaption></figure><p>Na base de dados (ATLAS MongoDB) deverá mostrar algo como:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/840/1*O_VcNFBpj_va-vhiAW5zrA.png" /><figcaption>atlas</figcaption></figure><p>Notar que a password está encriptada!</p><p>Se tentar-mos criar outro <em>user</em> com o mesmo e-mail teremos:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/573/1*JA9jbg0fAODPzwCwDYkgfA.png" /><figcaption>e-mail duplicado</figcaption></figure><p>No momento, somos redireccionados para a página de <strong><em>login </em></strong>quando o registo é bem sucedido, queremos agora, para além disso, passar uma mensagem de sucesso. Para conseguir isso faremos uso dos módulos ‘<strong>connect-flash</strong>’ e ‘<strong>express-session</strong>’.</p><p>Em ‘<strong>app.js </strong>’ o <em>import </em>dos módulos e o <em>middleware </em>encontra-se já implementado, falta chamar a <em>flash-message</em> na função ‘<strong>POSTregister</strong>’<strong> </strong>definida em ‘<strong>usersController.js</strong>’ e passá-la em ‘<strong>\views\partials\messages.js</strong>’.</p><p>Em ‘<strong>\controllers\usersController.js\</strong>’ editar a função ‘<strong>POSTregister</strong>’ assim:</p><pre>// POSTregister-form(validação)<br><strong>exports.POSTregister = function (req, res) {</strong><br>  // os valores de req.body são separados individualmente em<br>  // variáveis<br>  const { name, email, password, password2 } = req.body;<br>  let errors = []; // array de erros</pre><pre>// verificar se todos os campos estão preenchidos<br>  if (!name || !email || !password || !password2) {<br>    errors.push({ msg: &#39;Please enter all fields&#39; });<br>  }<br>  <br>  // verificar se as passes são iguais<br>  if (password != password2) {<br>    errors.push({ msg: &#39;Passwords do not match&#39; });<br>  }</pre><pre>// verificar tamanho da pass<br>  if (password.length &lt; 3) {<br>    errors.push({ msg: &#39;Password must be at least 6 characters&#39; });<br>  }</pre><pre>// Se há erros..<br>  if (errors.length &gt; 0) {<br>    // render da página com os valores do &#39;form&#39; + erros<br>    res.render(&#39;register&#39;, {<br>      errors,<br>      name,<br>      email,<br>      password,<br>      password2<br>  });<strong><br></strong>  } else {<br>  // procura User_Duplicado, dps devolve o &#39;user&#39;<br>  User.findOne({ email: email }).then(user =&gt; {<br>  // se &#39;user&#39; já existe renderiza &#39;register.ejs&#39;com erro<br>  if (user) {<br>    errors.push({ msg: &#39;Email already exists&#39; });<br>    res.render(&#39;register&#39;, {<br>      errors,<br>      name,<br>      email,<br>      password,<br>      password2<br>  });<br>  // senão há user_duplicado cria novo_user<br>  } else {<br>  const newUser = new User({<br>    name,<br>    email,<br>    password<br>  });<br>  // encripta passw e guarda novo_user<br>  bcrypt.genSalt(10, (err, salt) =&gt; {<br>    bcrypt.hash(newUser.password, salt, (err, hash) =&gt; {<br>      if (err) throw err;<br>      newUser.password = hash;<br>      newUser<br>       .save()<strong><br>       </strong>.then(user =&gt; {<strong><br>          // flash-message-register-sucess<br>          req.flash(<br>           &#39;success_msg&#39;,&#39;You are now registered!&#39;<br>          );<br>          res.redirect(&#39;/users/login&#39;);<br>     </strong> })<br>       .catch(err =&gt; console.log(err));<br>    });<br>  });<br>}<br>});<br>}<br>};</pre><p>Em ‘<strong>\views\partials\messages.js</strong>’ acrescentar:</p><pre>&lt;%# &#39;typeof&#39; devolve tipo variavel, &#39;undefined&#39;-&gt;errors_vazio! %&gt;<br>&lt;% if(typeof errors != &#39;undefined&#39;){ %&gt;<br>  &lt;% errors.forEach(function(error) { %&gt;<br>    &lt;div class=&quot;alert alert-warning alert-dismissible fade show&quot;<br>role=&quot;alert&quot;&gt;<br>     &lt;%= error.msg %&gt;<br>     &lt;button type=&quot;button&quot; class=&quot;close&quot; data-dismiss=&quot;alert&quot; aria-label=&quot;Close&quot;&gt; &lt;span aria-hidden=&quot;true&quot;&gt;&amp;times;&lt;/span&gt;&lt;/button&gt;<br>   &lt;/div&gt;<br>  &lt;% }); %&gt;<br>&lt;% } %&gt;<br>&lt;%# var-globais(nulas se não forem chamadas) %&gt;<strong><br>&lt;% if(success_msg != &#39;&#39;){ %&gt;<br>  &lt;div class=&quot;alert alert-success alert-dismissible fade show&quot; role=&quot;alert&quot;&gt;<br>    &lt;%= success_msg %&gt;<br>    &lt;button type=&quot;button&quot; class=&quot;close&quot; data-dismiss=&quot;alert&quot; aria-label=&quot;Close&quot;&gt; &lt;span aria-hidden=&quot;true&quot;&gt;&amp;times;&lt;/span&gt; &lt;/button&gt;<br>  &lt;/div&gt;<br>&lt;% } %&gt;<br>&lt;% if(error_msg != &#39;&#39;){ %&gt;<br>  &lt;div class=&quot;alert alert-danger alert-dismissible fade show&quot; role=&quot;alert&quot;&gt;<br>    &lt;%= error_msg %&gt;<br>    &lt;button type=&quot;button&quot; class=&quot;close&quot; data-dismiss=&quot;alert&quot; aria-label=&quot;Close&quot;&gt; &lt;span aria-hidden=&quot;true&quot;&gt;&amp;times;&lt;/span&gt; &lt;/button&gt;<br>&lt;/div&gt;<br>&lt;% } %&gt;<br>&lt;% if(error != &#39;&#39;){ %&gt;<br>  &lt;div class=&quot;alert alert-danger alert-dismissible fade show&quot; role=&quot;alert&quot;&gt;<br>  &lt;%= error %&gt;<br>    &lt;button type=&quot;button&quot; class=&quot;close&quot; data-dismiss=&quot;alert&quot; aria-label=&quot;Close&quot;&gt; &lt;span aria-hidden=&quot;true&quot;&gt;&amp;times;&lt;/span&gt; &lt;/button&gt;<br>&lt;/div&gt;<br>&lt;% } %&gt;</strong></pre><p>Notar as variáveis <strong>‘success_msg’</strong> e ‘<strong>error_msg’</strong> que são variáveis globais definidas em ‘<strong>app.js</strong>’ no <em>middleware.</em></p><p>Se agora fizer-mos o registo de um utilizador, ao clicar no botão ‘<strong>register</strong>’, teremos algo como:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/567/1*QGC5JJZsLsGauy03K7OCBw.png" /><figcaption>success-register</figcaption></figure><h4>. Passport e Login</h4><p>Usaremos <em>passport </em>na versão <em>local-strategy </em>para tratar da autenticação. Apenas utilizadores autenticados têm acesso ás rotas.<a href="http://www.passportjs.org/docs/"> Saber mais!</a></p><p>Numa aplicação da Web, as credenciais usadas para autenticar um utilizador só serão transmitidas durante a solicitação de <em>login</em>. Se a autenticação for bem-sucedida, uma sessão será estabelecida e mantida por meio de um <em>cookie </em>configurado no <em>browser </em>do utilizador.</p><p>Cada solicitação subsequente não terá credenciais, mas sim o <em>cookie </em>exclusivo que identifica a sessão. Para suportar sessões de <em>login</em>, o <em>Passport </em>serializará e desserializará as instâncias do utilizador para e da sessão.</p><p>No ficheiro ‘<strong>passport.js</strong>’ vamos construir a estratégia local do <em>Passport </em>e implementar a serialização e desserialização do utilizador.</p><p>Passemos ao código!</p><p>Em ‘<strong>config/passport.js</strong>’ adicionar :</p><pre><strong>const LocalStrategy = require(&#39;passport-local&#39;).Strategy;<br>const mongoose = require(&#39;mongoose&#39;);<br>const bcrypt = require(&#39;bcryptjs&#39;);</strong></pre><pre>// importar User-model<br><strong>const User = require(&#39;../models/User&#39;);</strong></pre><pre>// o import desta função será em usersController.js para POSTlogin e // logout, &#39;passport&#39; vai ser passado a partir de app.js<br><strong>module.exports = function(passport) {<br>  passport.use(new LocalStrategy({ usernameField: &#39;email&#39; }, (email,<br>    password, done) =&gt; {</strong><br>     // e-mail coincide?<br><strong>     User.findOne({<br>       email: email<br>      }).then(user =&gt; {<br>        if (!user) {</strong><br>       // &#39;done&#39; callback(recebido em cima)<br> <strong>      return done(null, false, { message: &#39;Unregistered e-mail&#39; });<br>       }</strong><br>      // password e-mail coincidem?<br>      // bcrypt desencripta password(recebida em cima) e compara<br>      // password_introduzida<br><strong>      bcrypt.compare(password, user.password, (err, isMatch) =&gt; {<br>       if (err) throw err;<br>       if (isMatch) {<br>         return done(null, user);<br>       } else {<br>         return done(null, false, { message: &#39;Password incorrect&#39;});<br>       }<br>     });<br>   });<br>  })<br>);</strong><br>// metodo para serialização do &#39;user&#39;<br><strong>passport.serializeUser(function(user, done) {<br>  done(null, user.id);<br>});<br></strong>// metodo para desserialização do &#39;user&#39;<br><strong>passport.deserializeUser(function(id, done) {<br>  User.findById(id, function(err, user) {<br>    done(err, user);<br>  });<br>});<br>};</strong></pre><p>De notar que em ‘<strong>module.exports = function(passport) {…}’ </strong>o argumento <strong>‘passport’ </strong>não está configurado, tal configuração será passada em ‘<strong>app.js</strong>’.</p><p>Em ‘<strong>app.js</strong>’ acrescentar:</p><pre>const express = require(&#39;express&#39;);<br>const bodyParser = require(&#39;body-parser&#39;);<br>const mongoose = require(&#39;mongoose&#39;);<br>const expressLayouts = require(&#39;express-ejs-layouts&#39;);<br>const flash = require(&#39;connect-flash&#39;);<br>const session = require(&#39;express-session&#39;);<br><strong>const passport = require(&#39;passport&#39;);</strong></pre><pre>const app = express();</pre><pre>// Passo &#39;require(&#39;passport&#39;)&#39; para &#39;./config/passport&#39;<br><strong>require(&#39;./config/passport&#39;)(passport);</strong></pre><p>Vamos implementar uma rota para a submissão do formulário <em>Login.</em></p><p>Em ‘<strong>\routes\users.js</strong>’ acrescentar:</p><pre><strong>router.post(&#39;/login&#39;, usersController.POSTlogin);</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/880/1*1QIDIQglGKKwDYNwHHo1mw.png" /><figcaption>routes\users.js</figcaption></figure><p>Quando fazemos o <em>submit </em>do formulário <em>Login</em> queremos que a rota ‘<strong>users/login</strong>’ use o<em>local strategy</em> definido em ‘<strong>\config\passport.js</strong>’</p><p>Em ‘<strong>controller\userController.js</strong>’ acrescentar:</p><pre>// POSTlogin<br><strong>exports.POSTlogin = function (req, res) {<br>  passport.authenticate(&#39;local&#39;, {<br>  successRedirect: &#39;/dashboard&#39;,<br>  failureRedirect: &#39;/users/login&#39;,<br>  failureFlash: true<br>  })(req, res, next);<br>};</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/851/1*rtI0UQceoXxdMJFNk7o0fw.png" /><figcaption>userController.js</figcaption></figure><p>Se tentarmos agora fazer <em>login </em>com um utilizador não registado, a página é novamente renderizada e apresentar-se-á assim:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/581/1*0YyDFiNLuhW7-dTa1VIE8Q.png" /><figcaption>login</figcaption></figure><p>Quando o login for bem sucedido a página <em>dashboard</em> (apenas de teste) será renderizada. Vamos adicionar o seguinte código a ‘<strong>views\dashboard</strong>’.</p><pre><strong>&lt;h1 class=&quot;mt-4&quot;&gt;Dashboard&lt;/h1&gt;<br>&lt;p class=&quot;lead mb-3&quot;&gt;Welcome &lt;/p&gt;<br>&lt;a href=&quot;/users/logout&quot; class=&quot;btn btn-secondary&quot;&gt;Logout&lt;/a&gt;</strong></pre><p>De notar que a rota ‘<strong>/users/logout</strong>’ não foi ainda criada!</p><p>Se fizermos um <em>login </em>válido teremos:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/507/1*-jn4VwYnL8OMprff2spHUg.png" /><figcaption>dashboard</figcaption></figure><p>Passemos ao <strong><em>logout.</em></strong></p><p>Necessitamos de criar uma rota. Em ‘<strong>\routes\users</strong>’ acrescentar:</p><pre>// logout<br><strong>router.get(&#39;/logout&#39;, usersController.logout);</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/983/1*wKHlV1UHn03K3zznuqSrtg.png" /><figcaption>routes\users</figcaption></figure><p>Em ‘<strong>controllers\usersController.js</strong>’ acrescentar:</p><pre>// logout<br><strong>exports.logout = function (req, res) {<br>  req.logout();<br>  req.flash(&#39;success_msg&#39;, &#39;You are logged out&#39;);<br>  res.redirect(&#39;/users/login&#39;);<br>};</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/999/1*ueVaDVni7w3mqmu0g3wNRA.png" /><figcaption>usersController.js</figcaption></figure><p>Ao clicar no botão ‘<strong>logout</strong>’ somos redireccionados para a página de <em>login</em>, com uma mensagem de sucesso.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/602/1*gryV2NSmrNQHIp09m1XSHA.png" /><figcaption>logout-success</figcaption></figure><h4>Proteger rotas</h4><p>No momento, se por exemplo introduzirmos o endereço: <a href="http://localhost:5000/dashboard"><strong>http://localhost:5000/dashboard</strong></a> no navegador, seremos encaminhados para dashboard, sem necessitarmos de fazer autenticação.</p><p>Para proteger as rotas usaremos <strong><em>ensureAuthenticated</em> </strong>de <strong><em>Passport.</em></strong></p><p>Em ‘<strong>\config\Auth.js</strong>’ acrescentar o seguinte código:</p><pre>// objeto anónimo com propriedade &#39;ensureAuthenticated&#39;<br><strong>module.exports = {<br>  ensureAuthenticated: function(req, res, next) {<br>    if (req.isAuthenticated()) {<br>      return next();<br>    }<br>    </strong>// msg erro<strong><br>    req.flash(&#39;error_msg&#39;, &#39;Please log in to view that resource&#39;);<br>    res.redirect(&#39;/users/login&#39;);<br>  }<br>};</strong></pre><p>Incluiremos esta propriedade como parâmetro nas rotas que quisermos proteger. Exemplo: se quisermos que apenas utilizadores autenticados acedam á página <em>Dashboard</em> basta em ‘<strong>routes\index.js</strong>’ editar o código como:</p><pre>const express = require (&#39;express&#39;);<br>const router = express.Router();</pre><pre>// importa a propriedade do objeto anónimo de &#39;../config/auth&#39;<strong><br>const { ensureAuthenticated } = require(&#39;../config/auth&#39;);</strong><br></pre><pre>// importa controlador<br>const indexController = require(&#39;../controllers/indexController&#39;);<br>...</pre><pre>// dashboard<br><strong>router.get(&#39;/dashboard&#39;, ensureAuthenticated,<br>           indexController.dashboard);</strong><br>...</pre><p>Agora se no browser introduzirmos o endereço <a href="http://localhost:5000/dashboard"><strong>http://localhost:5000/dashboard</strong></a><strong> </strong>obteremos:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/620/1*Kc6TDn_Scf72DK8Ep29F5Q.png" /><figcaption>acesso negado — sem autenticação</figcaption></figure><h3>Incluir informação da distancia entre a localização atual do utilizador e os pontos de interesse próximos de si</h3><p>Implementar esta funcionalidade é bastante simples.</p><p>Recordemos primeiro que objeto JSON a função ‘<strong>details</strong>’ em ‘<strong>/controllers/apiController’ </strong>retorna na rota: ‘<strong>http://localhost:5000/api/details/?lng=lngVal&amp;lat=latVal</strong>’.</p><p>Vamos editar temporariamente a função ‘<strong>details</strong>’ com:</p><pre><strong>module.exports.details = (req, res, next) =&gt;{</strong><br>  let lng = parseFloat(req.query.lng);<br>  let lat = parseFloat(req.query.lat);<br>  const maxDist = 300000; // 300km<br>  PI.aggregate([{<br>       &#39;$geoNear&#39;: {<br>       &#39;near&#39;: { &#39;type&#39;: &#39;Point&#39;,<br>       &#39;coordinates&#39;: [parseFloat(lng), parseFloat(lat)] },<br>       &#39;spherical&#39;: true,<br>       &#39;distanceField&#39;: &#39;dist&#39;,<br>       &#39;limit&#39;: 5,<br>       &#39;maxDistance&#39;: maxDist<br>      }<br>     }])<br>       <strong>.then(pi =&gt; res.send(pi))</strong><br>    // .then(pi =&gt; res.render(&#39;details&#39;, {pis: pi}))<br>       .catch(next);<br><strong>};</strong></pre><p>Recorrendo ao <strong><em>Postman:</em></strong></p><ul><li>Seleccionar a rota acima com valores de <em>query-string</em> correspondentes a uma localização próxima de pelo menos um Ponto de Interesse presente na base de dados.</li><li>Premir botão ‘<strong>Send</strong>’</li></ul><p>Exemplo de resultado:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/962/1*H-AEHI5W8nsgL8M5P4gviQ.png" /><figcaption>postman</figcaption></figure><p>Notar que o objeto contém uma propriedade de nome “<strong>dist</strong>”. O valor numérico de “<strong>dist</strong>” representa a distancia do utilizador ao ponto de interesse, no exemplo acima o “<strong>Café Modem</strong>”, está á distancia de 18538.772… metros da localização correspondente á latitude e longitude introduzidas na <em>query-string</em>.</p><p>Para visualizarmos esta informação na página de <strong>details (Near By)</strong> editar a view ‘<strong>details.ejs</strong>’ como:</p><pre>...<br>&lt;% pis.forEach(function(data) { %&gt;<br>  &lt;tr&gt;<br>   &lt;td&gt;&lt;%= data.name %&gt;&lt;/td&gt;<br>   &lt;td&gt;&lt;%= data.details %&gt;&lt;/td&gt;<br>   <strong>&lt;td&gt;&lt;%= Math.floor(data.dist)%&gt; m&lt;/td&gt;</strong><br>...</pre><h3>Incluir data de criação de um pontosde interesse</h3><p>Para incluir a data de criação de um ponto de interesse, temos de atualizar o modelo ‘<strong>PImodel</strong>’ com uma propriedade do tipo <em>date.</em></p><p>Em ‘<strong>models/PImodel.js</strong>’ editar como:</p><pre>...<br><strong>const PISchema = new Schema({</strong><br>  <strong>date: {<br>  type: Date,<br>  default: Date.now<br>  },</strong><br>  name: {<br>  type: String,<br>  required: [true, &#39;*Campo obrigatório!&#39;]<br>  },<br>  details: {<br>  type: String<br>  },<br>  status: {<br>  type: Boolean,<br>  default: true<br>  },<br>  geometry: GeoSchema<br><strong>});</strong></pre><p>Notar que por omissão ‘<strong>date</strong>’ assumirá o valor da data atual.</p><p>Agora basta nas <em>views</em> ‘<strong>lisPIs.ejs</strong>’ e ‘<strong>details.ejs</strong>’ acrescentar um novo ‘<strong>&lt;td&gt;</strong>’ no ciclo ‘<strong>forEach</strong>’ assim:</p><pre><strong>&lt;% pis.forEach(function(data) { %&gt;<br> </strong>&lt;tr&gt;<br>  ...<br>  <strong>&lt;td&gt;&lt;%= data.date.toString().substring(0, 24) %&gt;&lt;/td&gt;</strong><br>  ...<br>&lt;/tr&gt;<br><strong>&lt;% }) %&gt;</strong></pre><p>Notar a conversão dos dados recebidos para string e o “corte” da string a partir do carater 24 para excluir a informação ‘<em>GMT+0100 (GMT Daylight Time)</em>’ de por Exemplo: ‘<strong>Sat May 11 2019 22:53:34 GMT+0100 (GMT Daylight Time)</strong>’.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XvioFiK9AC2ITKDrD14uQA.png" /><figcaption>date time</figcaption></figure><h3>Colocação da aplicação num serviço na Cloud</h3><p>O serviço da cloud que iremos utilizar é o Heroku. Existe um pré-requisito necessário para esta operação que é ter o GitHub instalado. Saber mais <a href="https://gist.github.com/derhuerst/1b15ff4652a867391f03">aqui</a>!</p><p><strong>Para hospedar a aplicação no Heroku seguir os seguintes passos:</strong></p><ul><li>Criar uma conta no <a href="http://heroku.com/">Heroku</a>.</li><li>No site criar uma nova app:</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cgQ7hFZNP7nsrVha9sc2oQ.png" /><figcaption>criar app no heroku</figcaption></figure><ul><li>Seguir para <strong>Heroku CLI</strong></li><li>Baixar o instalador</li><li>Instalar</li></ul><p>Depois de instalado o CLI, será possível aceder á conta que criámos via <strong>Git Bash.</strong></p><p>Concluímos a instalação no terminal do Git Bash com <strong>npm install -g heroku</strong>.</p><p><a href="https://devcenter.heroku.com/articles/heroku-cli#download-and-install">Saber mais</a>!</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/963/1*_3Unhq0ZuflwvdLLzvjVTw.png" /><figcaption>terminal git bash no VS code</figcaption></figure><ul><li>Aceder á conta Heroku via terminal: <strong>heroku login</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xqaiAC1_a6IQXIRXWTZzoQ.png" /><figcaption>heroku login</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*An2VrvB0WN8Yl1TLhSV99Q.png" /><figcaption>logged in</figcaption></figure><ul><li>Inicializar a aplicação como repositório Git: <strong>git init </strong>(garantir que estamos na pasta do projeto!)</li><li>Ligar a aplicação ao repositório do Heroku: <strong>heroku git:remote -a pontosinteresse </strong>(‘pontosinteresse’ foi o nome que demos á <em>app </em>no heroku)</li><li>Adicionar a nossa aplicação ao repositório</li></ul><pre><strong>$ git add .<br>$ git commit -am &quot;first commit&quot;<br>$ git push heroku master</strong></pre><ul><li>Criar um ficheiro com nome ‘<strong>Procfile</strong>’<strong> </strong>na raiz do projeto e editar como:</li></ul><pre>// app.js-&gt; nome da nossa aplicação principal<strong><br>web: node app.js</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/990/1*9Qj7TRxNpeQgtJHFVHVAPA.png" /><figcaption>Procfile</figcaption></figure><ul><li>Garantir que o servidor está á escuta no porto providenciado pelo Heroku.</li></ul><p>Em ‘<strong>app.js’</strong> editar ficheiro como:</p><pre>// &#39;process.env.port&#39;: o porto é providenciado por Heroku<br><strong>let port = 5000;<br>app.listen(process.env.PORT || port, () =&gt;{<br>   console.log(&#39;Servidor em execução no porto: &#39;+ port);<br>});</strong></pre><ul><li>Submeter as mudanças efetuadas na aplicação no repositório</li></ul><pre><strong>$ git add .<br>$ git commit -am &quot;meu novo commit&quot;<br>$ git push heroku master</strong></pre><p>Se tudo correu bem, a aplicação ficou devidamente hospedada e disponível <em>online</em>. No <em>dashboard </em>da Heroku encontramos o botão ‘<strong>open app’</strong> e ao clicar, encontraremos a nossa aplicação.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-uWqFZSxeJtFSHNwmK0tlA.png" /><figcaption>open app — botão</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*22qNIbv8pjkCm6zvIa1YAg.png" /><figcaption>app — online</figcaption></figure><h3>Separar a aplicação da API</h3><p>Queremos disponibilizar a API da aplicação a utilizadores autenticados, queremos que as rotas da api sejam referenciadas como<strong> …/api/…</strong> (Ex: ‘http://localhost:5000/api/listall’) e a aplicação como <strong>…/… </strong>(Ex: ‘http://localhost:5000/listall’) para tal devemos fazer o seguinte:</p><ul><li>Copiar as funções de <strong>apiController </strong>para <strong>indexController </strong>(não esquecer de importar o modelo PI).</li><li>Em <strong>indexController</strong> todo e qualquer <em>redirect </em>pretendido deve ser feito a partir da raiz (‘<strong>/</strong>’) Ex: ‘<strong>res.redirect(‘/listall’)</strong>’</li><li>Em ‘<strong>routes\index.js</strong>’ criar as rotas necessárias que referenciem as funções copiadas para <strong>indexController </strong>e proteger as rotas com a propriedade <strong><em>ensureAuthenticated</em></strong> importada de ‘<strong>\config\Auth.js</strong>’.</li><li>Nas <em>views</em>, todos os endereços começados por ‘<strong>/api/…</strong>’ devem passar a ser ‘<strong>/…</strong>’</li><li>Em <strong>apiController</strong> toda e qualquer função, deve enviar na resposta, o objeto solicitado no <em>end-point,</em> tal qual faziamos com o Postman antes de criarmos o <em>front-end</em> da aplicação — Exemplo:</li></ul><pre>// listar todos os pontos de interesse da BD<br><strong>exports.listAll = function (req, res, next) {</strong><br>  PI.find({}).then(function(pi){<br>    // res.render(&#39;listPIs&#39;, {pis: pi}); -&gt; no <em>front-end</em><br>    <strong>res.send(pi);</strong><br>  }).catch(next);<br><strong>};</strong></pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*n6S7r_LMmqLbGNMuLf7GPw.png" /><figcaption>apiController — excerto</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9eGVa-EDKPmczCWwu29GlA.png" /><figcaption>indexController — excerto</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XCSLe6-dGmAEeAi1m0joOQ.png" /><figcaption>routes\index.js</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5LTRlfRxqdePs_DfmrDWsQ.png" /><figcaption>listPIs.ejs — excerto</figcaption></figure><p>Separada a aplicação da api podemos oferecer dois exemplos, que nesta altura para quem acompanhou o tutorial desde o inicio, não são novidade. Se introduzirmos o endereço: <a href="http://localhost:5000/listall">http://localhost:5000/api/listall</a> recebemos o seguinte resultado:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rKF_TC1kCKxcSbpYJcT8rQ.png" /><figcaption>pedido de autenticação</figcaption></figure><p>Porque a rota está protegida é-nos pedido fazer a autenticação.</p><p>Se nos autenticar-mos e fizer-mos de novo o mesmo pedido, recebemos o seguinte resultado:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/476/1*ZXfWJsb2_XvuEegiiCQXCg.png" /><figcaption>unico documento na base de dados</figcaption></figure><p>Se fizer-mos logout e introduzir-mos o endereço: <a href="http://localhost:5000/listall">http://localhost:5000/listall</a>, recebemos o seguinte resultado:</p><figure><img alt="" src="https://cdn-images-1.medium.com/proxy/1*rKF_TC1kCKxcSbpYJcT8rQ.png" /><figcaption>pedido de autenticação</figcaption></figure><p>Se nos autenticar-mos e fizer-mos de novo o mesmo pedido, recebemos o seguinte resultado:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gN7RkDa1akocnpQqCOdqAw.png" /><figcaption>unico documento na base de dados</figcaption></figure><h3>Melhoramentos no layout</h3><p>Mencionaremos alguns melhoramentos efetuados no layout da aplicação.</p><p>Em ‘<strong>\public\assets\styles</strong>’ criámos as seguintes classes para criar os botões:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/125db46e2662cc12e7f6c6b2fb0abc0d/href">https://medium.com/media/125db46e2662cc12e7f6c6b2fb0abc0d/href</a></iframe><p>Na <em>view ‘</em><strong>dashboard.ejs</strong>’ (que antes se chamava ‘create.ejs’) incluímos um video com o seguinte código:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/5b1362b51c51aa49c147312f1d7455ee/href">https://medium.com/media/5b1362b51c51aa49c147312f1d7455ee/href</a></iframe><p>Tornámos o mapa da google responsivo criando e usando as seguintes classes em ‘<strong>styles.css</strong>’:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b9fb84c344b52e76f316727c0e213fe8/href">https://medium.com/media/b9fb84c344b52e76f316727c0e213fe8/href</a></iframe><p>Em ‘<strong>\views\details.ejs</strong>’ usar a class ‘<strong>map-responsive</strong>’ como:</p><iframe src="" width="0" height="0" frameborder="0" scrolling="no"><a href="https://medium.com/media/b4bf8aef38589c4781b7ab492f7cd5a9/href">https://medium.com/media/b4bf8aef38589c4781b7ab492f7cd5a9/href</a></iframe><p>As restantes modificações foram um exercício de exploração do tema ‘<strong><em>Flatly</em></strong><em>’ </em>de ‘<strong><em>bootswatch</em></strong>’ que usámos em ‘<strong>views\bootswatch.ejs</strong>’.</p><h3>Screenshots da nossa aplicação final</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*oY7cR4i8GAD--rMkFWj12g.png" /><figcaption>welcome-page</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*0QYuXN3bek99kjjuF_aRmA.png" /><figcaption>register-page</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*xZ0Bc-QJWeuysjuqadLc3g.png" /><figcaption>login-page</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*kcQ3dpWAQZuCDvQBpvh3rA.png" /><figcaption>dashboard-page</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*052ntWvtTR-OSCiH6ItBtw.png" /><figcaption>nearby-page</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QPMSKHXtrPut7KcxF8SK1g.png" /><figcaption>edit-page</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2xsTvF06uEiQTY3zJrqRYA.png" /><figcaption>nearby-page (show)</figcaption></figure><p>E chegamos ao fim deste Tutorial, esperamos que tenham gostado!</p><p>Até á próxima!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=7802098cbe9e" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Criar uma app de meteorologia]]></title>
            <link>https://medium.com/@nunofilipe_16451/criar-uma-app-de-meteorologia-f2f9eb02ab10?source=rss-fbcb3903cce------2</link>
            <guid isPermaLink="false">https://medium.com/p/f2f9eb02ab10</guid>
            <dc:creator><![CDATA[Nuno Filipe]]></dc:creator>
            <pubDate>Tue, 26 Mar 2019 11:10:35 GMT</pubDate>
            <atom:updated>2019-03-26T11:10:35.396Z</atom:updated>
            <content:encoded><![CDATA[<h3>Requisitos:</h3><p><strong>. Node.js</strong> — É um interpretador de código JavaScript que funciona do lado do servidor.</p><p><strong>. OpenWeatherMap </strong>— É um serviço que permite consultar informações climáticas. Este serviço tem disponível uma API público que nos permite aceder à informação climatérica de uma determinada cidade.</p><h3>Passo 1 — Criar conta no site OpenWeatherMap</h3><p>Criamos uma conta de acesso <a href="https://home.openweathermap.org/users/sign_up">aqui</a>.</p><p>Em seguida selecionamos o separador <strong>API Keys</strong> e vamos criar uma chave. Para tal, basta inserir no campo <strong>Name</strong> um nome que ficará associado à chave que for gerada.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VCgK2nLdZ3pcz7NczCd5rw.png" /></figure><h3>Passo 2 — Desenvolvimento da app</h3><p>Vamos criar um diretório com o nome nodejs-weather e iniciamos o nosso projeto com o comando npm init.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/605/1*JNLt7NXLH1XN4XbO3PeYng.jpeg" /></figure><h3>Invocar a API OpenWeatherMap</h3><p>Invocamos a API OpenWeatherMap, usando o módulo npm <a href="https://www.npmjs.com/package/request">request</a>. Para instalar este módulo basta executar o comando:</p><pre>npm install request --save</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/584/1*rwzEsqJT_4zu63zDImQgfQ.jpeg" /></figure><p><strong>Abrir o ficheiro index.js e insirir o seguinte código:</strong></p><pre>let request = require(`request`);<br>let apiKey = `ff36744e21a2eb124250183dde2e2884`;<br>let cidade = `Guarda`;<br>let url =`<a href="http://api.openweathermap.org/data/2.5/weather?q=${cidade}&amp;appid=${apiKey}&amp;units=metric`">http://api.openweathermap.org/data/2.5/weather?q=${cidade}&amp;appid=${apiKey}&amp;units=metric`</a><br> <br>request(url, function (err, response, body) {<br> if(err){<br> console.log(`error:`, error);<br> } else {<br> // assim já funciona<br> let weather = JSON.parse(body);<br> let dados = `Temperatura para a ${weather.name}:<br> -------------------------------------------<br> - Temperatura: ${weather.main.temp}ºc<br> - Humidade: ${weather.main.humidity} %`;<br> console.log(dados);<br> }<br>});</pre><p>Breves Explicações</p><ul><li><strong>apiKey</strong> — Insiram a chave criada no OpenWeatherMap</li><li><strong>cidade</strong> — Insirir o nome da Cidade para a qual se pretende obter a informação climatérica</li><li><strong>url</strong>: Invocação da API, onde passamos como parâmetros a cidade e a chave.</li></ul><p><strong>Executando o comando node index.js o output será o seguinte:</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/739/1*DYHZYOla5lKk9wCVLF2iGg.jpeg" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f2f9eb02ab10" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Como instalar HBase, base de dados distribuída orientada para BigData]]></title>
            <link>https://medium.com/@nunofilipe_16451/como-instalar-hbase-base-de-dados-distribu%C3%ADda-orientada-para-bigdata-27a51ae8d86d?source=rss-fbcb3903cce------2</link>
            <guid isPermaLink="false">https://medium.com/p/27a51ae8d86d</guid>
            <dc:creator><![CDATA[Nuno Filipe]]></dc:creator>
            <pubDate>Tue, 19 Mar 2019 09:29:58 GMT</pubDate>
            <atom:updated>2019-03-27T19:05:52.803Z</atom:updated>
            <content:encoded><![CDATA[<h3>Como instalar HBase, base de dados distribuída, em Fully Distributed Mode</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/968/1*jTf8B912gsjvx3AZvO8u2g.png" /></figure><h3>O que é o HBase?</h3><p>O HBase é uma base de dados distribuída, não-relacional (NoSQL) que é executado em cima do Hadoop Distributed File System (HDFS). O apache HBase fornece acesso aleatório e em tempo real aos dados do hadoop. A fácil integração com o hadoop, permite a utilização do MapReduce para distribuir e processar vários terabytes de dados.</p><p>Este tutorial mostra como instalar a plataforma distribuída hadoop na primeira fase e como instalar a base de dados distribuída Hbase na fase seguinte.</p><h3><strong>INSTALAÇÃO DO HADOOP</strong></h3><h3><strong>O que é o hadoop?</strong></h3><p>Hadoop é uma plataforma distribuída que permite gerir e processar grandes quantidades de dados.</p><p>O Hadoop está dividido em duas partes essenciais:</p><ul><li>Hadoop Distributed File System (HDFS) - um sistema de ficheiros distribuído que armazena dados em máquinas dentro do cluster.</li><li>Hadoop MapReduce - modelo de programação para processamento de grandes volumes de dados.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*dAb9kG-lXX4RICeSxyncTg.png" /></figure><h3>Fase 1 — Instalar o hadoop em modo Multi Node no Ubuntu 16.04.4 usando o Oracle VM virtual box</h3><p>A melhor estratégia é instalar o Hadoop em modo Single Node na máquina virtual, clonar essa máquina e reconfigurá-la. A seguir criam-se as máquinas slaves a partir da master (modo Multi Node).</p><h3><strong>Configuração hadoop Single Node</strong></h3><p>Criada máquina virtual ‘hadoopSingleNode’ com Ubuntu como sistema operativo, abrir linha de comandos e seguir os seguintes passos:</p><p><strong>. Instalar java</strong></p><pre>// Instalar java<em><br> . </em>sudo apt-get install default-jdk</pre><pre>// Verificar instalação e caminho<br> . update-alternatives --config java</pre><p><strong>. Atribuir um nome ao host</strong></p><pre>// Editar hostname<br> . sudo nano /etc/hostname</pre><pre>// Edição:<br> . singleNode</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/803/1*TDkIjslKr5e2aOqczoZRJg.jpeg" /></figure><p>. <strong>Mapear os domínios</strong></p><pre>// Editar hosts:<br> . nano /etc/hosts</pre><pre>// Edição:<br> . 192.168.10.10   singleNode</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/799/1*eM3L7UTI9a9DeoEqp5H9-Q.jpeg" /></figure><p>. <strong>Instalar SSH e criar uma chave</strong></p><pre>// instalar ssh<br> . sudo apt-get install ssh</pre><pre>// criar chave<br> . cat ~/.ssh/id_rsa.pub &gt;&gt; ~/.ssh/authorized_keys</pre><pre>// verificação<br> . ls -al ~/.ssh</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/803/1*cJ5O01LKoct0doe0xWfPNQ.jpeg" /></figure><p>. <strong>Download e descompactação do hadoop</strong></p><pre><strong>// download<br> . wget</strong> <a href="https://www.apache.org/dist/hadoop/core/hadoop-2.7.0/hadoop-2.7.0.tar.gz">https:<strong>//</strong>www.apache.org<strong>/</strong>dist<strong>/</strong>hadoop<strong>/</strong>core<strong>/</strong>hadoop-2.7.0<strong>/</strong>hadoop-2.7.0.tar.gz</a></pre><pre>// descompactar<br> . <strong>tar</strong> xzf hadoop-2.7.0.tar.gz</pre><pre>// mover para pasta HADOOP<br> . <strong>mv</strong> hadoop-2.7.0 HADOOP</pre><p><strong>. Definir variáveis no ficheiro </strong>~/.bashrc</p><pre>// Editar<br>. sudo nano ~/.bashrc</pre><pre>// Edição:<br> # HADOOP VARIABLES<br> # Caminho Java:/usr/lib/jvm/java-8-openjdk-i386<br>  export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-i386<br>  export HADOOP_HOME=/home/nuno/HADOOP <br>  export PATH=$PATH:$HADOOP_HOME/bin <br>  export PATH=$PATH:$HADOOP_HOME/sbin <br>  export HADOOP_MAPRED_HOME=$HADOOP_HOME <br>  export HADOOP_COMMON_HOME=$HADOOP_HOME <br>  export HADOOP_HDFS_HOME=$HADOOP_HOME <br>  export YARN_HOME=$HADOOP_HOME <br>  export HADOOP_COMMON_LIB_NATIVE_DIR=$HADOOP_HOME/lib/native <br>  export HADOOP_OPTS=&quot;-Djava.library.path=$HADOOP_HOME/lib&quot; <br> # HADOOP VARIABLES END</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/803/1*Ab3cjR6xtjAdH7VLk8uJbw.jpeg" /></figure><p><strong>. Tornar a configuração na sessão corrente, com efeito</strong></p><pre>source ~/.bashrc</pre><p><strong>. Editar </strong>hadoop-env.sh<strong> e definir a variável de ambiente </strong>JAVA_HOME</p><pre>// Editar:<br> . cd /home/nuno/HADOOP/etc/hadoop/<br> . sudo nano hadoop-env.sh</pre><pre>// Edição:<br> . export JAVA_HOME=&quot;/usr/lib/jvm/java-8-openjdk-i386&quot;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/797/1*8QvHkm6APcGFvwDmaxz-_Q.jpeg" /></figure><p><strong>. Editar </strong>core-site.xml</p><pre>// Editar o ficheiro core-site.xml:<br> . cd /home/nuno/HADOOP/etc/hadoop/<br> . sudo nano core-site.xml</pre><pre>// Edição:<br> &lt;configuration&gt;<br>  &lt;property&gt; <br>    &lt;name&gt;fs.default.name&lt;/name&gt;<br>    &lt;value&gt;hdfs://localhost:9000&lt;/value&gt; <br>  &lt;/property&gt;<br> &lt;/configuration&gt;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/705/1*4QcxrDzE2PU3Riur4L5pbw.jpeg" /></figure><p><strong>. Editar </strong>yarn-site.xml</p><pre>// Editar o ficheiro yarn-site.xml:<br> . cd /home/nuno/HADOOP/etc/hadoop/<br> . sudo nano yarn-site.xml</pre><pre>// Edição:<br>  &lt;property&gt; <br>    &lt;name&gt;yarn.nodemanager.aux-services&lt;/name&gt;<br>    &lt;value&gt;mapreduce_shuffle&lt;/value&gt; <br>  &lt;/property&gt; <br>  &lt;property&gt; <br>    &lt;name&gt;yarn.nodemanager.aux-services.mapreduce.shuffle.class<br>    &lt;/name&gt;<br>    &lt;value&gt;org.apache.hadoop.mapred.ShuffleHandler&lt;/value&gt; <br>  &lt;/property&gt;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/802/1*gGm4SfqdCiudJkfQfCSsyA.jpeg" /></figure><p><strong>. Editar </strong>mapred-site.xml</p><p>Caso este ficheiro não exista, procurar o ficheiro mapred-site.xml.template. Neste caso deve-se mudar o nome mapred-site.xml.template para mapred-site.xml.</p><pre>// Aceder á dir ../hadoop:<br>. cd /home/nuno/HADOOP/etc/hadoop/</pre><pre>// Mudar nome e editar mapred-site.xml:<br> . sudo cp mapred-site.xml.template mapred-site.xml<br> . sudo nano mapred-site.xml</pre><pre>// Edição:<br>  &lt;property&gt;<br>   &lt;name&gt;mapreduce.framework.name&lt;/name&gt; <br>   &lt;value&gt;yarn&lt;/value&gt; <br>  &lt;/property&gt;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/725/1*47N_rFAQOHmeW3Vw8g1P_Q.jpeg" /></figure><p><strong>. Editar </strong>hdfs-site.xml</p><pre>// Editar o ficheiro hdfs-site.xml:<br> . cd /home/nuno/HADOOP/etc/hadoop/<br> . sudo nano hdfs-site.xml</pre><pre>// Edição:<br>&lt;configuration&gt;<br>  &lt;property&gt;<br>    &lt;name&gt;dfs.replication&lt;/name&gt;<br>    &lt;value&gt;1&lt;/value&gt;<br>  &lt;/property&gt;<br>  &lt;property&gt;<br>    &lt;name&gt;dfs.namenode.name.dir&lt;/name&gt;<br>    &lt;value&gt;file:/home/nuno/HADOOP/hadoop_data/hdfs/namenode&lt;/value&gt;<br>  &lt;/property&gt;<br>  &lt;property&gt;<br>    &lt;name&gt;dfs.datanode.data.dir&lt;/name&gt;<br>    &lt;value&gt;file:/home/nuno/HADOOP/hadoop_data/hdfs/datanode&lt;/value&gt;<br>  &lt;/property&gt;<br>&lt;/configuration&gt;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/801/1*qm0Z1XRgXg42ECBHfwmUyQ.jpeg" /></figure><p><strong>. Criar pastas </strong>namenode <strong>e </strong>datanode</p><pre>. sudo mkdir -p /home/nuno/HADOOP/hadoop_data/hdfs/namenode<br>. sudo mkdir -p /home/nuno/HADOOP/hadoop_data/hdfs/datanode</pre><p><strong>. Mudar dono da pasta </strong>~/HADOOP</p><pre>// mudar o dono da pasta ../HADOOP para user:nuno e grupo:nuno<br> . sudo chown nuno:nuno -R /home/nuno/HADOOP</pre><p><strong>. Formatar o </strong>namenode</p><pre> . hdfs namenode -format</pre><p><strong>. Iniciar todos os serviços (com privilégios root) associados ao hadoop</strong></p><pre> . start-all.sh<br>       ou<br> . start-dfs.sh<br> . start-yarn.sh</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/803/1*u-w-yLPDFaYHJ1D-XXwZ_g.jpeg" /></figure><p><strong>. Verificar se todos os serviços iniciaram correctamente</strong></p><pre>jps</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/802/1*0f78BnXaFh9MbNwTv56x0w.jpeg" /></figure><p><strong>. Aceder ao apache hadoop</strong></p><p>Para aceder à interface de gestão do apache hadoop basta abrir um browser e introduzir o endereço <a href="http://localhost:8088/">http://localhost:8088</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*S34neB2e5WAiAAjv-Y-sIQ.jpeg" /></figure><h3><strong>Configuração do hadoop em modo<em> Multi Node</em></strong></h3><p>Neste ponto faremos um clone da máquina configurada em modo Single Node e seguimos para a configuração em modo Multi Node.</p><p>Configura-se a nova máquina clonada que servirá de Master, a seguir fazem-se dois clones a partir da maquina Master que servirão de Slaves.</p><p><strong>. Configuração de rede</strong></p><p>As máquinas virtuais que utilizam o hadoop em modo distribuído necessitam de comunicar entre si, uma opção é configurar as máquinas no virtual box com duas interfaces por máquina, uma em modo Host-Only e outra em modo NAT.</p><p><strong>Esquema Host-Only network:</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1021/1*P8FgpWMk0R34uXcsPtTdUg.png" /><figcaption>*os endereços são a titulo de exemplo</figcaption></figure><p><strong>Esquema NAT network:</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PExxS8ISU7nYjT5vQbj3LA.png" /><figcaption>*os endereços são a titulo de exemplo</figcaption></figure><h3>Configuração do Master</h3><p><strong>. Definir nós do cluster</strong></p><pre>// Editar /etc/hosts:<br> . sudo nano /etc/hosts</pre><pre>// Edição:<br>  127.0.0.1       localhost<br>  192.168.10.11   master    <br>  192.168.10.12   slave1   <br>  192.168.10.13   slave2</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/649/1*A_JLWrn8PIEsc2qyvUDYBQ.jpeg" /></figure><p><strong>. Mudar hostname</strong></p><pre>// EDITAR:<br> . sudo nano /etc/hostname</pre><pre>// Edição:<br> . master</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/642/1*KB8FM2lOZOCa-SyYaimKpQ.jpeg" /></figure><p><strong>. Redefinir hostname em </strong>core-site.xml</p><pre>// Editar:<br> . cd /home/nuno/HADOOP/etc/hadoop/<br> . sudo nano core-site.xml</pre><pre>// Edição:<br> &lt;name&gt;fs.default.name&lt;/name&gt;<br> &lt;value&gt;hdfs://master:9000&lt;/value&gt;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/639/1*g7W4r9j4XwJFL5jEXvdWYg.jpeg" /></figure><p><strong>. Editar </strong>hdfs-site.xml</p><pre>// Editar:<br> . cd /home/nuno/HADOOP/etc/hadoop/<br> . sudo nano hdfs-site.xml</pre><pre>// Edição:<br> &lt;property&gt;<br>   &lt;name&gt;dfs.replication&lt;/name&gt;<br>   &lt;value&gt;3&lt;/value&gt;<br> &lt;/property&gt;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/644/1*vrbfBHDO1wZ8-vHp97aJeA.jpeg" /></figure><p><strong>. Editar </strong>yarn-site.xml<strong> e fazer reboot da máquina</strong></p><pre>// Editar:<br> . cd /home/nuno/HADOOP/etc/hadoop/<br> . sudo nano yarn-site.xml</pre><pre>// Edição:<br> &lt;property&gt;<br>   &lt;name&gt;yarn.resourcemanager.resource-tracker.address&lt;/name&gt;<br>   &lt;value&gt;master:8025&lt;/value&gt;<br> &lt;/property&gt;<br> &lt;property&gt;<br>   &lt;name&gt;yarn.resourcemanager.scheduler.address&lt;/name&gt;<br>   &lt;value&gt;master:8030&lt;/value&gt;<br> &lt;/property&gt;<br> &lt;property&gt;<br>   &lt;name&gt;yarn.resourcemanager.address&lt;/name&gt;<br>   &lt;value&gt;master:8050&lt;/value&gt;<br> &lt;/property&gt;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/708/1*coaiBbww7XI2N_feV8_76A.jpeg" /></figure><p><strong>. Criar slaves a partir do master, clonando o master</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/828/1*Vkr_OU9lv5mHxIYWsuLKbQ.jpeg" /></figure><p><strong>. No master editar </strong>/etc/network/interfaces</p><pre>// Editar:<br> . sudo nano /etc/network/interfaces</pre><pre>// Edição:<br> . address 192.168.10.11 <br>// Nota: 192.168.10.10 era a máquina singleNode !!</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/708/1*sO4T3NrzgOEVXlYvzk3yfg.jpeg" /></figure><p>. <strong>Editar ficheiro </strong>masters<strong> e </strong>slaves</p><pre>// Editar:<br> . sudo nano /home/nuno/HADOOP/etc/hadoop/masters</pre><pre>// Edição:<br> . master</pre><pre>// Editar:<br> . sudo nano /home/nuno/HADOOP/etc/hadoop/slaves</pre><pre>// Edição:<br> . slave1 <br> . slave2</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/706/1*D_tVMicLqfew2Vt7hCtfYA.jpeg" /><figcaption>masters</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/710/1*cR5hMzeh6mmQFPgBPnOS4Q.jpeg" /><figcaption>slaves</figcaption></figure><p><strong>. Editar </strong>hdfs-site.xml</p><pre>//<strong> </strong>Editar<strong>:<br></strong> . sudo nano /home/nuno/HADOOP/etc/hadoop/hdfs-site.xml</pre><pre>// Edição:<br>&lt;configuration&gt;<br>  &lt;property&gt;<br>    &lt;name&gt;dfs.replication&lt;/name&gt;<br>    &lt;value&gt;3&lt;/value&gt;<br>  &lt;/property&gt;<br>  &lt;property&gt;<br>    &lt;name&gt;dfs.namenode.name.dir&lt;/name&gt;<br>    &lt;value&gt;file:/home/nuno/HADOOP/hadoop_data/hdfs/namenode&lt;/value&gt;<br>  &lt;/property&gt;<br>  &lt;property&gt;<br>    &lt;name&gt;dfs.datanode.data.dir&lt;/name&gt;<br>    &lt;value&gt;file:/home/nuno/HADOOP/hadoop_data/hdfs/datanode&lt;/value&gt;<br>  &lt;/property&gt;<br>&lt;/configuration&gt;</pre><h3>Configuração dos slaves</h3><p><strong>. No slave1 editar </strong>interfaces</p><pre>// Editar:<br> . sudo nano /etc/network/interfaces</pre><pre>// Edição:<br> . address 192.168.10.12</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/646/1*bWtXl5eZ79O6aHVlY1Fs9A.jpeg" /></figure><p><strong>. No slave1 editar </strong>hostname</p><pre>// Editar:<br> . sudo nano /etc/hostname</pre><pre>// Edição:<br> . slave1</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/645/1*9q-dsmd-tzEVgiForii7iQ.jpeg" /></figure><p><strong>. No slave2 editar </strong>interfaces</p><pre>// Editar:<br> . sudo nano /etc/network/interfaces</pre><pre>// Edição:<br> . address 192.168.10.13</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/693/1*FDSF_xDerbY5m1uWLzRoxA.jpeg" /></figure><p><strong>. No slave2 editar </strong>hostname</p><pre>// Editar:<br> . sudo nano /etc/hostname</pre><pre>// Edição:<br> . slave2</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/695/1*v0gP8wVmEgHyM_-f1lWeYw.jpeg" /></figure><p><strong>. No Master formatar o </strong>namenode</p><pre>. hdfs namenode -format</pre><p><strong>. No Master iniciar todos os serviços associados ao hadoop</strong></p><pre> . start-all.sh<br>       ou<br> . start-dfs.sh<br> . start-yarn.sh</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/712/1*D2V5CyFXRxdyIg8XXhh_kw.jpeg" /></figure><p><strong>. Verificar se está a correr no Master</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/710/1*XUtcCSoTrbCYVgZQE4OBZw.jpeg" /></figure><p><strong>. Verificar se está a correr no Slave1 e/ou Slave2</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/694/1*Xl9hMT__K7PnL95E6LTmBA.jpeg" /></figure><p><strong>. Aceder à interface gráfica de gestão</strong></p><p>Para aceder à interface de gestão do apache hadoop basta abrir um browser e introduzir o endereço <a href="http://master:8088/cluster">http://master:8088/cluster</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*rNONcWVRsK6c_1C6UsA4pw.jpeg" /></figure><p>Podemos verificar de imediato a operacionalidade do hadoop quando no campo ‘Active Nodes’ encontramos o valor ‘2’ que se refere aos dois slaves configurados.</p><p><strong>TESTAR A PLATAFORMA HADOOP CALCULANDO O VALOR DE PI</strong></p><p>O instalador da plataforma hadoop contém um método para calcular o valor de pi, quasi-Monte Carlo. Muito sumariamente, o método passa por colocar pontos aleatoriamente num quadrado unitário que dentro contém um círculo. Quanto maior for o numero de pontos utilizados, melhor será a estimativa do valor de pi.</p><p>Utiliza-se o seguinte comando para executar este exemplo.</p><pre>// Posicionar na pasta mapreduce:<br> . cd ~/HADOOP/share/hadoop/mapreduce/<br>// Comando:<br> . hadoop jar hadoop-mapreduce-examples-2.9.1.jar pi 6 100000</pre><p>Neste exemplo o comando utiliza 6 mapas com 100.000 amostras para estimar o valor de pi.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5-6_G713RekGouwKL5bDnQ.jpeg" /><figcaption>Output.part.1</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9Ex0c50iGcwJvwiAz8kpZw.jpeg" /><figcaption>Output.part.2</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*bGUsKXXwrgZQOSsiEIFCKw.jpeg" /><figcaption>Output.part.3</figcaption></figure><p>É possível ver o valor estimado que a aplicação calculou na imagem acima : “Pi = 3.1416466666666666666667”</p><h3>Fase 2 — Instalação da plataforma HBase</h3><p><strong>FULLY-DISTRIBUTED MODE:</strong></p><ul><li>HBase será executado em vários hosts, Master e Slaves.</li><li>Os daemons serão distribuídos por todos os nós do cluster, em que existe o Master e vários RegionServers que utilizam o ZooKeeper para coordenação e comunicação, um dos RegionServers funcionará como Master-Backup para contemplar tolerância a falhas.</li><li>Utilizará o sistema HDFS já configurado na instalação do hadoop.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/575/1*Q1ZzRUTyYX40a5b796h-nw.jpeg" /><figcaption>Os endereços são a titulo de exemplo</figcaption></figure><h3>Componentes da Arquitetura (Daemons)</h3><p><strong>HMaster</strong> — O Hmaster atribui regiões aos RegionServers com a ajuda do ZooKeeper para distribuir os pedidos de forma equilibrada, deslocando as regiões para RegionServers menos ocupados.</p><p>Este componente é responsável por alterações do esquema e outras operações de metadados, como criação de tabelas e famílias de colunas.</p><p><strong>HRegionServer </strong>— O HRegionServer, é executado em todos os nós DataNode no cluster do hadoop. Esses são os nós de trabalho que manipulam solicitações de leitura, gravação, atualização e exclusão.</p><p><strong>Zookeeper </strong>(<strong>HQuorumPeer</strong>) — O HBase usa o ZooKeeper como um serviço de coordenação distribuída. Alguns serviços fornecidos são:</p><ul><li>Estabelecer a comunicação do cliente com os servidores da região.</li><li>Acompanhar falhas do servidor e partições de rede.</li><li>Manter informações de configuração.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1002/1*fY5TUAIvIQmeoP5uUsaVQg.jpeg" /></figure><h3>Configuração HBase em Fully-Distributed Mode</h3><p>No Virtual Box criar 3 clones a partir da maquina hadoopMaster da forma apresentada na figura abaixo. Notar que a configuração da rede será em tudo semelhante áquela usada no hadoop Multinode.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/829/1*XBGX7bFsirNzWgXmEoUllA.jpeg" /></figure><p><strong>. Download HBase em masterHbase</strong></p><p>Usar um browser na maquina masterHbase e fazer download a partir de: <a href="http://www-us.apache.org/dist/hbase/stable/">http://www-us.apache.org/dist/hbase/stable/</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/808/1*OqK2-wgxvwCKrie9LJg36Q.jpeg" /></figure><p><strong>. Fazer o untar do ficheiro descarregado</strong></p><pre>// Dir do ficheiro descarregado:<br> . cd ~/Desktop</pre><pre>// Untar<br> . tar xfz hbase-1.4.6-bin.tar.gz</pre><p><strong>A CONFIGURAR EM TODAS AS MÁQUINAS</strong></p><p><strong>. Editar </strong>hostname</p><pre>// Editar:<br> . sudo nano /etc/hostname</pre><pre>// Edição:<br>   masterhbase<br>   regionserver1<br>   regionserver2</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/662/1*OXW247zJy6gusYEq9uzLMw.jpeg" /><figcaption>Exemplo da configuração em regionServer1</figcaption></figure><p><strong>. Editar </strong>hosts</p><pre>// Editar:<br> . sudo nano /etc/hosts</pre><pre>// Edição:<br>   127.0.0.1       localhost<br>   192.168.10.11   masterhbase<br>   192.168.10.12   regionserver1<br>   192.168.10.13   regionserver2</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/662/1*p49XgDsVMfRpE3gZRKGNng.png" /><figcaption>Exemplo da configuração em masterHbase</figcaption></figure><p><strong>. Editar ficheiros </strong>masters <strong>e </strong>slaves</p><pre>// Editar masters:<br> . sudo nano /home/nuno/HADOOP/etc/hadoop/masters</pre><pre>// Edição:<br>   masterhbase</pre><pre>// Editar slaves:<br> . sudo nano /home/nuno/HADOOP/etc/hadoop/slaves</pre><pre>// Edição:<br>   regionserver1<br>   regionserver2</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/662/1*jU9pf0lXi5vggBZ5wwlxpA.jpeg" /><figcaption>masters</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/666/1*Fmq15ape7sm_0TRm7-FT0w.jpeg" /><figcaption>slaves</figcaption></figure><p><strong>. Editar </strong>core-site.xml</p><pre>// Editar:<br> . cd /home/nuno/HADOOP/etc/hadoop/<br> . sudo nano core-site.xml</pre><pre>// Edição:<br>&lt;configuration&gt;<br> &lt;property&gt;<br>   &lt;name&gt;fs.default.name&lt;/name&gt;<br>   &lt;value&gt;hdfs://masterhbase:9000&lt;/value&gt;<br> &lt;/property&gt;<br>&lt;/configuration&gt;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/665/1*EVOwR6vfWMi5jYCMjT3BsA.jpeg" /></figure><p><strong>. Criar diretoria </strong>/usr/local/hbase</p><pre>. sudo mkdir /usr/local/hbase</pre><p><strong>. Mudar dono e permissões da diretoria </strong>/usr/local/hbase</p><pre>. sudo chown -R nuno /usr/local/hbase<br>. sudo chmod -R 755 /usr/local/hbase</pre><p><strong>. Criar diretoria </strong>/var/hbase/pids</p><pre>. sudo mkdir /var/hbase/pids</pre><p><strong>. Mudar dono e permissões da diretoria </strong>/var/hbase/pids</p><pre> . sudo chown -R nuno /var/hbase/pids<br> . sudo chmod -R 755 /var/hbase/pids</pre><p><strong>. Gerar novas chaves SSH</strong></p><pre>. ssh-keygen -t rsa -P “”</pre><pre>// Nota: <br>. Fazer overwrite do ficheiro /home/nuno/.ssh/id_rsa</pre><p><strong>. Adicionar a chave publica em </strong>$HOME/.ssh/authorized_keys</p><pre>. cat $HOME/.ssh/id_rsa.pub &gt;&gt; $HOME/.ssh/authorized_keys</pre><p><strong>. Adicionar hostname á lista de hosts conhecidos para SSH</strong></p><pre>// fazer para cada uma das máquinas<br> . ssh masterhbase   <br> . ssh regionserver1<br> . ssh regionserver2</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/661/1*k9z2tj74EgpDJHETMBlJQQ.jpeg" /></figure><p><strong>FAZER APENAS EM MASTERHBASE</strong></p><p><strong>. Copiar a chave publica ssh para os regionServers</strong></p><pre> . ssh-copy-id -i $HOME/.ssh/id_rsa.pub nuno@192.168.10.12<br> . ssh-copy-id -i $HOME/.ssh/id_rsa.pub nuno@192.168.10.13</pre><p><strong>. Mover o conteudo da pasta </strong>hbase-1.4.6<strong> para </strong>/usr/local/hbase</p><pre>. mv hbase-1.4.6/* /usr/local/hbase</pre><p><strong>. Editar </strong>$HOME/.bashrc</p><pre>// Editar <strong>.</strong>bashrc:<br> . sudo nano $HOME/.bashrc</pre><pre>// Edição:<br># VARIABLES</pre><pre> export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-i386<br> export HADOOP_HOME=/home/nuno/HADOOP<br> export PATH=$PATH:$HADOOP_HOME/bin<br> export PATH=$PATH:$HADOOP_HOME/sbin<br> export HADOOP_MAPRED_HOME=$HADOOP_HOME<br> export HADOOP_COMMON_HOME=$HADOOP_HOME<br> export HADOOP_HDFS_HOME=$HADOOP_HOME<br> export YARN_HOME=$HADOOP_HOME<br> export HADOOP_COMMON_LIB_NATIVE_DIR=$HADOOP_HOME/lib/native<br> export HADOOP_OPTS=&quot;-Djava.library.path=$HADOOP_HOME/lib&quot;</pre><pre> export HBASE_HOME=/usr/local/hbase<br> PATH=$PATH:$HBASE_HOME/bin<br> export CLASSPATH=$CLASSPATH:/usr/local/hbase/lib/*</pre><pre># VARIABLES END</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/834/1*kw3pZFuElDyruxQAKkH4dg.jpeg" /></figure><p><strong>. Reload das mudanças em</strong> /.bashrc</p><pre>. source $HOME/.bashrc</pre><p><strong>. Editar ficheiro </strong>hbase-env.sh</p><pre>// posicionar na dir<br> . cd /usr/local/hbase/conf</pre><pre>// Editar<br> . nano hbase-env.sh</pre><pre>// Edição:<br> export JAVA_HOME=/usr/lib/jvm/java-8-openjdk-i386<br> export HBASE_REGIONSERVERS=/usr/local/hbase/conf/regionservers<br> export HBASE_MANAGES_ZK=true<br> export HBASE_PID_DIR=/var/hbase/pids</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/636/1*E4avwtpto4o0f3-ek4OYHA.jpeg" /><figcaption>Output.part.1</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/644/1*gE1I1DLYa1NrV4tS5XJgfA.jpeg" /><figcaption>Output.part.2</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/643/1*1BDqTsBD_6MnEy8bUCMKwA.jpeg" /><figcaption>Output.part.3</figcaption></figure><p><strong>. Editar ficheiro </strong>regionservers</p><pre>// Editar:<br> . sudo nano /usr/local/hbase/conf/regionservers</pre><pre>// Edição:<br>   192.168.10.12 <br>   192.168.10.13</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/639/1*VzYtgk41PTLtopteYZma5A.jpeg" /></figure><p><strong>. Editar ficheiro </strong>backup-masters</p><pre>// Editar:<br> . sudo nano /usr/local/hbase/conf/backup-masters</pre><pre>// Edição:<br>   192.168.10.12</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/643/1*yrFC3oOpbm_wWGMTt5tr4g.jpeg" /></figure><p><strong>. Correr hadoop e criar um novo utilizador no HDFS</strong></p><pre>// Correr hadoop:<br> . start-all.sh</pre><pre>// Criar novo utilizador no HDFS:<br> . hdfs dfs -mkdir -p /user/nuno/hbase</pre><pre>// Verificar criação de utilizador:<br> . hdfs dfs -ls /user</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/741/1*FXIurZdVml-M71CkZgAGqQ.jpeg" /></figure><p><strong>. Criar nova dir em </strong>/user/hduser/zookeeper<strong> no HDFS</strong></p><pre>. hdfs dfs -mkdir -p /user/nuno/zookeeper</pre><p><strong>. Editar ficheiro </strong>hbase-site.xml</p><pre>// Posicionar na dir:<br> . cd /usr/local/hbase/conf</pre><pre>// Editar:<br> . nano hbase-site.xml</pre><pre>// Edição:<br>&lt;configuration&gt;<br>        &lt;property&gt;<br>        &lt;name&gt;hbase.rootdir&lt;/name&gt;<br>        &lt;value&gt;hdfs://masterhbase:9000/user/nuno/hbase&lt;/value&gt;<br>        &lt;/property&gt;</pre><pre>&lt;property&gt;<br>        &lt;name&gt;hbase.cluster.distributed&lt;/name&gt;<br>        &lt;value&gt;true&lt;/value&gt;<br>        &lt;/property&gt;</pre><pre>&lt;property&gt;<br>        &lt;name&gt;hbase.zookeeper.quorum&lt;/name&gt;<br>        &lt;value&gt;192.168.10.11,192.168.10.12,192.168.10.13&lt;/value&gt;<br>        &lt;/property&gt;</pre><pre>&lt;property&gt;<br>        &lt;name&gt;hbase.master&lt;/name&gt;<br>        &lt;value&gt;192.168.10.11:60010&lt;/value&gt;<br>        &lt;/property&gt;</pre><pre>&lt;property&gt;<br>        &lt;name&gt;hbase.zookeeper.property.clientPort&lt;/name&gt;<br>        &lt;value&gt;2181&lt;/value&gt;<br>        &lt;/property&gt;</pre><pre>&lt;property&gt;<br>        &lt;name&gt;hbase.zookeeper.property.dataDir&lt;/name&gt;<br>        &lt;value&gt;hdfs://masterhbase:9000/user/nuno/zookeeper&lt;/value&gt;<br>        &lt;/property&gt;<br>&lt;/configuration&gt;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/747/1*y_u7cLVQjw3XBHm8FJ9B8Q.jpeg" /><figcaption>Output.part.1</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/750/1*CR7DFW2jfDRIyiTnMlxXug.jpeg" /><figcaption>Output.part.2</figcaption></figure><p><strong>. Transferir os ficheiros HBase configurados na maquina masterHabase para maquina regionServers</strong></p><pre>. scp -r /usr/local/hbase/* nuno@192.168.10.12:/usr/local/hbase <br>. scp -r /usr/local/hbase/* nuno@192.168.10.13:/usr/local/hbase</pre><p><strong>. Transferir o ficheiro </strong>.bashrc<strong> configurado na maquina masterHbase para maquina regionServers</strong></p><pre>. cp -r $HOME/.bashrc nuno@192.168.10.12:$HOME/.bashrc<br>. cp -r $HOME/.bashrc nuno@192.168.10.13:$HOME/.bashrc</pre><p><strong>. Iniciar os daemons do HBase</strong></p><pre>// Posicionar na dir:<br> . cd /usr/local/hbase/bin</pre><pre>// Executar:<br> . ./start-hbase.sh</pre><p><strong>. Verificar os processos a correr no masterHbase e regionServers</strong></p><pre>. jps</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/762/1*Mq55bD3uchJmh4Aik70DMA.jpeg" /><figcaption>masterHbase</figcaption></figure><p>Notar que regionServer1 funciona como backup-master</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/664/1*zuFKj2JWA89WTIa7N-UAWw.jpeg" /><figcaption>regionServer1</figcaption></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/667/1*xg6CuajqsC4OfMyWN4YzIw.jpeg" /><figcaption>regionServer2</figcaption></figure><p><strong>. Aceder à interface gráfica de gestão do HBase</strong></p><p>Para aceder à interface de gestão do HBase basta abrir um browser e introduzir o endereço <a href="http://masterhbase:16010/master-status">http://masterhbase:16010/master-status</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*FG8mz7uDlNNdQ3SePA3qXg.jpeg" /><figcaption>Output.part.1</figcaption></figure><p>Notar as máquinas registadas no Zookeeper.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*mmGV3Ltq3HNMCq5mSU6ZYg.jpeg" /><figcaption>Output.part.2</figcaption></figure><p><strong>CRIAR TABELAS, INSERIR DADOS E LISTAR DADOS COM HBASE</strong></p><p><strong>. Abrir a shell do HBase</strong></p><pre>. hbase shell</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/765/1*_SfZsHmf0FkJAmL1318fHA.jpeg" /></figure><p><strong>. Criar tabela de teste</strong></p><pre>. create &#39;tbl_test&#39;, &#39;columnTest_1&#39;, &#39;columnTest_2&#39;</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/839/1*ihDEy44rGEz-Lj8iLJnjKA.jpeg" /></figure><p><strong>. Inserir dados na tabela tbl_test e verificação</strong></p><pre>// Inserção:<br>. put &#39;tbl_test&#39;, &#39;row1&#39;, &#39;columnTest_1:a&#39;, &#39;valor_1&#39;<br>. put &#39;tbl_test&#39;, &#39;row1&#39;, &#39;columnTest_2:a&#39;, &#39;valor_1&#39;<br>. put &#39;tbl_test&#39;, &#39;row1&#39;, &#39;columnTest_1:b&#39;, &#39;valor_2&#39;<br>. put &#39;tbl_test&#39;, &#39;row1&#39;, &#39;columnTest_2:b&#39;, &#39;valor_2&#39;</pre><pre>// Verificação:<br>. scan &#39;tbl_test&#39;<br>. list</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/902/1*I9-FMZmy9eU7KU0hroZaag.jpeg" /></figure><p><strong>. Visualizar as tabelas na interface gráfica de gestão do HBase</strong></p><p>Abrir um browser e introduzir o endereço <a href="http://masterhbase:16010/tablesDetailed.jsp">http://masterhbase:16010/tablesDetailed.jsp</a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jO3C7iked0Kb81wxvZSKxw.jpeg" /></figure><p>E é tudo, fiquem bem!</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=27a51ae8d86d" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>