Ohjelmointirajapintojen työkaluissa on ohjelmointirajapintaan lisättyjen uusien elementtien (esimerkiksi tyyppien, metodien ja kenttien) @since-Javadoc-tunnisteiden hallintatuki. Ohjelmointirajapinnan uudet elementit voivat olla ohjelmointirajapinnan pakettiin tai lajiin lisättyjä uusia lajeja tai ohjelmointirajapinnan lajiin lisättyjä uusia metodeja tai kenttiä. Metodin lisäykset ovat erityistapauksia, joissa metodin lisäys voi merkitä metodin lisäystä lajiin, pääluokan metodin ohitusta, päärajapinnan metodin toteutusta tai aiemmin luotujen metodien allekirjoituksen muutosta.
Huomautus: @since-tunnisteiden tietoja ei välitetä toteutusten tai aliluokkien kautta. Kullakin ohjelmointirajapintaan lisättävällä elementillä oletetaan olevan omat @since-tunnisteensa ja versiotietonsa.
Työkalut sisältävät seuraavat @since-tunnisteiden tarkistukset:
@since-tunnisteet@since-tunnisteet@since-tunnisteen versiot.@since-tunnisteiden hallinnan oletusasetuksia voi muuttaa
Lisäosien kehitys > Ohjelmointirajapinnan virheet/varoitukset -oletusasetussivulla.
Työkalut tarkistavat, onko jokaisessa uudessa havaitussa ohjelmointirajapinnan elementissä @since-tunniste.
Jos elementissä ei ole @since-tunnistetta, elementtiin lisätään määrite @since-tunnisteen tarpeesta. Järjestelmä ehdottaa lisäksi tunnisteelle versiota. Uuden tunnisteen ehdotettu versio on resurssijoukon nykyinen versio, paitsi jos kyseessä on rikkova ohjelmointirajapinnan muutos, jolloin myös resurssijoukon versio on päivitettävä. Jos myös resurssijoukon versio on päivitettävä, puuttuvan @since-tunnisteen ehdotettu versio on sama kuin resurssijoukon ehdotettu versio.
Tutustu seuraavaan esimerkkiin: järjestelmässä on resurssijoukko A, jonka versio on 1.0.0, ja luokka C, joka on lisätty resurssijoukon A versioon 1.1.0. Kyseinen versio sisältää metodin m1().
@since-tunniste, ja ehdottavat, että metodiin m2() sijoitetaan uusi tunniste, @since 1.1.@since-tunniste, ja ehdottavat, että metodiin m2() sijoitetaan uusi tunniste, @since 2.0. Tässä esimerkissä 2.0.0 on resurssijoukon uusi ehdotettu versio.
Uusien elementtien @since-tunnisteiden ristiriidattomuus voidaan tarkistaa, jolloin varmistetaan, että tunnisteet on muotoiltu oikein. Ohjelmointirajapinnan työkalut tarkistavat, että kaikki @since-tunnisteet noudattavat seuraavaa yleistä muotoilua:
[@since] [johdanto] [kaksiosainen versio] [jälkiliite]
Tutustu seuraaviin @since-tunniste-esimerkkeihin:
@since A 1 added m2(): tunniste merkittäisiin virheellisesti muotoilluksi, koska versiosta puuttuu toinen segmentti@since: tunniste merkittäisiin virheellisesti muotoilluksi, koska versiotietoja ei ole@since A: tunniste merkittäisiin, koska versiotietoja ei ole@since 1.0.0: tunniste merkittäisiin, koska versiossa on liian monta segmenttiä@since A 1.0 added m2(): tunnistetta ei merkittäisi.
Myös uusien elementtien @since-tunnisteiden kelpoisuus voidaan tarkistaa. @since-tunnistetta pidetään kelvollisena, jos tunnisteen versiotiedot vastaavat resurssijoukon versiota.
Tutustu seuraavaan esimerkkiin. Esimerkissä on lisätty uusi metodi m2() ohjelmointirajapinnan luokkaan, joka sijaitsee resurssijoukossa A, jonka versio on 1.0.0:
@since A 1.0 added method m2(): tunniste on kelvollinen@since A 2.0 added method m2(): tunniste on virheellinen, koska resurssijoukon A versio on 1.0.0@since A 0.1 added method m2(): tunniste on virheellinen, koska resurssijoukon A versio on 1.0.0.

Ohjelmointirajapintojen perustasojen oletusasetukset
Ohjelmointirajapintojen virheiden ja varoitusten oletusasetukset