Урок за Ruby on Rails

Rails е създаден от Дейвид Хайнемайер Хансон, известен като DHH. Той е един от най-влиятелните и популярни инструменти за изграждане на уеб приложения. Използва се от големи сайтове като Airbnb, GitHub и Shopify.

Защо Rails?

Преди да инсталирате инструментариума, е полезно да разберете защо Rails остава популярен избор за корабиping уеб приложения бързо.

• Rails е пакетиран като Ruby gem и можете да го използвате за изграждане на голямо разнообразие от приложения.
• Позволява ви да изграждате обикновени уеб приложения, сайтове за електронна търговия, системи за управление на съдържание и други.
• Rails е пълнофункционална рамка, която включва всичко необходимо за създаване на уеб приложение, управлявано от база данни, използвайки модела Model-View-Controller (MVC).
• Всички слоеве са проектирани да работят безпроблемно заедно, така че проектите в Rails обикновено се нуждаят от по-малко редове код от еквивалентни проекти в други рамки.

Как да изтеглите и инсталирате Ruby на Windows

Процесът на инсталиране зависи от вашата операционна система. Следващите раздели обхващат инсталирането на Ruby на Windows, Mac и Linux.

Стъпка 1) Изтеглете Rubyinstaller.
Най-лесният начин да инсталирате Ruby на вашия Windows компютърът е чрез Ruby Installer, достъпен на https://rubyinstaller.org/.

След като го изтеглите, стартирайте инсталатора.

Стъпка 2) Кликнете върху изтегления инсталатор.
Double- щракнете върху изтегления инсталационен файл, например rubyinstaller-2.4.1-2-x64.exe.

Стъпка 3) Приемете лиценза.
Изберете радио бутона „Приемам лиценза“ и щракнете върху бутона „Напред“. Трябва да видите екрана по-долу.

Стъпка 4) Отбележете първите две квадратчета.
Поставете отметка в първите две квадратчета, за да улесните изпълнението на Ruby скриптове.

Щракнете върху бутона „Инсталиране“, за да започнете инсталацията. Трябва да видите екрана по-долу, когато тя завърши.

Стъпка 5) Щракнете върху Готово.
Не премахвайте отметката от опцията, която инсталира MSYS2. Щракнете върху „Finish“, за да завършите инсталацията. Отваря се прозорец на командния ред, както е показано по-долу.

Стъпка 6) Инсталирайте MSYS2.
Тази стъпка инсталира MSYS2, платформа за изграждане, която разполага с мениджър на пакети за лесно инсталиране на пакети на Windows.

Натиснете Enter, за да инсталирате всички компоненти, тъй като те са необходими за безпроблемната среда за разработка на Ruby on Rails. Windows.

Инсталиране на Rails

Трябва да имате инсталиран Ruby от предишния раздел. След това инсталирайте Rails. Можете да инсталирате Rails, използвайки пакет от RailsInstaller, но пакетът често не доставя най-новата версия на всяка необходима зависимост.

Ако вече имате инсталирани най-новата версия на Ruby, базовите RubyGems и разширения, просто изпълнете следната команда в командния ред, за да инсталирате Rails на вашата система: gem install rails.

Вие също ще трябва да инсталирате Node.js ако все още го нямате, защото някои библиотеки, от които Rails зависи, изискват JavaИзпълнението на скрипта, за да работи правилно. Вземете Node на https://nodejs.org.

По-често срещан и предпочитан подход към Windows е да се използва Windows Подсистема за Linux. Тя предоставя GNU/Linux среда с инструменти за команден ред, помощни програми и често срещани приложения директно вътре. Windows.

Инсталиране на Ruby на Mac

Вашият Mac вече има предварително инсталиран Ruby. Предварително инсталираната версия обаче често е остаряла, така че трябва да инсталирате по-нова версия.

Най-лесният начин да направите това е да използвате мениджър на пакети, като например HomebrewМоже първо да се наложи да инсталирате Homebrew, като изпълните командата по-долу в терминала.

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

Това показва предупреждение и ви подканва да въведете паролата си. Въведете паролата си за Mac (символите не се показват, докато пишете) и натиснете Enter, когато сте готови. След това изпълнете тази Homebrew команда, за да инсталирате Ruby на вашия Mac.

brew install ruby

След това изпълнете тази команда:

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

Това задава новата инсталация на Ruby като Ruby по подразбиране на вашата система, вместо предварително инсталирания Ruby.

