Il metodo "Require" in Ruby

Per creare componenti riutilizzabili, che possono essere facilmente utilizzati in altri programmi, un linguaggio di programmazione deve avere un modo per importare senza problemi quel codice in fase di esecuzione. Nel Rubino, il richiedere Il metodo viene utilizzato per caricare un altro file ed eseguirne tutti dichiarazioni. Questo serve per importare tutta la classe e metodo definizioni nel file. Oltre a eseguire semplicemente tutte le istruzioni nel file, il metodo request tiene anche traccia di quali file sono stati precedentemente richiesti e, quindi, non richiederà un file due volte.

Il metodo request prende il nome del file da richiedere, come a corda, come unico argomento. Questo può essere un percorso del file, ad esempio ./lib/some_library.rb o un nome abbreviato, come ad esempio some_library. Se l'argomento è un percorso e un nome file completo, il metodo request cercherà lì il file. Tuttavia, se l'argomento è un nome abbreviato, il metodo Require cercherà un certo numero di directory predefinite sul proprio sistema. L'uso del nome abbreviato è il modo più comune di utilizzare il metodo request.

L'esempio seguente mostra come utilizzare l'istruzione request. Il file test_library.rb è nel primo blocco di codice. Questo file stampa un messaggio e definisce una nuova classe. Il secondo blocco di codice è il file test_program.rb. Questo file carica il file test_library.rb file usando therequiremethod e crea un nuovo TestClass oggetto.

mette "test_library incluso"
classe TestClass
def inizializza
mette "Oggetto TestClass creato"
fine
fine

#! / usr / bin / env ruby
richiedi 'test_library.rb'
t = TestClass.new

Quando si scrivono componenti riutilizzabili, è meglio non dichiarare molte variabili nell'ambito globale al di fuori di qualsiasi classe o metodo o utilizzando il $ prefisso. Questo per prevenire qualcosa chiamato "inquinamento dello spazio dei nomi"Se si dichiarano troppi nomi, un altro programma o libreria potrebbe dichiarare lo stesso nome e causare uno scontro tra nomi. Quando due librerie completamente non correlate iniziano a cambiare accidentalmente le variabili reciproche, le cose si romperanno, apparentemente a caso. Questo è un bug molto difficile da rintracciare ed è meglio solo evitarlo.

Per evitare scontri con i nomi, puoi racchiudere tutto nella tua libreria all'interno di a modulo dichiarazione. Ciò richiederà alle persone di fare riferimento alle tue classi e al tuo metodo con un nome completo come MyLibrary:: my_method, ma ne vale la pena poiché generalmente non si verificano scontri con i nomi. Per le persone che vogliono avere tutti i nomi delle classi e dei metodi nell'ambito globale, possono farlo utilizzando il includere dichiarazione.

L'esempio seguente ripete l'esempio precedente ma racchiude tutto in a La mia biblioteca modulo. Due versioni di my_program.rb sono dati; uno che usa il includere dichiarazione e uno che non lo fa.

mette "test_library incluso"
modulo MyLibrary
classe TestClass
def inizializza
mette "Oggetto TestClass creato"
fine
fine
fine

#! / usr / bin / env ruby
richiede 'test_library2.rb'
t = MyLibrary:: TestClass.new

#! / usr / bin / env ruby
richiede 'test_library2.rb'
include MyLibrary
t = TestClass.new

Poiché i componenti riutilizzabili vengono spesso spostati, è anche meglio non utilizzare percorsi assoluti nelle chiamate richieste. Un percorso assoluto è un percorso simile /home/user/code/library.rb. Noterai che il file deve trovarsi nella posizione esatta per funzionare. Se lo script viene mai spostato o la directory home cambia, tale istruzione non funzionerà più.

Invece di percorsi assoluti, è spesso comune creare un ./lib nella directory del tuo programma Ruby. Il ./lib la directory viene aggiunta alla $ LOAD_PATH variabile che memorizza le directory in cui il metodo request cerca i file Ruby. Successivamente, se il file my_library.rb è memorizzato nella directory lib, può essere caricato nel tuo programma con un semplice richiede "my_library" dichiarazione.

L'esempio seguente è uguale al precedente test_program.rb esempi. Tuttavia, presuppone che test_library.rb il file è archiviato nel file ./lib directory e lo carica utilizzando il metodo sopra descritto.

#! / usr / bin / env ruby
$ LOAD_PATH << './lib'
richiedi 'test_library.rb'
t = TestClass.new