API dépréciée ou restreinte ou interdite ou découragée

Bonjour,

J'aimerais comprendre la fonction des API Java dépréciées et restreintes.
Comme on peut le voir dans Eclipse, cela permet la gestion de cette notion comme voici : Options ECLIPSE - Deprecated and restricted API

Ok pour la classification des erreurs trouvées par rapport aux API utilisées mais qui ou quoi déclare les API ou méthodes dépréciées ou restreintes ?

Comment Eclipse sait qu'une référencé est interdite ou découragée ?

Apparemment cela fait référence aux "access rules" mais à quoi Eclipse fait-il référence ?

Quelqu'un saurait-il m'éclairer sur toutes les notions dont fait référence Eclipse afin de pouvoir comprendre et maitriser l'ensemble de ce paramétrage ?

J'ai bien évidemment utilisé l'aide via F1 mais cela ne m'a pas plus aidé.

Merci d'avance pour votre aide.

En fait, un bundle OSGi a dans son MANIFEST.MF une directive "Export-Package" qui liste les packages qui sont declares comme accessibles aux autres bundles. Cet export package peut contenir des regles plus precises parfois.
Du coup Eclipse te dis quand tu as une dependance vers un bundle non exporte.

Ensuite, il y a l'"API tool" dans Eclipse http://www.eclipse.org/pde/pde-api-tools/ . En ajoutant des annotations a la javadoc (qu'Eclipse peut voir si tu installes la javadoc ou les sources), le producteur du plugin peut definir des regles d'acces plus fines et plus permissives qu'OSGi.

OK il y a donc d'une part les commentaires effectués par les développeurs Java qui déprécient ou interdisent les anciennes classes modifiées afin d'engager les développeurs à utiliser les nouvelles et de l'autre l'utilisation de classe de plugins et en particulier les packages exportés ou non.

Apparemment les "access rules" sont définis dans le build path du project eclipse dans les packages des librairies. Il est possible de défini une visibilité par chaque packages et donc par conséquent d'éventuelles erreurs ou warnings (suivant le paramétrage de l'ecran presenté au debut) du compilateur.


Merci à toi Mickael pour cet precision très importante.