За да потвърдите, че инсталацията е била успешна, из��ълнете следното в терминала:

ruby --version

Това отпечатва номера на инсталираната от вас версия на Ruby. Изходът изглежда по следния начин:

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

Инсталиране на Ruby на Ubuntu (Linux)

Най-лесният начин за инсталиране на Ruby на Ubuntu е чрез мениджъра на пакети apt. Изпълнете следните команди в терминала, за да инсталирате най-новата версия на Ruby от Ubuntu хранилища.

• sudo apt актуализация – Това актуализира настройката по подразбиране Ubuntu хранилища.
• sudo apt инсталира ruby-full – Това изтегля и инсталира най-новата версия на Ruby.

За да потвърдите инсталацията, изпълнете ruby –версияТова отпечатва инсталираната от вас версия на Ruby.

Инсталиране на Rails на Ubuntu (Linux)

Следвайте стъпките по-долу, за да инсталирате Rails на вашата Linux машина.

Стъпка 1) Актуализирайте вашия gem manager, като изпълните актуализация на скъпоценни камъни – система в терминала или командния ред.

Стъпка 2) бягане релси за инсталиране на скъпоценни камъни за да инсталирате най-новата версия на Rails на вашия компютър.

Стъпка 3) Инсталирайте bundler gem-а за лесно управление на зависимостите на gem-а в Rails приложенията. Изпълнете. скъпоценни камъни.

Два принципа на релсите

Rails следва основните принципи на софтуерния дизайн и ви насърчава да ги използвате също.

Двете най-често срещани са:

• Не се повтаряй (DRY) – това води до сбит, последователен и лесен за поддръжка код.
• Конвенция над конфигурацията – Rails е предварително конфигуриран с разумни настройки по подразбиране, които отговарят на най-често срещаната употреба. Това прави разработването на приложения бързо и ви оставя с по-малко код за поддръжка.

Rails – файлови структури на проекта

След като Rails е инсталиран на вашата система, създайте Rails приложение. Следващите раздели ще ви разкрият пример на Ruby on Rails, като изградите приложение със списък със задачи. Изпълнете следната команда във вашия терминал, за да създадете приложението:

rails new todo_app

Тази команда създава директория с име приложение_за_тодо в текущата директория с основната структура на папките на уеб приложение на Rails, както е показано по-долу.

Ето основните директории, генерирани за проекта:

ап – групира поддиректории за потребителския интерфейс/оформлението (изгледи и помощни програми), контролера (файлове на контролери) и моделите (бизнес/приложна логика).

приложение/контролери – съхранява файлове на контролери, използвани от Rails за обработка на заявки от клиента.

приложение/активи – съдържа статични файлове, необходими на интерфейса на приложението, групирани по тип: JavaСценарий файлове, изображения и таблици със стилове.

приложение/помощници – съдържа помощни функции, които поддържат модела на приложението, изгледа и логиката на контролера фокусирани, малки и подредени.

приложение/модели – съдържа файлове, които моделират базата данни на вашето приложение. Класовете модели правят работата с базата данни много лесна.

приложение/изгледи – съдържа файловете с шаблони/оформления, с които потребителят на вашето приложение взаимодейства. Шаблоните комбинират HTML с данни от базата данни.

кофа за боклук – съдържа Rails скриптове, които стартират вашето приложение. Може да включва и други скриптове, които използвате за настройване и надграждане на приложението.

довереник – съдържа конфигурационни файлове, като например база данни.yml, среда.rb, маршрути.rbи др., от които се нуждае приложението ви, за да работи.

db – съдържа файлове и скриптове, използвани за управление на базата данни на вашето приложение.

ИЪ – съдържа разширени модули за вашето приложение.

влезете – съдържа лог файлове, като например server.log, development.log, test.log и production.log, използван за отстраняване на грешки или наблюдение на вашето приложение.

обществен – съдържа статични файлове и компилирани ресурси, като например HTML файлове, JavaСкриптови файлове, изображения и стилови таблици.

тест – съдържа тестови файлове, които пишете, за да тествате функционалността на приложението си.

TMP – съдържа временни файлове като кеш и pid файлове.

продавач – съдържа библиотеки на трети страни.

gemfile – определя основните изисквания за gem-ове, за да стартирате вашето уеб приложение. Можете да групирате gem-овете в разработка, тест или продукция, а Rails ще знае кога да включи всеки gem.

