Come utilizzare l'applicazione Rack in Ruby

Nel articolo precedente, hai imparato cos'è Rack. Ora è il momento di iniziare a utilizzare Rack e pubblicare alcune pagine.

Innanzitutto, iniziamo con un "Ciao mondo" applicazione. Questa applicazione, indipendentemente dal tipo di richiesta che viene fornita, restituirà con un codice di stato 200 (che è HTTP-speak per "OK") e la stringa "Ciao mondo" come il corpo.

Prima di esaminare il seguente codice, considerare nuovamente i requisiti che qualsiasi applicazione Rack deve soddisfare.

Un'applicazione Rack è qualsiasi oggetto Ruby che risponde al metodo call, accetta un singolo parametro hash e restituisce un array contenente il codice di stato della risposta, le intestazioni di risposta HTTP e il corpo della risposta come un array di stringhe.

classe HelloWorld
def call (env)
return [200, {}, ["Ciao mondo!"]]
fine
fine

Come puoi vedere, un oggetto del tipo Ciao mondo soddisferà tutti questi requisiti. Lo fa in un modo molto minimale e non estremamente utile, ma soddisfa tutti i requisiti.

È abbastanza semplice, ora collegiamolo a WEBrick (il server HTTP fornito Rubino). Per fare questo, usiamo il Rack:: Gestore:: WEBrick.run metodo, passagli un'istanza di Ciao mondo e la porta su cui eseguire. Un server WEBrick sarà ora in esecuzione e Rack invierà richieste tra il server HTTP e l'applicazione.

Nota, questo non è un modo ideale per avviare le cose con Rack. Viene mostrato qui solo per far funzionare qualcosa prima di immergersi in un'altra funzionalità di Rack chiamata "Rackup", che viene mostrata di seguito. L'uso di Rack:: Handler in questo modo presenta alcuni problemi. Innanzitutto, non è molto configurabile. Tutto è codificato nello script. In secondo luogo, come noterai se esegui il seguente script, non puoi uccidere il programma. Non risponderà a Ctrl-C. Se si esegue questo comando, è sufficiente chiudere la finestra del terminale e aprirne una nuova.

#! / usr / bin / env ruby
richiede 'rack'
classe HelloWorld
def call (env)
return [200, {}, ["Ciao mondo!"]]
fine
fine
Rack:: Gestore:: WEBrick.run (
HelloWorld.new,
: Porta => 9000
)

Mentre questo è abbastanza facile da fare, non è il modo in cui Rack viene normalmente utilizzato. Il rack viene normalmente utilizzato con uno strumento chiamato accumulare. Rackup fa più o meno ciò che era nella sezione inferiore del codice sopra, ma in un modo più utilizzabile. Il rackup viene eseguito dalla riga di comando e viene assegnato a .ru "File Rackup." Questo è solo uno script di Ruby che, tra le altre cose, invia un'applicazione a Rackup.

Un file Rackup di base per quanto sopra sarebbe simile a questo.

classe HelloWorld
def call (env)
ritorno [
200,
{'Content-Type' => 'text / html'},
["Ciao mondo!"]
]
fine
fine
eseguire HelloWorld.new

Innanzitutto, abbiamo dovuto apportare una piccola modifica a Ciao mondo classe. Rackup esegue un'app middleware chiamata Rack:: Lint che la sanità mentale controlla le risposte. Tutte le risposte HTTP dovrebbero avere a Tipo di contenuto intestazione, quindi è stato aggiunto. Quindi, l'ultima riga crea solo un'istanza dell'app e la passa a correre metodo. Idealmente, l'applicazione non dovrebbe essere scritta interamente all'interno del file Rackup, questo file dovrebbe richiedere l'applicazione e crearne un'istanza in quel modo. Il file Rackup è solo "colla", nessun codice di applicazione reale dovrebbe essere lì.

Se si esegue il comando rackup helloworld.ru, avvierà un server sulla porta 9292. Questa è la porta Rackup predefinita.

Rackup ha alcune funzionalità più utili. Innanzitutto, cose come la porta possono essere modificate dalla riga di comando o in una riga speciale nello script. Sulla riga di comando, passa semplicemente a -p port parametro. Per esempio: rackup -p 1337 helloworld.ru. Dallo stesso script, se la prima riga inizia con #\, quindi viene analizzato proprio come la riga di comando. Quindi puoi definire anche qui le opzioni. Se si desidera eseguire sulla porta 1337, è possibile leggere la prima riga del file Rackup # \ -p 1337.