Edition d'éléments Java

Dans la présente section, vous allez afficher et modifier des éléments Java dans le plan de travail.

Utilisation de la vue Structure

  1. Pour ouvrir le fichier junit.samples.VectorTest.java dans l'éditeur Java, cliquez deux fois sur le fichier dans la vue Packages.

  2. Notez que la syntaxe est mise en évidence. Parmi les éléments de code source Java mis en forme différemment figurent :

    • les commentaires normaux,
    • les commentaires Javadoc,
    • les mots clés,
    • les chaînes.
    Mise en évidence de la syntaxe
  3. Examinez la vue Structure. Elle affiche la structure du fichier Java, notamment la déclaration du package, les déclarations d'importation, les types et les méthodes. La vue Structure indique si un élément Java est statique, abstrait, final, etc. Elle indique également si une méthode est ignorée à partir d'une classe de base (ignorée) ou spécifique quand elle implémente une méthode à partir d'une interface (implémentation).

    Vue Structure
  4. Utilisez les boutons Masquer les zones, Masquer les membres statiques et Masquer les membres non publics dans la barre d'outils de la vue Structure pour filtrer les données affichées dans la vue.

    Barre d'outils de la vue Structure
  5. Cliquez sur le bouton Trier dans la vue Structure pour afficher les éléments Java par ordre alphabétique au lieu de les afficher tels qu'ils apparaissent dans le fichier Java.

  6. Vous pouvez modifier le code source en affichant l'ensemble du fichier Java. Vous pouvez également limiter l'affichage à un seul élément Java. Cliquez sur le bouton Afficher la source de l'élément sélectionné dans la barre d'outils.

    Dans la vue Structure, sélectionnez ensuite un élément. Seul l'élément sélectionné s'affiche dans l'éditeur Java.

    Bouton de la barre d'outils Afficher uniquement l'élément sélectionné
  7. Cliquez une nouvelle fois sur le bouton Afficher la source de l'élément sélectionné pour afficher une nouvelle fois le fichier Java dans son intégralité.

    Dans la vue Structure, sélectionnez différents éléments et notez qu'ils sont de nouveau affichés dans une vue complète du fichier dans l'éditeur. La vue Structure sélection est signalée par un indicateur situé dans la règle verticale, sur le bord gauche de l'éditeur Java.

    Indicateur

Ajout des méthodes et utilisation de l'assistant de code

  1. Vérifiez que le bouton Trier par ordre alphabétique de la barre d'outils de la vue Structure est désactivé.

  2. Commencez à ajouter une méthode en entrant la valeur suivante à la fin du fichier VectorTest.java (avant les parenthèses fermantes du type) dans l'éditeur Java :

    public void testSizeIsThree() {

    Dès que vous entrez le nom de la méthode dans la zone de l'éditeur, la nouvelle méthode apparaît dans la partie inférieure de la vue Structure.

    Nouvelle méthode dans la vue Structure
  3. Cliquez sur le bouton Sauvegarder.

    L'unité de compilation est compilée automatiquement et les erreurs éventuelles apparaissent dans la vue Packages, dans la vue Tâches et sur la règle verticale. Dans la vue Package, les erreurs remontent jusqu'au projet de l'unité de compilation qui contient l'erreur.

    Propagation des erreurs dans la vue Packages
  4. Terminez l'opération en entrant la chaîne suivante :

        assertTrue(fFull.size() == 3);
    }
  5. Sauvegardez le fichier.

    Notez que les indicateurs d'erreurs disparaissent.

Suppression et remplacement d'une méthode à partir de l'historique local

Dans cette section, vous allez utiliser la fonction Historique local pour passer à une version sauvegardée d'un élément Java.

  1. Supprimez la méthode que vous avez créée en la sélectionnant dans la vue Structure et en cliquant sur Supprimer dans le menu contextuel.

  2. Ajoutez une nouvelle version de la méthode en entrant les chaînes suivantes à la fin du fichier VectorTest.java à la fin de l'éditeur Java :

    public void testSizeIsThree() {
        fFull.add(0, new Integer(0));
        fFull.remove(new Integer(3));
        assertTrue(fFull.size() == 3);
    }

    Sauvegardez le fichier.

  3. Dans la vue Structure, sélectionnez la méthode testSizeIsThree(), puis, dans son menu contextuel, sélectionnez Remplacer à partir de l'historique local.

  4. Dans la boîte de dialogue Remplacement par un élément Java de l'historique local, la liste Historique local indique les différents états sauvegardés de cet élément. La sous-fenêtre Comparaison des sources Java affiche le détail des différences entre la ressource sélectionnée dans l'historique et celle du plan de travail.

    Remplacement à partir de l'historique local
  5. Dans la sous-fenêtre Historique local, sélectionnez la version que vous avez supprimée, puis cliquez sur le bouton Remplacer.

    Dans l'éditeur Java, la méthode est remplacée par la version de l'historique sélectionnée.

  6. Sauvegardez le fichier.

