Interne APIs

Auch wenn es möglich ist, interne APIs vom Kundencode aus aufzurufen oder zu unterklassifizieren, wird ab Version 6.0.3 davon abgeraten. Solche APIs sind mit der Anmerkung @Accesslevel(INTERNAL) versehen.

Wichtig: 'Abgeraten' bedeutet in diesem Zusammenhang, dass ihre Verwendung zwar weiterhin unterstützt wird, aber dass solche APIs in künftigen Releases geändert oder entfernt werden können, nachdem dies dem Kunden mit einer Mindestankündigungsfrist von einem Jahr mitgeteilt worden ist.
Anmerkung: Es gibt jedoch keine solche Ankündigungsfrist für jegliche APIs, die in Version 6.0.3 als 'intern' markiert sind. Das bedeutet, dass es gegenwärtig keine Pläne gibt, eine der in 6.0.3 als 'intern' markierten APIs zu ändern. Daher sollte dem Kunden genügend Zeit zur Verfügung stehen, solche Migrationen zu planen.

Bestehende Kundenreferenzen auf APIs, die von Version 6.0.3 an als 'intern' markiert sind, erfüllen die gleiche Funktion wie zuvor, nur mit der Ausnahme, dass in Eclipse-Projekten, die solche Abhängigkeiten enthalten, Warnungen generiert werden.

Es ist anzustreben, dass sich die Projekte mit der Zeit von solchen Abhängigkeiten von internen APIs wegbewegen und keine neuen Abhängigkeiten geschaffen werden, wobei das auch kurzfristig unvermeidbar sein kann, wenn sich ein Kundenprojekt in seiner Design- oder Entwicklungsphase befindet. Die meisten jetzigen Kunden werden nach Übernahme von Version 6.0.3 oder späteren Versionen mit Warnungmeldungen konfrontiert sein. Es wird nicht erwartet, dass sie diese im Rahmen der Übernahme sofort beseitigen. Wie bereits angedeutet, hat dies keinen Einfluss auf den Support-Anspruch des Kunden.

Beachten Sie, dass, wie auch bei früheren Versionen der Anwendung, einige interne APIs dahingehend konfiguriert sind, dass sie in Eclipse fehlerhafte Zugriffsbeschränkungen generieren, wenn sie referenziert werden. Diese APIs sind mit der Anmerkung @Accesslevel(RESTRICTED)) versehen. Solche Verweise werden in Kundenprojekten nicht unterstützt. Diese APIs sind immer interne APIs gewesen und wurden auch bisher nicht für den Kundengebrauch unterstützt. Es ist deutlich zu erkennen, um welche Art der API es sich handelt: zugriffsbeschränkte APIs generieren Eclipse-Fehlermeldungen, nicht empfohlene APIs erzeugen Warnmeldungen in Eclipse.