[java] comment déclarer une méthode deprecated

comment déclarer une méthode deprecated [java] - Java - Programmation

Marsh Posté le 29-04-2002 à 15:15:21    

y a presque tout dans le titre ...
 
je cherche à déclarer une méthode (d'une classe à moi) deprecated, de façon à ce qu'à l'execution un warning s'affiche automatiquement de la  même façon que ca le fait avec les méthodes deprecated de la JDK.
 
Je vais chercher de mon côté, mais la question me parraissait sympa à partager.
 
Je mets la réponse dès que je trouve si personne m'a donné la soluce avant. :)

Reply

Marsh Posté le 29-04-2002 à 15:15:21   

Reply

Marsh Posté le 29-04-2002 à 15:23:08    

dans la javadoc de ta methode tu utilise le tag @deprecated
 
[pre]
/**
 * ma super methode  
 * qui finalement a pris de l'âge
 *
 * @deprecated ne plus utiliser paske ça craint
 */
[/pre]
 
(http://www.chmsr.gatech.edu/java/javadoc_tags.html)

 

[jfdsdjhfuetppo]--Message édité par greg@freestarthu le 29-04-2002 à 15:24:00--[/jfdsdjhfuetppo]

Reply

Marsh Posté le 29-04-2002 à 15:28:17    

merci.
C'est ce quej'étais en train de voir à cette url là : http://java.sun.com/products/jdk/1 [...] ation.html
Ca me parrait bizarre parce que ca veut dire que la javadoc est analysée à la compile de façon à générer un code qui ve prévenir le progammeur que la méthode est dépréciée ...
 
bizarre, bizarre ... je teste et je vous dis quoi !

Reply

Marsh Posté le 29-04-2002 à 15:29:35    

benou a écrit a écrit :

merci.
bizarre, bizarre ... je teste et je vous dis quoi !  




 
pfff quel incrédule :/

Reply

Marsh Posté le 29-04-2002 à 15:31:00    

greg@freestarthu a écrit a écrit :

 
pfff quel incrédule :/  




ca te parrait pas louche à toi ? :??:

Reply

Marsh Posté le 29-04-2002 à 15:32:38    

benou a écrit a écrit :

 
ca te parrait pas louche à toi ? :??:  




non  pas vraiment :)
- ça te force à ecrire la javadoc
- ça montre bien que la deprecation(?) n'est rien d'autre qu'un conseil... le fait que ta methode est depré..ciée(?) ne devrait en rien perturber le fonctionnement de ton appli
 
enfin i'm'semble :sarcastic:

Reply

Marsh Posté le 29-04-2002 à 15:35:22    

je suis plutot d'accors avec benou perso
les balises de la javadoc son ignoré par le compilateur comment pourait t il savoir des lors qu une qu'une methode est deprecated?

Reply

Marsh Posté le 29-04-2002 à 15:35:34    

greg@freestarthu a écrit a écrit :

 
non  pas vraiment :)
- ça te force à ecrire la javadoc
- ça montre bien que la deprecation(?) n'est rien d'autre qu'un conseil... le fait que ta methode est depré..ciée(?) ne devrait en rien perturber le fonctionnement de ton appli
 
enfin i'm'semble :sarcastic:  




ouais ouais ok, mais le fait que ca affiche un message fait que le comportement de l'appli est différent : une sortie c'est un effet de bord.
Ca te trouble pas que la modification d'un commentaire créé un effet de bord ?
 
je trouve pas ca très propre moi ... :/

Reply

Marsh Posté le 29-04-2002 à 15:38:04    

euh ça n'affiche ce msg qu'a la compilation... tu trouves que la compilation fait "partie" de ton appli toi ?

Reply

Marsh Posté le 29-04-2002 à 15:46:01    

greg@freestarthu a écrit a écrit :

euh ça n'affiche ce msg qu'a la compilation... tu trouves que la compilation fait "partie" de ton appli toi ?  




heu ... oui pardon t'as raison, je suis con moi ...
 
mais bon, je trouve quand même ca un peu bizare. Un bon gros modifier m'aurait paru plus logique.

Reply

Marsh Posté le 29-04-2002 à 15:46:01   

Reply

Marsh Posté le 29-04-2002 à 16:03:10    

