Génération de Javadoc - tag @see et retours console + Interface Comarable / Comparator

**viry0ne** · 08/05/2020, 10h57

Bonjour à tous !

Petite question du jour bonjour...

J'ai écrit ça :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
	/** Interface Comparable<T>
         * Redéfinit la méthode compareTo() pour trier les images par nombre de formes croissant
         * @see SortFormes
         */
	@Override
    public int compareTo(Image otherImg) {
        return (this.getNbFormes()-otherImg.getNbFormes());
    }
 
	/** Interface Comparator<T>
         * Trie les images par nombre de formes croissants mais avec l'interface Comparator
         * @see pkgTP2.Image.compareTo(Image otherImg)
         */
	public static class SortFormes implements Comparator<Image> {
 
	    /** Permets de trier les images d'un tableau ou d'une collection d'images 
             * par le nombre de formes qui la composent (ordre croissant)
             * @param i1 Première image de comparaison
             * @param i2 Seconde image de comparaison
             * @return différence de la soustraction du nombre de formes
             */
		@Override
	    public int compare(Image i1, Image i2) {
	    	return (i1.getNbFormes()-i2.getNbFormes());
	    }

Comme vous pouvez voir, j'essaie de faire un @see vers l'override de la méthode compareTo mais ça ne fonctionne pas...
J'imagine que je n’écris pas la référence comme il faut !?
(Peut-on faire des références "libres" un peu comme on veut avec des tags spécifiques par exemple ?)

De plus, j'avais réussi une fois à ce que dans la console Eclipse où on a le retour sur la génération de la javadoc, cela m'indique explicitement les warnings.
Mais je n'y arrive plus ! c'est que ça se configure ce truc là ? Impossible de retrouver comment j'avais fait !!!

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
...
Generating /home/POO/doc/help-doc.html...
1 warning            // j'aimerais qu'il me dise ce que c'est le warning !

Bon et dans un autre genre, et sans doute le plus important, on est bien d'accord que pour implémenter Comparator il me faut créer une classe imbriquée et créer la méthode qui fait ce que je veux ?

En l’occurrence, je ne vois pas bien la différence entre mon utilisation de Comparable, et de Comparator.
Si j'ai bien suivi c'est juste qu'avec Comparator je peux en implémenter plein de différentes...?

Idem, dans mon test j'utilise aussi bien une collection (Collection.sort) qu'un ArrayList... (Array.sort).
Du coup quelles différences, pourquoi l'un plutôt que l'autre ?

Merci d'avance pour vos lumières !