Tutorial Ruby on Rails

O Rails foi criado por David Heinemeier Hansson, popularmente conhecido como DHH. É uma das ferramentas mais influentes e populares para o desenvolvimento de aplicações web. É utilizado por grandes sites como Airbnb, GitHub e Shopify.

Por que Trilhos?

Antes de instalar o conjunto de ferramentas, é útil entender por que o Rails continua sendo uma escolha popular para envio de código.ping aplicações web rapidamente.

• O Rails é distribuído como uma gem do Ruby e você pode usá-lo para criar uma ampla variedade de aplicações.
• Ele permite criar aplicações web comuns, sites de comércio eletrônico, sistemas de gerenciamento de conteúdo e muito mais.
• Rails é um framework full-stack que inclui tudo o que você precisa para criar uma aplicação web orientada a banco de dados usando o padrão Model-View-Controller (MVC).
• Todas as camadas são projetadas para funcionar perfeitamente em conjunto, portanto, os projetos Rails normalmente precisam de menos linhas de código do que projetos equivalentes em outras estruturas.

Como baixar e instalar Ruby em Windows

O processo de instalação depende do seu sistema operacional. As próximas seções abordam a instalação do Ruby em sistemas operacionais. Windows, Mac e Linux.

Passo 1) Baixe o Rubyinstaller.
A maneira mais fácil de instalar Ruby em seu Windows O computador é instalado através do Ruby Installer, disponível em https://rubyinstaller.org/.

Após o download, execute o instalador.

Passo 2) Clique no instalador que você baixou.
Double-clique no arquivo de instalação baixado, por exemplo rubyinstaller-2.4.1-2-x64.exe.

Passo 3) Aceitar a licença.
Selecione a opção “Aceito a licença” e clique no botão “Avançar”. Você deverá ver a tela abaixo.

Passo 4) Marque as duas primeiras caixas de seleção.
Marque as duas primeiras caixas de seleção para facilitar a execução de scripts Ruby.

Clique no botão “Instalar” para iniciar a instalação. Você deverá ver a tela abaixo quando ela for concluída.

Passo 5) Clique em Concluir.
Não desmarque a opção que instala o MSYS2. Clique em “Concluir” para finalizar a instalação. Uma janela do prompt de comando será aberta, como mostrado abaixo.

Passo 6) Instale o MSYS2.
Esta etapa instala o MSYS2, uma plataforma de compilação que inclui um gerenciador de pacotes para facilitar a instalação de pacotes no sistema. Windows.

Pressione Enter para instalar todos os componentes, pois todos são necessários para um ambiente de desenvolvimento Ruby on Rails funcionando corretamente. Windows.

Instalando Trilhos

Você já deve ter o Ruby instalado, conforme descrito na seção anterior. Em seguida, instale o Rails. Você pode instalar o Rails usando um pacote do [link para o pacote]. Instalador do Rails, mas o pacote geralmente não inclui a versão mais recente de todas as dependências necessárias.

Se você já possui a versão mais recente do Ruby e os pacotes RubyGems e extensões básicos instalados, basta executar o seguinte comando no prompt de comando para instalar o Rails em seu sistema: gem install rails.

Você também precisará instalar Node.js Se você ainda não o tem, pois algumas bibliotecas das quais o Rails depende exigem um JavaPara que o script funcione corretamente em tempo de execução, obtenha o Node em https://nodejs.org.

Uma abordagem mais comum e preferida em Windows é usar o Windows Subsistema para Linux. Ele fornece um ambiente GNU/Linux com ferramentas de linha de comando, utilitários e aplicativos comuns diretamente no sistema. Windows.

Instalando Ruby no Mac

Seu Mac já possui o Ruby pré-instalado. No entanto, a versão pré-instalada geralmente está desatualizada, portanto, você deve instalar uma versão mais recente.

A maneira mais fácil de fazer isso é usar um gerenciador de pacotes como o HomebrewVocê pode precisar instalar o Homebrew primeiro executando o comando abaixo no Terminal.

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Isso exibirá um aviso e solicitará que você insira sua senha. Digite a senha do seu Mac (os caracteres não aparecerão enquanto você digita) e pressione Enter quando terminar. Em seguida, execute este comando do Homebrew para instalar o Ruby no seu Mac.

brew install ruby

Em seguida, execute este comando:

echo 'export PATH="/usr/local/bin:/usr/local/sbin:$PATH"' >> ~/.bash_profile

Isso define a nova instalação do Ruby como o Ruby padrão em seu sistema, em vez do Ruby pré-instalado.

