flux
Class MultiSource

java.lang.Object
  java.lang.Thread
      flux.MultiSource

All Implemented Interfaces:

BoxModelObject, IFlux, java.awt.event.ActionListener, java.io.Serializable, java.lang.Runnable, java.util.EventListener

public class MultiSource
extends java.lang.Thread
implements IFlux, BoxModelObject, java.awt.event.ActionListener

Met à disposition un tampon assurant la prise de données en temps rèèl. Un Thread gère le calcul sur les donnés;es reçues.

Version:

2.11, 10/21/2004

Author:

Laurent JEANPIERRE

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

java.lang.Thread.State, java.lang.Thread.UncaughtExceptionHandler

Field Summary

static java.lang.String

description Renvoie une chaîne décrivant le rôle de la boîte.

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Constructor Summary

MultiSource()
Construit la source des flux

MultiSource(ObjectDrawingFrame odf, java.util.Collection data)

Method Summary

void	actionPerformed(java.awt.event.ActionEvent e)
void	add(int entree, java.lang.Object valeur) Introduit une donnée dans cette section du flux.
void	addBlock(int entree, java.util.Collection valeur) Introduit un bloc de données dans cette section du flux.
void	addFlux(java.lang.Class type) Ajoute un flux à la source.
void	addFlux(java.lang.Class type, java.lang.String descriptif) Ajoute un flux à la source.
void	changeEntryType(int no, java.lang.Class type) Modifie le type dynamique du flux.
void	changeExitType(int no, java.lang.Class type) Modifie le type dynamique du flux.
void	connect(IFlux autre) Connecte la sortie du flux à l'entrée d'une autre section du flux.
void	connect(IFlux autre, int entree) Connecte la sortie du flux à une entrée d'une autre section du flux.
void	connect(int sortie, IFlux autre) Connecte l'une des sorties du flux à l'entrée d'une autre section du flux.
void	connect(int sortie, IFlux autre, int entree) Connecte l'une des sorties du flux à une entrée d'une autre section du flux.
void	connectBack(int entree, IFlux autre, int sortie) Connecte l'une des entrées du flux à une sortie d'une autre section du flux afin d'obtenir un flux bidirectionnel.
java.lang.String	descriptionEntree(int no) Retourne la description de l'une des broches d'entrée.
java.lang.String	descriptionSortie(int no) Retourne la description de l'une des broches de sortie.
java.lang.String	descriptionUtilise(int no) Retourne la description de l'une des broches d'utilisation.
void	disconnect(int index) disconnect la sortie index.
int	donneesEnAttente() Indique le nombre de données en attente dans la source.
void	drawRealObject(java.awt.Graphics g) Dessine l'objet visuel sur le contexte passé en paramètre.
void	dumpLocks() Liste les modules ayant vérrouillé ce module.
void	generateCode(java.io.FileWriter file) Code for initialisation overriding method in BoxModelObject *
void	generateConnections(java.io.FileWriter file) Code for the connections generated by individual connections *
BoxObject	getBox() Renvoie la boîte associée au modèle durant le design.
BuildingPanel	getBuildingPanel(boolean lockedBox) Renvoie le panneau de construction de ce modèle.
javax.swing.JPanel	getDebugPanel() Renvoie un JPanel permettant d'agir sur le fonctionnement du module.
Entree	getEntry(int index) Recupère l'interface de l'une des entrées.
int	getEntryNb() Combien d'entrées sont disponibles ?
java.lang.Class	getEntryType(int no) Renvoie le type des entrées du flux.
Sortie	getExit(int index) Renvoie la sortie dont le numéro est specifié
int	getExitNb() Combien de sorties sont disponibles ?
java.lang.Class	getExitType(int no) Renvoie le type des sorties du flux.
BoxModelObject	getUse(int broche) Renvoie l'un des objets en cours d'utilisation.
int	getUseNb() Combien de broches d'utilisation sont disponibles ?
java.lang.Class	getUseType(int no) Renvoie le type des broches d'utilisation du flux.
boolean	isUsing(int broche) Indique si la broche est en cours d'utilisation.
void	lock(java.lang.Object qui) Verrouille l'objet pour modification
void	raz(int entree) Signale une remise à zéro du flux.
void	razBlock(int entree, java.util.Collection valeur) Modifie les données.
void	reset() Supprime toutes les données et repart à zéro.
void	restart() Rejoue une séquece mémorisée au préalable.
java.lang.Class	retourAutorise(int no) Indique pour quel type de boîte connectée à l'une des broches d'entrée un retour est autorisé.
void	reveil() Reveille la source pour qu'elle evoie les données en attente.
void	run()
void	sauvegarde_donnees(java.io.Writer fic) Sauvegarde les données du flux dans fic.
void	setBox(BoxObject with) Associe le modèle avec une boîte à user durant le design.
void	setMemoriser() Indique qu'il est nécessaire de mémoriser toutes les données pour usage ultérieur.
IFlux	twin() Crée un clone du flux courant.
void	unlock(java.lang.Object qui) Deverrouille l'objet en fin de modification
void	unUse(int broche) Libère la broche.
void	use(int broche, java.lang.Object autre) Connecte l'une des broches du flux à un autre objet du flux.

