Index of /guides/java/staf2x/ex/xml/fiches

[ICO]NameLast modifiedSizeDescription

[PARENTDIR]Parent Directory  -  
[   ]Fiches.xml1999-01-15 13:06 2.3K 
[   ]Fiches2.xml1999-01-21 14:38 2.2K 
[TXT]README.html2000-04-18 16:39 20K 
[TXT]README.html.source2000-04-18 16:42 17K 
[DIR]SAX/2000-04-20 00:20 -  
[   ]make-toc2000-04-18 16:38 5.7K 
[DIR]v1/2000-10-06 19:59 -  
[DIR]v2/2001-04-11 21:25 -  

Résolution d'un exercice STAF2x en XML :

Voir l'ancien programme STAF2x /Daisy (1998/1999). En 4/2000 j'ai réparé un le code, réorganisé un peu les fichiers. La version v2 (solution amélioré ci-dessus) se retrouve maintenant dans TIE et sera problement maintenu.
Contents
  1. Solution minimale :
    § 1.1 Qu'est ce qui a été fait ? § 1.2 Sur quoi ca porte ?
  2. Solution améliorée :
    § 2.1 Qu'est ce qui a été fait ? § 2.2 Sur quoi ca porte ? § 2.3 Quels sont les versions ? § 2.4 Comment on s'en sert ?
 
Solution minimale : Solution améliorée :

1. Solution minimale :  Go Top

1.1 Qu'est ce qui a été fait ?  Go Top

Le travail à consisté à :

Il a fallu environ deux heures pour réaliser l'ensemble de ces étapes mais il ne s'agit pas d'une compétition.

1.2 Sur quoi ca porte ?  Go Top

Le thème choisi pour la résolution de l'exercice est de fournir un accès à un système de fiches à utiliser pour classer des ressources bibliographiques ou, pourquoi pas, les ressources d'un campus virtuel.

Une représentation sous forme de table est possible avec le DTD qui a finalement été employé. Tous les éléments d'une fiche doivent être présents en un et un seul exemplaire ce qui permet de construire un tableau à deux entrées dans laquelle les lignes sont les ressources bibliographiques et les colonnes sont les champs (ou les items si vous préférez).

En résumé, chaque "Entry" a un :

Attention à l'encodage : Si vous utilisez d'autres caractères que ISO-8859-1 (les accents Européens Unix/win) il faut l'indiquer dans le fichier Fiches.xml. Voir par exemple la XML spéc.

Quels sont les versions ?

Quatre versions sont pour le moment disponibles. Ces versions réalisent quatre approches différentes du problème :

La première permet une autonomie de l'application (qui peut être locale) mais pas des données (cherchées sur le Web). La seconde et la troisième version sont complètement intégrées dans un navigateur Web mais exigent un travail plus lourd du coté du serveur (puisqu'il s'agit d'un Servlet) et un affichage moins agréable (on affiche en HTML). La quatrième version est complètement intégrée dans un navigateur Web. De mon point de vue (S.M.M), c'est la version qui a le plus d'avantage puisque elle dispose d'un affichage agréable tout en ne nécessitant aucune installation. Le désavantage est d'avoir les données dans un programme et non un document HTML directement publiable.

Si l'on fait exception des fichiers de classes Java à importer (xerces.jar) et que l'on compare le nombre de fichiers source (par opposition au nombre de fichers produits par la compilation), on peut s'apercevoir qu'il existe de grandes différences qui sont à la fois dues à la taille des commentaires ainsi qu'à la philosophie interne de chaque solution.

En effet, la première version, sous forme d'une application Java utilise 5 fichiers source :

En effet, la seconde version, sous forme d'un Servlet Java utilise 3 fichiers source :

En effet, la troisième version, sous forme d'une page JHTML utilise 2 fichiers source :

En effet, la quatrième version, sous forme d'un Applet utilise 5 fichiers source :

Comment on s'en sert ?

(1) Pour utiliser la première version, il est nécessaire de disposer de la version 1.2 de Java. Par ailleurs, vous devez aussi pouvoir accéder aux classes XML pour Java (elles sont disponibles ici). Il est donc nécessaire de mettre à jour votre classpath.

Sur PC, il faut faire SET CLASSPATH=%CLASSPATH%;.;C:\xml\xerces.jar

...si l'on suppose que vos classes XML pour Java sont sur votre disque dur C dans le repertoire xml.

Comme nous avons compilé les classes vous pouvez éviter cette opération et en récuperant les fichiers ".class". Il vous suffit donc dès lors de lancer le visualiseur d'applications Java avec la classe FicheModel.

(2) Pour utiliser la seconde version, il faut se connecter au serveur Java et de lui demander le document http://tecfa2.unige.ch:8080/servlet/FicheServlet.

Si vous deviez gérer la création complète de cet exemple, il vous faudrait installer un Serveur Java, le configurer, le lancer, installer la version 1.2 de Java, configurer le CLASSPATH pour prendre en compte les classes XML et celles pour les Servlet (ce qui donnerait sous Unix une commande de la forme "setenv CLASSPATH /local/java/JSDK2.0/lib/jsdk.jar:xerces.jar:."), compiler la classe FicheServlet.java, la placer au bon endroit avant enfin de pouvoir l'acceder à travers votre propre serveur Web.

Une autre solution consiste à utiliser notre serveur Java...

(3) Pour utiliser la troisième version, il faut se connecter au serveur Java et de lui demander le document http://tecfa2.unige.ch:8080/develop/jhtml-ex/fiches.jhtml. Une présentation légerement différente (c'est à dire sous forme d'arbre au lieu de table) est également disponible à l'adresse : http://tecfa2.unige.ch:8080/develop/jhtml-ex/fichesa.jhtml.

