SOMA.gui
Class Creatore

java.lang.Object
  SOMA.gui.Creatore

public class Creatore

extends java.lang.Object

Field Summary

protected static java.lang.String	CREA_PLACEDEF Intestazione di ogni singola invocazione per distinguere il tipo di place da creare: dei DEFault o NORmale.
protected static java.lang.String	CREA_PLACEMOB
protected static java.lang.String	CREA_PLACENOR
protected static java.lang.String	FILE_PLACES File su cui salvare e successivamente ricaricare le stringhe di invocazione dei place.
protected static boolean	primaVolta Tengo traccia se è la prima volta che si esegue un metodo di questa classe.
protected static DirExplorerItem	rootDir Riferimento alla "root" del menù creato da Main.
protected static java.lang.String	SICURO_NO
protected static java.lang.String	SICURO_SI

Constructor Summary

Creatore()

Method Summary

protected static void	abilitaSicurezza()
static void	cancellaConfigPlace() Cancella il file di salvataggio delle invocazioni.
static Environment[]	caricaConfigSalvata(Anagrafe anagrafe) Carica il file di configurazione dei place (precedentemente salvato) e crea uno a uno ogni place.
protected static void	CaricaMiaLingua() Carico il file di lingua di questa classe
static int	cheDimensConfigSalvata() Rende la dimensione del file di configurazione dei place (precedentemente salvato).
static DirExplorerItem	chePlaceDir(PlaceID placeID) Rende il riferimento al "direttorio" del menù corrispondente al Place passato (accede a "rootDir").
static DirExplorerItem	cheRootDir() Rende il riferimento alla "root" del menù a directory di SOMA.
static Environment	crea(java.lang.String invocazione, Anagrafe anagrafe) Crea un place di default o un place normale da una stringa di invocazione.
static void	defRootDir(DirExplorerItem rootDirMenu) Salva il riferimento alla "root" del menù a directory di SOMA, quello che viene creato da Main.
static boolean	esisteConfigSalvata() Rende true se esiste il file di salvataggio delle configurazioni dei place.
static java.lang.String	invocaPlace(java.lang.String domNome, java.lang.String placeNome, int placePorta, java.lang.String regAddr, int regPorta, boolean usaSicurezza) Rende la stringa di invocazione (da dare a "crea") per la creazione di un place (normale) contenuto nel dominio domNome e col nome placeNome, sulla porta domPorta e la cui registrazione del PNS (nota: PNS e non DNS) verrà effettuata verso il processo presente sul computer all'indirizzo IP regAddr e sulla porta regPorta (tale indicazione DEVE fare riferimento al place di default del dominio domNome in cui il place sarà contenuto).
static java.lang.String	invocaPlace(java.lang.String domNome, java.lang.String placeNome, java.lang.String placePorta, java.lang.String regAddr, java.lang.String regPorta, boolean usaSicurezza) Analoga alla precedente, ma i numeri di porta sono delle stringhe anziché dei numeri interi.
static java.lang.String	invocaPlaceDefault(java.lang.String domNome, int domPorta, java.lang.String regAddr, int regPorta, boolean usaSicurezza) Rende la stringa di invocazione (da dare a "crea") per la creazione di un place di default relativo al dominio domNome, sulla porta domPorta e la cui registrazione del DNS verrà effettuata verso il processo presente sul computer all'indirizzo IP regAddr e sulla porta regPorta.
static java.lang.String	invocaPlaceDefault(java.lang.String domNome, java.lang.String domPorta, java.lang.String regAddr, java.lang.String regPorta, boolean usaSicurezza) Analoga alla precedente, ma i numeri di porta sono delle stringhe anziché dei numeri interi.
static java.lang.String	invocaPlaceMobile(java.lang.String domNome, java.lang.String placeNome, int placePorta, java.lang.String regAddr, int regPorta) Rende la stringa di invocazione (da dare a "crea") per la creazione di un place mobile contenuto nel dominio domNome e col nome placeNome, sulla porta domPorta e la cui registrazione del PNS (nota: PNS e non DNS) verrà effettuata verso il processo presente sul computer all'indirizzo IP regAddr e sulla porta regPorta (tale indicazione DEVE fare riferimento al place di default del dominio domNome in cui il place sarà contenuto).
static java.lang.String	invocaPlaceMobile(java.lang.String domNome, java.lang.String placeNome, java.lang.String placePorta, java.lang.String regAddr, java.lang.String regPorta) Analoga alla precedente, ma i numeri di porta sono delle stringhe anziché dei numeri interi.
static void	lanciaAgente(Environment env, java.lang.String nomeAgente, java.lang.String[] arrParam, boolean usaSysClassLoader, boolean rintracciabile, boolean nonFarloPartire) Lancia un agente, dato l'Environment del place.
static void	lanciaAgente(Environment env, java.lang.String nomeAgente, java.lang.String[] arrParam, boolean usaSysClassLoader, boolean rintracciabile, boolean nonFarloPartire, java.lang.String profileFileName, java.lang.String profilePassword) Lancia un agente, dato l'Environment del place.
static void	salvaConfigPlace(java.lang.String invocazione, boolean append) Salva la "stringa di invocazione" sul file di configurazione dei place.