Methods inherited from class java.lang.Thread

activeCount, checkAccess, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

description

public static java.lang.String description

Renvoie une chaîne décrivant le rôle de la boîte.

Constructor Detail

MultiSource

public MultiSource(ObjectDrawingFrame odf,
                   java.util.Collection data)

MultiSource

public MultiSource()

Construit la source des flux

Method Detail

sauvegarde_donnees

public void sauvegarde_donnees(java.io.Writer fic)
                        throws java.io.IOException

Sauvegarde les données du flux dans fic. La sauvegarde est faite en ASCII.

Specified by:

sauvegarde_donnees in interface BoxModelObject

Parameters:

fic - le Writer dans lequel il faut écrire.

Throws:

java.io.IOException

setMemoriser

public void setMemoriser()

Indique qu'il est nécessaire de mémoriser toutes les données pour usage ultérieur.

addFlux

public void addFlux(java.lang.Class type)

Ajoute un flux à la source.

Parameters:

type - le type du flux à bufferiser.

addFlux

public void addFlux(java.lang.Class type,
                    java.lang.String descriptif)

Ajoute un flux à la source.

Parameters:

type - le type du flux à bufferiser.

descriptif - un String décrivant le canal.

getDebugPanel

public javax.swing.JPanel getDebugPanel()

Renvoie un JPanel permettant d'agir sur le fonctionnement du module.

Specified by:

getDebugPanel in interface IFlux

Returns:

null si aucun panneau n'est disponible.

actionPerformed

public void actionPerformed(java.awt.event.ActionEvent e)

Specified by:

actionPerformed in interface java.awt.event.ActionListener

getExitNb

public final int getExitNb()

Combien de sorties sont disponibles ?

Specified by:

getExitNb in interface IFlux

Returns:

le nombre de sorties disponibles.

getExitType

public final java.lang.Class getExitType(int no)
                                  throws java.lang.IllegalArgumentException

Renvoie le type des sorties du flux.

Specified by:

getExitType in interface IFlux

Parameters:

no - le numéro de la sortie interrogé

Returns:

la Class correspondant à la sortie no.

Throws:

java.lang.IllegalArgumentException - si no n'est pas entre 0 et getExitNb()-1.

getEntryNb

public final int getEntryNb()

Combien d'entrées sont disponibles ?

Specified by:

getEntryNb in interface IFlux

Returns:

le nombre d'entrées disponibles.

getEntryType

public final java.lang.Class getEntryType(int no)
                                   throws java.lang.IllegalArgumentException

Renvoie le type des entrées du flux.

Specified by:

getEntryType in interface IFlux

Parameters:

no - le numéro de l'entrée interrogé

Returns:

la Class correspondant à l'entrée no.

Throws:

java.lang.IllegalArgumentException - si no n'est pas entre 0 et getEntryNb()-1.

lock

public void lock(java.lang.Object qui)

Verrouille l'objet pour modification

Specified by:

lock in interface IFlux

