API internes

Même s'il est possible d'appeler et d'associer à une sous-classe des API internes à partir du code personnalisé, cela est déconseillé dans la version 6.0.3. Ces API sont annotées avec @Accesslevel(INTERNAL).

Important : Dans ce contexte, 'déconseillé' signifie que leur utilisation continue d'être prise en charge, mais que ces API peuvent être changées ou supprimées dans les éditions ultérieures, lorsqu'un délai de préavis minimal d'un an a été accordé aux clients à l'égard de tout changement ou suppression de ce type.

Remarque : Aucun préavis de ce type n'est accordé pour l'une des API marquées comme internes dans la version 6.0.3 (c'est-à-dire qu'il n'existe pas de plans en cours permettant de changer l'une des API marquées comme internes dans la version 6.0.3). Par conséquent, les clients doivent pouvoir bénéficier d'un délai approprié pour planifier ce type de migrations.

Les références client existantes aux API marquées comme internes à partir de la version 6.0.3 continueront à fonctionner comme auparavant, à cela près que les avertissements dissuasifs seront générés dans les projets Eclipse qui disposent de ces dépendances.

Les projets doivent s'efforcer de s'écarter de ces dépendances concernant les API internes au fil du temps. De plus, ils ne doivent pas introduire de nouvelles dépendances associées (dans la mesure du raisonnable et en fonction du stade où se situe un projet client dans son processus de conception/développement, cela peut être inévitable à court terme). La plupart des clients existants verront des références déconseillées signalées après le passage à la version 6.0.3 ou versions ultérieures. De plus, il n'est pas prévu que les clients les corrigent immédiatement dans le cadre de ce passage. Comme mentionné plus haut, cela n'aura pas d'incidence sur leurs droits de support.

Notez que comme avec les versions précédentes de l'application, certaines API internes ont été configurées pour générer des erreurs "d'accès restreint" dans Eclipse en cas de référencement (ces API sont annotées avec @Accesslevel(RESTRICTED)) et ces références ne seront pas prises en charge dans les projets client. Ces API ont toujours été internes et n'ont jamais été prises en charge pour l'utilisation client ; il sera alors facile de les identifier (les API d'accès restreint génèrent des erreurs Eclipse et les API déconseillées génèrent des avertissements Eclipse).