4.dia Annotációk a Java programozási nyelvben

Question 1

Annotáció fogalma

Answer 1

Olyan metaadat a programkonstrukcióhoz, amelynek nincsen közvetlen kihatása a programvégrehajtásra.
Gépi feldolgozásra szolgálnak fordítási illetve akár futási időben. Használható dokumentációra is, tömör formában.

Question 2

Lehetséges felhasználások

Answer 2

Fordításidejű feldogozás :
Például tekintsen el egy figyelmeztetéstől vagy jelezzen bizonyos hibákat.
Pl: @Depricated, @Override
Futásidejű feldolgozás :
Vannak olyan annotációk amelyekhez hozzáférhetünk végrehajtás közben is.
Kódgenerálás :
Pl: Dagger, Jakarta XML Binding, Project Lombok
Egységtesztelés: JUnit
Perzisztencia: Jackson, Jakarta Persistence, Jakarta XML Bindig, Jdbi
HTTP kliensek: Feign, Rerofit
Függőség befecskendezés: Guice, Spring Framework
Alkalmazás keretrendszerek: Micronaut Framework, Spring Framework

Question 3

Annotációk szintaxisa

Answer 3

Részei:
AnnotációInterfészNeve(Opcionális=Lista,Kulcs=ÉrtékPárokkal)
Az annotáció interfész határozza meg, hogy milyen kulcs-érték párokat lehet megadni. Ha van alapértelmezett érték, azt nem kötelező megadni. Ezeknek a sorrendje nem számít.
Ha egy elem lista, akkor Annot(Opc={Lista,Igy.Kell})

Question 4

Annotációk fajtái

Answer 4

Közönséges annotáció:
Több kulcs-érték párból áll.
Egyelemű annotáció:
Egy kulcs-érték párból áll.
Jelölő annotáció:
Nincsen kulcs-érték pár.
(Elhagyható a zárójel.)

Question 5

Hol alkalmazható annotáció?

Answer 5

-Deklarációkra (Deklaráció annotáció):
Konstruktor, metódus, osztályváltozó, lokális változó, formális paramtére, típusparaméter, osztály, interfész (akár annotációs interfészek), enum, enum konstans, rekord, rekord komponens, modul, csomag.
-Deklarációkban és kifejezésekben használt típusokra (Típus annotáció)

Question 6

@Deprecated (Előre definiált annotáció interfészek)

Answer 6

Az annotációval ellátott elem használata kerülendő, lehet veszélyes vagy létezik jobb alternatíva.
(Javadocban is érdemes jelezni @depricated)
Következmény: Figyelmeztet amikor ezt az elemet akarjuk használni.
Két eleme van:
since : Melyik verzióban lett elavult. (string)
forRemoval : elem jövőben törlésre fog kerülni. (bool)

Question 7

@SuppressWarnings (Előre definiált annotáció interfészek)

Answer 7

Az adott elem és a benne lévő programelemek által adott figyelmeztetéseket ne vegyen figyelembe.

Question 8

@Override (Előre definiált annotáció interfészek)

Answer 8

A megjelőlt metódus felülír egy ősosztályban deklarált metódust.
Nem kötelező megadni, de ajánlott a hibák (elírások) elkerülése szempontjából.

Question 9

@FunctionalInterface (Előre definiált annotáció interfészek)

Answer 9

Funkcionális interfészt jelez, amelynek pontosan egy absztrakt metódusa van.

Question 10

@Documented (Meta-annotációk)

Answer 10

Az általa jelölt annotáció interfész annotációinak használata meg kell, hogy jelenjen az API dokumentációjában. (Ez alapértelmezetten nem történik meg.)

Question 11

@Inherited (Meta-annotációk)

Answer 11

Azt jelzi, hogy egy annotáció intefész automatikusan öröklődik. (Alapértelmezetten ilyen nincs.)

Question 12

@Repeatable (Meta-annotációk)

Answer 12

Az annotócói interfész akár többször is használható ugyan azon a deklaráción vagy típusok.

Question 13

@Retention (Meta-annotációk)

Answer 13

A megjelölt annotáció interfész annotáióhoz határoz meg tárolási módot.
Lehet
RetentionPolicy.SOURCE: a fordító figyelmen kívül hagyja az annotációt.
RetentionPolicy.CLASS: a fordító eltárolja az annotációkat a bájtkódban, de azokat futásidőben nem lehet elérni.
RetentionPolicy.RUNTIME: a fordító a bájtkódban eltárolja az annotációt, és azt el lehet érni futásidőben.

Question 14

@Target (Meta-annotációk)

Answer 14

Mgehatározza hogy az annotáció interfész annotációja (milyen deklarációnál) hol használható.
ElementType.ANNOTATION_TYPE : Annotáció intefész
ElementType.CONSTRUCTOR : Konstruktor
ElementType.METHOD : Metódus
ElementType.FIELD : Osztályváltozó, enum konstans
ElementType.LOCAL_VARIABLE : Lokális változó
ElementType.PARAMETER : Formális paraméter
ElementType.TYPE_PARAMETER : Típusparaméter
ElementType.TYPE : Osztály, interfész, enum, rekord
ElementType.TYPE_USE : Típus
ElementType.RECORDE_COMPONENT : Rekord komponens
ElementType.MODULE : Modul
ElementType.PACKAGE : Csomag

Question 15

Annotáció interfészek deklarálása

Answer 15

módosítók @interface név { deklarációk }
Egy speciális interfészt határoz meg. Nem lehetnek generikusak és nem lehet szülőinterfészük, mindegyik szuper-interfésze a java.lang.annotation.Annotation közönséges interfész.
Törzsében lehet:
Osztály-, (annotation) interfész-, konstans- és speciális metódus deklarációk.
Speciális metódus fog jelenteni egy elemet. Nem lehetnek formális paraméterei, típusparaméterei es throws kulcsszót sem tartalmazhat. Nem lehet ezen túl privát, default és static. Visszatérési értéke megadja az elem típusát:
Primitívek, String, Class vagy Class<T1,..,Tn>, enum, annotációs interfész, ezekből tömb. A ‘default’ kulcsszóval alapértelmezett értéket lehet hozzáadni.

Question 16

Deklaráció és típus annotációk

Answer 16

Az annotáció interfész deklaráció határozza meg, hogy melyik.