jus.util
Class Dialogue

java.lang.Object
  extended by jus.util.Dialogue

public class Dialogue
extends java.lang.Object

Dialogue organise les entrées/sorties simples en masquant les difficultés (exceptions) liées à la gestion standard des entrées/sorties dans la librairie `Java`. Un dialogue peut utiliser 3 supports différents en entrée et en sortie (combinables entre eux)

    - le standard input ou output
    - un fichier
    - un widget (fenêtre graphique)
 

Version:
1.0 14 octobre 1999, 2.0 P.Morat 20 mai 2003, 3.0 P.Morat 16 janvier 2005
Author:
Xavier Girod

Field Summary
 char EOF
          la fin de fichier
 
Constructor Summary
Dialogue()
          Création d'un dialogue pour la communication avec l'utilisateeur
 
Method Summary
 void afficher(java.lang.Object aImprimer)
          Imprime la donnée à la position actuelle du curseur, sans générer de saut de ligne après l'impression.
 void afficherln(java.lang.Object aImprimer)
          Imprime la donnée à la position actuelle du curseur et génère de saut de ligne après l'impression.
 void attendre()
          Attente d'une sollicitation à continuer
 void attendre(java.lang.Object verrou)
          Attente d'une sollicitation à continuer
 void attendreRetour()
          Affiche la chaine "Taper pour continuer" et attend la réponse de l'utilisateur.
 void bip()
          Emission d'un "bip" au terminal
 void continuer()
          Sollicitation à continuer
 void continuer(java.lang.Object verrou)
          Sollicitation à continuer
 java.lang.String format(java.lang.Object s, java.lang.String pattern)
          Mise en forme d'une donnée
 boolean lireBoolean()
          Permet la saisie au clavier d'un booléen, avec une grande variété de possibilités : v[rai] f[aux] V[RAI] F[AUX] t[rue] f[alse] T[RUE] F[ALSE] o[ui] n[on] O[UI] N[ON] y[es] n[o] Y[ES] N[O]
 boolean lireBoolean(java.lang.String texteQuestion)
          Pose la question `question` et attend une réponse booléenne.
 byte lireByte()
          Acquiert la prochaine ligne entrée au clavier et l'interprète comme un byte.
 byte lireByte(java.lang.String prompt)
          Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier.
 char lireChar()
          Lit le texte tapé par l'opérateur jusqu'au prochain .
 char lireChar(java.lang.String prompt)
          Affiche prompt et lit le texte tapé par l'opérateur jusqu'au prochain Retour chariot.
 double lireDouble()
          Acquiert la prochaine ligne entrée au clavier et l'interprète comme un flottant.
 double lireDouble(java.lang.String prompt)
          Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un flottant.
<T extends java.lang.Enum<T>>
T
lireEnum(java.lang.Class<T> classe)
          Acquiert la prochaine ligne entrée au clavier et l'interprète comme une valeur énumérée.
<T extends java.lang.Enum<T>>
T
lireEnum(java.lang.Class<T> type, java.lang.String prompt)
          Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme une valeur énumérée.
<T extends java.lang.Enum<T>>
T
lireEnum(java.lang.String classe)
           
 float lireFloat()
          Acquiert la prochaine ligne entrée au clavier et l'interprète comme un flottant.
 float lireFloat(java.lang.String prompt)
          Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un flottant.
 int lireInt()
          Acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier.
 int lireInt(java.lang.String prompt)
          Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier.
 long lireLong()
          Acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier.
 long lireLong(java.lang.String prompt)
          Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier.
 short lireShort()
          Acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier.
 short lireShort(java.lang.String prompt)
          Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier.
 java.lang.String lireString()
          Lit le texte tapé par l'opérateur jusqu'au prochain .
 java.lang.String lireString(java.lang.String prompt)
          Affiche prompt et lit le texte tapé par l'opérateur jusqu'au prochain Retour chariot.
 void ln()
          imprime 1 ligne blanche
 void ln(int nb)
          imprime nb lignes blanches
 void print(java.lang.Object aImprimer)
           
 void println()
           
 void println(java.lang.Object aImprimer)
           
 boolean readBoolean()
           
 boolean readBoolean(java.lang.String prompt)
           
 byte readByte()
           
 byte readByte(java.lang.String prompt)
           
 char readChar()
           
 char readChar(java.lang.String prompt)
           
 double readDouble()
           
 double readDouble(java.lang.String prompt)
           
<T extends java.lang.Enum<T>>
T
readEnum(java.lang.Class<T> classe)
           
<T extends java.lang.Enum<T>>
T
readEnum(java.lang.Class<T> classe, java.lang.String prompt)
           
