net.eduvax.util

Class Sequencer

java.lang.Object

net.eduvax.util.Sequencer

All Implemented Interfaces:

java.lang.Runnable

public class Sequencer
extends java.lang.Object
implements java.lang.Runnable

Permet le lancement séquentiel d'action dans un thread propre du sequenceur.

Utilisations possibles : - dialogue avec des API dont le contexte est déterminé par le thread courant. - dialogue avec API non ou partiellement réentrante (ex : API OpalRT qui n'aime pas qu'un même noeud soit piloté par plusieurs threads).

Field Summary

Fields

Modifier and Type	Field and Description
private ErrorHandler	_errHandler Gestionnaire d'erreur
private java.lang.Runnable	_nextToRun Prochaine commande à executer par le séquenceur
private boolean	_run Etat d'activité du séquenceur
(package private) java.util.Hashtable<java.lang.Runnable,java.lang.Boolean>	_runStatus Status des commande en attente et en cours
private EThread	_thread Thread propre du sequenceur.

Constructor Summary

Constructors

Constructor and Description
Sequencer(java.lang.String name) Construit un nouveau séquenceur et démarre son thread.

Method Summary

Methods

Modifier and Type	Method and Description
EThread	getThread() Obtenir le thread du sequenceur.
void	run() point d'entrée du thread du séquenceur Ne pas appeler cette méthode, il s'agit du callback pour le thread qui pilote le sequenceur.
void	run(java.lang.Runnable toRun) Demander l'execution d'un Runnable au thread du séquenceur.
boolean	run(java.lang.Runnable toRun, int timeout) Demander l'execution d'un Runnable au thread du séquenceur.
void	stop() Demander l'arrêt du séquenceur.

Methods inherited from class java.lang.Object

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

Field Detail

_thread

private EThread _thread

Thread propre du sequenceur.

_run

private boolean _run

Etat d'activité du séquenceur

_nextToRun

private java.lang.Runnable _nextToRun

Prochaine commande à executer par le séquenceur

_runStatus

java.util.Hashtable<java.lang.Runnable,java.lang.Boolean> _runStatus

Status des commande en attente et en cours

_errHandler

private ErrorHandler _errHandler

Gestionnaire d'erreur

Constructor Detail

Sequencer

public Sequencer(java.lang.String name)

Construit un nouveau séquenceur et démarre son thread.

Parameters:

nom - nom du sequenceur, le thread du sequenceur sera baptisé selon ce nom

Method Detail

stop

public void stop()

Demander l'arrêt du séquenceur.

L'arrêt est effectif à la fin de la commande en cours s'il y en a une.

getThread

public EThread getThread()

Obtenir le thread du sequenceur.

Attention, ce n'est pas pour faire n'importe quoi ! En principe on devrait se limiter à des choses relativement neutres comme getName() ou Join().

Returns:

Thread du sequenceur.

run

public void run(java.lang.Runnable toRun)

Demander l'execution d'un Runnable au thread du séquenceur.

Parameters:

toRun - Runnable à confier au sequenceur

Cet appel bloque jusqu'à ce que la commande soit traitée

run

public boolean run(java.lang.Runnable toRun,
          int timeout)

Demander l'execution d'un Runnable au thread du séquenceur.

Cet appel bloque jusqu'à ce que la commande soit traitée ou que le delai timeout soit expiré.

Parameters:

toRun - Runnable à confier au sequenceur

timeout - Délai d'attente maximal (millisecondes)

Returns:

- true : la commande a été traité - false si elle n'a pas commencé ou terminé avant expiration du délai. C'est le cas en particulier si le sequenceur est déjà arrêté.

run

public void run()

point d'entrée du thread du séquenceur

Ne pas appeler cette méthode, il s'agit du callback pour le thread qui pilote le sequenceur. Ce thread est démarré directement par le final staticructeur.

Specified by:

run in interface java.lang.Runnable