Para confirmar se a instalação foi bem-sucedida, execute o seguinte comando no Terminal:

ruby --version

Este comando imprime o número da versão do Ruby que você tem instalada. A saída será algo como:

ruby 2.6.0p0 (2018-12-25 revision 66547) [x86_64-darwin18]

Instalando Ruby em Ubuntu (Linux)

A maneira mais fácil de instalar o Ruby em Ubuntu é através do gerenciador de pacotes apt. Execute os seguintes comandos no Terminal para instalar a versão mais recente do Ruby. Ubuntu repositórios.

• sudo apt update – Isso atualiza o padrão Ubuntu repositórios.
• sudo apt install ruby-full – Este comando baixa e instala a versão mais recente do Ruby.

Para confirmar a instalação, execute ruby –versãoEste comando imprime a versão do Ruby que você tem instalada.

Instalando Rails em Ubuntu (Linux)

Siga os passos abaixo para instalar o Rails em sua máquina Linux.

Passo 1) Atualize seu gerenciador de gems executando o seguinte comando: atualização de gem –sistema no Terminal ou na linha de comando.

Passo 2) Execute trilhos de instalação de joias para instalar a versão mais recente do Rails em seu computador.

Passo 3) Instale a gem bundler para facilitar o gerenciamento das dependências de gems em sua aplicação Rails. Execute gem instalar empacotador.

Dois princípios dos trilhos

O Rails segue princípios básicos de design de software e incentiva você a usá-los também.

Os dois mais comuns são:

• Não se repita (DRY) – isso resulta em um código conciso, consistente e de fácil manutenção.
• Convenção sobre configuração – O Rails já vem pré-configurado com valores padrão adequados para a maioria dos usos comuns. Isso torna o desenvolvimento de aplicações mais rápido e reduz a quantidade de código que você precisa manter.

Rails – Estruturas de Arquivos de Projeto

Com o Rails instalado em seu sistema, crie um aplicativo Rails. As próximas seções apresentarão um exemplo em Ruby on Rails, criando um aplicativo de lista de tarefas. Execute o seguinte comando no seu Terminal para criar o aplicativo:

rails new todo_app

Este comando cria um diretório chamado aplicativo de tarefas no diretório atual com a estrutura de pastas básica de uma aplicação web Rails, conforme mostrado abaixo.

Aqui estão os principais diretórios gerados para o projeto:

app – Agrupa subdiretórios para a interface do usuário/layout (visualizações e auxiliares), o controlador (arquivos de controladores) e os modelos (lógica de negócios/aplicação).

aplicativo/controladores – Armazena arquivos de controlador usados ​​pelo Rails para lidar com solicitações do cliente.

aplicativo/recursos – Contém arquivos estáticos necessários para o front-end da aplicação, agrupados por tipo: JavaScript arquivos, imagens e folhas de estilo.

aplicativo/ajudantes – Contém funções auxiliares que mantêm o modelo, a visualização e a lógica do controlador do seu aplicativo focados, compactos e organizados.

aplicativo/modelos – Contém arquivos que modelam o banco de dados da sua aplicação. As classes de modelo facilitam muito o trabalho com o banco de dados.

aplicativo/visualizações – Contém os arquivos de modelo/layout com os quais o usuário do seu aplicativo interage. Os modelos combinam HTML com dados do banco de dados.

caixa – Contém scripts Rails que iniciam sua aplicação. Também pode incluir outros scripts que você usa para configurar e atualizar a aplicação.

configuração – contém arquivos de configuração como banco de dados.yml, ambiente.rb, rotas.rb, etc., que seu aplicativo precisa para funcionar.

db – Contém arquivos e scripts usados ​​para gerenciar o banco de dados do seu aplicativo.

lib – Contém módulos adicionais para sua aplicação.

log – contém arquivos de registro como server.log, desenvolvimento.log, teste.log e produção.log, usado para depurar ou monitorar seu aplicativo.

público – Contém arquivos estáticos e recursos compilados, como arquivos HTML, JavaArquivos de script, imagens e folhas de estilo.

teste – Contém arquivos de teste que você escreve para testar a funcionalidade do seu aplicativo.

tmp – Contém arquivos temporários, como arquivos de cache e arquivos PID.

fornecedor – Contém bibliotecas de terceiros.

GemfileName – especifica os requisitos básicos de gems para executar sua aplicação web. Você pode agrupar as gems em desenvolvimento, teste ou produção, e o Rails saberá quando incluir cada gem.

