fr.ifremer.isisfish.datastore
Class SimulationStorage

java.lang.Object
  fr.ifremer.isisfish.datastore.VersionStorage
      fr.ifremer.isisfish.datastore.DataStorage
          fr.ifremer.isisfish.datastore.SimulationStorage

public class SimulationStorage
extends DataStorage

Class permettant la gestion de la persistance d'une simulation. Created: 17 août 2005 03:48:50 CEST

Version:

$Revision: 3034 $ Last update: $Date: 2010-04-29 18:14:25 +0200 (jeu., 29 avril 2010) $ by : $Author: chatellier $

Author:

Benjamin POUSSIN

Field Summary

static java.lang.String	CONTROL_FILENAME
static java.lang.String	DESIGN_PLAN_FILENAME
protected SimulationInformation	information some free information, that user can add during simulation
static java.lang.String	INFORMATION_FILENAME
static java.lang.String	LOG_CATEGORY represent the category used for logging in simulation
protected SimulationParameter	parameter
static java.lang.String	PARAMETERS_FILENAME
static java.lang.String	RESULT_EXPORT_DIRECTORY
static java.lang.String	RESULT_XML_FILENAME
protected ResultStorage	resultStorage
static java.lang.String	SENSITIVITY_RESULTS
static java.lang.String	SIMULATION_PATH
protected java.io.File	simulationControlFile
protected static java.util.Map<java.lang.String,SimulationStorage>	simulations Cache des simulation storage.
protected boolean	useLog flag to says if simulation is actually using a simulation logger

Fields inherited from class fr.ifremer.isisfish.datastore.DataStorage

DATA_BACKUP_FILENAME, memstorage, name, storage

Fields inherited from class fr.ifremer.isisfish.datastore.VersionStorage

changeListeners, file, root

Constructor Summary

protected

SimulationStorage(java.io.File directory, java.lang.String name, SimulationParameter parameter) Pour la lecture d'une simulation existante.

Method Summary