Utilisation de l'assistant de contenu

  1. Ouvrez le fichier junit.samples.VectorTest.java dans l'éditeur Java.

  2. Accédez à la méthode testSizeIsThree() en la sélectionnant dans la vue Structure.

  3. Ajoutez les lignes suivantes à la fin de la méthode :

    Vector v = new Vector();
    for (int i=0; i<3; i++)
        v.addElement(new Object());
    assert
  4. Placez le curseur à la fin du mot assert et appuyez sur Ctrl+Espace pour activer l'assistant de contenu.

    La fenêtre de l'assistant de contenu s'affiche avec une liste de propositions. Faites défiler la liste pour afficher les options disponibles.

    Assistant de contenu
  5. Avec la fenêtre de l'assistant de contenu toujours active, entrez la lettre 't' après assert (pas d'espace entre les deux entrées). La liste est limitée. Seules les entrées commençant par 'assert' s'affichent.

    Sélectionnez différents éléments de la liste et placez le pointeur sur ces éléments pour visualiser l'aide Javadoc qui y est éventuellement associée.

    Assistant de contenu filtré
  6. Sélectionnez assertTrue(boolean) dans la liste et appuyez sur Entrée.

    Le code de la méthode assertTrue(boolean) est inséré.

  7. Complétez la ligne pour qu'elle se présente ainsi :

    assertTrue(v.size() == fFull.size());
  8. Sauvegardez le fichier.