Gemfile.lock – за разлика от Gemfile, който изрично изброява желаните от вас скъпоценни камъни в приложението, Gemfile.lock допълнително съдържа други скъпоценни камъни, от които зависят изброените в Gemfile. Те се инсталират автоматично, за да задоволят зависимостите.

Readme.md – използвайте този файл, за да споделите важни подробности за вашето приложение, като например какво прави приложението и как да го инсталирате и стартирате.

Рейкфил – съдържа различни дефиниции на rake задачи, които помагат за автоматизиране на ежедневните задачи за администриране на вашето приложение.

config.ru – конфигурационен файл на Rack, който предоставя интерфейс към уеб сървъра за стартиране на вашето приложение.

Променете директорията в приложение_за_тодо директория Rails генерирани и стартирани релсов сървър за да стартирате приложението. Тип Localhost: 3000 в адресната лента на вашия уеб браузър. Ако всичко е минало добре, би трябвало да видите екрана по-долу.

Това е началната страница по подразбиране на вашето приложение. Ще я промените в по-късен раздел от това ръководство за Ruby on Rails. Можете да спрете сървъра, като натиснете Ctrl + C.

Rails – Генериране на команди

Командата за генериране на Rails използва шаблони, за да създава много полезни неща във вашето приложение. Тези генератори спестяват много време.

Те пишат шаблонен код, който е необходим за работата на вашето уеб приложение. Изпълнете. генерират релси самостоятелно в командния ред или терминала, за да видите списък с наличните генератори, както е показано по-долу.

Можете също да бягате генерират релси за да видите описание на това, което прави командата. Тя изброява удобни опции и пример за употре��а. Фигурата по-долу показва резултата от изпълнението релси генерират контролер.

Използвайте командата rails generate scaffold, за да създадете автоматично модела, изгледа и контролера за приложението със списък със задачи, което изграждате. Изпълнете следното в терминала си (уверете се, че все още сте в приложение_за_тодо директория):

rails generate scaffold todo_list title:string description:text

Това създава пълен CRUD (Създаване, Четене, Актуализиране, Изтриване) уеб интерфейс за таблицата TodoLists.

Друга полезна команда, която трябва да знаете, е релсите унищожаватОбръща каквото и да е генерират релси прави.

Релси – маршрутизиране

Системата за маршрутизиране Rails, наречена рутер Rails, обработва всички входящи заявки към вашето уеб приложение. Тя проверява URL на всяка заявка и я съпоставя с действието на контролера, отговорно за обработката ѝ, използвайки синтаксиса, посочен във файла с маршрути (config/routes.rb).

Файлът с маршрути контролира всеки URL аспект на вашето уеб приложение. Rails използва RESTful дизайн, базиран на архитектурния стил REST, който предоставя картаping между HTTP глаголите и заявката URLкъм действията на контролера.

Файлът с маршрути е генериран, когато стартирате релси нови по-рано. Продължавайки с приложението Todo, което създавате, изпълнете следното:

rails db:migrate

Уверете се, че все още сте в основата на приложението ( приложение_за_тодо указател).

Стартирайте сървъра отново с релсов сървър, Тип http://localhost:3000/todo_lists/ във вашия браузър и натиснете Enter. Трябва да получите уеб страница като показаната по-долу.

Това е изгледът на списъците със задачи, генериран от командата scaffold, и се контролира от TodoListsController. индекс действие.

Добавете списък със задачи, като кликнете върху „Нов списък със задачи“ на страницата. Трябва да видите екрана по-долу.

Обърнете внимание на URL сега http://localhost:3000/todo_lists/newТова е страницата за създаване на нов списък със задачи и се контролира от TodoListsController. на нови метод.

Въведете заглавието и описанието на вашия списък със задачи във формуляра и кликнете върху „Създаване на списък със задачи“. URL трябва да се промени на http://localhost:3000/todo_lists/1, както е показано по-долу.

Това е страницата за показване на списък със задачи, контролирана от TodoListsController. Покажи метод. Ако се върнете към http://localhost:3000/todo_lists/, сега би трябвало да видите екрана по-долу с добавения нов списък със задачи.

Rails успя да свърже всяка заявка със съответното действие TodoListsController, използвайки дефиницията на маршрута в config/routes.rb.

Ако погледнете този файл, ще видите един ред ресурси: списъци_със_задачи, което е начинът по подразбиране на Rails за писане на RESTful маршрути. Този един ред създава седем маршрута, всички от които са mapping към контролера TodoLists.

