Tutorial de Ruby on Rails

Rails fue creado por David Heinemeier Hansson, conocido popularmente como DHH. Es una de las herramientas más influyentes y populares para el desarrollo de aplicaciones web. La utilizan importantes plataformas como Airbnb, GitHub y Shopify.

¿Por qué rieles?

Antes de instalar la cadena de herramientas, es útil comprender por qué Rails sigue siendo una opción popular para el envíoping aplicaciones web rápidamente.

• Rails se distribuye como una gema de Ruby y se puede utilizar para crear una amplia variedad de aplicaciones.
• Te permite crear aplicaciones web convencionales, sitios de comercio electrónico, sistemas de gestión de contenido y mucho más.
• Rails es un framework completo que incluye todo lo necesario para crear una aplicación web basada en bases de datos utilizando el patrón Modelo-Vista-Controlador (MVC).
• Todas las capas están diseñadas para funcionar juntas a la perfección, por lo que los proyectos de Rails suelen necesitar menos líneas de código que los proyectos equivalentes en otros frameworks.

Cómo descargar e instalar Ruby en Windows

El proceso de instalación depende de su sistema operativo. Las siguientes secciones cubren la instalación de Ruby en Windows, Mac y Linux.

Paso 1) Descarga Rubyinstaller.
La forma más sencilla de instalar Ruby en tu Windows El ordenador se instala mediante Ruby Installer, disponible en https://rubyinstaller.org/.

Una vez descargado, ejecute el instalador.

Paso 2) Haz clic en el instalador descargado.
Double-haga clic en el archivo de instalación descargado, por ejemplo rubyinstaller-2.4.1-2-x64.exe.

Paso 3) Acepte la licencia.
Seleccione la opción "Acepto la licencia" y haga clic en el botón "Siguiente". Debería ver la pantalla que se muestra a continuación.

Paso 4) Marque las dos primeras casillas.
Marque las dos primeras casillas de verificación para facilitar la ejecución de scripts Ruby.

Haz clic en el botón "Instalar" para iniciar la instalación. Deberías ver la pantalla que aparece a continuación cuando finalice.

Paso 5) Haga clic en Finalizar.
No desmarque la opción que instala MSYS2. Haga clic en «Finalizar» para completar la instalación. Se abrirá una ventana del símbolo del sistema como se muestra a continuación.

Paso 6) Instalar MSYS2.
Este paso instala MSYS2, una plataforma de compilación que cuenta con un administrador de paquetes para una fácil instalación de paquetes en Windows.

Presione Enter para instalar todos los componentes, ya que todos son necesarios para un entorno de desarrollo Ruby on Rails fluido. Windows.

Instalación de rieles

Debes tener Ruby instalado desde la sección anterior. A continuación, instala Rails. Puedes instalar Rails usando un paquete de Instalador de rielespero el paquete a menudo no incluye la última versión de todas las dependencias necesarias.

Si ya tienes instalada la última versión de Ruby y las extensiones y gemas RubyGems básicas, simplemente ejecuta el siguiente comando en la línea de comandos para instalar Rails en tu sistema: gem install rails.

También necesitarás instalar Node.js si aún no lo tienes, porque algunas bibliotecas de las que depende Rails requieren un JavaEl entorno de ejecución del script debe funcionar correctamente. Obtenga Node en https://nodejs.org.

Un enfoque más común y preferido sobre Windows es usar el Windows Subsistema para Linux. Proporciona un entorno GNU/Linux con herramientas de línea de comandos, utilidades y aplicaciones comunes directamente dentro de Windows.

Instalación de Ruby en Mac

Tu Mac ya tiene Ruby preinstalado. Sin embargo, la versión preinstalada suele estar desactualizada, por lo que deberías instalar una versión más reciente.

La forma más sencilla de hacerlo es utilizar un gestor de paquetes como HomebrewEs posible que primero necesites instalar Homebrew ejecutando el siguiente comando en la Terminal.

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

Aparecerá una advertencia y se te pedirá que introduzcas tu contraseña. Introduce la contraseña de tu Mac (los caracteres no se mostrarán mientras escribes) y pulsa Intro cuando termines. A continuación, ejecuta este comando de Homebrew para instalar Ruby en tu Mac.

brew install ruby

Luego ejecuta este comando:

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

Esto configura la nueva instalación de Ruby como la versión predeterminada de Ruby en su sistema, en lugar de la versión preinstalada.

Para confirmar que la instalación se realizó correctamente, ejecute lo siguiente en la terminal:

ruby --version