Gemfile.lock Ao contrário do Gemfile, que lista explicitamente as gems que você deseja em sua aplicação, o Gemfile.lock contém adicionalmente outras gems das quais as listadas no Gemfile dependem. Estas são instaladas automaticamente para satisfazer as dependências.

Leiame.md – Use este arquivo para compartilhar detalhes essenciais sobre seu aplicativo, como o que ele faz e como instalá-lo e executá-lo.

Arquivo Rake – Contém várias definições de tarefas Rake que ajudam a automatizar as tarefas administrativas diárias da sua aplicação.

config.ru – um arquivo de configuração do Rack que fornece uma interface para o servidor web para iniciar sua aplicação.

Mude o diretório para o aplicativo de tarefas diretório Rails gerado e executado servidor rails para iniciar o aplicativo. Tipo localhost: 3000 na barra de endereços do seu navegador. Você deverá ver a tela abaixo se tudo correr bem.

Esta é a página inicial padrão da sua aplicação. Você irá alterá-la em uma seção posterior deste tutorial de Ruby on Rails. Você pode parar o servidor pressionando Ctrl + C.

Rails – Gerar comandos

O comando `generate` do Rails usa modelos para criar muitos elementos úteis em sua aplicação. Esses geradores economizam muito tempo.

Eles escrevem o código padrão necessário para o funcionamento da sua aplicação web. Executar trilhos geram Digite `systemctl generate generators` no prompt de comando ou no Terminal para ver uma lista dos geradores disponíveis, como mostrado abaixo.

Você também pode correr trilhos geram Para ver uma descrição do que o comando faz, consulte a documentação. Ela lista opções úteis e um exemplo de uso. A figura abaixo mostra a saída da execução do comando. controlador de geração de trilhos.

Use o comando `rails generate scaffold` para criar automaticamente o modelo, a visualização e o controlador do aplicativo de lista de tarefas que você está desenvolvendo. Execute o seguinte no seu Terminal (certifique-se de ainda estar no terminal). aplicativo de tarefas diretório):

rails generate scaffold todo_list title:string description:text

Isso cria uma interface web completa de CRUD (Criar, Ler, Atualizar, Excluir) para a tabela TodoLists.

Outro comando útil para saber é trilhos destroemIsso reverte qualquer coisa trilhos geram faz.

Trilhos – Roteamento

O sistema de roteamento do Rails, chamado de roteador Rails, lida com todas as requisições recebidas pela sua aplicação web. Ele examina o URL de cada solicitação e a mapeia para a ação do controlador responsável por processá-la, usando a sintaxe especificada no arquivo de rotas (config / routes.rb).

O arquivo de rotas controla tudo URL aspecto da sua aplicação web. O Rails utiliza um design RESTful baseado no estilo arquitetural REST, que fornece um mapaping entre verbos HTTP e requisição URLs para ações do controlador.

O arquivo de rotas foi gerado quando você executou trilhos novos anteriormente. Continuando com o aplicativo Todo que você está criando, execute o seguinte:

rails db:migrate

Certifique-se de que você ainda está na raiz do aplicativo (o aplicativo de tarefas diretório).

Reinicie o servidor com servidor rails. Tipo http://localhost:3000/todo_lists/ Abra o navegador e pressione Enter. Você deverá ver uma página da web semelhante à mostrada abaixo.

Esta é a visualização da lista de tarefas gerada pelo comando scaffold e é controlada pelo controlador TodoListsController. índice ação.

Adicione uma lista de tarefas clicando em “Nova lista de tarefas” na página. Você deverá ver a tela abaixo.

Observe a URL é agora http://localhost:3000/todo_lists/newEsta é a página para criar uma nova lista de tarefas e é controlada pelo controlador `TodoListsController`. new método.

Insira o título e a descrição da sua lista de tarefas no formulário e clique em “Criar lista de tarefas”. URL deve mudar para http://localhost:3000/todo_lists/1, como mostrado abaixo.

Esta é a página de exibição de uma lista de tarefas, controlada pelo controlador TodoListsController. mostrar método. Se você voltar para http://localhost:3000/todo_lists/Você deverá ver agora a tela abaixo com a nova lista de tarefas adicionada.

O Rails conseguiu mapear cada requisição para a ação correspondente do TodoListsController usando a definição de rota em config / routes.rb.

Se você der uma olhada neste arquivo, verá uma única linha. recursos :listas_de_tarefa, que é a maneira padrão do Rails de escrever rotas RESTful. Esta única linha cria sete rotas, todas mapeandoping ao controlador TodoLists.

Por convenção, cada ação do controlador corresponde a uma operação CRUD (Criar, Ler, Atualizar, Excluir) específica no banco de dados.