benou a écrit a écrit :

 
heu ... oui pardon t'as raison, je suis con moi ...




j'ai pas dit ça :o)
 

benou a écrit a écrit :

 
mais bon, je trouve quand même ca un peu bizare. Un bon gros modifier m'aurait paru plus logique.  




pas à moi, mais bon, est-ce que cela vaut la peine d'etre debatu? :)
(les modifiers *modifient* le comportement de ta methode...)

Reply

Marsh Posté le 29-04-2002 à 16:07:48    

greg@freestarthu a écrit a écrit :

 
pas à moi, mais bon, est-ce que cela vaut la peine d'etre debatu? :)
(les modifiers *modifient* le comportement de ta methode...)  




 
dans tout les cas, merci de ta réponse ! :jap:

Reply

Marsh Posté le 29-04-2002 à 16:13:39    

benou a écrit a écrit :

 
 
dans tout les cas, merci de ta réponse ! :jap:  




de rien  :jap:

Reply

Marsh Posté le 16-02-2009 à 16:18:26    

quelques années plus tard...
 
J'aimerais savoir s'il est possible de retrouver avec l'annotation @Deprecated la possibilité d'ajouter un texte d'explication comme on pouvait le faire avec la javadoc.
 

Code :
  1. /**
  2.    * Recuperation de l'index de la première ligne selectionnee
  3.    *
  4.    * @return entier : -1 si pas trouve, sinon de 1 à n
  5.    * @deprecated Use {@link #getFirstSelectedLineIndex()} instead
  6.    */
  7.   @Deprecated public final int getSelected() {
  8.     return this.getFirstSelectedLineIndex();
  9.   }


 
Par exemple, sous eclipse 3.3, après avoir indiqué l'annotaion, on n'a plus d'explication à l'obsolescence de la méthode...
Peut-on ajouter un paramètre à l'annotation ?


Message édité par Sxilderik le 16-02-2009 à 16:21:56

---------------
Lernu la internacian lingvon !
Reply

Marsh Posté le 18-02-2009 à 17:00:05    

D'après Sun, si tu utilises l'annotation @Deprecated, il faut aussi l'ajouter dans la javadoc (avec l'explication).  
http://java.sun.com/docs/books/tut [...] tions.html

Reply

Marsh Posté le 18-02-2009 à 18:12:16    

post_it a écrit :

D'après Sun, si tu utilises l'annotation @Deprecated, il faut aussi l'ajouter dans la javadoc (avec l'explication).  
http://java.sun.com/docs/books/tut [...] tions.html


 
Oui oui c'est ce que je fais (cf mon bout de code) mais, du moins sous Eclipde 3.3, j'ai le phénomène suivant :
 
- en passant la souris sur la méthode dans la classe où elle réside, j'ai bien le message @deprecated de la javadoc, avec le commentaire que j'ai mis
 
- en passant la souris sur les appels à cette méthode dans les autres classes, je n'ai plus ce message, mais seulement le message « système » issu de l'annotation @Deprecated.
 
Comment retrouver le message particulier dans les autres classes ? Ou bien est-ce un problème Eclipse 3.3 ?
 


---------------
Lernu la internacian lingvon !
Reply

Marsh Posté le 20-02-2009 à 11:50:40    

Je ne connais pas Eclispe, mais j'ai l'impression que c'est lui le problème!...

Reply

Marsh Posté le 20-02-2009 à 14:39:45    

Ce n'est pas à proprement parler un problème Eclipse mais un parametrage.
 
En fouillant un peu je pense avoir trouvé une piste :
Windows > Preferences > Java > Editor > Hovers > "décocher combined Hovers et cocher Javadoc"
 

Reply

Marsh Posté le 20-02-2009 à 15:01:16    

Bidem a écrit :

Ce n'est pas à proprement parler un problème Eclipse mais un parametrage.
 
En fouillant un peu je pense avoir trouvé une piste :
Windows > Preferences > Java > Editor > Hovers > "décocher combined Hovers et cocher Javadoc"
 


 
Merci, ça marche bien :)


---------------
Lernu la internacian lingvon !
Reply

Sujets relatifs:

Leave a Replay

Make sure you enter the(*)required information where indicate.HTML code is not allowed