SOMA.gui
Class Config

java.lang.Object
  SOMA.gui.Config

public class Config

extends java.lang.Object

Field Summary

protected static java.lang.String	FILE_CONFIG File su cui memorizzare le modifiche di utente.
protected static boolean	modificate Questa variabile mi permetterà di ricordarmi (al momento del salvataggio) se l'utente ha fatto una MODIFICA delle proprietà.
protected static boolean	primaVolta Devo sapere se è la prima volta che eseguo un qualsiasi metodo di questa classe, perché devo (ovviamente) caricare dal disco tutte le "proprietà" modificate da utente (nella precedente esecuzione del programma).
protected static java.util.Properties	propDefault Qui invece tutte le "proprietà" DEFINITE dal programmatore!
protected static java.util.Properties	propUtente Qui ci memorizzo tutte le "proprietà" MODIFICATE da utente!

Constructor Summary

Config()

Method Summary

static void	caricaPropUtente() Carico tutte la proprietà che sono state modificate dall'utente.
static void	caricaPropUtente(java.lang.String nomeFile) Carico tutte la proprietà che sono state modificate dall'utente.
static void	caricaPropUtenteSeCiSono() Come la precedente, ma NON rende l'eccezione se non c'è il file.
static java.lang.String	cheProp(java.lang.String chiave) Rende il valore della proprietà "chiave".
static boolean	chePropBool(java.lang.String chiave) Come "cheProp" ma specifica per valori di tipo boolean.
static java.awt.Color	chePropCol(java.lang.String chiave) Come "cheProp" ma specifica per valori di classe Color.
static java.awt.Rectangle	chePropComponent(java.lang.String chiave, java.awt.Component componente) Come "cheProp" ma specifica per un "componente".
static java.lang.String	chePropDefault(java.lang.String chiave) Rende il valore di default della proprietà "chiave".
static java.awt.Dimension	chePropDim(java.lang.String chiave) Come "cheProp" ma specifica per valori di classe Color.
static int	chePropInt(java.lang.String chiave) Come "cheProp" ma specifica per valori di tipo intero.
static void	defProp(java.lang.String chiave, java.lang.String valore) DEFINIZIONE di una proprietà - si impone l'assegnazione di un valore di DEFAULT.
static void	defPropBool(java.lang.String chiave, boolean valore) Come "defProp" ma specifica per valori di tipo boolean.
static void	defPropCol(java.lang.String chiave, java.awt.Color valore) Come "defProp" ma specifica per valori di classe Color.
static void	defPropComponent(java.lang.String chiave, java.awt.Component componente) Come "defProp" ma specifica per memorizzare "locazione" e "dimensione" di una finestra (passata come un generico componente - su cui si può fare la "getBounds()").
static void	defPropDim(java.lang.String chiave, java.awt.Dimension valore) Come "defProp" ma specifica per valori di classe Dimension.
static void	defPropInt(java.lang.String chiave, int valore) Come "defProp" ma specifica per valori di tipo intero.
static void	defPropVariabile(java.lang.String chiave, java.lang.String valore) Come la "defProp", ma non controlla se la proprietà è già stata definita (con diverso valore).
static java.lang.String	inStringa() Rende la rappresentazione sottoforma di stringa di TUTTO l'elenco di proprietà definite dal programmatore e modificate da utente.
static void	modifProp(java.lang.String chiave, java.lang.String valore) MODIFICA di una proprietà - si fa una modifica del valore di DEFAULT.
static void	modifPropBool(java.lang.String chiave, boolean valore) Come "modifProp" ma specifica per valori di tipo boolean.
static void	modifPropCol(java.lang.String chiave, java.awt.Color valore) Come "modifProp" ma specifica per valori di classe Color.
static void	modifPropComponent(java.lang.String chiave, java.awt.Component componente) Come "modifProp" ma specifica per un "componente".
static void	modifPropDim(java.lang.String chiave, java.awt.Dimension valore) Come "modifProp" ma specifica per valori di classe Color.
static void	modifPropInt(java.lang.String chiave, int valore) Come "modifProp" ma specifica per valori di tipo intero.
static void	resetConfig() Ripristina tutte le proprietà al proprio valore di default!
static void	resetProp(java.lang.String chiave) Ripristina al valore di default la proprietà passata.
static void	salvaPropUtente() Salva su disco tutte le modifiche fatte dall'utente alle proprietà.
static void	salvaPropUtente(java.lang.String nomeFile) Salva su disco tutte le modifiche fatte dall'utente alle proprietà.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FILE_CONFIG

