Vizsgálótöredék adatelemek

A töredékek adatelemei azok az adatelem nevek és típusok, amikre a töredék forráskódja hivatkozhat.

Az adatelemek meghatározásai elhagyhatóak. Egy töredék több adatelemet tartalmazhat, de minden elemtípus csak egyszer szerepelhet.

Egy adatelem az alábbi tulajdonságokat tartalmazza:
Tulajdonság Leírás
Adattípus Kötelező. A rendelkezésre álló típusok az alábbi táblázatban olvashatók.
Név Kötelező. Egy érvényes Java változó nevét kell meghatároznia. A vizsgálótöredék forráskódja ezzel a névvel hivatkozik a jelzett adatokra.
Az alábbi táblázat a Vizsgálókészlet szerkesztőn keresztül elérhető adattípusok felsorolását és leírását tartalmazza:
Data Type Típus Leírás
className String (karaktersorozat)

Metódusvizsgálóknál a vizsgált metódus osztályneve, beleértve a csomagnevet, belső formátumban; hívóhely vizsgálóknál a hívott metódus osztályneve.

Példa: org/eclipse/tptp/SomeClass

methodName String (karaktersorozat)

Metódusvizsgálóknál a vizsgált metódus metódusneve, belső formátumban; hívóhely vizsgálóknál a hívott metódus metódusneve.

A konstruktorok <init>, a statikus osztály inicializálók <clinit> metódusnévvel rendelkeznek.

methodSig String (karaktersorozat)

A metódus argumentum és visszatérési típus belső formátumú aláírása. StaticInitializer töredékeknél érvénytelen.

Például: (Ljava/lang/String;)I

thisObject Object (objektum)

A this (a példány metódusok esetén) a vizsgált metódus számára átadott objektum. StaticInitializer töredékeknél érvénytelen.

A thisObject null értékkel rendelkezik a statikus metódusok, a konstruktorokra alkalmazott entry töredékek és a konstruktorban kivétel dobásakor a konstruktorokra alkalmazott exit töredékek esetén.

args Object[] (objektumtömb)

Egy Object hivatkozásokból álló, a vizsgált metódusok argumentumait képviselő tömb. A metódusokhoz tartozó minden egyes argumentumhoz (nem számítva a this argumentumot) tartozik egy elem ezen tömbben. A primitív típusú argumentumok a megfelelő hivatkozástípus ideiglenes objektumaihoz kötöttek, például: Integer az int típushoz. Ha a metódus nem fogad argumentumokat, akkor az Object[] tömb mérete nulla.

Megjegyzés: A nem statikus belső osztályok konstruktorainak "belső" szintenként van egy rejtett argumentumuk, így az argumentumtömb több elemet tartalmaz a forráskódban megjelenőnél. StaticInitializer töredékeknél érvénytelen.

returnedObject Object (objektum) A visszaadásra kerülő objektum hivatkozása. Ez a típus csak az exit és az afterCall töredékeknél áll rendelkezésre. Ha a vizsgált metódus visszatérési típusa primitív típus, akkor a visszatérési érték a megfelelő hivatkozási típus ideiglenes objektumához kötött. A void metódus (nincs visszatérési érték), vagy kivétel általi kilépés esetén a returnedObject null értékű lesz.
exceptionObject Throwable (dobható) A dobásra kerülő kivétel objektum hivatkozása. Ezen típus csak a catch és exit töredékek esetén elérhető. A metódus normális befejezése esetén az exceptionObject null értékű lesz.
isFinally boolean (logikai) Jelző, amely azt jelzi, hogy a töredék egy finally záradékból (true - igaz), vagy egy catch záradékból (false - hamis) került-e meghívásra. Csak a catch töredékek esetén érvényes.
staticField (változik) A statikus mező által hivatkozott objektum. Ennek típusa megegyezik a staticField objektumban meghatározott típussal. Ez csak akkor érvényes, ha a vizsgáló meghatároz egy staticField objektumot. (Lásd: Példa staticField és staticInitializer vizsgálóra.) Érvénytelen hívóhelyi vizsgálók esetén.
classSourceFile String (karaktersorozat) Az osztály fájljának hibakeresési jellemzőiből elérhető fájlnév információk. Ha nincsenek forrás információk, akkor a classSourceFile null értékű lesz. Java esetén az érték jellemzően csak a fájlnév, elérési út nélkül. Érvénytelen hívóhelyi vizsgálók esetén.
methodNames String (karaktersorozat)

Metódusnevek és aláírások kódolt listája. A listában a metódusok sorrendje megegyezik a methodLineTables elem metódussorrendjével és a methodNumber adatelem által tükrözött sorrenddel. A lista nem tartalmazza egyetlen Vizsgálókészlet által beszúrt metódus nevét sem.

A methodNames karaktersorozat néhány plusz ("+") jellel elválasztott metódusnévből és aláírásból áll. A metódus aláírások Java belső formátumúak. Például két metódussal rendelkező osztály esetén a String típusú értéket fogadó és int típussal visszatérő alapértelmezett run konstruktormetódus a következő methodNames karaktersorozattal rendelkezik: <init>()V+run(Ljava/lang/String;)I

Érvénytelen hívóhelyi vizsgálók esetén.

methodLineTables String (karaktersorozat) Az osztályban lévő összes végrehajtható kódegységgel kapcsolatos sorok számának kódolt listája. A lista nem tartalmaz egyetlen Vizsgálókészlet által osztályba beszúrt végrehajtható egységet sem. A kódolással kapcsolatos magyarázat a methodLineTables adat karaktersorozat formátum részben található. Érvénytelen hívóhelyi vizsgálók esetén.
methodNumber Integer (egész szám) A methodNames táblázatban lévő sorszám, amely azon metódushoz tartozik, amelybe a vizsgáló töredék beszúrásra került. Hívóhely vizsgálók és staticInitializer töredékek esetén érvénytelen.
executableUnitNumber Integer (egész szám) Azon végrehajtható egység száma, amelybe a vizsgáló töredék beszúrásra került. Ez az adattípus csak az executableUnit és az elfogás vizsgálótöredékek esetén érvényes. Ha a metódushoz nem tartoznak forrás sor információk, akkor egyetlen, nullás számozású végrehajtható egységgel rendelkező metódusként jelenik meg.
Példa:

Vizsgálótöredék adatelemek megadásához kattintson a Töredék elemre a fapanelben, majd a Hozzáadás és Szerkesztés lehetőséggel írja be, illetve határozza meg az adatelemeket.

Vizsgálókészlet szerkesztő, benne egy töredék adatelemeivel

Kapcsolódó leírások
Vizsgálótöredék Java forráskódja
Vizsgálótöredék típusok