Utilisation des modèles

  1. Ouvrez le fichier junit.samples.VectorTest.java dans l'éditeur Java.

  2. Ajoutez une nouvelle méthode en entrant les lignes suivantes :

    public void testValues() {
        Integer[] expected= new Integer[3];
        for
  3. Avec le curseur placé après for, appuyez sur Ctrl+Espace pour activer l'assistant de contenu.

    Assistant de contenu pour for
  4. Sélectionnez l'entrée for - iterate over array.

    Le modèle est inséré dans l'éditeur et la lettre i est mise en évidence. le nom du tableau local est deviné automatiquement.

    Modèle inséré
  5. Appuyez sur Entrée pour confirmer le modèle.

  6. Complétez la boucle for en indiquant :

    public void testValues() {
        Integer[] expected= new Integer[3];
        for (int i= 0; i < expected.length; i++) {
            expected[i]= i + 1;
        }
        
        Integer[] actual= to
  7. Placez le curseur après to, et appuyez sur Ctrl+Espace pour activer l'assistant de contenu. Sélectionnez toarray - convert collection to array.

    Modèle inséré

    Le modèle est inséré dans l'éditeur et type est mis en évidence et sélectionné.

    Modèle inséré
  8. Remplacez la sélection en entrant Integer. Le type du constructeur de tableau est modifié de manière synchrone.

  9. Appuyez sur Tab pour mettre en évidence et sélectionner collection et écraser la sélection en entrant fFull.

    Modèle inséré
  10. Appuyez sur Entrée pour confirmer le modèle.

  11. Ajoutez les lignes de code suivantes pour la méthode :

            assertEquals(expected.length, actual.length);
            for (int i= 0; i < actual.length; i++)
                assertEquals(expected[i], actual[i]);
        }
  12. Sauvegardez le fichier.

Organisation des importations

  1. Ouvrez le fichier junit.samples.VectorTest.java dans l'éditeur Java.

  2. Supprimez les déclarations en les sélectionnant dans la vue Structure et en choisissant Supprimer dans le menu contextuel.

    Menu contextuel de la vue Structure
  3. Dans le menu contextuel de l'éditeur, sélectionnez Organiser les importations.

    Les instructions d'importation requises sont ajoutées au début de votre code, sous la déclaration du package.

    Organiser les importations

    Vous pouvez utiliser directement l'option Organiser les importations à partir d'un menu contextuel des déclarations d'importation dans la vue Structure.

    Remarque : Vous pouvez définir l'ordre des déclarations d'importation dans les préférences (Fenêtre > Préférences > Java > Organiser les importations).

  4. Sauvegardez le fichier.

Extraction d'une méthode

Dans la présente section, vous allez améliorer le code du constructeur de junit.framework.TestSuite. Pour clarifier la finalité du code, vous allez extraire le code qui collecte les scénarios de test à partir des classes de base et le placer dans une nouvelle méthode appelée collectTestMethods.

  1. Dans le fichier junit.framework.TestSuite.java, sélectionnez le bloc de code suivant :

    Class superClass= theClass;
    Vector names= new Vector();
    while (Test.class.isAssignableFrom(superClass)) {
        Method[] methods= superClass.getDeclaredMethods();
        for (int i= 0; i < methods.length; i++) {
            addTestMethod(methods[i], names, constructor);
        }
        superClass= superClass.getSuperclass();
    }

    Sélectionnez le bloc de code en utilisant la fonction Développer la sélection :

    1. Accédez au constructeur TestSuite(Class).
    2. Placez le curseur juste avant while.
    3. Appuyez sur Alt+Maj+Flèche du haut.
    4. Appuyez deux fois sur Alt+Maj+Flèche de gauche.
  2. Dans le menu contextuel de l'élément sélectionné dans l'éditeur, choisissez Propager les modifications > Extraire la méthode...

    Méthode contextuel Extraire la méthode
  3. Dans la zone Nom de la méthode, tapez collectInheritedTests, puis cliquez sur Suivant.

    Assistant d'extraction de la méthode page 1
  4. La page de prévisualisation de la propagation des modifications affiche les modifications qui seront apportées.

    Cliquez sur Fin pour extraire la méthode.

    Assistant d'extraction de la méthode page 2
  5. Accédez à la méthode extraite en la sélectionnant dans la vue Structure.

    Méthode extraite

Utilisation des options Ouvrir la déclaration et Ouvrir la déclaration des types

  1. Ouvrez le fichier junit.samples.money.MoneyTest.java dans l'éditeur Java.

  2. Sur la première ligne de la déclaration de la classe MoneyTest sélectionnez la spécification de la superclasse TestCase et

    • sélectionnez Naviguer > Ouvrir la déclaration dans la barre de menus ou
    • Appuyez sur F3.

    Remarque : Cette commande fonctionne également sur les méthodes et les zones.

    Menu Ouvrir la déclaration

    La superclasse TestCase s'affiche dans la zone de l'éditeur et est également représentée dans la vue Structure.

    Déclaration ouverte
  3. Cliquez sur l'onglet TestCase.java pour activer l'éditeur correspondant.Assurez-vous que la déclaration de classe est toujours sélectionnée, puis effectuez l'une des opérations suivantes :

    • Sélectionnez Naviguer > Ouvrir la hiérarchie des types ou
    • Appuyez sur F4.
    Menu Ouvrir la hiérarchie des types
  4. La vue Hiérarchie s'ouvre et affiche la classe TestCase.

    Vue Hiérarchie des types

    Remarque : Vous pouvez également ouvrir les éditeurs pour les types et les méthodes de la vue Hiérarchie.

Concepts connexes

Vues Java
Editeur Java
Prise en charge de la propagation des modifications
Modèles

Tâches connexes

Utilisation de l'éditeur Java
Affichage et masquage d'éléments
Affichage d'éléments uniques ou de fichiers Java complets
Tri des éléments dans les vues Java
Utilisation de l'historique local
Utilisation de l'assistant de contenu
Utilisation de modèles
Gestion des instructions d'importation
Propagation des modifications
Propagation des modifications avec aperçu
Utilisation de la vue Hiérarchie
Ouverture d'une hiérarchie des types dans un élément Java
Ouverture d'une hiérarchie des types pour la sélection de texte en cours
Ouverture d'un éditeur pour un élément sélectionné

Référence connexe

Vue Structure Java
Assistant de contenu Java
Préférences des modèles
Préférences pour l'organisation des importations
Préférences de l'éditeur Java
Erreurs d'extraction de méthode
Vue Hiérarchie