protected static final java.lang.String FILE_CONFIG

File su cui memorizzare le modifiche di utente.

See Also:

Constant Field Values

propUtente

protected static java.util.Properties propUtente

Qui ci memorizzo tutte le "proprietà" MODIFICATE da utente!

propDefault

protected static java.util.Properties propDefault

Qui invece tutte le "proprietà" DEFINITE dal programmatore!

primaVolta

protected static boolean primaVolta

Devo sapere se è la prima volta che eseguo un qualsiasi metodo di questa classe, perché devo (ovviamente) caricare dal disco tutte le "proprietà" modificate da utente (nella precedente esecuzione del programma). Lo faccio in automatico, senza che il programmatore se ne debba interessare.

modificate

protected static boolean modificate

Questa variabile mi permetterà di ricordarmi (al momento del salvataggio) se l'utente ha fatto una MODIFICA delle proprietà. Ho voluto "ottimizzare": se viene richiesto un salvataggio delle proprietà (modificate), se non è stata fatta nessuna modifica dall'ultimo salvataggio è inutile andarle a salvare nuovamente!

Constructor Detail

Config

public Config()

Method Detail

caricaPropUtente

public static void caricaPropUtente()
                             throws java.lang.Exception

Carico tutte la proprietà che sono state modificate dall'utente. Viene usato il file specifico definito in "FILE_CONFIG".

Throws:

java.lang.Exception

caricaPropUtenteSeCiSono

public static void caricaPropUtenteSeCiSono()

Come la precedente, ma NON rende l'eccezione se non c'è il file.

caricaPropUtente

public static void caricaPropUtente(java.lang.String nomeFile)
                             throws java.lang.Exception

Carico tutte la proprietà che sono state modificate dall'utente. Non si usa il file definito in "FILE_CONFIG" ma il file il cui nome è passato nella stringa nomeFile. In tal modo si possono "personalizzare" il file di salvataggio.

Throws:

java.lang.Exception

salvaPropUtente

public static void salvaPropUtente()
                            throws java.lang.Exception

Salva su disco tutte le modifiche fatte dall'utente alle proprietà. Viene usato il file specifico definito in "FILE_CONFIG". NB: il salvataggio avviene solo se non è stata fatta nessuna modifica delle proprietà relativamente all'ultimo salvataggio. Infatti sarebbe inutile andare a salvare una configurazione che è perfettamente identica a quella che è già presente su disco!

Throws:

java.lang.Exception

salvaPropUtente

public static void salvaPropUtente(java.lang.String nomeFile)
                            throws java.lang.Exception

Salva su disco tutte le modifiche fatte dall'utente alle proprietà. Non si usa il file definito in "FILE_CONFIG" ma il file il cui nome è passato nella stringa nomeFile. In tal modo si possono "personalizzare" il file di salvataggio. NB: il salvataggio avviene solo se non è stata fatta nessuna modifica delle proprietà relativamente all'ultimo salvataggio.

Throws:

java.lang.Exception

defProp

public static void defProp(java.lang.String chiave,
                           java.lang.String valore)

DEFINIZIONE di una proprietà - si impone l'assegnazione di un valore di DEFAULT. Deve essere fatta dal programmatore all'interno del programma. La proprietà è espressa dall'identificatore "chiave" a cui viene assegnato il valore "valore". "chiave" e "valore" sono entrambi delle stringhe! Se la chiave non è già in UTENTE, la si assegna anche a esso col valore di default. Attenzione: non è ammessa la definizione di una proprietà più di una volta nel corso dell'esecuzione del programma, a meno che non venga definita sempre con lo stesso valore.

defPropVariabile

public static void defPropVariabile(java.lang.String chiave,
                                    java.lang.String valore)

Come la "defProp", ma non controlla se la proprietà è già stata definita (con diverso valore). Utile per proprietà che possono essere ridefinite più volte e ogni volta con valore diverso, per es. la dimensione di una finestra - che dipende dai componenti all'interno.

modifProp

public static void modifProp(java.lang.String chiave,
                             java.lang.String valore)

