Що таке стійка?
Rack забезпечує мінімальний інтерфейс між веб-серверами, що підтримують рамки Ruby та Ruby.
За допомогою Rack можна написати програму Rack.
Rack передає хеш-середовище (Hash, що міститься в HTTP-запиті від клієнта, що складається з заголовків, схожих на CGI), до вашої програми Rack, яка може використовувати речі, що містяться в цьому хеші, робити все, що завгодно.
Що таке додаток Rack?
Щоб використовувати Rack, ви повинні надати "додаток" - об'єкт, який відповідає #callметоду за допомогою параметра Hash Environment як параметр (як правило, визначений як env). #callповинен повернути масив рівно трьох значень:
- код стану (наприклад , «200»),
- Хеш заголовків ,
- Response Body (який повинен відповісти методом на Ruby
each).
Ви можете написати програму Rack, яка повертає такий масив - це буде відправлено назад вашому клієнту, Rack, у відповідь (це фактично буде екземпляр класу Rack::Response[натисніть, щоб перейти до документів]).
Дуже просте застосування в стійці:
gem install rack- Створіть
config.ruфайл - Rack знає, що це шукати.
Ми будемо створювати крихітний Rack додаток , яке повертає відповідь (екземпляр Rack::Response) , який Відповідний Тіло являє собою масив , який містить рядок: "Hello, World!".
Ми запустимо локальний сервер за допомогою команди rackup.
Відвідавши відповідний порт у нашому браузері, ми побачимо "Привіт, світ!" винесені у вікно перегляду.
#./message_app.rb
class MessageApp
def call(env)
[200, {}, ['Hello, World!']]
end
end
#./config.ru
require_relative './message_app'
run MessageApp.new
Запустіть локальний сервер rackupі відвідайте localhost: 9292, і ви побачите "Привіт, світ!" винесено.
Це не є вичерпним поясненням, але по суті, що тут відбувається, це те, що Клієнт (браузер) надсилає запит HTTP до Rack через ваш локальний сервер, а Rack створює екземпляр MessageAppта запускcall , передаючи в середовищі Hash як параметр метод ( envаргумент).
Rack приймає повернене значення (масив) і використовує його для створення екземпляра Rack::Responseі повертає його назад Клієнту. Браузер використовує магію для друку "Привіт, світ!" на екран.
До речі, якщо ви хочете побачити, як виглядає хеш-середовище, просто покладіть puts env під нього def call(env).
Як мінімум, те, що ви тут написали, - це програма Rack!
Взаємодія програми Rack взаємодіє з хешем вхідного середовища
У нашому маленькому додатку Rack ми можемо взаємодіяти з envхешем ( детальніше про хеш навколишнього середовища див. Тут ).
Ми реалізуємо можливість користувача вводити свій власний рядок запиту в URL-адресу, отже, ця рядок буде присутній у запиті HTTP, інкапсульованому як значення в одній з пар ключів / значень хеш середовища.
Наш додаток Rack отримає доступ до цього рядка запиту з хеш-середовища оточення та відправить його назад клієнту (у нашому веб-переглядачі, в даному випадку) через орган у відповіді.
З Документів Rack на хеш-середовищі:
"QUERY_STRING: Частина URL-адреси запиту, яка відповідає?, Якщо така є. Може бути порожньою, але завжди обов'язковою!"
#./message_app.rb
class MessageApp
def call(env)
message = env['QUERY_STRING']
[200, {}, [message]]
end
end
Тепер, rackupі відвідайте localhost:9292?hello( ?helloце рядок запиту), і вам слід побачити "привіт", відображений у вікні перегляду.
Rack Middleware
Ми будемо:
- вставити шматок Rack Middleware в нашу кодову - клас:
MessageSetter,
- хеш - середа вдарить цей клас першим і буде прийнятий в якості параметра:
env,
MessageSetterвставить 'MESSAGE'ключ у хеш-код env, його значення буде, 'Hello, World!'якщо env['QUERY_STRING']воно порожнє; env['QUERY_STRING']якщо ні,- нарешті, він повернеться
@app.call(env)- @appбути наступним додатком в «Стек»: MessageApp.
По-перше, версія "довгої руки":
#./middleware/message_setter.rb
class MessageSetter
def initialize(app)
@app = app
end
def call(env)
if env['QUERY_STRING'].empty?
env['MESSAGE'] = 'Hello, World!'
else
env['MESSAGE'] = env['QUERY_STRING']
end
@app.call(env)
end
end
#./message_app.rb (same as before)
class MessageApp
def call(env)
message = env['QUERY_STRING']
[200, {}, [message]]
end
end
#config.ru
require_relative './message_app'
require_relative './middleware/message_setter'
app = Rack::Builder.new do
use MessageSetter
run MessageApp.new
end
run app
З документів Rack :: Builder ми це бачимоRack::Builder реалізує невеликий DSL для ітеративної побудови додатків Rack. Це в основному означає, що ви можете створити "стек", що складається з однієї або декількох середніх програм та додатка "нижнього рівня", на який потрібно відправляти. Усі запити, що надходять до вашої програми нижнього рівня, спочатку будуть оброблені вашими проміжними програмами.
#useвказує проміжне програмне забезпечення для використання в стеку. Посереднє програмне забезпечення приймає як аргумент.
Посереднє програмне забезпечення для стійки повинно:
- мати конструктор, який приймає наступний додаток у стеку як параметр.
- відповісти на
callметод, який приймає хеш середовища як параметр.
У нашому випадку "Middleware" - MessageSetterце "конструктор" - initializeметод MessageSetter , "наступним додатком" в стеці є MessageApp.
Так ось, через те, що Rack::Builderробиться під кришкою, appаргумент методу MessageSetter's initializeє MessageApp.
(обведіть голову навколо вище, перш ніж рухатися далі)
Отже, кожен фрагмент Middleware по суті "передає" існуючий хеш-середовище до наступної програми в ланцюзі - так що у вас є можливість вимкнути цей хеш-середовище в середовищі Middleware, перш ніж передати його наступному додатку в стеку.
#runбере аргумент, що є об'єктом, який відповідає #callі повертає Rack Response (екземпляр Rack::Response).
Висновки
Використовуючи Rack::Builderви можете побудувати ланцюжки Middlewares, і будь-який запит до вашої програми буде оброблятися кожним Middleware по черзі, перш ніж остаточно обробити остаточний фрагмент у стеку (у нашому випадку MessageApp). Це надзвичайно корисно, оскільки воно розділяє різні етапи обробки запитів. З точки зору "розділення проблем", це не може бути набагато чистішим!
Ви можете побудувати "трубопровід запитів", що складається з декількох середніх програм, які стосуються таких речей, як:
- Аутентифікація
- Авторизація
- Кешування
- Прикраса
- Моніторинг продуктивності та використання
- Виконання (фактично обробляти запит та надати відповідь)
(вище пунктів від іншої відповіді на цю тему)
Ви часто будете бачити це в професійних додатках Sinatra. Sinatra використовує Rack! Дивіться тут для визначення того , що Сінатра IS !
Як остаточне зауваження, наше config.ruможе бути написане стильним стилем, створюючи абсолютно таку ж функціональність (і саме це ви зазвичай бачите):
require_relative './message_app'
require_relative './middleware/message_setter'
use MessageSetter
run MessageApp.new
А щоб більш чітко показати, що MessageAppробиться, ось його "довга" версія, яка прямо показує, що #callстворює новий екземпляр Rack::Response, з необхідними трьома аргументами.
class MessageApp
def call(env)
Rack::Response.new([env['MESSAGE']], 200, {})
end
end
Корисні посилання