Si vous deviez gérer la version complète de cet exemple, il vous faudrait effectuer toutes les étapes décrites pour développer la seconde solution.

(4) Pour utiliser la quatrième version, il suffit de se rendre à l'adresse http://tecfa.unige.ch/guides/java/staf2x/ex/xml/fiches/FicheApplet.html en utilisant un AppletViewer Java 1.2 ou un navigateur utilisant le plug-in Java 1.2 (mais sur PC ca n'a pas l'air de fonctionner pour Netscape...).

Notez que les classes XML pour Java (disponibles ici) sont présentes dans le même répertoire que l'applet qui ne se lancerait pas sinon (sauf si l'on définissait explicitement un CLASSPATH pour elles seules).

 
Solution minimale : Solution améliorée :

2. Solution améliorée :  Go Top

2.1 Qu'est ce qui a été fait ?  Go Top

Le travail à consisté à :

Il a fallu environ deux heures pour réaliser l'ensemble de ces étapes mais il ne s'agit pas d'une compétition.

2.2 Sur quoi ca porte ?  Go Top

Le thème choisi est le même que celui de la version de base : fournir un accès à un système de fiches à utiliser pour classer des ressources bibliographiques ou, pourquoi pas, les ressources d'un campus virtuel.

Une représentation sous forme de table est possible avec le DTD qui a finalement été employé :

En résumé, chaque "Entry" a un :

Attention à l'encodage : Si vous utilisez d'autres caractères que ISO-8859-1 (les accents Européens Unix/win) il faut l'indiquer dans le fichier Fiches2.xml. Voir par exemple la XML spéc.

2.3 Quels sont les versions ?  Go Top

Quatre versions sont pour le moment disponibles. Ces versions réalisent quatre approches différentes du problème :

La première permet une autonomie de l'application (qui peut être locale) mais pas des données (cherchées sur le Web). La seconde et la troisième version sont complètement intégrées dans un navigateur Web mais exigent un travail plus lourd du coté du serveur (puisqu'il s'agit d'un Servlet) et un affichage moins agréable (on affiche en HTML). La quatrième version est complètement intégrée dans un navigateur Web. De mon point de vue (S.M.M), c'est la version qui a le plus d'avantage puisque elle dispose d'un affichage agréable tout en ne nécessitant aucune installation. Le désavantage est d'avoir les données dans un programme et non un document HTML directement publiable.

Si l'on fait exception des fichiers de classes Java à importer (xerces.jar) et que l'on compare le nombre de fichiers source (par opposition au nombre de fichers produits par la compilation), on peut s'apercevoir qu'il existe de grandes différences qui sont à la fois dues à la taille des commentaires ainsi qu'à la philosophie interne de chaque solution.

En effet, la première version, sous forme d'une application Java utilise 4 fichiers source :

En effet, la seconde version, sous forme d'un Servlet Java utilise 2 fichiers source :

En effet, la troisième version, sous forme d'une page JHTML utilise 2 fichiers source :

En effet, la quatrième version, sous forme d'un Applet utilise 5 fichiers source :

2.4 Comment on s'en sert ?  Go Top

(1) Pour utiliser la première version, il est nécessaire de disposer de la version 1.2 de Java. Par ailleurs, vous devez aussi pouvoir accéder aux classes XML pour Java (elles sont disponibles ici). Il est donc nécessaire de mettre à jour votre classpath.

Sur PC, il faut faire SET CLASSPATH=%CLASSPATH%;.;C:\xml\xerces.jar

...si l'on suppose que vos classes XML pour Java sont sur votre disque dur C dans le repertoire xml.

Comme nous avons compilé les classes vous pouvez éviter cette opération et en récuperant les fichiers ".class". Il vous suffit donc dès lors de lancer le visualiseur d'applications Java avec la classe FicheModel2.

(2) Pour utiliser la seconde version, il faut se connecter au serveur Java et de lui demander le document http://tecfa2.unige.ch:8080/servlet/FicheServlet2.

Si vous deviez gérer la création complète de cet exemple, il vous faudrait installer un Serveur Java, le configurer, le lancer, installer la version 1.2 de Java, configurer le CLASSPATH pour prendre en compte les classes XML et celles pour les Servlet (ce qui donnerait sous Unix une commande de la forme "setenv CLASSPATH /local/java/JSDK2.0/lib/jsdk.jar:xerces.jar:."), compiler la classe FicheServlet2.java, la placer au bon endroit avant enfin de pouvoir l'acceder à travers votre propre serveur Web.

Une autre solution consiste à utiliser notre serveur Java...

(3) Pour utiliser la troisième version, il faut se connecter au serveur Java et de lui demander le document http://tecfa2.unige.ch:8080/develop/jhtml-ex/fiches2.jhtml. Une présentation légerement différente (c'est à dire sous forme d'arbre au lieu de table) est également disponible à l'adresse : http://tecfa2.unige.ch:8080/develop/jhtml-ex/fichesa2.jhtml.

Si vous deviez gérer la version complète de cet exemple, il vous faudrait effectuer toutes les étapes décrites pour développer la seconde solution.

(4) Pour utiliser la quatrième version, il suffit de se rendre à l'adresse http://tecfa.unige.ch/guides/java/staf2x/ex/xml/fiches/FicheApplet2.html en utilisant un AppletViewer Java 1.2 ou un navigateur utilisant le plug-in Java 1.2 (mais sur PC ca n'a pas l'air de fonctionner pour Netscape...).

Notez que les classes XML pour Java (disponibles ici) sont présentes dans le même répertoire que l'applet qui ne se lancerait pas sinon (sauf si l'on définissait explicitement un CLASSPATH pour elles seules).