void	addSimulationLogger(java.lang.String simulLogLevel, java.lang.String scriptLogLevel, java.lang.String libLogLevel, java.lang.String threadName) This method add logger for current simulation
static void	checkout(java.lang.String name) Checkout not existing Simulation localy from server
static SimulationStorage	create(java.lang.String name, SimulationParameter parameter) Permet de créer une nouvelle simulation si la simulation existe déjà une exception est levée.
java.io.File	createZip(java.io.File file) Cree un zip.
static boolean	exists(java.lang.String name) Indique si la simulation demandée existe ou non.
void	extractRegion(java.lang.String regionName) Extract the region of a given simulation in a
protected java.lang.String	getAppenderId()
static FisheryRegion	getFisheryRegion(org.nuiton.topia.TopiaContext context) Retourne la FisheryRegion associee a cette simulation.
SimulationParameter	getForceReloadParameter() Permet de force la relecture des parametres et donc que les scripts soit charge dans le bon classloader
SimulationInformation	getInformation() Get simulation informations.
protected java.io.File	getInformationFile() Retourne le nom du fichier contenant les informations de simulation.
static java.io.File	getMexicoDesignPlan(java.io.File root) Get Mexico XML design plan file.
static java.util.List<java.lang.String>	getNewRemoteSimulationNames() Retourne la liste des noms de toutes les régions disponible sur le serveur VCS qui ne sont pas encore en local.
static java.util.List<java.lang.String>	getNewSimulationNames() Retourne la liste des noms de toutes les régions disponible en local qui ne sont pas encore sur le serveur VCS.
SimulationParameter	getParameter() Get parameter property.
static java.util.List<java.lang.String>	getRemoteSimulationNames() Retourne la liste des noms de toutes les régions disponible sur le serveur VCS.
static java.io.File	getResultExportDirectory(java.io.File root) Retourne le repertoire de stockage des exports de resultat d'une simulation.
ResultStorage	getResultStorage() Get simulation ResultStorage.
static java.io.File	getSensitivityResultsDirectory() Retourne le repertoire de base de stockage des resutats des analyses de sensibilité.
static SimulationStorage	getSimulation(java.lang.String name) Retourne la simulation demandée.
protected java.io.File	getSimulationControlFile() Retourne le fichier de stockage du fichier de control de la simulation.
protected static java.io.File	getSimulationControlFile(java.lang.String id) Retourne le fichier de stockage du fichier de control de la simulation.
static java.io.File	getSimulationDirectory() Retourne le repertoire de base de stockage des simulations.
static java.io.File	getSimulationDirectory(java.lang.String name) Retourne le repertoire de stockage d'une simulation portant le nom name.
static java.io.File	getSimulationInformationFile(java.io.File root) Retourne le fichier de stockage des inforations de la simulation.
java.lang.String	getSimulationLogFile()
static java.util.List<java.lang.String>	getSimulationNames() Retourne la liste des noms de toutes les régions disponible en local.
protected java.io.File	getSimulationParametersFile() Retourne le fichier de stockage des parametres de la simulation courante.
static java.io.File	getSimulationParametersFile(java.io.File root) Retourne le fichier de stockage des parametres de la simulation.
static java.io.File	getSimulationResultXmlFile(java.io.File root) Retourne le fichier de stockage des resultats sous format XML mexico de la simulation.
static SimulationStorage	importAndRenameZip(java.io.File directory, java.io.File file, java.lang.String newName) Import zipped simulation in specific directory, result is not put in cache.
static SimulationStorage	importAndRenameZip(java.io.File file, java.lang.String newName) Import zipped simulation.
static SimulationStorage	importZip(java.io.File file) Import zipped simulation.
protected boolean	isVersionnableFile(java.io.File file) Permet de savoir si un fichier doit etre géré par le vcs ou non.
static boolean	localyExists(java.lang.String name) Indique si la simulation demandée existe ou non.
static void	readControl(java.io.File controlFile, SimulationControl control, java.lang.String... exclude) Reli le fichier contenant les infos de SimulationControl, en excluant certain champs.
static void	readControl(java.lang.String id, SimulationControl control, java.lang.String... exclude) Relit le fichier contenant les infos de SimulationControl, en excluant certain champs.
void	removeSimulationLogger() this method remove logger for the simulation
void	rename(java.lang.String toName) Renome juste le repertoire, s'il y a besoin de modifier des données dans le TopiaContext il faut surcharger cette methode.
void	saveControl(SimulationControl control) Force la sauvegarde du fichier de control d'une simulation, ce fichier est sous la forme d'un fichier de proprietes
void	setParameter(SimulationParameter parameter) Modifie les parametres de la simulation.

Methods inherited from class fr.ifremer.isisfish.datastore.DataStorage

closeMemStorage, closeStorage, copy, createZip, createZip, delete, finalize, getDataBackupFile, getDirectory, getMemStorage, getName, getStorage, getStorageDirectory, prepare

Methods inherited from class fr.ifremer.isisfish.datastore.VersionStorage

add, addStorageChangeListener, checkout, commit, fireDataChanged, getContextDatabaseCacheKey, getContextDatabaseDirectory, getFile, getFiles, getFiles, getRemoteStorageNames, getRoot, getStorageNames, getVCS, isOnRemote, isUpToDate, removeStorageChangeListener, update

Methods inherited from class java.lang.Object

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

Field Detail

SIMULATION_PATH

public static final java.lang.String SIMULATION_PATH

See Also:

Constant Field Values

INFORMATION_FILENAME

public static final java.lang.String INFORMATION_FILENAME

See Also:

Constant Field Values

CONTROL_FILENAME

public static final java.lang.String CONTROL_FILENAME

See Also:

Constant Field Values

PARAMETERS_FILENAME

public static final java.lang.String PARAMETERS_FILENAME

See Also:

Constant Field Values

RESULT_XML_FILENAME

public static final java.lang.String RESULT_XML_FILENAME

See Also:

Constant Field Values

RESULT_EXPORT_DIRECTORY