MODIFICA di una proprietà - si fa una modifica del valore di DEFAULT. Deve essere fatta dall'utente (o da azioni dell'utente che si ripercuotono sulle proprietà di configurazione). NON va a modificare il default, ma sarà salvata su disco! La proprietà è espressa dall'identificatore "chiave" a cui viene modificato il valore esistente con il nuovo valore "valore". "chiave" e "valore" sono entrambi delle stringhe! Attenzione: la modifica di una proprietà può essere fatta quante volte si vuole, anche nessuna!

cheProp

public static java.lang.String cheProp(java.lang.String chiave)

Rende il valore della proprietà "chiave". Tale valore sarà quello MODIFICATO dall'utente. Se l'utente non ha fatto alcuna modifica della proprietà, verrà reso il valore DEFINITO dal programmatore. "chiave" e "valore" sono entrambi delle stringhe!

chePropDefault

public static java.lang.String chePropDefault(java.lang.String chiave)

Rende il valore di default della proprietà "chiave". Il valore reso è il valore predefinito dal programmatore, anche se l'utente l'ha "modificato". "chiave" e "valore" sono entrambi delle stringhe!

resetProp

public static void resetProp(java.lang.String chiave)

Ripristina al valore di default la proprietà passata. Toglie l'eventuale modifica fatta da utente. "chiave" e "valore" sono entrambi delle stringhe!

resetConfig

public static void resetConfig()

Ripristina tutte le proprietà al proprio valore di default! Toglie tutte le eventuali modifiche fatta da utente.

defPropInt

public static void defPropInt(java.lang.String chiave,
                              int valore)

Come "defProp" ma specifica per valori di tipo intero.

modifPropInt

public static void modifPropInt(java.lang.String chiave,
                                int valore)

Come "modifProp" ma specifica per valori di tipo intero.

chePropInt

public static int chePropInt(java.lang.String chiave)

Come "cheProp" ma specifica per valori di tipo intero.

defPropBool

public static void defPropBool(java.lang.String chiave,
                               boolean valore)

Come "defProp" ma specifica per valori di tipo boolean.

modifPropBool

public static void modifPropBool(java.lang.String chiave,
                                 boolean valore)

Come "modifProp" ma specifica per valori di tipo boolean.

chePropBool

public static boolean chePropBool(java.lang.String chiave)

Come "cheProp" ma specifica per valori di tipo boolean.

defPropCol

public static void defPropCol(java.lang.String chiave,
                              java.awt.Color valore)

Come "defProp" ma specifica per valori di classe Color.

modifPropCol

public static void modifPropCol(java.lang.String chiave,
                                java.awt.Color valore)

Come "modifProp" ma specifica per valori di classe Color.

chePropCol

public static java.awt.Color chePropCol(java.lang.String chiave)

Come "cheProp" ma specifica per valori di classe Color.

defPropDim

public static void defPropDim(java.lang.String chiave,
                              java.awt.Dimension valore)

Come "defProp" ma specifica per valori di classe Dimension.

modifPropDim

public static void modifPropDim(java.lang.String chiave,
                                java.awt.Dimension valore)

Come "modifProp" ma specifica per valori di classe Color.

chePropDim

public static java.awt.Dimension chePropDim(java.lang.String chiave)

Come "cheProp" ma specifica per valori di classe Color.

defPropComponent

public static void defPropComponent(java.lang.String chiave,
                                    java.awt.Component componente)

Come "defProp" ma specifica per memorizzare "locazione" e "dimensione" di una finestra (passata come un generico componente - su cui si può fare la "getBounds()"). La chiave viene definita da utente (possono esserci più di una finestra) e i "valori" sono all'interno della finestra passata (posizione X-Y e dimensione W-H).

modifPropComponent

public static void modifPropComponent(java.lang.String chiave,
                                      java.awt.Component componente)

Come "modifProp" ma specifica per un "componente".

chePropComponent

public static java.awt.Rectangle chePropComponent(java.lang.String chiave,
                                                  java.awt.Component componente)

Come "cheProp" ma specifica per un "componente". Rende il rettangolo contenente "posizione" e "dimensione" Serve lo stesso la chiave!

inStringa

public static java.lang.String inStringa()

Rende la rappresentazione sottoforma di stringa di TUTTO l'elenco di proprietà definite dal programmatore e modificate da utente. NB: NON posso chiamarla "toString" perché questa è STATICA!