Esto imprime el número de versión de Ruby que tienes instalada. La salida se ve algo así:

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

Instalando Ruby en Ubuntu (Linux)

La forma más sencilla de instalar Ruby en Ubuntu es a través del gestor de paquetes apt. Ejecute los siguientes comandos en la Terminal para instalar la última versión de Ruby desde el Ubuntu repositorios.

• sudo apt update – Esto actualiza la configuración predeterminada Ubuntu repositorios.
• sudo apt install ruby-full – Esto descarga e instala la última versión de Ruby.

Para confirmar la instalación, ejecute ruby –versiónEsto muestra la versión de Ruby que tienes instalada.

Instalación de rieles en Ubuntu (Linux)

Sigue los pasos que se indican a continuación para instalar Rails en tu máquina Linux.

Paso 1) Actualiza tu gestor de gemas ejecutando gem update –system en la terminal o en el símbolo del sistema.

Paso 2) Ejecutar gema instalar rieles para instalar la última versión de Rails en su computadora.

Paso 3) Instala la gema bundler para una gestión sencilla de las dependencias de gemas de la aplicación Rails. Ejecuta gem install bundler.

Dos principios de los rieles

Rails sigue los principios básicos del diseño de software y te anima a que tú también los uses.

Los dos más comunes son:

• No se repita (SECO) Esto da como resultado un código conciso, coherente y fácil de mantener.
• Convención sobre configuración Rails viene preconfigurado con valores predeterminados sensatos que se adaptan a la mayoría de los usos comunes. Esto agiliza el desarrollo de aplicaciones y reduce la cantidad de código que hay que mantener.

Rails – Estructuras de archivos de proyecto

Con Rails instalado en tu sistema, crea una aplicación Rails. Las siguientes secciones muestran un ejemplo con Ruby on Rails mediante la creación de una aplicación de lista de tareas. Ejecuta el siguiente comando en tu terminal para crear la aplicación:

rails new todo_app

Este comando crea un directorio llamado aplicación de tareas en el directorio actual con la estructura de carpetas básica de una aplicación web Rails, como se muestra a continuación.

Estos son los directorios principales generados para el proyecto:

applicación – Agrupa subdirectorios para la interfaz de usuario/diseño (vistas y funciones auxiliares), el controlador (archivos de controladores) y los modelos (lógica de negocio/aplicación).

aplicación / controladores – Almacena los archivos del controlador que utiliza Rails para gestionar las solicitudes del cliente.

aplicación / activos – Contiene archivos estáticos necesarios para la interfaz de usuario de la aplicación, agrupados por tipo: JavaScript archivos, imágenes y hojas de estilo.

aplicación / ayudantes – Contiene funciones auxiliares que mantienen el modelo de la aplicación, la vista y la lógica del controlador centrados, concisos y ordenados.

aplicación/modelos – Contiene archivos que modelan la base de datos de su aplicación. Las clases del modelo facilitan enormemente el trabajo con la base de datos.

aplicación / vistas – Contiene los archivos de plantilla/diseño con los que interactúa el usuario de su aplicación. Las plantillas combinan HTML con datos de la base de datos.

papelera – Contiene los scripts de Rails que inician tu aplicación. También puede incluir otros scripts que uses para configurar y actualizar la aplicación.

config – contiene archivos de configuración como base de datos.yml, entorno.rb, rutas.rb, etc., que su aplicación necesita para funcionar.

db – Contiene archivos y scripts utilizados para administrar la base de datos de su aplicación.

lib – Contiene módulos extendidos para su aplicación.

log – contiene archivos de registro como servidor.log, desarrollo.log, prueba.log y producción.log, utilizado para depurar o supervisar su aplicación.

público – contiene archivos estáticos y recursos compilados, como archivos HTML, JavaArchivos de script, imágenes y hojas de estilo.

compruébalo – Contiene los archivos de prueba que usted escribe para probar la funcionalidad de su aplicación.

tmp – contiene archivos temporales como archivos de caché y archivos PID.

vendedor – Contiene bibliotecas de terceros.

Archivo de gemas – especifica los requisitos básicos de gemas para ejecutar tu aplicación web. Puedes agrupar las gemas en desarrollo, prueba o producción, y Rails sabrá cuándo incluir cada una.

Gemfile.lock A diferencia del Gemfile, que enumera explícitamente las gemas que deseas en tu aplicación, el Gemfile.lock contiene además otras gemas de las que dependen las que aparecen en el Gemfile. Estas se instalan automáticamente para satisfacer las dependencias.