public static final java.lang.String RESULT_EXPORT_DIRECTORY

See Also:

Constant Field Values

DESIGN_PLAN_FILENAME

public static final java.lang.String DESIGN_PLAN_FILENAME

See Also:

Constant Field Values

SENSITIVITY_RESULTS

public static final java.lang.String SENSITIVITY_RESULTS

See Also:

Constant Field Values

simulations

protected static java.util.Map<java.lang.String,SimulationStorage> simulations

Cache des simulation storage.

information

protected SimulationInformation information

some free information, that user can add during simulation

parameter

protected SimulationParameter parameter

resultStorage

protected transient ResultStorage resultStorage

LOG_CATEGORY

public static java.lang.String LOG_CATEGORY

represent the category used for logging in simulation

useLog

protected boolean useLog

flag to says if simulation is actually using a simulation logger

simulationControlFile

protected transient java.io.File simulationControlFile

Constructor Detail

SimulationStorage

protected SimulationStorage(java.io.File directory,
                            java.lang.String name,
                            SimulationParameter parameter)

Pour la lecture d'une simulation existante.

Parameters:

directory - repertoire de base du storage (inclu le nom de la sim)

name - le nom de la simulation

parameter - les paramètres de la simulation

Method Detail

getSimulationDirectory

public static java.io.File getSimulationDirectory()

Retourne le repertoire de base de stockage des simulations.

Returns:

simulation directory

getSimulationDirectory

public static java.io.File getSimulationDirectory(java.lang.String name)

Retourne le repertoire de stockage d'une simulation portant le nom name.

Parameters:

name - le nom de la simulation dont on souhaite le repertoire

Returns:

simulation name directory

getSensitivityResultsDirectory

public static java.io.File getSensitivityResultsDirectory()

Retourne le repertoire de base de stockage des resutats des analyses de sensibilité.

Returns:

sensitivity result directory

getResultExportDirectory

public static java.io.File getResultExportDirectory(java.io.File root)

Retourne le repertoire de stockage des exports de resultat d'une simulation.

Parameters:

root - le repertoire de stockage de la simulation

Returns:

result export directory

getSimulationParametersFile

public static java.io.File getSimulationParametersFile(java.io.File root)

Retourne le fichier de stockage des parametres de la simulation.

Parameters:

root - le repertoire de stockage de la simulation

Returns:

parameter file

getSimulationInformationFile

public static java.io.File getSimulationInformationFile(java.io.File root)

Retourne le fichier de stockage des inforations de la simulation.

Parameters:

root - le repertoire de stockage de la simulation

Returns:

information file

getSimulationResultXmlFile

public static java.io.File getSimulationResultXmlFile(java.io.File root)

Retourne le fichier de stockage des resultats sous format XML mexico de la simulation.

Parameters:

root - le repertoire de stockage de la simulation

Returns:

mexico xml file

getSimulationParametersFile

protected java.io.File getSimulationParametersFile()

Retourne le fichier de stockage des parametres de la simulation courante.

Returns:

parameter file

getMexicoDesignPlan

public static java.io.File getMexicoDesignPlan(java.io.File root)

Get Mexico XML design plan file.

Parameters:

root - le repertoire de stockage de la simulation

Returns:

a File even if file doesn't exist

getSimulationControlFile

protected java.io.File getSimulationControlFile()

Retourne le fichier de stockage du fichier de control de la simulation. Ce fichier conserve l'etat de la simulation, cela permet a un processus externe de connaitre l'etat d'une simulation distante.

Returns:

simulation control file

getSimulationControlFile

protected static java.io.File getSimulationControlFile(java.lang.String id)

Retourne le fichier de stockage du fichier de control de la simulation. Ce fichier conserve l'etat de la simulation, cela permet a un processus externe de connaitre l'etat d'une simulation distante.

Returns:

simulation control file

saveControl

public void saveControl(SimulationControl control)

Force la sauvegarde du fichier de control d'une simulation, ce fichier est sous la forme d'un fichier de proprietes

