Exercice 1.2 : Création de votre première sonde

Avant de commencer, vous devez terminer l'Exercice 1.1 : Importation des ressources requises.

La sonde que vous allez créer signale chaque nouvelle entrée de méthode dans votre programme.

Pour créer une sonde, vous devez exécuter trois tâches principales :

  1. création d'un fichier source Probekit vide ;
  2. création du contenu du fichier source ;
  3. vérification de la sonde.

Création d'un fichier source Probekit vide

Vous allez créer le fichier Probekit dans un projet spécifique, bien qu'il soit possible de créer des sondes dans le même projet que votre application.

  1. Créez un nouveau projet Java dans lequel la sonde sera enregistrée :
    1. Dans la barre de menus Software Development Platform, sélectionnez Fichier > Nouveau > Projet... La boîte de dialogue Nouveau projet s'ouvre.
    2. Sélectionnez Projet Java, puis cliquez sur Suivant. La boîte de dialogue Nouveau projet Java s'ouvre.
    3. Dans la zone Nom du projet, entrez RandomNumbersProbe puis cliquez sur Fin. Une entrée pour RandomNumbersProbe est ajoutée à la vue Packages.
  2. Convertissez le projet Java en projet Probekit :
    1. Dans la vue Packages, cliquez avec le bouton droit de la souris sur le projet RandomNumbersProbe que vous venez de créer, puis sélectionnez Nouveau > Autre... La boîte de dialogue Nouveau s'ouvre.
    2. Cochez la case Afficher tous les assistants, puis développez la perspective Profilage et Journalisation.
    3. Sélectionnez Convertir des projets Java en projets Probekit, puis cliquez sur Suivant.
    4. Si la boîte de dialogue "Confirm Enablement" s'ouvre, cliquez sur Always enable capabilities and don't ask me again, puis sur OK. La boîte de dialogue Convertir des projets Java en projets Probekit s'ouvre.
    5. Assurez-vous que seul le projet RandomNumbersProbe est sélectionné, puis cliquez sur Fin.
  3. Créez un nouveau fichier source Probekit dans le projet RandomNumbersProbe :
    1. Dans la vue Packages, cliquez avec le bouton droit de la souris sur RandomNumbersProbe.
    2. Sélectionnez Nouveau > Fichier. La boîte de dialogue New File s'ouvre.
    3. Sélectionnez RandomNumbersProbe pour en faire le dossier parent.
    4. Dans la zone Nom du fichier, entrez RandomNumbersProbe.probe, puis cliquez sur Fin. Une entrée pour RandomNumbersProbe.probe est ajoutée à la vue Packages. L'éditeur Probekit et la vue Incidents s'ouvrent. L'éditeur affiche le nouveau fichier.

Vous disposez maintenant d'un fichier source Probekit vide dans son propre projet. Le compilateur de sonde a tenté de compiler ce fichier source car celui-ci fait partie d'un projet Probekit et vous avez activé la fonction de création automatique dans votre espace de travail. La vue Incidents signale une erreur car un fichier vide n'est pas un fichier source Probekit valide.

Création du contenu du fichier source

Au cours de cette tâche, vous allez utiliser l'éditeur Probekit pour créer les éléments constitutifs d'une sonde.

Les fichiers source Probekit se présentent sous la forme d'une arborescence. Au sommet de celle-ci se trouve un élément Probekit. En dessous de cet élément, vous devez créer un élément Probe, lui-même suivi d'un nouvel élément Fragment. Ensuite, vous devez indiquer que cet élément Fragment aura accès à deux données : le nom de classe et le nom de méthode. Enfin, vous devez rédiger le fragment de code Java.

La sonde que vous devez créer est composée d'un fragment de code Java "entry" unique. Un fragment "entry" est un fragment qui est déclenché par l'heure de saisie de méthodes spécifiques dans le programme que vous êtes en train d'analyser. Avec cette sonde, le fragment "entry" imprime le nom de la classe et de la méthode à chaque fois qu'une méthode est saisie. Comme indiqué précédemment, cette sonde s'appliquera à toutes les classes et méthodes. En revanche, lors de son déploiement, vous devrez limiter sa portée en filtrant les classes système lors de la procédure de lancement.

Remarque : Probekit prend en charge d'autres types de fragment que les fragments "entry". Par exemple, vous pouvez aussi rédiger des fragments qui sont exécutés lors de la fermeture de certaines méthodes ou lorsqu'une méthode particulière traite une exception. Pour plus d'informations, consultez l'aide en ligne.

Pour créer les éléments de votre sonde :

  1. Dans l'éditeur Probekit, cliquez à l'aide du bouton droit de la souris sur l'élément Probekit, puis sélectionnez Nouveau > Sonde. Un élément Probe est ajouté dans l'arborescence.
  2. Cliquez à l'aide du bouton droit de la souris sur le nouvel élément Probe, puis sélectionnez Nouveau > Fragment. Un élément Fragment est inséré sous l'élément Probe. Par défaut, les fragments sont créés comme des fragments "entry". (Notez que entry est également sélectionné dans la zone Type de fragment à droite de l'éditeur Probekit.)
  3. Créez une variable qui va porter le nom de classe :
    1. Cliquez à l'aide du bouton droit de la souris sur l'élément Fragment entry, puis sélectionnez New > Data.
    2. A droite de l'éditeur Probekit, vérifiez que le type de données sélectionné est bien className.
    3. Dans la zone Nom, saisissez cname comme nom de variable.
  4. Créez la variable qui va porter le nom de la méthode :
    1. Cliquez à l'aide du bouton droit de la souris sur l'élément Fragment entry, puis sélectionnez New > Data.
    2. Sélectionnez methodName dans la liste déroulante Type de données.
    3. Dans la zone Nom, saisissez mname comme nom de variable.
  5. Entrez le code Java que vous voulez exécuter :
    1. Cliquez sur l'élément Fragment entry.
    2. Dans la section réservée au code Java, entrez la ligne de code suivante :
      System.out.println("[Enter method " + cname + "." + mname + "]");
  6. Dans la barre de menus, sélectionnez Fichier > Sauvegarder. Le compilateur de sonde compile automatiquement la sonde à partir de son code source.

Vérification de la sonde

Lorsque vous enregistrez votre sonde, le compilateur de sonde signale des erreurs dans la vue Incidents. Consultez cette vue pour repérer les problèmes éventuels. S'il y a des erreurs, corrigez-les dans l'éditeur Probekit et enregistrez de nouveau la sonde.

Deux types d'erreur peuvent être signalés dans la vue Incidents :

Félicitations ! Vous venez de créer votre première sonde.

Vous êtes maintenant prêt à aborder l'Exercice 1.3 : Application de votre sonde.

Conditions d'utilisation | Appréciations en retour
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.