BROUILLAMINEUR & HSQLDB : mode opératoire
... introduction rapide pour découvrir le gestionnaire HSQLDB du "brouillamineur"
Cette option {BDDsc} du "Brouillamineur" est appelée bien
sûr à évoluer, mais elle permet déjà
d'expérimenter rapidement et simplement la manipulation de cet
extraordinaire outil Open Source qu'est HSQLDB - voir le site : http://hsqldb.org/
Actuellement, la version "HSQLDB 1.8.0.4" a été
amalgamée au "brouillamineur" proposé sur notre
site GONIC ...
(Un .jar (brou.jar) pour le brouillamineur exécutable / un .jar (hsqldb.jar) à récupérer dans la lib de l'Open Source HSQLDB / un .jar (brou_sources.jar) pour le décor (répertoire d'exécution et sources en .java) et un .jar (brouillamin.jar) pour lancer le tout )
* Lancer le "Brouillamineur" :
- - en mode Applet := charger "essai/brouillamineur.html"
... mais dans l'Etat actuel,
l'option {BDDsc} ne sera pas opérationnelle, car la connection
HSQLDB ne peut être autorisée à l'Applet ...
( cela peut cependant donner un
aperçu très limité du look de l'interface
rudimentaire utilisée ...)
- - en mode Application autonome :
charger les .jar : xor/essai/brou.jar , xor/essai/brou_sources.jar , xor/essai/brouillamin.jar et bien sûr : hsqldb.jar (celui-ci, vous êtes censés aller le chercher sur hsqldb.org)
décompacter le "brou_sources.jar" dans le répertoire de votre choix, et y placer les autres .jar
, s'assurer de disposer de tous les fichiers et
répertoires nécessaires, dans l'environnement
d'exécution (voir le répertoire "xor/essai" de ce site)
lancer le brouillamin.jar .. (dans le cas idéal, il suffit de double-cliquer dessus)
* Se rappeler les bases de l'interface (RHM) du "Brouillamineur" : à savoir
- un simple clic dans le fond gris rappelle dans le cadre vert ces 'bases de l'interface (RHM) du "Brouillamineur" '
- les mots entourés de crochets, sont en pricipe des 'commandes' ( exemple : [mot-commande] )
pour faire exécuter une telle commande, il faut faire un double
clic (en utilisant le bouton gauche de la souris) sur le
'mot-commande'
- (au passage, voir les possibilités offertes par les "clics tordus", par les "clics biscornus" et par les "clics combinés" ...)
voir plaidoirie en faveur des clics combinés ...
* Pour essayer le gestionnaire HSQLDB du "brouillamineur" :
- ATTENTION ! : lancer la commande {charsets} pour passer en "UTF-16"
(l'interface utilise des fichiers texte conçus avec ce format ...)
- (rappeler le menu principal du cadre vert en simple-cliquant dans le fond gris, et ..)
doule-cliquer dans la 'commande' {BDDsc} ( pour Base De Données , essai )
Dans le cadre bleu (en haut à gauche), double-cliquer sur : {BDDopen}(BDDbidon)
... le reste devrait être intuitif
Si , avant ce double-clic, vous avez remplacé, entre
parenthèses, 'BDDbidon' par un autre nom (exemple: MA_BASE ),
vous vous connecterez à la base voulue (MA_BASE) .
Cette base sera crée si elle n'existe pas. ...
- Note : principe d'interface à priori spécifique à l'option {BDDsc} :
- un simple clic, sur une chaîne de caractères
entourée de crochets ('[' et ']' ) suffit à la
sélectionner ..
* Commandes SQL directes:
le cadre jaune est réservé aux commandes les
plus techniques (les plus 'risquées' pour la base) :
charger dans ce cadre jaune le fichier : "BDDsql_" .
Vous disposez alors des commandes : {executeQuery} , {executeUpdate} ou {execute}
pour passer directement des commandes selon la norme SQL ...
Dans le cas de {executeQuery}, les résultats s'affichent dans le cadre vert (en bas) ...
* Commandes basiques simples (non standard SQL, niveau utilisateur néophyte)
le cadre bleu (fichier BDDchoix_ au départ), donne accès aux commandes :
- {ACTUAL}
met à jour la présentation, dans le cadre bleu, de la base de donnée éventuellement ouverte :
- le nom de cette base est affiché,
- le nom de chacune des tables de cette base est affiché :
suivi du label de chacune des colonnes de la table
et précédé d'un '*' , si
cette table est celle qui est sélectionnée pour les
opérations courantes
(pour sélectionner une table : cliquer sur son nom juste avant de double-cliquer sur {ACTUAL} )
Les commandes proposées ensuite sont relatives à la Table sélectionnée ..
note :
cette commande {ACTUAL} fait aussi apparaître des information dans le cadre vert :
- liste des tables système :
pour voir la description d'une de ces table : -cliquer sur
son nom dans le cadre vert, puis, double-cliquer sur {ZYEUTER}
en haut du cadre vert ...
- ..
- description de la table sélectionnée
- {creerTableBDD}
double-cliquer sur cette commande pour créer une nouvelle Table dans la Base de donnée courante
le cadre jaune affiche alors (temporairement) le contenu du fichier : "creerTableBDD_" :
La commande {creerTableBDD} est alors présentée dans ce
cadre jaune avec une mise en place de son paramétrage :
simple-cliquer dans [?nom_table?] ou dans [?nom_colonne?] pour commencer la saisie du label à cet endroit
simple-cliquer dans [TYPEcolonne_choisi] pour remplacer cet élément :
- par ce que désigne, plus bas la ligne : par défaut, TYPEcolonne_choisi = xxx
- ou par un des types SQL présentés plus bas
entre crochets, si vous venez de le sélectionner (un simple clic
suffit)
Avant d'affiner le paramétrage, ajuster le nombre de colonnes de la table à créer par copier/coller.
- {detruireTable}(nom-de-table)
double-cliquer sur cette commande pour détruire la Table désignée en paramètre
- {SHOW}
affiche les lignes de la table sélectionnée
- {AJOUTER}(....)
présente en paramètres les labels des colonnes de la
table sélectionnée : donner une valeur à chaque
colonne de la ligne à ajouter à cette table
exemple : {AJOUTER} (PRENOM=???
;NOM=??? ;ADRESSE=??? ) //
remplacer les '???'
- {SUPPRIMERligne}
pour supprimer une ligne de la table sélectionnée :
- s'assurer que le cadre vert présente les lignes de la table : commande {SHOW}
- cliquer sur le repère '[n]' désignant (en début
de ligne de texte dans le cadre vert), la ligne choisie de la table de
BDD
- double-cliquer (le repère étant sélectionné) la commande {SUPPRIMERligne} dans le cadre bleu
- {MODIFIERligne}
pour modifier une colonne d'une ligne de la table sélectionnée :
- s'assurer que le cadre vert présente les lignes de la table : commande {SHOW}
- cliquer sur le repère '[n]' désignant (en début
de ligne de texte dans le cadre vert), la ligne choisie de la table de
BDD
- modifier la valeur d' UNE
colonne de cette ligne (dans le cadre vert) (si plusieurs valeurs sont
modidiées, seule la première sera prise en compte)
- (le repère étant sélectionné,) double-cliquer la commande {MODIFIERligne} dans le cadre bleu
- une nouvelle commande paramétrée
{MODIFIERligne}(...) est présentée dans le
cadre vert
- pour confirmer la modification, double-cliquer sur le '{MODIFIERligne}' dans ce cadre vert
Nota Bene :
actuellement, une seule connection de BDD peut être ouverte.
Cette connection est automatiquement fermée : quand on
quitte le "Brouillamineur" / ou quand on ouvre une nouvelle BDD.
Si un Brouillamineur a ouvert une BDD, un autre
"Brouillamineur" lancé concurremment ne peut pas se connecter
à la BDD.
Nota Bene :
PLAIDOIRIE en faveur des CLICS COMBINÉS
Par oppostion au pianiste qui utilise intelligemment, et avec dextérité tous ses doigts,
le "commercial" moderne ne peut plus se séparer de son téléphone portable : il ne fait travailler que son pouce.
( Idem pour pas mal d'autres "teen-agers" ou gens affairés ...)
L'informaticien, ou l'utilisateur de prothèses d'intelligence (logiciels tout faits, grand public), quant à lui, s'il n'est pas un pur Linuxien, inconditionnel de la ligne de commande, finit par n'utiliser que son index pour 'picorer' si possible toujours le même bouton de sa souris.
La pratique des "clics Tordus", "clics Biscornus", ou "clics Combinés" pourraît aider à prévenir une régression trop rapide dans l'Évolution de l'Homo Informaticus, en l'incitant à utiliser au moins deux doigts au lieu d'un seul ! ... ;))