Parameters:

control - l'objet control de la simulation courante

readControl

public static void readControl(java.lang.String id,
                               SimulationControl control,
                               java.lang.String... exclude)

Relit le fichier contenant les infos de SimulationControl, en excluant certain champs.

Parameters:

id - l'identifiant de la simulation a lire

control - le control a mettre a jour en fonction de ce qui est lu

exclude - les champs a exclure

readControl

public static void readControl(java.io.File controlFile,
                               SimulationControl control,
                               java.lang.String... exclude)

Reli le fichier contenant les infos de SimulationControl, en excluant certain champs.

Parameters:

controlFile - le fichier de control

control - le control a mettre a jour en fonction de ce qui est lu

exclude - les champs a exclure

setParameter

public void setParameter(SimulationParameter parameter)

Modifie les parametres de la simulation.

Parameters:

parameter - les nouveaux parametres

getParameter

public SimulationParameter getParameter()

Get parameter property.

Returns:

Parameter property.

getForceReloadParameter

public SimulationParameter getForceReloadParameter()

Permet de force la relecture des parametres et donc que les scripts soit charge dans le bon classloader

Returns:

les paramètres de la simulation après opération

getInformationFile

protected java.io.File getInformationFile()

Retourne le nom du fichier contenant les informations de simulation.

Returns:

information file

getInformation

public SimulationInformation getInformation()

Get simulation informations.

Returns:

simulation information

getResultStorage

public ResultStorage getResultStorage()

Get simulation ResultStorage.

Returns:

le ResultStorage a utiliser pour cette simulation

exists

public static boolean exists(java.lang.String name)

Indique si la simulation demandée existe ou non.

Parameters:

name - le nom de la simulation à tester

Returns:

true si la simulation existe déjà

localyExists

public static boolean localyExists(java.lang.String name)

Indique si la simulation demandée existe ou non.

Parameters:

name - le nom de la simulation à tester

Returns:

true si la simulation existe déjà

getSimulation

public static SimulationStorage getSimulation(java.lang.String name)

Retourne la simulation demandée.

Parameters:

name - name of the required simulation

Returns:

la simulation souhaitée ou null si la simulation n'existe pas

create

public static SimulationStorage create(java.lang.String name,
                                       SimulationParameter parameter)
                                throws StorageException

Permet de créer une nouvelle simulation si la simulation existe déjà une exception est levée.

Parameters:

name - le nom de la simulation

parameter - Les parametres de la simulation

Returns:

la nouvelle simulation

Throws:

StorageException - si problème lors de la création du storage

java.lang.IllegalArgumentException - si le nom existe déjà en tant que simulation

getSimulationNames

public static java.util.List<java.lang.String> getSimulationNames()

Retourne la liste des noms de toutes les régions disponible en local.

Returns:

la liste des noms de toutes les régions disponible en local

getNewSimulationNames

public static java.util.List<java.lang.String> getNewSimulationNames()

Retourne la liste des noms de toutes les régions disponible en local qui ne sont pas encore sur le serveur VCS.

Returns:

liste de noms de simulations

getRemoteSimulationNames

public static java.util.List<java.lang.String> getRemoteSimulationNames()

Retourne la liste des noms de toutes les régions disponible sur le serveur VCS.

Returns:

la liste des noms de toutes les régions disponible sur le serveur VCS. Si le serveur n'est pas disponible la liste retournée est vide.

getNewRemoteSimulationNames

public static java.util.List<java.lang.String> getNewRemoteSimulationNames()

Retourne la liste des noms de toutes les régions disponible sur le serveur VCS qui ne sont pas encore en local.

Returns:

liste de noms de simulations

getFisheryRegion

public static FisheryRegion getFisheryRegion(org.nuiton.topia.TopiaContext context)
                                      throws StorageException

Retourne la FisheryRegion associee a cette simulation.

Parameters:

context - context

Returns:

simulation's FisheryRegion

Throws:

StorageException

checkout