Léame.md – Utilice este archivo para compartir detalles esenciales sobre su aplicación, como qué hace la aplicación y cómo instalarla y ejecutarla.

archivo de rake – Contiene varias definiciones de tareas de Rake que ayudan a automatizar las tareas de administración diarias de su aplicación.

config.ru – Un archivo de configuración de Rack que proporciona una interfaz al servidor web para iniciar su aplicación.

Cambiar de directorio al aplicación de tareas directorio Rails generado y ejecutado servidor de rieles para iniciar la aplicación. Tipo localhost: 3000 En la barra de direcciones de tu navegador web. Si todo salió bien, deberías ver la pantalla que aparece a continuación.

Esta es la página de inicio predeterminada de su aplicación. La cambiará en una sección posterior de este tutorial de Ruby on Rails. Puede detener el servidor presionando Ctrl + C.

Rails – Generar comandos

El comando `generate` de Rails utiliza plantillas para crear muchos elementos útiles en tu aplicación. Estos generadores ahorran mucho tiempo.

Escriben código repetitivo necesario para que tu aplicación web funcione. Ejecutar generar rieles Ejecútelo por sí mismo en el símbolo del sistema o en la terminal para ver una lista de los generadores disponibles, como se muestra a continuación.

También puedes correr generar rieles Para ver una descripción de lo que hace el comando. Enumera opciones útiles y un ejemplo de uso. La siguiente figura muestra la salida de la ejecución Rails genera un controlador.

Utilice el comando rails generate scaffold para crear automáticamente el modelo, la vista y el controlador para la aplicación de lista de tareas pendientes que está creando. Ejecute lo siguiente en su terminal (asegúrese de que todavía esté en el aplicación de tareas directorio):

rails generate scaffold todo_list title:string description:text

Esto crea una interfaz web CRUD (Crear, Leer, Actualizar, Eliminar) completa para la tabla TodoLists.

Otro comando útil para saber es rieles destruir. Revierte lo que sea generar rieles hace.

Rieles – Enrutamiento

El sistema de enrutamiento de Rails, llamado Rails Router, maneja todas las solicitudes entrantes a su aplicación web. Examina el URL de cada solicitud y la asigna a la acción del controlador responsable de manejarla, utilizando la sintaxis especificada en el archivo de rutas (config / routes.rb).

El archivo de rutas controla cada URL aspecto de su aplicación web. Rails utiliza un diseño RESTful basado en el estilo arquitectónico REST, que proporciona un mapa.ping entre verbos HTTP y solicitud URLs a las acciones del controlador.

El archivo de rutas se generó cuando ejecutó nuevos raíles Anteriormente. Continuando con la aplicación de tareas pendientes que está creando, ejecute lo siguiente:

rails db:migrate

Asegúrese de que todavía se encuentra en la raíz de la aplicación (la aplicación de tareas directorio).

Reinicie el servidor con servidor de rieles. Tipo http://localhost:3000/todo_lists/ En tu navegador, pulsa Enter. Deberías ver una página web como la que aparece a continuación.

Esta es la vista de listas de tareas pendientes que generó el comando scaffold, y está controlada por el controlador TodoListsController. índice acción.

Agrega una lista de tareas pendientes haciendo clic en "Nueva lista de tareas pendientes" en la página. Deberías ver la pantalla que se muestra a continuación.

Note la URL es ahora http://localhost:3000/todo_lists/newEsta es la página para crear una nueva lista de tareas pendientes, y está controlada por el controlador TodoListsController. ¡nuevos Socios! de método.

Introduce el título y la descripción de tu lista de tareas en el formulario y haz clic en “Crear lista de tareas”. URL debería cambiar a http://localhost:3000/todo_lists/1, Como se muestra abajo.

Esta es la página de visualización de una lista de tareas pendientes, controlada por el controlador TodoListsController. show método. Si vuelves a http://localhost:3000/todo_lists/Ahora debería ver la pantalla a continuación con la nueva lista de tareas pendientes añadida.

Rails pudo asignar cada solicitud a la acción correspondiente de TodoListsController utilizando la definición de ruta en config / routes.rb.

Si echas un vistazo a este archivo, verás una sola línea. recursos :listas_de_todos, que es la forma predeterminada de Rails de escribir rutas RESTful. Esta única línea crea siete rutas, todas mapping al controlador TodoLists.

Por convención, cada acción del controlador se corresponde con una operación CRUD (Crear, Leer, Actualizar, Eliminar) específica en la base de datos.