Parameters:

qui - la référence de l'appelant

unlock

public void unlock(java.lang.Object qui)
            throws java.lang.IllegalAccessException

Deverrouille l'objet en fin de modification

Specified by:

unlock in interface IFlux

Parameters:

qui - la référence de l'appelant

Throws:

java.lang.IllegalAccessException - si qui n'a pas verrouillé ce flux.

connect

public final void connect(int sortie,
                          IFlux autre,
                          int entree)
                   throws java.lang.IllegalArgumentException

Connecte l'une des sorties du flux à une entrée d'une autre section du flux.

Specified by:

connect in interface IFlux

Parameters:

sortie - le numéro de la sortie à connect.

autre - la section de flux à connect à la sortie.

entree - le numéro de l'entrée de autre à connect sur la sortie.

Throws:

java.lang.IllegalArgumentException - si sortie n'est pas entre 0 et getExitNb()-1.

java.lang.IllegalArgumentException - si entree n'est pas entre 0 et autre.getEntryNb()-1.

java.lang.IllegalArgumentException - si le type de l'entrée ne correspond pas au type de la sortie.

connect

public final void connect(IFlux autre,
                          int entree)
                   throws java.lang.IllegalArgumentException

Connecte la sortie du flux à une entrée d'une autre section du flux.

Parameters:

autre - la section de flux à connect à la sortie.

entree - le numéro de l'entrée de autre à connect sur la sortie.

Throws:

java.lang.IllegalArgumentException - si le flux a plus d'une sortie.

java.lang.IllegalArgumentException - si entree n'est pas entre 0 et autre.getEntryNb()-1.

java.lang.IllegalArgumentException - si le type de l'entrée ne correspond pas au type de la sortie.

connect

public final void connect(IFlux autre)
                   throws java.lang.IllegalArgumentException

Connecte la sortie du flux à l'entrée d'une autre section du flux.

Parameters:

autre - la section de flux à connect à la sortie.

Throws:

java.lang.IllegalArgumentException - si le flux a plus d'une sortie.

java.lang.IllegalArgumentException - si autre a plus d'une entré.

java.lang.IllegalArgumentException - si le type de l'entrée ne correspond pas au type de la sortie.

connect

public final void connect(int sortie,
                          IFlux autre)
                   throws java.lang.IllegalArgumentException

Connecte l'une des sorties du flux à l'entrée d'une autre section du flux.

Parameters:

sortie - le numéro de la sortie à connect.

autre - la section de flux à connect à la sortie.

Throws:

java.lang.IllegalArgumentException - si sortie n'est pas entre 0 et getExitNb()-1.

java.lang.IllegalArgumentException - si autre a plus d'une entré.

java.lang.IllegalArgumentException - si le type de l'entrée ne correspond pas au type de la sortie.

changeEntryType

public void changeEntryType(int no,
                            java.lang.Class type)
                     throws java.lang.IllegalAccessException

Modifie le type dynamique du flux.

Specified by:

changeEntryType in interface IFlux

Parameters:

no - le numéro de l'entrée à modifier.

type - le type dynamique de cette entrée

Throws:

java.lang.IllegalAccessException - si cette entrée est incompatible avec type

changeExitType

public void changeExitType(int no,
                           java.lang.Class type)
                    throws java.lang.IllegalAccessException

Modifie le type dynamique du flux.

Specified by:

changeExitType in interface IFlux

Parameters:

no - le numéro de la sortie à modifier.

type - le type dynamique de cette sortie

Throws:

java.lang.IllegalAccessException - si cette sortie est incompatible avec type

getExit

public Sortie getExit(int index)

Renvoie la sortie dont le numéro est specifié

Specified by:

getExit in interface IFlux

Parameters:

index - le numéro de la sortie à recupèrer.

Returns:

une Sortie correspondant au numéro demandé, ou null si elle n'existe pas.

getEntry

public Entree getEntry(int index)

Recupère l'interface de l'une des entrées.

Specified by:

getEntry in interface IFlux

Parameters:

index - le numéro de l'entrées à récupérer.

Returns:

