Créer des configurations de débogage pour transformer et déboguer vos fichiers

Les configurations de débogage vous permettent de fournir des détails sur la transformation et le débogage de vos fichiers, comme le JRE que vous voulez utiliser ou le type de configuration de lancement que vous désirez. Par ailleurs, vous pouvez les enregistrer pour pouvoir les réutiliser.

Avant de commencer

Pourquoi et quand exécuter cette tâche

Pour créer une configuration de débogage, procédez comme suit :

Procédure

  1. Passez dans la perspective Java™. Cliquez sur Fenêtre > Ouvrir la perspective > Autre > Java.
  2. Cliquez sur Exécuter > Déboguer. La boîte de dialogue Configuration de débogage apparaît.
  3. Cliquez avec le bouton droit de la souris sur Transformation XSL et cliquez sur Nouveau. Cela crée une nouvelle configuration vide.
  4. Sélectionnez la nouvelle configuration.
  5. Sur la page Informations générales, spécifiez ce qui suit :
    1. Nom. Spécifiez un nom pour votre nouvelle configuration de débogage.
    2. Projet. Spécifiez le projet dont vous voulez que les fichiers source proviennent.
    3. Fichier XSL source. Spécifiez le fichier XSL source.
    4. Fichier XML source. Spécifiez un fichier source contenant du XML. Vous ne pouvez pas spécifier plus d'un fichier source car vous ne pouvez déboguer qu'un seul fichier à la fois.
    5. Fichier de sortie. Spécifiez le nom et l'emplacement de votre fichier de sortie. Si vous indiquez un fichier existant, son contenu sera remplacé.
    6. Par défaut, la case S'arrêter à la première règle de canevas est cochée. Lorsqu'elle est cochée, le processus de transformation s'arrête au premier canevas défini dans le fichier XSL.
  6. Cliquez sur l'onglet Paramètres. Sur la page Paramètres, vous pouvez spécifier :
    1. Paramètres de feuille de style. Dans votre feuille de style XSL, vous pouvez définir un élément xsl:param avec un attribut Nom. Cette page vous permet de spécifier une nouvelle Valeur pour votre paramètre ou de remplacer la valeur existante. Pour cela, cliquez sur Ajouter, puis indiquez le Nom de l'attribut que vous voulez remplacer et la Valeur nouvelle ou de remplacement.
    2. Propriétés de sortie. Vous pouvez choisir de remplacer les propriétés de sortie par défaut spécifiées dans votre fichier de feuille de style XSL. Par exemple, vous pouvez avoir spécifié dans votre fichier de feuille de style que la sortie soit un fichier HTML et le codage en UTF-8, et décider que pour cette transformation la sortie soit un fichier texte codé en ASCII. Pour modifier ces valeurs, cochez les cases Remplacer les paramètres par défaut et indiquez les valeurs voulues. Pour plus d'informations sur ces zones, appuyez sur F1.
    3. Propriétés de transformation. Si vous le souhaitez, spécifiez les valeurs Limite de récursivité et Base de l'URI . La Limite de récursivité définit le nombre de niveaux vers lesquels vous voulez que la transformation établisse des liens et la Base de l'URI est un chemin de contexte que vous pouvez définir pour la bonne résolution des URI (Uniform Resource Identifiers).
  7. Cliquez sur l'onglet JRE. Cette page définit le JRE (Java Runtime Environment) utilisé pour exécuter et déboguer l'application. Sélectionnez un JRE qui fournit le support Xalan et Xerces dont vous avez besoin.
    1. Pour utiliser le JRE d'espace de travail par défaut, sélectionnez le bouton d'option JRE par défaut d'espace de travail.
    2. Pour choisir dans la liste des JRE déjà définis, sélectionnez le bouton d'option Autre JRE. Pour ajouter un JRE à votre liste d'options, cliquez sur JRE installés.
      Remarque : Si vous sélectionnez un Autre JRE, vous devrez également spécifier l'exécutable Java à utiliser avec.
  8. Cliquez sur l'onglet Chemin de classe. La page Chemin de classe définit l'emplacement des fichiers de classes utilisés lors de l'exécution et du débogage de l'application. Par défaut, les emplacements de classes user et bootstrap sont dérivés du chemin de génération du projet associé. Vous pouvez remplacer ces valeurs ici.
  9. Cliquez sur l'onglet Source. Cette page définit l'emplacement des fichiers source utilisés pour afficher le code source lors du débogage des fichiers. Par défaut, ces paramètres sont dérivés du chemin de génération du projet associé. Vous pouvez remplacer ces valeurs ici.
  10. Cliquez sur l'onglet Commun. Cette page contient les options suivantes :
    1. Type de configuration de lancement : Locale ou Partagée. Une configuration de lancement définit la manière dont un programme doit être lancé. Si vous sélectionnez Partagée, vous devez spécifier l'emplacement de la configuration partagée.
    2. Vous pouvez choisir d'afficher votre configuration de débogage dans le menu de favoris Déboguer, dans le menu de favoris Exécuter ou dans les deux.
    3. La case à cocher Lancer en arrière-plan détermine si la configuration sera lancée en arrière-plan ou non lors de son exécution.
  11. Cliquez sur Appliquer pour enregistrer vos modifications de la configuration.
  12. Cliquez sur Déboguer pour exécuter la transformation.

Résultats

Le fichier de sortie est créé à l'emplacement que vous avez spécifié. Si vous avez indiqué un fichier existant comme fichier de sortie, son contenu sera remplacé.
Remarque : Le fichier de sortie n'apparaît dans la vue Navigateur que lorsque vous actualisez le contenu du dossier ou projet où il se trouve.

Que faire ensuite

Une fois la transformation terminée, vous serez invité à passer dans la perspective Débogage. Cliquez sur Oui. Vous pouvez déboguer vos fichiers avec le débogueur Java. Pour plus d'informations sur l'utilisation de la perspective Débogage et du débogueur Java, reportez-vous à la documentation en ligne du débogueur JDT (Java Development Tools) et de développement Java.

Vous pouvez réexécuter la transformation et déboguer à tout moment en rouvrant la boîte de dialogue Configuration de débogage (Exécuter > Déboguer), en sélectionnant la configuration et en cliquant sur Déboguer.


Commentaires en retour