Raf Nedir?
Rack, Ruby ve Ruby çerçevelerini destekleyen web sunucuları arasında minimum bir arayüz sağlar.
Rack kullanarak bir Rack Uygulaması yazabilirsiniz.
Rack, bir istemciden, CGI benzeri başlıklardan oluşan bir HTTP isteğinin içinde yer alan bir Hash) Rack Uygulamanıza bu karma işleminde bulunan şeyleri istediği gibi kullanabilen Aktarma uygulamanıza geçirir.
Raf Uygulaması Nedir?
Rack'i kullanmak için bir 'uygulama' sağlamalısınız - bu #callyöntem Ortam Karma ile parametreye parametre olarak yanıt veren bir nesne (genellikle olarak tanımlanır env). #calltam olarak üç değerden oluşan bir Dizi döndürmelidir:
- Durum Kodu (örneğin '200'),
- Bir başlıkların karma ,
- Tepki Vücut (Ruby yöntemine yanıt vermelidir
each).
Böyle bir dizi döndüren bir Rack Uygulaması yazabilirsiniz - bu, bir Yanıt içinde Rack tarafından istemcinize geri gönderilir (bu aslında bir Sınıf örneğidirRack::Response [belgelere gitmek için tıklayın]).
Çok Basit Bir Raf Uygulaması:
gem install rack- Bir
config.rudosya oluşturun - Rack bunu aramayı bilir.
Rack::ResponseYanıt Gövdesi String içeren bir dizi olan bir Yanıt (örneği ) döndüren küçük bir Rack Uygulaması oluşturacağız "Hello, World!".
Komutu kullanarak yerel bir sunucuyu tetikleyeceğiz rackup.
Tarayıcımızdaki ilgili bağlantı noktasını ziyaret ettiğinizde "Merhaba, Dünya!" görünümünde render.
#./message_app.rb
class MessageApp
def call(env)
[200, {}, ['Hello, World!']]
end
end
#./config.ru
require_relative './message_app'
run MessageApp.new
Yerel bir sunucuyu başlatın ve localhost'urackup ziyaret edin : 9292 ve 'Merhaba, Dünya!' render.
Bu kapsamlı bir açıklama değildir, ancak esasen burada olan şey, İstemcinin (tarayıcı) yerel sunucunuz aracılığıyla Rack'e bir HTTP İsteği göndermesidir ve Rack , Ortam Karma'yı yöntem olarak bir parametre olarak geçirerek başlatır MessageAppve çalışır call( envargüman).
Rack, dönüş değerini (dizi) alır ve bunu bir örneği oluşturmak için kullanır ve bunu Rack::Responseİstemciye geri gönderir. Tarayıcı kullanan sihirli yazdırmak için 'Merhaba, Dünya!' ekrana getirin.
Bu arada, ortamın nasıl göründüğünü görmek istiyorsanız, puts envaltına koyun def call(env).
En az olduğu gibi, burada yazdıklarınız bir Rack uygulamasıdır!
Bir Raf Uygulamasının Gelen Ortam karması ile etkileşime girmesi
Küçük Rack uygulamamızda, envkarma ile etkileşime girebiliriz ( Çevre karma hakkında daha fazla bilgi için buraya bakın ).
Kullanıcının URL'ye kendi sorgu dizesini girme yeteneğini uygulayacağız; bu nedenle, bu dizgi, Ortam karmasının anahtar / değer çiftlerinden birinde bir değer olarak kapsüllenen HTTP isteğinde bulunacaktır.
Rack uygulamamız bu sorgu dizesine Ortam karmasından erişir ve bunu Yanıttaki Gövde aracılığıyla istemciye (bu durumda tarayıcımız) gönderir.
Ortam Karması'ndaki Raf belgelerinden:
"QUERY_STRING: İstek URL'sinin? Varsa onu takip eden bölümü. Boş olabilir, ancak her zaman gereklidir!"
#./message_app.rb
class MessageApp
def call(env)
message = env['QUERY_STRING']
[200, {}, [message]]
end
end
Şimdi, rackupadresini ziyaret edin localhost:9292?hello( ?hellosorgu dizesi olmak üzere) ve görünüm penceresinde 'merhaba' ifadesini görmelisiniz.
Raf Orta Yazılımı
Yapacağız:
- Bizim kod temeli haline Raf Middleware'in bir parça eklemek - bir sınıf:
MessageSetter,
- Çevre karma öncelikle bu sınıf vuracak ve parametre olarak geçilecek:
env,
MessageSetterBir ekleyecektir 'MESSAGE'env karma içine anahtar, kendi değerini 'Hello, World!'ise env['QUERY_STRING']boş; env['QUERY_STRING']değilse,- Nihayet, bu dönecektir
@app.call(env)- @app: 'Yığın' sonraki uygulama olma MessageApp.
İlk olarak, 'uzun el' versiyonu:
#./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
Gönderen Rack :: Oluşturucu docs biz görüyoruz Rack::Builderuygular iteratif yapı Raf uygulamalara küçük DSL. Bu temel olarak, bir veya daha fazla Middlewares ve gönderilecek bir 'alt seviye' uygulamasından oluşan bir 'Stack' oluşturabileceğiniz anlamına gelir. Alt düzey uygulamanıza gönderilen tüm istekler ilk önce Ara Yazılım (lar) nız tarafından işlenir.
#usebir yığın içinde kullanılacak ara katman yazılımını belirtir. Ara katmanı argüman olarak alır.
Rack Middleware şunları yapmalıdır:
- yığındaki bir sonraki uygulamayı parametre olarak alan bir yapıcıya sahip olmak.
callOrtam karmasını parametre olarak alan yönteme yanıt verir .
Bizim durumumuzda, 'Middleware', MessageSetter'yapıcı' MessageSetter'ın initializeyöntemidir, yığındaki 'sonraki uygulama' dır MessageApp.
Ne çünkü Yani burada, Rack::Builderkaputun altında yapar appargümanı MessageSetterbireyin initializeyönteme olduğunu MessageApp.
(devam etmeden önce başınızı yukarı çevirin)
Bu nedenle, her bir Middleware parçası temel olarak mevcut Ortam karmasını zincirdeki bir sonraki uygulamaya 'aktarır' - böylece, ortamdaki karma değerini yığında bir sonraki uygulamaya geçirmeden önce değiştirme olanağına sahipsiniz.
#run#callbir Rack Response (yanıt Rack::Response) yanıtı (ve örneği ) döndüren bir nesne olan bir argüman alır .
Sonuçlar
Kullanarak Rack::BuilderMiddlewares zincirleri oluşturabilirsiniz ve uygulamanıza herhangi bir talep, her bir Middleware tarafından nihayetinde yığındaki son parça tarafından işlenmeden önce (bizim durumumuzda MessageApp) işlenecektir . Bu son derece kullanışlıdır, çünkü işleme isteklerinin farklı aşamalarını ayırır. 'Endişelerin ayrılması' açısından, daha temiz olamazdı!
Aşağıdakiler gibi şeylerle ilgilenen birkaç Middlewares'den oluşan bir 'istek boru hattı' oluşturabilirsiniz:
- Kimlik Doğrulama
- Yetki
- Önbelleğe almak
- Dekorasyon
- Performans ve Kullanım İzleme
- Yürütme (aslında isteği işleme ve yanıt verme)
(bu konudaki başka bir cevaptan madde işaretleri yukarıda)
Bunu profesyonel Sinatra uygulamalarında sık sık göreceksiniz. Sinatra Rack kullanıyor! Sinatra IS'nin tanımı için buraya bakın !
Son bir not olarak, config.rutam olarak aynı işlevselliği üreten kısa el tarzında yazılabilir (ve genellikle göreceğiniz şey budur):
require_relative './message_app'
require_relative './middleware/message_setter'
use MessageSetter
run MessageApp.new
Ve ne MessageAppyaptığını daha açık bir şekilde göstermek için #call, Rack::Responsegerekli üç argümanla yeni bir örnek oluşturduğunu açıkça gösteren 'uzun el' versiyonu .
class MessageApp
def call(env)
Rack::Response.new([env['MESSAGE']], 200, {})
end
end
Kullanışlı bağlantılar