l'Entree gèrant cette entrées.

Throws:

java.lang.IllegalArgumentException - si index n'est pas entre 0 et getEntryNb()-1.

disconnect

public void disconnect(int index)

disconnect la sortie index.

Specified by:

disconnect in interface IFlux

Parameters:

index - le numéro de la sortie à deconnect.

Throws:

java.lang.IllegalArgumentException - si index n'est pas entre 0 et getExitNb()-1.

twin

public IFlux twin()

Crée un clone du flux courant. Toutes les caractèristiques seront recopiées. Aucun lien avec d'autres flux ne sera copié.

Specified by:

twin in interface IFlux

dumpLocks

public void dumpLocks()

Description copied from interface: IFlux

Liste les modules ayant vérrouillé ce module. Pour débogage.

Specified by:

dumpLocks in interface IFlux

getUseNb

public int getUseNb()

Combien de broches d'utilisation sont disponibles ?

Specified by:

getUseNb in interface IFlux

Returns:

le nombre de broches disponibles.

getUseType

public java.lang.Class getUseType(int no)
                           throws java.lang.IllegalArgumentException

Renvoie le type des broches d'utilisation du flux.

Specified by:

getUseType in interface IFlux

Parameters:

no - le numéro de la broche interrogé

Returns:

la Class correspondant à la broche no.

Throws:

java.lang.IllegalArgumentException - si no n'est pas entre 0 et getUseNb()-1.

use

public void use(int broche,
                java.lang.Object autre)
         throws java.lang.IllegalArgumentException

Connecte l'une des broches du flux à un autre objet du flux.

Specified by:

use in interface IFlux

Parameters:

broche - le numéro de la broche à connect.

autre - l'objet à user

Throws:

java.lang.IllegalArgumentException - si broche n'est pas entre 0 et getUseNb()-1.

java.lang.IllegalArgumentException - si le type de autre ne correspond pas au type de la broche.

descriptionUtilise

public java.lang.String descriptionUtilise(int no)

Retourne la description de l'une des broches d'utilisation.

Specified by:

descriptionUtilise in interface BoxModelObject

Parameters:

no - un entier contenant le numéro de la broche à interroger.

isUsing

public boolean isUsing(int broche)
                throws java.lang.IllegalArgumentException

Indique si la broche est en cours d'utilisation.

Specified by:

isUsing in interface IFlux

Parameters:

broche - le numéro de la broche à tester.

Throws:

java.lang.IllegalArgumentException - si broche n'est pas entre 0 et getUseNb()-1.

unUse

public void unUse(int broche)
           throws java.lang.IllegalArgumentException

Libère la broche.

Specified by:

unUse in interface IFlux

Parameters:

broche - le numéro de la broche à déconnect.

Throws:

java.lang.IllegalArgumentException - si broche n'est pas entre 0 et getUseNb()-1.

getUse

public BoxModelObject getUse(int broche)
                      throws java.lang.IllegalArgumentException

Renvoie l'un des objets en cours d'utilisation.

Specified by:

getUse in interface IFlux

Parameters:

broche - le numéro de la broche à tester.

Throws:

java.lang.IllegalArgumentException - si broche n'est pas entre 0 et getUseNb()-1.

retourAutorise

public java.lang.Class retourAutorise(int no)

Indique pour quel type de boîte connectée à l'une des broches d'entrée un retour est autorisé.

Specified by:

retourAutorise in interface BoxModelObject

Parameters:

no - un entier contenant le numéro de la broche à interroger.

Returns:

la classe dont doit dériver un module pour accepter ce retour. null si aucun retour n'est autorisé

connectBack

public void connectBack(int entree,
                        IFlux autre,
                        int sortie)
                 throws java.lang.IllegalArgumentException

Connecte l'une des entrées du flux à une sortie d'une autre section du flux afin d'obtenir un flux bidirectionnel.

Specified by:

connectBack in interface IFlux

Parameters:

entree - le numéro de l'entrée à connect sur la sortie.

autre - la section de flux à connect à la sortie.

sortie - le numéro de la sortie de autre à connect.

Throws:

