Tutorial Node.js: REST API de uma simples calculadora

O Node.js é uma das linguagens de programação mais versáteis da atualidade. Com a possibilidade de adicionar pacotes (packages), facilmente construímos aplicações e serviços poderosos.

Hoje vamos aprender como criar uma API com funções básicas de calculadora.

O Node.js tem também suporte para vários protocolos como, por exemplo, HTTP, HTTPS, DNS, WebSockets, etc e segue o modelo não bloqueante, ou seja, os pedidos serão feitos e entregues quando estiverem prontos…

O que significa CRUD?

CRUD é uma sigla que vem do mundo da programação de computadores e se refere às quatro funções que são consideradas necessárias para implementar um aplicativo de armazenamento persistente: criar (CREATE), ler (READ), atualizar (UPDATE) e excluir (DELETE).

A abreviação CRUD mapeada para o padrão ISO/SQL:

• Create — INSERT
• Read — SELECT
• Update — UPDATE
• Delete — DELETE

Arquitetura REST

REST, ou REpresentational State Transfer, é um estilo de arquitetura para fornecer padrões entre sistemas de computador na web, tornando mais fácil para os sistemas se comunicarem entre si.

Existem várias representações para apresentar um recurso como, por exemplo, XML, JSON, sendo que este último é o mais usado. Saber mais aqui.

Passo 1) Criar o diretório para projeto

Passo 2) Iniciar o projeto

D

Depois de preenchidos os campos:

No final será criado o ficheiro package.json. Este ficheiro guarda as informações sobre o projeto e também sobre as dependências (pacotes) do mesmo.

Passo 4) Instalação de pacotes necessários

• hapi — framework para criação de apps web.

Passo 5) Criar servidor (com Node.js)

Para começar vamos criar o ficheiro index.js (indicado no package.json)

type null >> index.js

Dentro do nosso ficheiro, associamos as dependências instaladas anteriormente (hapi) e inicializamos a app.

Para iniciar a app executa-se o comando

node index.js

O resultado ainda não aparece nada de especial sendo o resultado:

Vamos agora criar um about da app. Para tal adiciona-se o código a seguir ao init:

server.route ({
    method: 'GET',
    path: '/ calculator / about',
    handler: function (request, h) {

        var data = {
            msg: 'Calculator API'
        };

        return data;
    }
});

Fazendo o teste via POSTMAN

Organização da Aplicação (MVC)

A nossa aplicação deverá seguir o “design” MCV. M de Model (código para o nosso modelo de base de dados), V de View (layout) e C de controllers (parte lógica da app (Como a app lida com as solicitações recebidas e as respostas enviadas).

Criação dos Routes

mkdir routes
cd routes
touch routes.js

No ficheiro index.js, antes do init(), devem invocar o ficheiro de routes.

Ficheiro routes com as operações básicas da calculadora.

Depois de criada a app e colocada em execução, podemos facilmente testar todas as operações via browser ou POSTMAN.