Começando com o Rails!
Nós vamos usar o Rails para criar nossa aplicação de
Back-End.
LEMBRE-SE: o Back-End é aplicação que vai apenas gerenciar
os dados.
O Rails segue a arquitetura que nós vimos na dinâmica: o MVC
(Model View Controller).
Ele funciona igualzinho como foi na dinâmica do Instagram
Humano:
1. O Back-End é feito para aceitar requisições HTTP. Essas
requisições são feitas para uma rota da aplicação.
2. tudo começa nas rotas: uma rota aponta para uma ação
de uma controller;
3. a controller utiliza as models necessárias para pegar os
dados que aquela ação da controller necessita;
4. As models possuem funções que permitem o acesso ao
banco de dados;
5. As models devolvem os dados solicitados para a
controller e a controller pede para a view montar a
resposta que será devolvida para quem fez a requisição
Você vai perceber essa arquitetura em ação na prática.
Mas primeiro, você precisa de um ambiente com o Rails
instalado
Instalando o Rails no Linux
Se você está usando um Linux, pode instalar utilizando RVM
(Ruby Version Manager). Rode os seguintes comandos:
gpg --keyserver hkp://keys.gnupg.net --recv-keys
409B6B1796C275462A1703113804BB82D39DC0E3
7D2BAF1CF37B13E2069D6956105BD0E739499BDB
curl -sSL https://get.rvm.io | bash -s stable --rails
Se não funcionar, siga o passo a passo na documentação do
RVM.
Utilizando o CodeAnywhere
Para essa prática você pode usar o CodeAnywhere para criar
sua aplicação com o Rails.
Basta criar um container com Ruby on Rails.
Quando o container for criado, instale a versão 2.4.0 do Ruby e
instale a última versão do Rails. Rode os seguintes comandos
no terminal do container do CodeAnywhere:
rvm install ruby 2.4.0
gem install rails
Nós precisamos da versão 5 do Rails. Confira a versão que foi
instalada rodando o seguinte comando:
rails --version
Qualquer variação da versão 5 serve.
Você provavelmente já sabe como usar o CodeAnywhere.
Criando um novo projeto com
o Rails
O Rails já vem com uma interface de linha de comando (CLI,
Command Line Interface) que possui várias funcionalidades
para facilitar o desenvolvimento.
Para criar um projeto Rails, rode o seguinte comando:
rails new --api NOME_DO_SEU_PROJETO
cd NOME_DO_SEU_PROJETO
Substitua NOME_DO_SEU_PROJETO por um nome que faça
sentido para o seu projeto. Só não use acentos e caracteres
especiais.
O segundo comando faz você entrar na pasta que acabou de ser
criada com o seu projeto.
Como vamos criar uma lista de tarefas pode usar o nome
“todolist”.
A flag --api diz para o Rails que nós estamos criando essa
aplicação para ser apenas um Back-End, ou seja, que ele não
vai precisar de nada para tratar HTMLs, entre outras
tecnologias que não fazem sentido para uma aplicação que só
vai cuidar dos dados.
Como vamos usar o Rails para Back-End, a camada view tem
que ser alterada para fornecer meios de montar uma resposta
que não seja HTML.
Um formato que é bastante utilizado é o JSON. O JSON é um
formato simples e todas as linguagens já possuem
ferramentas para ler um JSON. Por isso que utilizamos ele.
O Rails já vem com JBuilder por padrão. Para usar ele, basta
abrir o arquivo Gemfile (na raiz do projeto) e descomentar a linha
(provavelmente vai ser a linha 13 do Gemfile) :
gem ‘jbuilder’, ‘~> 2.5’
Depois de colocar o JBuilder como dependência do projeto, rode
o seguinte comando para instalar o JBuilder:
bundle install
Agora você está pronto para começar a criar sua aplicação!
Criando a estrutura MVC para
a entidade Tarefa
Após criarmos a nossa abstração da entidade Tarefa, nós
criamos a model que vai representar essa entidade na
aplicação.
Para essa prática, uma Tarefa pode ser abstraída contendo as
propriedades “descricao”, do tipo String, e “finalizada”, do tipo
Boolean.
Para criar a estrutura necessária (todos os arquivos do MVC
para a entidade Tarefa), rode o seguinte comando:
rails generate scaffold Tarefa descricao:string
finalizada:boolean
Esse comando vai criar a rota, a controller, a model e a view
para a entidade Tarefa.
Além de criar os arquivos, ele já cria uma implementação
padrão das operações básicas em uma entidade: Cadastro,
Listagem, Atualização e Deleção. É o vulgo CRUD.
Junto com a model Tarefa que foi criada, o Rails vai criar uma
migration para criar a respectiva tabela no banco de dados.
Para o Rails realmente criar a tabela no banco de dados, rode o
seguinte comando:
rails db:migrate
Gaste alguns minutos explorando os arquivos criados. Veja a
controller em “app/controllers”, a model em “app/models” e a view
em “app/views” .
Para ver as rotas que estão registradas para a aplicação, rode o
seguinte comando:
rails routes
Agora, coloque sua aplicação no ar! Para subir um servidor com
a aplicação rodando, rode o comando:
rails server
Esse comando sobe um servidor com a aplicação que foi criada.
Para sua aplicação aceitar requisições, tem que ter um servidor
rodando a sua aplicação. Esse comando faz isso.
Por padrão, o Rails sobe a aplicação na porta 3000.
Se você está rodando em um Linux na sua própria máquina, a
aplicação vai estar disponível na URL http://localhost:3000.
Se você está usando o CodeAnywhere, você vai ter que pegar o
nome do seu container na página de informações do container
(basta clicar com o botão direito em cima do nome do seu
container, no menu lateral, e ir em “Info”).
Por exemplo, o nome do meu container é
http://todolist-italopaivab792165.codeanyapp.com, então a
aplicação vai estar rodando na URL
http://todolist-italopaivab792165.codeanyapp.com:3000.
Acesse a rota “/tarefas.json” nessa URL e veja que a aplicação vai
te retornar um JSON vazio (porque não tem nenhuma tarefa
cadastrada no banco de dados ainda).
Para acessar uma rota, apenas coloque ela no final da URL. Por
exemplo, com uma URL do CodeAnywhere:
http://todolist-italopaivab792165.codeanyapp.com:3000/tarefas.json
Lembrando que essa rota “/tarefas.json” aponta para a ação
“index” da controller de Tarefas se for feita uma requisição com
o método GET. Confira as rotas da aplicação com o rails
routes:
Ah, caso você não saiba, toda vez que você digita uma URL no
seu navegador (Chrome, Firefox, Internet Explorer, etc) você
está fazendo uma requisição HTTP utilizando o método GET!
Faz sentido né?! Porque você quer pegar (get) a página que está
naquela URL.
Então, quando você acessa essa rota, o Rails vai rodar a ação
“index” da controller de Tarefa. Dá uma olhada lá no que essa
ação “index” faz.
Provavelmente ela deve pedir uma lista com todas as tarefas
que estão no banco de dados para a model de Tarefa.
E como não tem nenhuma tarefa cadastrada ainda no banco de
dados, essa rota não está retornando dado nenhum.
Agora vamos popular o nosso banco de dados para aparecer
alguma coisa nessa rota!
Brincando com o banco de
dados através da Model
Após ter rodado o comando rails db:migrate você já deve ter
a tabela de tarefas no banco de dados. Agora é hora de
cadastrar algumas tarefas e testar algumas consultas.
Se você está usando o CodeAnywhere, abra outro terminal no
seu container (basta clicar com o botão direito em cima do
nome do seu container, no menu lateral, e ir em “SSH Terminal”)
para rodar os próximos comandos.
Deixe o rails server rodando em um terminal separado,
enquanto rodamos os próximos comandos em outro terminal.
Rode o seguinte comando para abrir um terminal com a nossa
aplicação. Aqui você pode testar qualquer classe (qualquer
model, por exemplo) da sua aplicação.
rails console
Com o terminal aberto pelo comando anterior, crie algumas
tarefas com o método “create”:
tarefa1 = Tarefa.create(descricao: ‘Primeira tarefa’,
finalizada: false)
tarefa2 = Tarefa.create(descricao: ‘Segunda tarefa’,
finalizada: false)
O método create cria uma registro no banco de dados e retorna
um objeto da classe da model na qual ele foi chamado, no caso
a model de Tarefa. Então, as variáveis tarefa1 e tarefa2 são
objetos da model Tarefa (lembra da orientação a objetos ?).
Agora acesse a rota “/tarefas.json” e perceba que agora essa rota
retorna os dados das tarefas cadastradas no banco de dados.
http://todolist-italopaivab792165.codeanyapp.com:3000/tarefas.json
Por quê?!
Porque a ação index da controller de tarefa pediu para o model
de Tarefa todas as tarefas cadastradas no banco de dados.
Esse método “all” faz uma consulta no banco de dados e pega
tudo que tiver na tabela de tarefas e retorna.
Teste esse método no console do Rails e veja que ele vai
retornar um array com as tarefas.
Teste alguns métodos de consulta ao banco de dados listados
na documentação do Rails.
Por exemplo, o where:
Tarefa.where(finalizada: false)
O método where t e permite fazer consultas ao banco de dados
com base em alguns critérios.
Essa consulta acima vai retornar uma lista (array) com todas
as tarefas que ainda não estão finalizadas.
Pesquise como fazer as seguintes consultas no banco de dados
através da model de Tarefa do Rails:
● pegar a última tarefa cadastrada no banco de dados;
● pegar a primeira tarefa cadastrada no banco de dados;
● pegar todas as tarefas que estão finalizadas;
● pegar a tarefa que possui a descrição “Estudar Banco de
Dados”;
● pegar a tarefa que possui o ID de número 7;
● saber quantas tarefas foram cadastradas no banco de
dados;
● saber quantas tarefas finalizadas existem no banco de
dados.
Você vai encontrar como fazer essas consultas na
documentação do Rails. Se não encontrar aí, pesquise no
Google e tente achar uma solução.