java.lang.IllegalArgumentException - si entree n'est pas entre 0 et getEntryNb()-1.

java.lang.IllegalArgumentException - si sortie n'est pas entre 0 et autre.getExitNb()-1.

java.lang.IllegalArgumentException - si le type de autre n'est pas acceptable pour un retour.

add

public void add(int entree,
                java.lang.Object valeur)

Introduit une donnée dans cette section du flux.

Specified by:

add in interface IFlux

Parameters:

entree - le numéro de l'entrée à remplir.

valeur - la donnée. Elle doit se conformer au type getEntryType(entree).

addBlock

public void addBlock(int entree,
                     java.util.Collection valeur)

Introduit un bloc de données dans cette section du flux.

Specified by:

addBlock in interface IFlux

Parameters:

entree - le numéro de l'entrée à remplir.

valeur - les données. Elles doivent toutes se conformer au type getEntryType(entree).

razBlock

public void razBlock(int entree,
                     java.util.Collection valeur)

Modifie les données. Equivalent à un raz + addBloc.

Specified by:

razBlock in interface IFlux

Parameters:

entree - le numéro de l'entrée à actualiser.

valeur - le bloc de valeurs à envoyer.

raz

public void raz(int entree)

Signale une remise à zéro du flux.

Specified by:

raz in interface IFlux

Parameters:

entree - le numéro de l'entrée à réinitialiser.

donneesEnAttente

public int donneesEnAttente()

Indique le nombre de données en attente dans la source.

Returns:

un int correspondant au nombre de données en attente.

run

public void run()

Specified by:

run in interface java.lang.Runnable

Overrides:

run in class java.lang.Thread

restart

public void restart()
             throws java.lang.IllegalAccessException

Rejoue une séquece mémorisée au préalable.

Throws:

java.lang.IllegalAccessException - si aucune séquence n'est mémorisée.

reveil

public void reveil()

Reveille la source pour qu'elle evoie les données en attente.

reset

public void reset()

Supprime toutes les données et repart à zéro.

getBox

public BoxObject getBox()

Renvoie la boîte associée au modèle durant le design.

Specified by:

getBox in interface BoxModelObject

Returns:

un BoxObject correspondant à l'interface entre le IFlux et l'application de design.

setBox

public void setBox(BoxObject with)

Associe le modèle avec une boîte à user durant le design.

Specified by:

setBox in interface BoxModelObject

Parameters:

with - un BoxObject contenant les donnés;es de l'interface visuelle.

generateCode

public void generateCode(java.io.FileWriter file)

Code for initialisation overriding method in BoxModelObject *

Specified by:

generateCode in interface BoxModelObject

Parameters:

file - le fichier dans le quel le code sera écrit.

generateConnections

public void generateConnections(java.io.FileWriter file)

Code for the connections generated by individual connections *

Specified by:

generateConnections in interface BoxModelObject

Parameters:

file - le fichier dans le quel le code sera écrit.

drawRealObject

public void drawRealObject(java.awt.Graphics g)

Dessine l'objet visuel sur le contexte passé en paramètre.

Specified by:

drawRealObject in interface BoxModelObject

Parameters:

g - le contexte graphique sur lequel il faut dessiner.

getBuildingPanel

public BuildingPanel getBuildingPanel(boolean lockedBox)

Renvoie le panneau de construction de ce modèle.

Specified by:

getBuildingPanel in interface BoxModelObject

Parameters:

lockedBox - Vrai si les connections du modèle ne doivent être modifiées.

Returns:

une instance de BuildingPanel sp&eactue;cialisée dans la création de ce modèle.

descriptionEntree

public java.lang.String descriptionEntree(int no)

Retourne la description de l'une des broches d'entrée.

Specified by:

descriptionEntree in interface BoxModelObject

Parameters:

no - un entier contenant le numéro de la broche à interroger.

descriptionSortie

public java.lang.String descriptionSortie(int no)

Retourne la description de l'une des broches de sortie.

Specified by:

descriptionSortie in interface BoxModelObject

Parameters:

no - un entier contenant le numéro de la broche à interroger.