<T extends java.lang.Enum<T>>
T
readEnum(java.lang.String classe)
           
 float readFloat()
           
 float readFloat(java.lang.String prompt)
           
 int readInt()
           
 int readInt(java.lang.String prompt)
           
 long readLong()
           
 long readLong(java.lang.String prompt)
           
 short readShort()
           
 short readShort(java.lang.String prompt)
           
 java.lang.String readString()
           
 java.lang.String readString(java.lang.String prompt)
           
 void resetIn()
          fixe l'entrée sur l'entrée standard
 void resetOut()
          fixe la sortie sur la sortie standard
 void setIn()
          fixe l'entrée sur une fenêtre graphique modale indépendante
 void setIn(java.io.Reader reader)
          fixe l'entrée sur un reader
 void setIn(java.lang.String file)
          fixe l'entrée sur un fichier
 void setOut()
          fixe la sortie sur une fenêtre graphique indépendante
 void setOut(java.lang.String file)
          fixe la sortie sur un fichier
 void setOut(java.io.Writer writer)
          fixe la sortie sur un writer
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

EOF

public char EOF
la fin de fichier

Constructor Detail

Dialogue

public Dialogue()
Création d'un dialogue pour la communication avec l'utilisateeur

Method Detail

setIn

public void setIn()
fixe l'entrée sur une fenêtre graphique modale indépendante


setIn

public void setIn(java.io.Reader reader)
fixe l'entrée sur un reader

Parameters:
reader - le reader associé à l'entrée

setIn

public void setIn(java.lang.String file)
fixe l'entrée sur un fichier

Parameters:
file - le fichier d'entrée

setOut

public void setOut()
fixe la sortie sur une fenêtre graphique indépendante


setOut

public void setOut(java.io.Writer writer)
fixe la sortie sur un writer

Parameters:
writer - le writer de sortie

setOut

public void setOut(java.lang.String file)
fixe la sortie sur un fichier

Parameters:
file - le fichier de sortie

resetIn

public void resetIn()
fixe l'entrée sur l'entrée standard


resetOut

public void resetOut()
fixe la sortie sur la sortie standard


afficher

public void afficher(java.lang.Object aImprimer)
Imprime la donnée à la position actuelle du curseur, sans générer de saut de ligne après l'impression.

Parameters:
aImprimer - la donnée à imprimer

print

public void print(java.lang.Object aImprimer)

afficherln

public void afficherln(java.lang.Object aImprimer)
Imprime la donnée à la position actuelle du curseur et génère de saut de ligne après l'impression.

Parameters:
aImprimer - la donnée à imprimer

println

public void println(java.lang.Object aImprimer)

ln

public void ln()
imprime 1 ligne blanche


println

public void println()

ln

public void ln(int nb)
imprime nb lignes blanches

Parameters:
nb - le nombre de lignes

bip

public void bip()
Emission d'un "bip" au terminal


attendreRetour

public void attendreRetour()
Affiche la chaine "Taper pour continuer" et attend la réponse de l'utilisateur.


attendre

public void attendre(java.lang.Object verrou)
Attente d'une sollicitation à continuer

Parameters:
verrou - le verrou d'attente

attendre

public void attendre()
Attente d'une sollicitation à continuer


continuer

public void continuer(java.lang.Object verrou)
Sollicitation à continuer

Parameters:
verrou - le verrou d'attente

continuer

public void continuer()
Sollicitation à continuer


lireChar

public char lireChar()
Lit le texte tapé par l'opérateur jusqu'au prochain . Retourne la chaine saisie, une chaine vide en cas d'erreur

Returns:
la donnée lue

readChar

public char readChar()

lireChar

public char lireChar(java.lang.String prompt)
Affiche prompt et lit le texte tapé par l'opérateur jusqu'au prochain Retour chariot. Retourne la chaine saisie, une chaine vide en cas d'erreur

Parameters:
prompt - l'invite pour l'utilisateur
Returns:
la donnée lue

readChar

public char readChar(java.lang.String prompt)

lireString

public java.lang.String lireString()
Lit le texte tapé par l'opérateur jusqu'au prochain . Retourne la chaine saisie, une chaine vide en cas d'erreur

Returns:
la donnée lue

readString

public java.lang.String readString()

lireString

public java.lang.String lireString(java.lang.String prompt)
Affiche prompt et lit le texte tapé par l'opérateur jusqu'au prochain Retour chariot. Retourne la chaine saisie, une chaine vide en cas d'erreur

Parameters:
prompt - l'invite pour l'utilisateur
Returns:
la donnée lue

readString

public java.lang.String readString(java.lang.String prompt)

lireBoolean

public boolean lireBoolean(java.lang.String texteQuestion)
Pose la question `question` et attend une réponse booléenne. Retourne `true` ou `false` suivant la réponse donnée. une grande latitude dans les réponses est possible : v[rai] f[aux] V[RAI] F[AUX] t[rue] f[alse] T[RUE] F[ALSE] o[ui] n[on] O[UI] N[ON] y[es] n[o] Y[ES] N[O].

