Попередні статті:
- Привіт, Sinatra!
- Привіт, DataMapper!
- Співаємо з Sinatra!
Прийшов час поговорити про
REST архітектуру додатку та її реалізацію на
Sinatra.
Особисто мені коштувало багато зусиль зрозуміти, що таке
REST. Тому прошу не чіплятися до того, наскільки я спрощую термінологію, щоб сфокусуватися на самій темі.
REST - це
Representational State Transfer, так звана "передача стану представлення". Фактично - це спосіб організації доступу до ресурсів. Відповідно до цієї архітектури використовується чотири типи
HTTP запитів -
GET,
POST,
PUT і
DELETE.
- GET - отримати ресурс тільки для читання
- POST - створити новий ресурс
- PUT - оновити існуючий ресурс
- DELETE - видалити ресурс
Нічого не нагадує? Якщо порівняти з
SQL-синтаксисом,
GET - це запит
SELECT,
POST - це
INSERT,
PUT -
UPDATE, і
DELETE - знову просто
DELETE.
Ресурси - це ті дані, з якими ми працюємо. Наприклад у нашому блозі стаття - це ресурс, коментарій - це теж ресурс. Ресурси можуть мати взаємозв'язки, та містити в собі інші ресурси. Для більшості ресурсів в нашому додатку будуть необхідні операції їх створення, отримання, оновлення та видалення.
Крім звичних
GET і
POST Sinatra розуміє методи
PUT і
DELETE. Нажаль ці методи не підтримуються броузерами, але
Sinatra вміє з ними працювати через прихований елемент форми з ім'ям
"_method" і значенням, рівним методу
HTTP:
put або
delete. Наприклад:
<form method="post" action "/destroy">
<input type="hidden" name="_method" value="delete">
<button type="submit">Destroy it</button>
</form>
Далі ми будемо вважати клас-контролер реалізацією інтерфейсу
REST.
Наш контролер буде реалізовувати наступні сім дій(методів).
Чотири цих:
- show: обробляє GET запит для відображення індивідуального ресурсу, який ідентифікується виразом params[:id]
- create: обробляє POST запит для створення нового екземпляру ресурсу
- update: обробляє PUT запит для оновлення існуючого ресурсу, ідентифікованого виразом params[:id], використовуючи дані зв'язані з запитом
- destroy: обробляє DELETE запит для видалення екземпляра ресурсу, ідентифікованого виразом params[:id]
І три цих:
- index: обробляє GET запит для відображення колекції ресурсів
- new: обробляє GET запит, який створює логічну структуру нового ресурсу і передає її клієнту. Цей ресурс не буде збережений на сервері. Можна вважати, що дія new створює порожню форму, яка передається клієнту для заповнення.
- edit: обробляє GET запит, який повертає вміст ресурсу, ідентифікованого виразом params[:id], в форму, пристосовану для редагування цього вмісту
Не важко помітити, що ці сім дій включають чотири базових операції для створення, читання, оновлення і видалення ресурсу -
CRUD (
create,
read,
update,
delete). Серед них також є дії для виводу переліку ресурсів та дві додаткові дії, які повертають клієнту новий та існуючий ресурси в форму, призначену для редагування.
Для
Sinatra назви цих дій не мають ніякого значення, і використовуються мною тільки для зручності, і є запозиченими з
Rails.
Для того щоб реалізувати
REST підхід у нашому додатку треба поступити інакше ніж у попередній статті. В першу чергу один і той же URL може в залежності залежати від типу HTTP запиту відповідати різним методам. Наприклад
URL
/posts/1
повинен викликати метод
show(для відображення статті №1), якщо був використаний запит
GET, але у випадку запиту
DELETE повинен викликати метод
destroy.
Все що нам залишилося зробити, це реалізувати цих сім методів у нашому контролері і оновити шаблони представлень.
Розробку нашого "Is It" веб-сайту розпочнемо з огляду структури додатку на Sinatra.