Methods inherited from class java.lang.Object

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

Field Detail

FILE_PLACES

protected static final java.lang.String FILE_PLACES

File su cui salvare e successivamente ricaricare le stringhe di invocazione dei place.

See Also:

Constant Field Values

CREA_PLACEDEF

protected static final java.lang.String CREA_PLACEDEF

Intestazione di ogni singola invocazione per distinguere il tipo di place da creare: dei DEFault o NORmale.

See Also:

Constant Field Values

CREA_PLACENOR

protected static final java.lang.String CREA_PLACENOR

See Also:

Constant Field Values

CREA_PLACEMOB

protected static final java.lang.String CREA_PLACEMOB

See Also:

Constant Field Values

SICURO_SI

protected static final java.lang.String SICURO_SI

See Also:

Constant Field Values

SICURO_NO

protected static final java.lang.String SICURO_NO

See Also:

Constant Field Values

rootDir

protected static DirExplorerItem rootDir

Riferimento alla "root" del menù creato da Main.

primaVolta

protected static boolean primaVolta

Tengo traccia se è la prima volta che si esegue un metodo di questa classe. Infatti la "prima volta" - e solo in quell'occasione - va caricato il file di lingua.

Constructor Detail

Creatore

public Creatore()

Method Detail

CaricaMiaLingua

protected static void CaricaMiaLingua()

Carico il file di lingua di questa classe

defRootDir

public static void defRootDir(DirExplorerItem rootDirMenu)

Salva il riferimento alla "root" del menù a directory di SOMA, quello che viene creato da Main.

cheRootDir

public static DirExplorerItem cheRootDir()

Rende il riferimento alla "root" del menù a directory di SOMA.

chePlaceDir

public static DirExplorerItem chePlaceDir(PlaceID placeID)

Rende il riferimento al "direttorio" del menù corrispondente al Place passato (accede a "rootDir").

crea

public static Environment crea(java.lang.String invocazione,
                               Anagrafe anagrafe)
                        throws java.lang.Exception

Crea un place di default o un place normale da una stringa di invocazione. Tutto ciò che occorre è passato attraverso la stringa "invocazione". L'invocazione dice al Creatore cosa si vuole che venga creato e è buona cosa che sia creata attraverso i metodi "invocaPlaceDefault" o "invocaPlace" oppure che sia una stringa letta dal file di salvataggio dei dati dei place. L'oggetto "Anagrafe" passato verrà avvisato dell'avvenuta creazione del place; porre Anagrafe=null se NON si vuole mantenerne traccia. Sfruttando il late-binding, l'Environment reso può essere un: Environment, MobilbeEnvironment, SecurityEnvironment.

Throws:

java.lang.Exception

abilitaSicurezza

protected static void abilitaSicurezza()

invocaPlaceDefault

public static java.lang.String invocaPlaceDefault(java.lang.String domNome,
                                                  int domPorta,
                                                  java.lang.String regAddr,
                                                  int regPorta,
                                                  boolean usaSicurezza)
                                           throws java.lang.Exception

Rende la stringa di invocazione (da dare a "crea") per la creazione di un place di default relativo al dominio domNome, sulla porta domPorta e la cui registrazione del DNS verrà effettuata verso il processo presente sul computer all'indirizzo IP regAddr e sulla porta regPorta. Viene generata un eccezione se un qualsiasi dato non è corretto.

Throws:

java.lang.Exception

invocaPlaceDefault

public static java.lang.String invocaPlaceDefault(java.lang.String domNome,
                                                  java.lang.String domPorta,
                                                  java.lang.String regAddr,
                                                  java.lang.String regPorta,
                                                  boolean usaSicurezza)
                                           throws java.lang.Exception

Analoga alla precedente, ma i numeri di porta sono delle stringhe anziché dei numeri interi. Viene generata un eccezione se un qualsiasi dato non è corretto.

Throws:

java.lang.Exception

invocaPlace

public static java.lang.String invocaPlace(java.lang.String domNome,
                                           java.lang.String placeNome,
                                           int placePorta,
                                           java.lang.String regAddr,
                                           int regPorta,
                                           boolean usaSicurezza)
                                    throws java.lang.Exception

Rende la stringa di invocazione (da dare a "crea") per la creazione di un place (normale) contenuto nel dominio domNome e col nome placeNome, sulla porta domPorta e la cui registrazione del PNS (nota: PNS e non DNS) verrà effettuata verso il processo presente sul computer all'indirizzo IP regAddr e sulla porta regPorta (tale indicazione DEVE fare riferimento al place di default del dominio domNome in cui il place sarà contenuto). Viene generata un eccezione se un qualsiasi dato non è corretto.

