API-verktøy gir mulighet til å håndtere Javadocs @since-koder som er lagt til APIen (typer, metoder, felter osv.).
Nye API-elementer kan være en ny type som er lagt til en API-pakke, en ny type som er lagt til en API-type, en ny metode som er lagt til en API-type, eller et nytt felt som er lagt til en API-type.
Tilføying av nye metoder er et spesialtilfelle, da en ny metode kan legges til en type og dermed overstyre metoden i en overordnet klasse, implementere en overordnet grensesnittmetode eller endre signaturen til en eksisterende metode.
Merk: @since-kodeinformasjon propageres ikke via implementering eller underordnede klasser. Alle elementer som legges til en API forventes å ha sin egen @since-kode og versjonsinformasjon.
Verktøyene gir følgende validering av @since-koder:
Preferansene for @since-kodeadministrasjon kan endres på
Plugin-utvikling > API-feil/-advarsler preferansesiden.
Alle nye API-elementer som oppdages, blir sjekket av verktøyet for å sikre at de har en @since-kode.
Hvis det nye elementet ikke har en @since-kode, blir det flagget med at det trenger en, og en ny versjon foreslås for koden.
Den foreslåtte versjonen til den nye koden blir den gjeldende versjonen av bunten, unntatt hvis det er en brytende API-endring hvor versjonen av bunten også må oppdateres. Hvis buntversjonen også må oppdateres, blir den foreslåtte versjonen til den manglende @since-koden den samme som den foreslåtte buntversjonen.
La oss se på følgende eksempel: vi har en bunt A med versjon 1.0.0, og vi har en klasse C som ble lagt til i versjon 1.1.0 av A som inneholder metoden m1().
@since-kode på m2(), og foreslå at den nye koden @since 1.1 blir satt på m2().@since-kode på m2() og foreslå at den nye koden @since 2.0 blir satt på m2(). Hvor 2.0.0
er den foreslåtte nye versjonen for bunten.
Det er mulig å sjekke at @since-kodene til nye elementer er konsekvente, for å sikre at de er riktig formulert. API-verktøy sjekker at alle @since-koder følger det generelle formatet:
[@since] [preamble] [todelt versjon] [postamble]
Se på følgende @since-kodeeksempler:
@since A 1 la til m2(): ville ha blitt flagget med at den har feil format, på grunn av at versjonen mangler i det andre segmentet@since: ville ha blitt flagget med at den har feil format, på grunn av at versjonsinformasjonen mangler@since A: ville ha blitt flagget på grunn av at versjonsinformasjonen mangler@since 1.0.0: ville ha blitt flagget på grunn av at versjonen har for mange segmenter@since A 1.0 la til m2(): ville ikke ha blitt flagget
Nye elementer kan også få sjekket at @since-kodene deres er gyldige. En @since-kode anses som gydig hvis versjonsinformasjonen til koden stemmer med versjonen av bunten.
La oss se på følgende eksempel hvor vi har lagt til den nye metoden m2() i en API-klasse i bunt A med versjonen 1.0.0:
@since A 1.0 la til metoden m2(): anses som gyldig@since A 2.0 la til metoden m2(): er ugyldig på grunn av at versjonen til bunt A er 1.0.0@since A 0.1 la til metoden m2(): er ugyldig på grunn av at versjonen til bunt A er 1.0.0

Preferanser for API-basis
Preferanser for API-feil og -advarsler