Ejecutar rutas ferroviarias en su línea de comandos para ver las distintas rutas disponibles en su aplicación. La siguiente figura muestra el resultado de la ejecución rutas ferroviarias.

Rails – Vistas

La capa de vista es uno de los componentes del paradigma MVC y se encarga de generar la respuesta HTML para cada solicitud a tu aplicación. Rails utiliza ERB (Embedded Ruby) por defecto, que es un potente sistema de plantillas para Ruby.

ERB hace que las plantillas sean fáciles de escribir y mantener al combinar texto plano con código Ruby para la sustitución de variables y el control de flujo. Una plantilla ERB utiliza el .html.erb extensión.

Generalmente, utilizarás dos marcadores de etiquetas, cada uno de los cuales hace que el código incrustado se procese y gestione de una manera particular.

Una etiqueta con un signo de igual <%= %> indica que el código incrustado es una expresión, y el resultado del código debe sustituirse en la salida cuando se renderiza la plantilla.

La otra etiqueta sin signo igual <% %> indica al motor de renderizado que el resultado del código no debe sustituirse ni imprimirse en la salida.

Cada controlador en su aplicación Rails tiene un subdirectorio correspondiente en aplicación / vistasy cada acción en un controlador tiene una acción correspondiente .html.erb archivo en ese subdirectorio.

Eche un vistazo a aplicación / vistas de la aplicación Todo que estás creando. Encontrarás un subdirectorio llamado listas_de_tareas que contiene .html.erb archivos con nombres que corresponden a las acciones en el TodoListas controlador.

Rails: ActiveRecord, patrón de registro activo y ORM

ActiveRecord es la implementación en Ruby del patrón Active Record. En este patrón, una clase representa una tabla de base de datos, y una instancia de la clase representa una fila en esa tabla.

ActiveRecord se conoce comúnmente como un ORM (Mapeo Objeto-Relacional).ping) capa, una técnica que le permite administrar su base de datos utilizando un lenguaje con el que se sienta más cómodo. Es independiente de la base de datos, por lo que puede cambiar fácilmente entre bases de datos, por ejemplo, SQLite, MySQL, PostgreSQL, SQL Server o Oracle — utilizando el mismo código y lógica.

Por ejemplo, para obtener una matriz que contenga todas las listas de tareas pendientes de su aplicación, no es necesario escribir código que abra una conexión, ejecute una consulta SQL SELECT y convierta el resultado.

Solo tienes que escribir Lista de tareas.todoy ActiveRecord devuelve el array lleno de objetos TodoList que puedes usar como quieras.

Todo lo que necesitas hacer es configurar la configuración en config / database.ymlActiveRecord gestiona las diferencias entre los sistemas de bases de datos. Al cambiar de una base de datos a otra, no es necesario reescribir el código.

Tú te centras en la lógica de la aplicación, y ActiveRecord se encarga de los detalles de bajo nivel para conectarse a la base de datos. Utiliza convenciones de nomenclatura para asignar los modelos a las tablas de la base de datos.

Rails pluraliza los nombres de las clases de tu modelo para encontrar la tabla de la base de datos correspondiente. Por lo tanto, para una clase Lista de quehaceres, ActiveRecord utiliza una tabla de base de datos llamada listas_de_tareas.

Rieles – Migraciones

Una migración de Rails es un script que se utiliza para modificar la base de datos de una aplicación. Se usa para configurar o cambiar la base de datos sin escribir código SQL manualmente.

Utiliza Ruby para definir los cambios en el esquema de la base de datos y permite usar el control de versiones para mantener la base de datos sincronizada en diferentes entornos.

Las migraciones de Rails utilizan un lenguaje específico de dominio (DSL) de Ruby. Esto actúa como un abstracy permite utilizar o cambiar el motor de la base de datos según sus necesidades.

Las migraciones se pueden compartir con cualquier persona que trabaje en la aplicación y también se pueden revertir para deshacer los cambios. Este es un mecanismo de seguridad robusto, por lo que no tiene que preocuparse por dañar permanentemente su base de datos.

Rails – Asociaciones ActiveRecord

Una conexión entre dos modelos ActiveRecord se conoce como asociación. Las asociaciones facilitan enormemente la realización de operaciones en registros relacionados en el código. Existen cuatro categorías comunes.

Cara a cara: Un registro contiene precisamente una instancia de otro modelo. Un buen ejemplo es un perfil de usuario: un usuario tiene solo un perfil. Utiliza el tiene_uno palabra clave.

Uno a muchos: La asociación más común: un modelo tiene cero o más instancias de otro modelo. Utilice el tiene_muchos palabra clave para indicar esta asociación.