Throws:

java.lang.Exception

invocaPlace

public static java.lang.String invocaPlace(java.lang.String domNome,
                                           java.lang.String placeNome,
                                           java.lang.String placePorta,
                                           java.lang.String regAddr,
                                           java.lang.String regPorta,
                                           boolean usaSicurezza)
                                    throws java.lang.Exception

Analoga alla precedente, ma i numeri di porta sono delle stringhe anziché dei numeri interi. Viene generata un eccezione se un qualsiasi dato non è corretto.

Throws:

java.lang.Exception

invocaPlaceMobile

public static java.lang.String invocaPlaceMobile(java.lang.String domNome,
                                                 java.lang.String placeNome,
                                                 int placePorta,
                                                 java.lang.String regAddr,
                                                 int regPorta)
                                          throws java.lang.Exception

Rende la stringa di invocazione (da dare a "crea") per la creazione di un place mobile contenuto nel dominio domNome e col nome placeNome, sulla porta domPorta e la cui registrazione del PNS (nota: PNS e non DNS) verrà effettuata verso il processo presente sul computer all'indirizzo IP regAddr e sulla porta regPorta (tale indicazione DEVE fare riferimento al place di default del dominio domNome in cui il place sarà contenuto). Viene generata un eccezione se un qualsiasi dato non è corretto.

Throws:

java.lang.Exception

invocaPlaceMobile

public static java.lang.String invocaPlaceMobile(java.lang.String domNome,
                                                 java.lang.String placeNome,
                                                 java.lang.String placePorta,
                                                 java.lang.String regAddr,
                                                 java.lang.String regPorta)
                                          throws java.lang.Exception

Analoga alla precedente, ma i numeri di porta sono delle stringhe anziché dei numeri interi. Viene generata un eccezione se un qualsiasi dato non è corretto.

Throws:

java.lang.Exception

esisteConfigSalvata

public static boolean esisteConfigSalvata()

Rende true se esiste il file di salvataggio delle configurazioni dei place.

caricaConfigSalvata

public static Environment[] caricaConfigSalvata(Anagrafe anagrafe)

Carica il file di configurazione dei place (precedentemente salvato) e crea uno a uno ogni place. Dal file vengono lette le "stringhe di invocazione" che vengono passate a "crea". Al ritorno viene reso un array di Environment che identificano tutti i place creati. Se l'array ha dimensione zero, nessun place è stato creato. Nota: durante il caricamento viene mostrata una finestra di dialogo con una barra che indica il progresso nella creazione. L'oggetto Anagrafe passato verrà avvisato dei place creati. Se non lo si vuole avvisare, porre Anagrafe=null nella chiamata.

cheDimensConfigSalvata

public static int cheDimensConfigSalvata()

Rende la dimensione del file di configurazione dei place (precedentemente salvato). La dimensione è intesa in "numero di stringhe di invocazione" distinte.

salvaConfigPlace

public static void salvaConfigPlace(java.lang.String invocazione,
                                    boolean append)
                             throws java.lang.Exception

Salva la "stringa di invocazione" sul file di configurazione dei place. Se "append" vale true, la stringa viene accodata alla fine del file; altrimenti il file viene cancellato e riempito con la sola stringa passata.

Throws:

java.lang.Exception

cancellaConfigPlace

public static void cancellaConfigPlace()

Cancella il file di salvataggio delle invocazioni.

lanciaAgente

public static void lanciaAgente(Environment env,
                                java.lang.String nomeAgente,
                                java.lang.String[] arrParam,
                                boolean usaSysClassLoader,
                                boolean rintracciabile,
                                boolean nonFarloPartire)
                         throws java.lang.Exception

Lancia un agente, dato l'Environment del place. Viene lanciato nel place di ambiente "env" l'agente il cui nome è contenuto in "nomeAgente" (senza estensione ".class") con i parametri "arrParam". Sono disponibili parametri aggiuntivi: "usaSysClassLoader" (per usare il caricatore di classi di sistema), "rintracciabile" (per far sì che si possa sempre sapere la posizione dell'agente) e "nonFarloPartire" (per creare l'agente senza che ne sia messo in esecuzione il suo "worker").

Throws:

java.lang.Exception

lanciaAgente

public static void lanciaAgente(Environment env,
                                java.lang.String nomeAgente,
                                java.lang.String[] arrParam,
                                boolean usaSysClassLoader,
                                boolean rintracciabile,
                                boolean nonFarloPartire,
                                java.lang.String profileFileName,
                                java.lang.String profilePassword)
                         throws java.lang.Exception

Lancia un agente, dato l'Environment del place. Come la precedente, ma ha i parametri per la sicurezza (profilo e password)

Throws:

java.lang.Exception