Comment annoter la dépréciation d'une classe en Java?

Non, vous n'avez pas besoin d'. L'ajout de l'annotation @Deprecated à DeprecatedClass va générer un message d'avertissement à chaque fois qu'il est utilisé.

Ce que vous devrait n'est cependant méthodes de marquage dans autres classes qui prennent votre classe déprécié en tant qu'argument ou la retourner comme obsolète. C'est valable pour tout accès à un autre code peut-être les instances de votre classe déprécié — champs publics, des constantes et ainsi de suite. Ceux bien sûr, ne peut pas être utilisé sans une instance de votre obsolète calss, si l'avertissement est donné de toute façon, mais dans un état correct dépréciation d'annotation et commentaire, vous devez fournir une explication et un point à un autre, ce qui est précieux renseignements que vous besoin à donner.

Une signature de méthode, c'est comme un contrat et est donc une classe de signature. Vous êtes le dire à d'autres programmeurs quelles méthodes ils peuvent appeler et comment ils peuvent les appeler. Vous leur dites les champs qui sont accessibles. D'autres programmeurs base de leur code. Si vous avez vraiment besoin de rompre le contrat, vous devez d'abord fournir un substitut pour ce contrat (une nouvelle méthode avec la même fonctionnalité), et de leur dire et de leur donner le temps de passer à ce nouveau contrat (railler les anciennes méthodes et les classes).

Bien sûr, le ci-dessus suppose que vous êtes de codage à un public. Si vous êtes le seul à utiliser votre code et vous voulez juste pour rendre caduque pour nettoyer votre code sans casser la compilation, juste déprécier la classe, fixer les mises en garde, et de le supprimer.

OriginalL'auteur SQB

Vous avez seulement besoin d'ajouter de l'autodérision message de la déclaration de quelque chose que vous autodérision. Il sert d'avertissement que les gens devraient éviter une mise en œuvre qui utilise la classe déprécié, comme dans List<DeprecatedClass>.

OriginalL'auteur BlackBox