Objectif du TP

• Construire un outil de références croisées pour Java. 

• Étudier les fonctionnalités d'introspection proposées par java, notamment la classe java.lang.Class et le paquetage java.lang.reflect.

• Spécifier une méthode calculant les classes référencées par une classe.

• Implémenter des jeux de tests correspondant à cette spécification.

• Définir un paquetage fr.imag.reflect implémentant la méthode et réaliser un outil de visualisation.

Déroulement du TP

• Télécharger l'archive JXREF.zip.

• Suivre les instructions dans ce fichier. (ATTENTION: ce TP dépend du TP CLASSVIEW et suppose entre autre que dot est accessible.

Questions

En suivant une approche "programmation extrême", on pourra répondre à la question (1) et (2) par incréments successifs, mais on réalisera toujours les tests AVANT de réaliser le programme correspondant.

(1) Spécification et jeu de tests

• Essayer de déterminer les différentes conditions faisant qu'une classe puisse dépendre d'une autre en prenant différents exemples simples.

  •  CR: énumérer brièvement la liste de ces cas.

• Etudier le paquetage java.lang.reflect et la class java.lang.Class de manière systématique pour déterminer quelles méthodes permettent de calculer la relation de dépendance. On prêtera une attention particulière à  ne oublier aucun cas. Les classes internes seront considérées comme élément intégral des classes et seront donc prises en considération. Il s'agira de compléter dans la question suivante la méthode getReferencedClasses de la classe fr.imag.reflect.Class.  

  • CR: donner la liste des classes de java.lang.reflect concernées et pour chaque classe (incluant java.lang.Class) la liste des méthodes concernées. Commenter brièvement. 

• Si Objecteering est disponible réaliser un diagramme de classe conceptuel décrivant la réflection en Java. Donner une spécification conceptuelle de la relation de dépendance telle que l'on chercher à la calculer et l'exprimer en OCL.

  • CR: un ou plusieurs diagrammes de classes + la où les expressions OCL. 

• Réaliser avec JUnit des classes de tests simples pour chaque cas identifié ci-dessus. Le répertoire tests devra accueillir l'ensemble des tests:

  • tests/src : le source des classes de tests junit
  • tests/classes : les classes de tests junit compilées
  • tests/data/src : le source des programmes java utilisée comme données des tests
  • tests/data/src : les classes java utilisées comme données des tests
  •  
  • CR: Descriptions des tests avec le programme de tests et le résultat escompté

(2) Implémentation

• Compléter la méthode getReferencedClasses de la classe fr.imag.reflect.Class. Les autres méthodes de cette classe seront complétées dans les questions suivantes.

• Tester cette méthode. Attention, la qualité des tests est essentielle et il est donc fondamental de prendre des données réelles pour valider ce TP. Ce dernier sera évalué à partir de jeu de tests complexes. Le répertoire tests/data/src contient des exemples de données de tests dans des paquetages préfixés par ref (Ne pas utiliser ce préfixe pour vos données de tests).

(3) Visualisation du graphe de dépendances entre classes

• En se basant sur les programmes développés dans CLASSVIEW, écrire une classe visualisant le graphe de dépendance correspondant à un ensemble de classes spécifiées.
• Tester ce programme.

(4) Visualisation du graphe de dépendances entre paquetages

• Il s'agit de déduire de la relation de dépendance décrite ci-dessus la relation de dépendance entre paquetages. Pour cela il est nécessaire de construire des fonctions permettant de manipuler le concept de paquetage. Complèter les méthodes getPackage et getReferencedPackages de la classe fr.imag.reflect.Class. Tester ces méthodes.
• Compléter les méthodes isPackageDirectory, getPackageRootDirectories, getClasses, getReferencedClasses, getReferencedPackages de la classe fr.imag.reflect.Package. Tester ces méthodes.
• Réaliser une classe permettant de visualiser le graphe de dépendances entre paquetages pour un ensemble de paquetage spécifiés.
• Compléter la méthode getPackages de la classe fr.imag.reflect.Package. Tester cette méthode.
• Réaliser une classe permettant de visualiser le graphe de dépendances entre les paquetages accessibles dans le CLASSPATH.