Execute rotas ferroviárias na sua linha de comando para ver as várias rotas disponíveis em sua aplicação. A figura abaixo mostra a saída da execução do comando. rotas ferroviárias.

Trilhos – Vistas

A camada de visualização é um dos componentes do paradigma MVC e é responsável por gerar a resposta HTML para cada requisição à sua aplicação. O Rails utiliza ERB (Embedded Ruby) por padrão, que é um poderoso sistema de templates para Ruby.

O ERB facilita a criação e a manutenção de modelos, combinando texto simples com código Ruby para substituição de variáveis ​​e controle de fluxo. Um modelo ERB usa o .html.erb extensão.

Na maioria das vezes, você usará dois marcadores de tag, cada um dos quais faz com que o código incorporado seja processado e tratado de uma maneira específica.

Uma etiqueta com um sinal de igual <%= %> Indica que o código incorporado é uma expressão e que o resultado do código deve ser substituído na saída quando o modelo for renderizado.

A outra tag sem sinal de igual <% %> Indica ao renderizador que o resultado do código não deve ser substituído ou impresso na saída.

Cada controlador em sua aplicação Rails possui um subdiretório correspondente em aplicativo/visualizaçõesE cada ação em um controlador tem uma correspondente .html.erb arquivo nesse subdiretório.

Dê uma olhada aplicativo/visualizações do aplicativo Todo que você está criando. Você encontrará um subdiretório chamado listas_de_tarefas ou um caixão .html.erb arquivos com nomes correspondentes às ações no Listas de tarefas controlador.

Rails – ActiveRecord, padrão de registro ativo e ORM

ActiveRecord é a implementação em Ruby do padrão Active Record. Nesse padrão, uma classe representa uma tabela de banco de dados e uma instância dessa classe representa uma linha nessa tabela.

O ActiveRecord é comumente referido como um ORM (Mapeamento Objeto-Relacional).ping) camada, uma técnica que permite gerenciar seu banco de dados usando uma linguagem com a qual você se sinta mais confortável. É agnóstica ao banco de dados, então você pode alternar facilmente entre bancos de dados — por exemplo, SQLite, MySQL, PostgreSQL, SQL Server, ou Oracle — usando o mesmo código e lógica.

Por exemplo, para obter uma matriz contendo todas as listas de tarefas (Todo list) do seu aplicativo, você não precisa escrever um código que abra uma conexão, execute uma consulta SQL SELECT e converta o resultado.

Você só precisa digitar Lista de tarefas.tudoE o ActiveRecord retorna um array preenchido com objetos TodoList que você pode usar como quiser.

Tudo o que você precisa fazer é configurar o ambiente em config / database.ymlO ActiveRecord lida com as diferenças entre os sistemas de banco de dados. Ao migrar de um banco de dados para outro, você não precisa reescrever seu código.

Você se concentra na lógica da aplicação, e o ActiveRecord cuida dos detalhes de baixo nível da conexão com o seu banco de dados. Ele usa convenções de nomenclatura para mapear modelos para tabelas do banco de dados.

O Rails pluraliza os nomes das classes do seu modelo para encontrar a tabela correspondente no banco de dados. Portanto, para uma classe Lista de afazeresO ActiveRecord usa uma tabela de banco de dados chamada listas_de_tarefas.

Trilhos – Migrações

Uma migração do Rails é um script usado para evoluir o banco de dados da sua aplicação. Ela serve para configurar ou alterar o banco de dados sem precisar escrever SQL manualmente.

Ele usa Ruby para definir alterações no esquema do banco de dados e possibilita o uso de controle de versão para manter seu banco de dados sincronizado em diferentes ambientes.

As migrações do Rails usam uma Linguagem de Domínio Específico (DSL) em Ruby. Isso funciona como uma linguagem absoluta.trace possibilita usar ou alterar o mecanismo de banco de dados de acordo com suas necessidades.

As migrações podem ser compartilhadas com qualquer pessoa que trabalhe no aplicativo e também podem ser revertidas para desfazer as alterações. Este é um mecanismo de segurança robusto, portanto, você não precisa se preocupar em causar danos permanentes ao seu banco de dados.

Rails – Associações ActiveRecord

A conexão entre dois modelos ActiveRecord é conhecida como associação. As associações facilitam muito a realização de operações em registros relacionados no seu código. Existem quatro categorias comuns.

Um a um: Um registro contém precisamente uma instância de outro modelo. Um bom exemplo é um perfil de usuário — um usuário tem apenas um perfil. Ele usa o tem um palavra chave.