По конвенция, всяко действие на контролера се съпоставя със специфична CRUD (Създаване, Четене, Актуализиране, Изтриване) операция в базата данни.

бягане железопътни маршрути в командния ред, за да видите различните маршрути, налични във вашето приложение. Фигурата по-долу показва резултата от изпълнението на железопътни маршрути.

Релси – Изгледи

Слоят за преглед е един от компонентите на MVC парадигмата и е отговорен за генерирането на HTML отговор за всяка заявка към вашето приложение. Rails използва ERB (Embedded Ruby) по подразбиране, което е мощна система за шаблони за Ruby.

ERB прави шаблоните лесни за писане и поддръжка, като комбинира обикновен текст с Ruby код за заместване на променливи и контрол на потока. ERB шаблонът използва .html.erb удължаване.

Най-често ще използвате два маркера, всеки от които кара вградения код да бъде обработен и управляван по определен начин.

Етикет със знак за равенство <%= %> показва, че вграденият код е израз и резултатът от кода трябва да бъде заместен в изхода, когато шаблонът се рендира.

Другият таг без знак за равенство <% %> показва на рендера, че резултатът от кода не трябва да бъде заместван или отпечатван в изхода.

Всеки контролер във вашето Rails приложение има съответна поддиректория в приложение/изгледии всяко действие в контролера има съответстващ .html.erb файл в тази поддиректория.

Обърнете внимание на приложение/изгледи на приложението Todo, което създавате. Ще намерите поддиректория с име списъци_съ_до_до съдържащ .html.erb файлове с имена, съответстващи на действията в TodoLists контролер.

Rails – ActiveRecord, Active Record Pattern и ORM

ActiveRecord е Ruby имплементацията на шаблона Active Record. В този шаблон класът представлява таблица в базата данни, а екземпляр на класа представлява ред в тази таблица.

ActiveRecord обикновено се нарича ORM (Обектно-релационна карта)ping) слой, техника, която ви позволява да управлявате базата си данни, използвайки език, с който се чувствате най-комфортно. Той е независим от базата данни, така че можете лесно да превключвате между бази данни — например, SQLite, MySQL, PostgreSQL, SQL Server или Oracle — използвайки същия код и логика.

Например, за да получите масив, съдържащ всеки списък със задачи във вашето приложение, не е необходимо да пишете код, който отваря връзка, изпълнява SQL SELECT заявка и конвертира резултата.

Просто пишете TodoList.all, а ActiveRecord връща масива, запълнен с обекти на TodoList, които можете да използвате както желаете.

Всичко, което трябва да направите, е да настроите конфигурацията в config/database.yml, а ActiveRecord обработва разликите между системите за бази данни. Когато превключвате от една база данни към друга, не е нужно да пренаписвате кода си.

Вие се фокусирате върху логиката на приложението, а ActiveRecord се грижи за детайлите на ниското ниво на свързване с вашата база данни. Той използва конвенции за именуване, за да съпостави моделите с таблиците на базата данни.

Rails прави множествено число в имената на вашите класове на модели, за да намери съответната таблица в базата данни. Така че, за клас TodoList, ActiveRecord използва таблица в базата данни, наречена списъци_съ_до_до.

Релси – Миграции

Миграцията на Rails е скрипт, който използвате за развитие на базата данни на приложението си. Той се използва за настройване или промяна на базата данни без ръчно писане на SQL.

Той използва Ruby, за да дефинира промени в схемата на базата данни и прави възможно използването на контрол на версиите, за да поддържа базата данни синхронизирана в различни среди.

Миграциите на Rails използват Ruby Domain Specific Language (DSL). Това действа като ABS.tracи прави възможно използването или промяната на вашия двигател на базата данни въз основа на вашите изисквания.

Миграциите могат да бъдат споделяни с всеки, който работи по приложението, и могат да бъдат отменени, за да се отменят промените. Това е силен механизъм за безопасност, така че не е нужно да се притеснявате за евентуални трайни щети на базата данни.

Rails – ActiveRecord асоциации

Връзката между два ActiveRecord модела е известна като асоциация. Асоциациите улесняват значително извършването на операции върху свързани записи във вашия код. Има четири често срещани категории.

Едно към едно: Записът съдържа точно един екземпляр на друг модел. Добър пример е потребителски профил — потребителят има само един профил. Той използва има_едно ключова дума.

Едно към много: най-често срещаната асоциация — един модел има нула или повече екземпляри на друг модел. Използвайте има_много ключова дума за обозначаване на тази асоциация.

