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. In Ruby, il richiedere Il metodo viene utilizzato per caricare un altro file ed eseguire tutte le sue istruzioni. Questo serve per importare tutte le definizioni di classe e metodo 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.

Utilizzando il metodo 'richiede'

Il metodo request prende il nome del file da richiedere, come stringa, come singolo 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 usando il filerichiederemetodo 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

Evitare scontri di nomi

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 conflitti di nomi, è possibile racchiudere tutto nella libreria all'interno di un'istruzione del modulo. 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

Evita percorsi assoluti

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