Parameters:
texteQuestion - l'invite pour l'utilisateur
Returns:
la donnée lue

readBoolean

public boolean readBoolean(java.lang.String prompt)

lireBoolean

public boolean lireBoolean()
Permet la saisie au clavier d'un booléen, avec une grande variété de possibilités : v[rai] f[aux] V[RAI] F[AUX] t[rue] f[alse] T[RUE] F[ALSE] o[ui] n[on] O[UI] N[ON] y[es] n[o] Y[ES] N[O]

Returns:
la donnée lue

readBoolean

public boolean readBoolean()

lireInt

public int lireInt()
Acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (int). Retourne la valeur entière du nombre saisi

Returns:
la donnée lue

readInt

public int readInt()

lireInt

public int lireInt(java.lang.String prompt)
Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (int). Retourne la valeur entière du nombre saisi

Parameters:
prompt - l'invite pour l'utilisateur
Returns:
la donnée lue

readInt

public int readInt(java.lang.String prompt)

lireLong

public long lireLong()
Acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (long). Retourne la valeur entière du nombre saisi

Returns:
la donnée lue

readLong

public long readLong()

lireLong

public long lireLong(java.lang.String prompt)
Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (long). Retourne la valeur entière du nombre saisi

Parameters:
prompt - l'invite pour l'utilisateur
Returns:
la donnée lue

readLong

public long readLong(java.lang.String prompt)

lireByte

public byte lireByte()
Acquiert la prochaine ligne entrée au clavier et l'interprète comme un byte. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (byte). Retourne la valeur entière du nombre saisi

Returns:
la donnée lue

readByte

public byte readByte()

lireByte

public byte lireByte(java.lang.String prompt)
Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (byte). Retourne la valeur entière du nombre saisi

Parameters:
prompt - l'invite pour l'utilisateur
Returns:
la donnée lue

readByte

public byte readByte(java.lang.String prompt)

lireShort

public short lireShort()
Acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (short). Retourne la valeur entière du nombre saisi

Returns:
la donnée lue

readShort

public short readShort()

lireShort

public short lireShort(java.lang.String prompt)
Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un entier. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (short). Retourne la valeur entière du nombre saisi

Parameters:
prompt - l'invite pour l'utilisateur
Returns:
la donnée lue

readShort

public short readShort(java.lang.String prompt)

lireFloat

public float lireFloat()
Acquiert la prochaine ligne entrée au clavier et l'interprète comme un flottant. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (float). Retourne la valeur entière du nombre saisi

Returns:
la donnée lue

readFloat

public float readFloat()

lireFloat

public float lireFloat(java.lang.String prompt)
Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un flottant. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (float). Retourne la valeur entière du nombre saisi

Parameters:
prompt - l'invite pour l'utilisateur
Returns:
la donnée lue

readFloat

public float readFloat(java.lang.String prompt)

lireDouble

public double lireDouble()
Acquiert la prochaine ligne entrée au clavier et l'interprète comme un flottant. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (double). Retourne la valeur entière du nombre saisi

Returns:
la donnée lue

readDouble

public double readDouble()

lireDouble

public double lireDouble(java.lang.String prompt)
Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme un flottant. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte (double). Retourne la valeur entière du nombre saisi

Parameters:
prompt - l'invite pour l'utilisateur
Returns:
la donnée lue

readDouble

public double readDouble(java.lang.String prompt)

lireEnum

public <T extends java.lang.Enum<T>> T lireEnum(java.lang.Class<T> classe)
Acquiert la prochaine ligne entrée au clavier et l'interprète comme une valeur énumérée. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte. Retourne la valeur saisie

Parameters:
classe - le type énnuméré concerné
Returns:
la donnée lue

lireEnum

public <T extends java.lang.Enum<T>> T lireEnum(java.lang.String classe)

readEnum

public <T extends java.lang.Enum<T>> T readEnum(java.lang.Class<T> classe)

readEnum

public <T extends java.lang.Enum<T>> T readEnum(java.lang.String classe)

lireEnum

public <T extends java.lang.Enum<T>> T lireEnum(java.lang.Class<T> type,
                                                java.lang.String prompt)
Affiche prompt et acquiert la prochaine ligne entrée au clavier et l'interprète comme une valeur énumérée. Controle l'acquisition et redemande une entrée tant que la saisie au clavier n'est pas correcte. Retourne la valeur saisie

Parameters:
type - le type énnuméré concerné
prompt - l'invite pour l'utilisateur
Returns:
la donnée lue

readEnum

public <T extends java.lang.Enum<T>> T readEnum(java.lang.Class<T> classe,
                                                java.lang.String prompt)

format

public java.lang.String format(java.lang.Object s,
                               java.lang.String pattern)
Mise en forme d'une donnée

Parameters:
s - la donnée à formater
pattern - le format. on utilise le formattage proposé par la classe Formatter.
Returns:
la donnée formatée