Class Testo
java.lang.Object
|
+----Testo
- public class Testo
- extends Object
Questa classe è usata per interoggare i file di una versione della Bibbia.
Per aggiornamenti al file e informazioni su altre versioni, vai al sito del programma.
- Version:
- 4.0 (septembre 1999)
- Author:
- Richard Wilson (richardwilson@bigfoot.com)
-
E_ESPRESSIONEVUOTA
- Una costante usata da
ricerca()
per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.
-
E_PARENTESI
- Una costante usata da
ricerca()
per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.
-
E_PARENTESIQUADRATE
- Una costante usata da
ricerca()
per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.
-
E_SINTASSI
- Una costante usata da
ricerca()
per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.
-
Testo(Formato, String[], String[], String[], URL)
- Crea una classe che può interrogare i file di una versione della Bibbia, settando anche il formato da usare per i risultati e i nomi e abbreviazioni dei libri della Bibbia.
-
Testo(Formato, URL)
- Crea una classe che può interrogare i file di una versione della Bibbia, settando anche il formato da usare per i risultati delle azioni.
-
Testo(String[], String[], String[], URL)
- Crea una classe che può interrogare i file di una versione della Bibbia, settando anche i nomi e abbreviazioni dei libri della Bibbia.
-
Testo(URL)
- Crea una classe che può interrogare i file di una versione della Bibbia.
-
brano(String)
- Restituisce il testo di un brano quando dato il riferimento.
-
finalize()
- Chiude tutti i file aperti dal programma.
-
getFormato()
- Restituisce il formato usato per i risultati dell'azione.
-
getLibri()
- Restituisce un array di stringhe che contiene i nomi dei libri della Bibbia.
-
getLibriAbb()
- Restituisce un array di stringhe che contiene le abbreviazioni dei libri della Bibbia.
-
getLibriAbbRiconosciute()
- Restituisce un array di stringhe che contiene le abbreviazione dei libri della Bibbia che sono riconosciute dal programma.
-
getLingua()
- Restituisce la lingua di questa versione della Bibbia.
-
getLocale()
- Restituisce la lingua usata per le stringe dei risultati.
-
getNCapitoli(int)
- Restituisce il numero di capitoli in un certo libro della Bibbia.
-
getNLibri()
- Restituisce il numero di libri in questa versione della Bibbia.
-
getNome()
- Restituisce il nome di questa versione della Bibbia.
-
getNParole()
- Restituisce il numero di parole diverse in questa versione della Bibbia.
-
getNRadici()
- Restituisce il numero di radici diverse in questa versione della Bibbia.
-
getNVersetti(int, int)
- Restituisce il numero di versetti in un certo capitolo della Bibbia.
-
ricerca(String)
- Restituisce i versetti che contengono una parola o frase.
-
setFormato(Formato)
- Setta il formato da usare per i risultati dell'azione.
-
setLibri(String[])
- Setta i nomi dei libri della Bibbia.
-
setLibriAbb(String[])
- Setta le abbreviazioni dei libri della Bibbia che sono usate dal programma.
-
setLibriAbbRiconosciute(String[])
- Setta le abbreviazioni dei libri della Bibbia che sono riconosciute dal programma.
-
setLocale(String)
- Setta la lingua da usare per le stringhe dei risultati.
E_PARENTESI
public static final int E_PARENTESI
- Una costante usata da
ricerca()
per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.
Significa che c'è un errore nelle parentesi dell'espressione da ricercare.
- See Also:
- ricerca, BibbiaExceptionRicerca
E_PARENTESIQUADRATE
public static final int E_PARENTESIQUADRATE
- Una costante usata da
ricerca()
per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.
Significa che c'è un errore nelle parentesi quadrate dell'espressione da ricercare.
- See Also:
- ricerca, BibbiaExceptionRicerca
E_ESPRESSIONEVUOTA
public static final int E_ESPRESSIONEVUOTA
- Una costante usata da
ricerca()
per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.
Significa che l'espressione da ricercare non conteneva nessun testo.
- See Also:
- ricerca, BibbiaExceptionRicerca
E_SINTASSI
public static final int E_SINTASSI
- Una costante usata da
ricerca()
per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.
Significa che c'è un errore di sintassi nell'espressione da ricercare, al carattere numero (valore dell'eccezione) / E_SINTASSI.
- See Also:
- ricerca, BibbiaExceptionRicerca
Testo
public Testo(URL base) throws BibbiaExceptionFileNonEsiste, BibbiaExceptionFileCorrotto, SecurityException
- Crea una classe che può interrogare i file di una versione della Bibbia.
I nomi e abbreviazioni predefiniti dei libri sono usati (nella lingua del sistema operativo se è italiano,
inglese, francese, spagnolo o romene, altrimenti italiano). È anche possibile settare i nomi e abbreviazioni
dei libri in un secondo momento usando i metodi setLibri(String[])
, setLibriAbb(String[])
e setLibriAbbRiconosciute(String[])
.
Il formato predefinito è usato per i risultati delle azioni. È anche possibile settare il formato
in un secondo momento usando il metodo setFormato(Formato)
.
- Parameters:
- base - L'URL della directory in cui si trovano i file dei dati.
Di solito, sono nella stessa directory dell'applet, e basta usare "getCodeBase()" come argomento nell'applet che chiama questo costruttore.
- Throws: BibbiaExceptionFileNonEsiste
- se il programma non ha potuto trovare i file con i dati di una versione - bisogna installarli secondo le istuzioni.
- Throws: BibbiaExceptionFileCorrotto
- se il programma non ha potuto leggere i file con i dati di una versione - sono nel formato sbagliato, oppure corrotti.
- Throws: SecurityException
- se Java Virtual Machine (di solito il browser) non ha permesso al programma di leggere i file locali, cioè quelli con i dati.
- See Also:
- setLibri, setLibriAbb, setLibriAbbRiconosciute, setFormato
Testo
public Testo(String nomi[],
String abb[],
String abbRiconosciute[],
URL base) throws BibbiaExceptionFileNonEsiste, BibbiaExceptionFileCorrotto, BibbiaExceptionLibri, SecurityException
- Crea una classe che può interrogare i file di una versione della Bibbia, settando anche i nomi e abbreviazioni dei libri della Bibbia.
Il formato predefinito è usato per i risultati delle azioni. È anche possibile settare il formato
in un secondo momento usando il metodo setFormato(Formato)
.
- Parameters:
- nomi - Un array di stringhe che contengono i nomi dei libri di questa versione della Bibbia.
- abb - Un array di stringe che contengono le abbreviazioni dei libri che il programma userà nei risultati.
- abbRiconosciute - Un array di stringe che contengono le abbreviazioni dei libri che il programma riconosce quando l'utente digita un riferimento.
Le abbreviazioni di ogni libro sono separate con una virgola.
Per esempio, {"ge,gn", "eo,es", "le,lv", ..., "gd,guida", "ap"}.
Per questi tre array, bisogna dare 66 o 73 nomi, secondo il numero di libri nella versione.
- base - L'URL della directory in cui si trovano i file dei dati.
Di solito, sono nella stessa directory dell'applet, e basta usare "getCodeBase()" come argomento nell'applet che chiama questo costruttore.
- Throws: BibbiaExceptionFileNonEsiste
- se il programma non ha potuto trovare i file con i dati di una versione - bisogna installarli secondo le istuzioni.
- Throws: BibbiaExceptionFileCorrotto
- se il programma non ha potuto leggere i file con i dati di una versione - sono nel formato sbagliato, oppure corrotti.
- Throws: BibbiaExceptionLibri
- se gli array non contengono abbastanza stringe per i nomi di tutti i libri in questa versione.
I nomi predefiniti dei libri vengono invece usati.
- Throws: SecurityException
- se Java Virtual Machine (di solito il browser) non ha permesso al programma di leggere i file locali, cioè quelli con i dati.
- See Also:
- setFormato
Testo
public Testo(Formato f,
URL base) throws BibbiaExceptionFileNonEsiste, BibbiaExceptionFileCorrotto, SecurityException
- Crea una classe che può interrogare i file di una versione della Bibbia, settando anche il formato da usare per i risultati delle azioni.
I nomi e abbreviazioni predefiniti dei libri sono usati (nella lingua del sistema operativo se è italiano,
inglese, francese, spagnolo o romene, altrimenti italiano). È anche possibile settare i nomi e abbreviazioni
dei libri in un secondo momento usando i metodi setLibri(String[])
, setLibriAbb(String[])
e setLibriAbbRiconosciute(String[])
.
- Parameters:
- f - Un'istanza della classe
Formato
che descrive il formato da usare.
- base - L'URL della directory in cui si trovano i file dei dati.
Di solito, sono nella stessa directory dell'applet, e basta usare "getCodeBase()" come argomento nell'applet che chiama questo costruttore.
- Throws: BibbiaExceptionFileNonEsiste
- se il programma non ha potuto trovare i file con i dati di una versione - bisogna installarli secondo le istuzioni.
- Throws: BibbiaExceptionFileCorrotto
- se il programma non ha potuto leggere i file con i dati di una versione - sono nel formato sbagliato, oppure corrotti.
- Throws: SecurityException
- se Java Virtual Machine (di solito il browser) non ha permesso al programma di leggere i file locali, cioè quelli con i dati.
- See Also:
- setLibri, setLibriAbb, setLibriAbbRiconosciute, Formato
Testo
public Testo(Formato f,
String nomi[],
String abb[],
String abbRiconosciute[],
URL base) throws BibbiaExceptionFileNonEsiste, BibbiaExceptionFileCorrotto, BibbiaExceptionLibri, SecurityException
- Crea una classe che può interrogare i file di una versione della Bibbia, settando anche il formato da usare per i risultati e i nomi e abbreviazioni dei libri della Bibbia.
- Parameters:
- f - Un'istanza della classe
Formato
che descrive il formato da usare.
- nomi - Un array di stringhe che contengono i nomi dei libri di questa versione della Bibbia.
- abb - Un array di stringe che contengono le abbreviazioni dei libri che il programma userà nei risultati.
- abbRiconosciute - Un array di stringe che contengono le abbreviazioni dei libri che il programma riconosce quando l'utente digita un riferimento.
Le abbreviazioni di ogni libro sono separate con una virgola.
Per esempio, {"ge,gn", "eo,es", "le,lv", ..., "gd,guida", "ap"}.
Per questi tre array, bisogna dare 66 o 73 nomi, secondo il numero di libri nella versione.
- base - L'URL della directory in cui si trovano i file dei dati.
Di solito, sono nella stessa directory dell'applet, e basta usare "getCodeBase()" come argomento nell'applet che chiama questo costruttore.
- Throws: BibbiaExceptionFileNonEsiste
- se il programma non ha potuto trovare i file con i dati di una versione - bisogna installarli secondo le istuzioni.
- Throws: BibbiaExceptionFileCorrotto
- se il programma non ha potuto leggere i file con i dati di una versione - sono nel formato sbagliato, oppure corrotti.
- Throws: BibbiaExceptionLibri
- se gli array non contengono abbastanza stringe per i nomi di tutti i libri in questa versione.
I nomi predefiniti dei libri vengono invece usati.
- Throws: SecurityException
- se Java Virtual Machine (di solito il browser) non ha permesso al programma di leggere i file locali, cioè quelli con i dati.
- See Also:
- Formato
finalize
protected void finalize()
- Chiude tutti i file aperti dal programma.
Dovrebbe essere chiamata automaticamente all'uscita del programma, ma alcune implementazioni di Java non lo fanno (erroneamente).
Per questa ragione, conviene mettere
System.runFinalizersOnExit(true);
nella routine destroy()
della classe che creare un'istanza di Testo.
- Overrides:
- finalize in class Object
brano
public String brano(String rif) throws BibbiaExceptionFileCorrotto, BibbiaExceptionRiferimentoSbagliato
- Restituisce il testo di un brano quando dato il riferimento.
- Parameters:
- rif - Il riferimento del brano da visualizzare.
- Returns:
- Il brano desiderato.
- Throws: BibbiaExceptionFileCorrotto
- se il programma non ha potuto leggere i file con i dati di una versione - sono nel formato sbagliato, oppure corrotti; più probabilmente, c'è un errore (bug) nel programma che si manifesta in questo brano.
- Throws: BibbiaExceptionRiferimentoSbagliato
- se il riferimento del brano da visualizzare è sbagliato o ambiguo.
ricerca
public String ricerca(String frase) throws BibbiaExceptionFileCorrotto, BibbiaExceptionRicerca
- Restituisce i versetti che contengono una parola o frase.
- Parameters:
- frase - La parola o frase da ricercare.
- Returns:
- I versetti che contengono la parola o frase
- Throws: BibbiaExceptionFileCorrotto
- se il programma non ha potuto leggere i file con i dati di una versione - sono nel formato sbagliato, oppure corrotti; più probabilmente, c'è un errore (bug) nel programma che si manifesta in questo brano.
- Throws: BibbiaExceptionRicerca
- se l'espressione da ricercare (
frase<
) contiene un errore.
getNParole
public int getNParole()
- Restituisce il numero di parole diverse in questa versione della Bibbia.
getNRadici
public int getNRadici()
- Restituisce il numero di radici diverse in questa versione della Bibbia.
getNLibri
public int getNLibri()
- Restituisce il numero di libri in questa versione della Bibbia.
getNCapitoli
public int getNCapitoli(int libro)
- Restituisce il numero di capitoli in un certo libro della Bibbia.
- Parameters:
- libro - Il numero del libro di cui vuoi il numero di capitoli (Genesi=1, Esodo=2, ecc.).
- Returns:
- Il numero di capitoli in quel libro (0 se il libro non è in quella versione della Bibbia).
getNVersetti
public int getNVersetti(int libro,
int capitolo)
- Restituisce il numero di versetti in un certo capitolo della Bibbia.
- Parameters:
- libro - Il numero del libro di cui vuoi il numero di versetti (Genesi=1, Esodo=2, ecc.).
- capitolo - Il numero del capitolo del libro di vuoi il numero di versetti.
- Returns:
- Il numero di versetti in quel capitolo (0 se il libro non è in quella versione, o non c'è quel numero di capitoli nel libro.
setFormato
public void setFormato(Formato nuovoFormato)
- Setta il formato da usare per i risultati dell'azione.
- Parameters:
- nuovoFormato - Il nuovo formato da usare per i risultati (un'istanza della classe
Formato
).
- See Also:
- Formato
getFormato
public Formato getFormato()
- Restituisce il formato usato per i risultati dell'azione.
- See Also:
- Formato
setLocale
public void setLocale(String nuovoLocale)
- Setta la lingua da usare per le stringhe dei risultati.
Questo metodo cambia anche i nomi e le abbreviazioni dei libri per usare questa nuova lingua, per cui potrebbe essere necessario chiamare
setLibri
dopo.
- Parameters:
- locale - Una stringa che rappresenta la lingua da usare per i risultati.
Valori possibili sono 'it' (italiano), 'en' (inglese), 'es' (spagnolo), 'fr' (francese), 'ro' (romene) e '' (la lingua del sistema operativo, o se non è una di queste cinque, italiano).
getLocale
public String getLocale()
- Restituisce la lingua usata per le stringe dei risultati.
getLingua
public String getLingua()
- Restituisce la lingua di questa versione della Bibbia.
getNome
public String getNome()
- Restituisce il nome di questa versione della Bibbia.
setLibri
public void setLibri(String newLibri[]) throws BibbiaExceptionLibri
- Setta i nomi dei libri della Bibbia.
- Parameters:
- newLibri - Un array di stringhe (66 o 73 stringhe) che contiene i nomi da usare per i libri della Bibbia.
- Throws: BibbiaExceptionLibri
- se l'array non contiene abbastanza stringe per i nomi di tutti i libri in questa versione.
getLibri
public String[] getLibri()
- Restituisce un array di stringhe che contiene i nomi dei libri della Bibbia.
setLibriAbb
public void setLibriAbb(String newLibriAbb[]) throws BibbiaExceptionLibri
- Setta le abbreviazioni dei libri della Bibbia che sono usate dal programma.
- Parameters:
- newLibriAbb - Un array di stringhe (66 o 73 stringhe) che contiene le abbreviazioni da usare per i libri della Bibbia.
- Throws: BibbiaExceptionLibri
- se l'array non contiene abbastanza stringe per i nomi di tutti i libri in questa versione.
getLibriAbb
public String[] getLibriAbb()
- Restituisce un array di stringhe che contiene le abbreviazioni dei libri della Bibbia.
setLibriAbbRiconosciute
public void setLibriAbbRiconosciute(String newLibriAbbRiconosciute[]) throws BibbiaExceptionLibri
- Setta le abbreviazioni dei libri della Bibbia che sono riconosciute dal programma.
- Parameters:
- newLibriAbbRiconosciute - Un array di stringhe (66 o 73 stringhe) che contiene le abbreviazioni dei libri della Bibbia che sono riconosciute dal programma.
Le abbreviazioni di ogni libro vanno separate da una virgola, per esempio {"ge,gn", "eo,es", "le,lv", ..., "gd,guida", "ap"}.
- Throws: BibbiaExceptionLibri
- se l'array non contiene abbastanza stringe per i nomi di tutti i libri in questa versione.
getLibriAbbRiconosciute
public String[] getLibriAbbRiconosciute()
- Restituisce un array di stringhe che contiene le abbreviazione dei libri della Bibbia che sono riconosciute dal programma.