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)

Variable Index

 o E_ESPRESSIONEVUOTA
Una costante usata da ricerca() per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.
 o E_PARENTESI
Una costante usata da ricerca() per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.
 o E_PARENTESIQUADRATE
Una costante usata da ricerca() per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.
 o E_SINTASSI
Una costante usata da ricerca() per indicare il tipo di eccezione quando BibbiaExceptionRicerca viene generata.

Constructor Index

 o 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.
 o 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.
 o 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.
 o Testo(URL)
Crea una classe che può interrogare i file di una versione della Bibbia.

Method Index

 o brano(String)
Restituisce il testo di un brano quando dato il riferimento.
 o finalize()
Chiude tutti i file aperti dal programma.
 o getFormato()
Restituisce il formato usato per i risultati dell'azione.
 o getLibri()
Restituisce un array di stringhe che contiene i nomi dei libri della Bibbia.
 o getLibriAbb()
Restituisce un array di stringhe che contiene le abbreviazioni dei libri della Bibbia.
 o getLibriAbbRiconosciute()
Restituisce un array di stringhe che contiene le abbreviazione dei libri della Bibbia che sono riconosciute dal programma.
 o getLingua()
Restituisce la lingua di questa versione della Bibbia.
 o getLocale()
Restituisce la lingua usata per le stringe dei risultati.
 o getNCapitoli(int)
Restituisce il numero di capitoli in un certo libro della Bibbia.
 o getNLibri()
Restituisce il numero di libri in questa versione della Bibbia.
 o getNome()
Restituisce il nome di questa versione della Bibbia.
 o getNParole()
Restituisce il numero di parole diverse in questa versione della Bibbia.
 o getNRadici()
Restituisce il numero di radici diverse in questa versione della Bibbia.
 o getNVersetti(int, int)
Restituisce il numero di versetti in un certo capitolo della Bibbia.
 o ricerca(String)
Restituisce i versetti che contengono una parola o frase.
 o setFormato(Formato)
Setta il formato da usare per i risultati dell'azione.
 o setLibri(String[])
Setta i nomi dei libri della Bibbia.
 o setLibriAbb(String[])
Setta le abbreviazioni dei libri della Bibbia che sono usate dal programma.
 o setLibriAbbRiconosciute(String[])
Setta le abbreviazioni dei libri della Bibbia che sono riconosciute dal programma.
 o setLocale(String)
Setta la lingua da usare per le stringhe dei risultati.

Variables

 o 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
 o 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
 o 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
 o 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

Constructors

 o 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
 o 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
 o 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
 o 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

Methods

 o 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
 o 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.
 o 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.
 o getNParole
 public int getNParole()
Restituisce il numero di parole diverse in questa versione della Bibbia.

 o getNRadici
 public int getNRadici()
Restituisce il numero di radici diverse in questa versione della Bibbia.

 o getNLibri
 public int getNLibri()
Restituisce il numero di libri in questa versione della Bibbia.

 o 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).
 o 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.
 o 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
 o getFormato
 public Formato getFormato()
Restituisce il formato usato per i risultati dell'azione.

See Also:
Formato
 o 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).
 o getLocale
 public String getLocale()
Restituisce la lingua usata per le stringe dei risultati.

 o getLingua
 public String getLingua()
Restituisce la lingua di questa versione della Bibbia.

 o getNome
 public String getNome()
Restituisce il nome di questa versione della Bibbia.

 o 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.
 o getLibri
 public String[] getLibri()
Restituisce un array di stringhe che contiene i nomi dei libri della Bibbia.

 o 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.
 o getLibriAbb
 public String[] getLibriAbb()
Restituisce un array di stringhe che contiene le abbreviazioni dei libri della Bibbia.

 o 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.
 o getLibriAbbRiconosciute
 public String[] getLibriAbbRiconosciute()
Restituisce un array di stringhe che contiene le abbreviazione dei libri della Bibbia che sono riconosciute dal programma.