Muchos a muchos: Un poco más complicado. ActiveRecord ofrece dos maneras de manejarlo: tiene_y_pertenece_a_muchos y tiene_muchos :a través, lo que te da acceso al modelo de unión definido en una tabla separada.

Polimórfico de uno a muchos: Una asociación más avanzada en Rails. Define un modelo que puede pertenecer a muchos modelos diferentes en una sola asociación.

Rails – Validaciones de ActiveRecord

La validación ayuda a garantizar que disponga de datos correctos, ya que trabajar con datos erróneos es arriesgado y puede costarle dinero a su empresa.

La validación también proporciona una capa adicional de seguridad contra usuarios malintencionados que intentan insertar datos dañinos en la base de datos. Rails ofrece una API limpia con funciones de validación en ActiveRecord que mantienen la base de datos limpia, segura y libre de errores.

Las validaciones de ActiveRecord se ejecutan en los objetos del modelo antes de guardarlos en la base de datos, lo que las hace más fiables y sigue las mejores prácticas.

Los siguientes métodos de ActiveRecord activan validaciones cuando se llaman en objetos del modelo: ¡crea, crea!, ¡guarda, guarda!, actualiza y actualiza!. Las versiones de bang (¡Crea!, ¡Guarda!, ¡Actualiza!) generan una excepción si el registro no es válido, mientras que las versiones sin signo de exclamación devuelven falso en su lugar.

Los ayudantes de validación de ActiveRecord más comunes son:

• confirmación: Valida que dos campos tengan el mismo valor, por ejemplo, contraseña y confirmación de contraseña. Se utiliza junto con la función auxiliar de validación de presencia.
• Presencia: Comprueba que el campo no esté vacío.
• Unicidad: Garantiza un valor único para un campo, por ejemplo, el nombre de usuario.
• Eslora: impone un límite a la longitud de caracteres de un campo.

También puede crear su propia validación personalizada utilizando el validar método y pasándole el nombre de un método de validación personalizado.

Comprueba el modelo errores Este objeto permite averiguar por qué falló una validación. Esto proporciona todo lo necesario para que su aplicación sea más segura y con mayores restricciones, permitiendo únicamente el acceso a datos válidos en su base de datos.

Rieles – Controlador de acción

El controlador Rails es el centro de su aplicación web. Facilita y coordina la comunicación entre el usuario, los modelos y las vistas.

Sus clases de controlador heredan de Controlador de aplicaciones, que contiene código que puede ejecutarse en todos los demás controladores, y que a su vez hereda de ActionController::Base.

El controlador proporciona lo siguiente a su aplicación:

• Redirige las solicitudes externas a las acciones internas.
• Gestiona el almacenamiento en caché, lo que mejora el rendimiento de tu aplicación.
• Gestiona métodos auxiliares que amplían las capacidades de las plantillas de vista y también gestiona las sesiones de usuario, lo que proporciona a los usuarios una experiencia fluida.

Rieles – Configuraciones

Puedes configurar componentes como inicializadores, recursos, generadores y middlewares utilizando los archivos de inicialización y configuración de tu aplicación Rails en el config directorio. Archivos como config/application.rb, config/environments/development.rb, el config/environments/test.rb se utilizan aquí. También puede agregar configuraciones personalizadas para su aplicación.

Rieles – Depuración

A medida que desarrolles tu aplicación, necesitarás depurar tu código. Rails facilita esto con el adiós bicho gema. Puedes iniciar una sesión de depuración colocando la palabra clave adiós bicho en cualquier parte del código de su aplicación.

Esto detiene temporalmente la ejecución en ese punto. La gema byebug ofrece varios comandos. Los más útiles son:

• siguiente: pasa a la siguiente línea de código, saltaping todos los métodos invocados por la línea actual.
• paso: similar a Nextpero entra en cada método invocado.
• rotura: Detiene la ejecución del código.
• continuar: Continúa la ejecución del código.

Hay otras gemas de depuración disponibles, como palancaTodas ofrecen funcionalidades similares con sintaxis ligeramente diferente. No se recomienda usar gemas de depuración en producción, ya que suponen riesgos para la aplicación y una mala experiencia para los usuarios.

Los archivos de registro se pueden inspeccionar en busca de errores en producción y gestionarlos según corresponda. También se recomienda seguir un enfoque de Desarrollo Guiado por Pruebas (TDD) al crear la aplicación para garantizar que todo funcione correctamente antes de implementarla en producción.

Preguntas Frecuentes