Много към много: малко по-сложно. ActiveRecord предлага два начина за справяне с това: има_и_принадлежи_на_много намлява има_много :чрез, което ви дава достъп до модела на съединение, дефиниран в отделна таблица.

Полиморфно от едно към много: по-напреднала асоциация в Rails. Тя дефинира модел, който може да принадлежи към много различни модели в рамките на една асоциация.

Rails – Валидации на ActiveRecord

Валидирането помага да се гарантира, че разполагате с правилни данни, защото работата с лоши данни е рискована и може да струва пари на вашия бизнес.

Валидирането също така осигурява допълнителен слой сигурност срещу злонамерени потребители, които се опитват да вмъкнат вредни данни във вашата база данни. Rails предлага изчистен API с помощници за валидиране в ActiveRecord, които поддържат вашата база данни чиста, сигурна и без грешки.

Валидациите на ActiveRecord се изпълняват върху обекти на модели, преди да се запазят в базата данни, което ги прави по-надеждни и следват най-добрите практики.

Следните методи на ActiveRecord задействат валидации, когато се извикват върху обекти на модела: създавайте, създавайте!, запазвайте, запазвайте!, актуализирайте и актуализирайте!Версиите с взрив (създавай!, запазвай! и актуализирай!) генерира изключение, ако записът е невалиден, докато версиите без bang връщат false.

Най-често срещаните помощни програми за валидиране на ActiveRecord са:

• Потвърждение: Проверява дали две полета имат еднаква стойност, например парола и потвърждение на парола. Използва се заедно с помощника за валидиране на присъствие.
• Присъствие: проверява дали полето не е празно.
• Уникалност: гарантира уникална стойност за дадено поле, например потребителско име.
• Дължина: налага ограничение върху дължината на символите в полето.

Можете също да създадете своя собствена персонализирана валидация, като използвате валидира метод и му предаване на името на персонализиран метод за валидиране.

Проверете модела грешки обект, за да разберете защо валидацията е неуспешна. Това ви дава всичко необходимо, за да направите приложението си по-ограничено и сигурно, като допускате само валидни данни във вашата база данни.

Rails – ActionController

Контролерът на Rails е центърът на вашето уеб приложение. Той улеснява и координира комуникацията между потребителя, моделите и изгледите.

Вашите класове контролери наследяват от ApplicationController, който съдържа код, който може да се изпълнява във всички останали контролери и който от своя страна наследява от ActionController::Base.

Контролерът предоставя следното на вашето приложение:

• Той пренасочва външни заявки към вътрешни действия.
• Той управлява кеширането, като по този начин повишава производителността на вашето приложение.
• Той управлява помощни методи, които разширяват възможностите на шаблоните за преглед, а също така управлява потребителските сесии, осигурявайки на потребителите безпроблемно изживяване.

Релси – Конфигурации

Можете да конфигурирате компоненти като инициализатори, ресурси, генератори и междинни софтуери, използвайки инициализаторите на вашите Rails приложения и конфигурационни файлове в довереник директория. Файлове като config/application.rb, config/environments/development.rb, и config/environments/test.rb се използват тук. Можете също да добавите персонализирани настройки за вашето приложение.

Rails – отстраняване на грешки

Докато изграждате приложението си, ще трябва да отстранявате грешки в кода си. Rails улеснява това с... чао бъг скъпоценен камък. Можете да започнете сесия за отстраняване на грешки, като поставите ключовата дума чао бъг навсякъде в кода на приложението ви.

Това временно спира изпълнението в този момент. Скъпият инструмент byebug предлага няколко команди. Най-полезните са:

• следващия: преминава към следващия ред код, пропускаping всички методи, извикани от текущия ред.
• стъпка: подобен на до, но влиза в действие във всеки извикан метод.
• почивка: спира изпълнението на кода.
• продължи: продължава изпълнението на кода.

Налични са и други инструменти за дебъгване, като например докосвамВсички те предлагат подобна функционалност с леко различен синтаксис. Дебъгващите скъпоценни камъни не трябва да се използват в производствена среда, тъй като те представляват рискове за вашето приложение и лошо потребителско изживяване.

Лог файловете могат да бъдат проверявани за грешки в производствения процес и обработвани съответно. Също така трябва да следвате подход за разработка, управлявана от тестове (TDD), когато изграждате приложението си, за да се уверите, че всичко работи добре, преди да го внедрите в производствения процес.

Въпроси и Отговори