public static void checkout(java.lang.String name)
                     throws VCSException,
                            org.nuiton.topia.TopiaException

Checkout not existing Simulation localy from server

Parameters:

name - name of simulation to retrieve

Throws:

VCSException - si problème avec le VCS

org.nuiton.topia.TopiaException - si problème lors de l'opération sur la base embarquée

rename

public void rename(java.lang.String toName)
            throws StorageException

Description copied from class: DataStorage

Renome juste le repertoire, s'il y a besoin de modifier des données dans le TopiaContext il faut surcharger cette methode. Il est surement necessaire de surcharger cette methode pour aussi modifier l'entre qu'il y a dans le cache.

Overrides:

rename in class DataStorage

Parameters:

toName - le nouveau nom

Throws:

StorageException - si problème lors du renommage

importZip

public static SimulationStorage importZip(java.io.File file)
                                   throws java.io.IOException,
                                          org.nuiton.topia.TopiaException

Import zipped simulation.

Parameters:

file - zipped region file

Returns:

region storage or null

Throws:

java.io.IOException - si problème IO lors de la lecture du zip

org.nuiton.topia.TopiaException - si problème lors de la création du contexte

importAndRenameZip

public static SimulationStorage importAndRenameZip(java.io.File file,
                                                   java.lang.String newName)
                                            throws java.io.IOException,
                                                   org.nuiton.topia.TopiaException

Import zipped simulation.

Parameters:

file - zipped region file

newName - new name for the imported simulation

Returns:

region storage or null

Throws:

java.io.IOException - si problème IO lors de la lecture du zip

org.nuiton.topia.TopiaException - si problème lors de la création du contexte

importAndRenameZip

public static SimulationStorage importAndRenameZip(java.io.File directory,
                                                   java.io.File file,
                                                   java.lang.String newName)
                                            throws java.io.IOException,
                                                   org.nuiton.topia.TopiaException

Import zipped simulation in specific directory, result is not put in cache.

Parameters:

directory - where we want new simulation storage

file - zipped region file

newName - new name for the imported simulation

Returns:

region storage or null

Throws:

java.io.IOException - si problème IO lors de la lecture du zip

org.nuiton.topia.TopiaException - si problème lors de la création du contexte

extractRegion

public void extractRegion(java.lang.String regionName)
                   throws StorageException

Extract the region of a given simulation in a

Parameters:

regionName - the name of the region to export

Throws:

StorageException - if any problem while operation

addSimulationLogger

public void addSimulationLogger(java.lang.String simulLogLevel,
                                java.lang.String scriptLogLevel,
                                java.lang.String libLogLevel,
                                java.lang.String threadName)

This method add logger for current simulation

Parameters:

simulLogLevel - required min level for simulator logger

threadName - name of the thread to log (simulation thread)

scriptLogLevel - required min level fro scripts logger

libLogLevel - required min level for libraries logger

removeSimulationLogger

public void removeSimulationLogger()

this method remove logger for the simulation

getAppenderId

protected java.lang.String getAppenderId()

Returns:

the appender id used for this simulation (simulation_name.hashcode())

getSimulationLogFile

public java.lang.String getSimulationLogFile()

Returns:

the simulation log file

createZip

public java.io.File createZip(java.io.File file)
                       throws java.io.IOException

Description copied from class: DataStorage

Cree un zip. Le zip contient les memes fichiers lorsqu'on utilise le CVS.

Overrides:

createZip in class DataStorage

Parameters:

file - le fichier dans lequel l'export doit se faire

Returns:

l'argument file

Throws:

java.io.IOException - si problème lors de la création du zip

isVersionnableFile

protected boolean isVersionnableFile(java.io.File file)

Description copied from class: VersionStorage

Permet de savoir si un fichier doit etre géré par le vcs ou non. L'implantation par defaut exclus les répertoires VCS, il faut toujours appeler le super si on surcharge la methode.

Overrides:

isVersionnableFile in class DataStorage

Parameters:

file - le fichier a tester

Returns:

true si le fichier est versionné