Um para muitos: A associação mais comum ocorre quando um modelo tem zero ou mais instâncias de outro modelo. Use o tem_muitos palavra-chave para denotar esta associação.

De muitos para muitos: Um pouco mais complicado. O ActiveRecord oferece duas maneiras de lidar com isso: tem_e_pertence_a_muitos e tem_muitos :através, que lhe dá acesso ao modelo de junção definido em uma tabela separada.

Polimorfismo Um para Muitos: Uma associação mais avançada no Rails. Ela define um modelo que pode pertencer a vários modelos diferentes em uma única associação.

Rails – Validações ActiveRecord

A validação ajuda a garantir que você tenha dados corretos, pois trabalhar com dados incorretos é arriscado e pode custar dinheiro à sua empresa.

A validação também fornece uma camada extra de segurança contra usuários mal-intencionados que tentam inserir dados prejudiciais em seu banco de dados. O Rails oferece uma API limpa de funções auxiliares de validação no ActiveRecord que mantêm seu banco de dados limpo, seguro e livre de erros.

As validações do ActiveRecord são executadas nos objetos do modelo antes de serem salvas no banco de dados, o que as torna mais confiáveis ​​e está de acordo com as melhores práticas.

Os seguintes métodos do ActiveRecord acionam validações quando chamados em objetos do modelo: crie, crie!, salve, salve!, atualize e atualize!As versões bang (Criar!, Salvar! e Atualizar!) gera uma exceção se o registro for inválido, enquanto as versões sem o ponto de exclamação retornam falso.

Os auxiliares de validação mais comuns do ActiveRecord são:

• Confirmação: Valida se dois campos têm o mesmo valor, por exemplo, senha e confirmação de senha. É usado em conjunto com o auxiliar de validação de presença.
• Presença: Verifica se o campo não está vazio.
• Singularidade: Garante um valor único para um campo, por exemplo, o nome de usuário.
• Comprimento: Impõe um limite ao comprimento de caracteres de um campo.

Você também pode criar sua própria validação personalizada usando o validar método e passando a ele o nome de um método de validação personalizado.

Verifique o modelo erros objeto para descobrir por que uma validação falhou. Isso fornece tudo o que você precisa para tornar seu aplicativo mais restritivo e seguro, permitindo apenas a entrada de dados válidos em seu banco de dados.

Trilhos – ActionController

O controlador Rails é o centro da sua aplicação web. Facilita e coordena a comunicação entre o usuário, os modelos e as visualizações.

Suas classes de controlador herdam de Controlador de aplicação, que contém código que pode ser executado em todos os outros controladores e que, por sua vez, herda de Controlador de ação::Base.

O controlador fornece o seguinte para sua aplicação:

• Ele encaminha solicitações externas para ações internas.
• Ele gerencia o cache, proporcionando melhorias de desempenho ao seu aplicativo.
• Ele gerencia métodos auxiliares que ampliam as funcionalidades dos modelos de visualização e também gerencia sessões de usuário, proporcionando uma experiência fluida aos usuários.

Trilhos – Configurações

Você pode configurar componentes como inicializadores, ativos, geradores e middlewares usando os inicializadores e arquivos de configuração do seu aplicativo Rails. configuração diretório. Arquivos como config/application.rb, config/environments/development.rb e config/environments/test.rb são utilizadas aqui. Você também pode adicionar configurações personalizadas para seu aplicativo.

Trilhos – Depuração

À medida que você desenvolve sua aplicação, precisará depurar seu código. O Rails facilita isso com o byebug gem. Você pode iniciar uma sessão de depuração inserindo a palavra-chave. byebug em qualquer lugar no código do seu aplicativo.

Isso interrompe temporariamente a execução nesse ponto. A gem byebug oferece vários comandos. Os mais úteis são:

• Next: passa para a próxima linha de código, pularping Todos os métodos invocados pela linha atual.
• degrau: semelhante ao Próximo, mas entra em cada método invocado.
• pausa: interrompe a execução do código.
• continuar: continua a execução do código.

Outras ferramentas de depuração estão disponíveis, como: alavancaTodas elas oferecem funcionalidades semelhantes com sintaxes ligeiramente diferentes. Gems de depuração não devem ser usadas em produção, pois representam riscos para sua aplicação e uma experiência ruim para seus usuários.

Os arquivos de log podem ser inspecionados em busca de erros em produção e tratados adequadamente. Você também deve seguir uma abordagem de Desenvolvimento Orientado a Testes (TDD) ao construir seu aplicativo para garantir que tudo funcione corretamente antes da implantação em produção.

Perguntas Frequentes