Kohdemääritys osoittaa luokat ja metodit, joihin luotausta käytetään.
Kohdemääritys on valinnainen. Jos kohdetta ei ole määritetty, luotausta käytetään kaikkiin luokkiin, jotka instrumentointi käsittelee.
Kohdemäärityksen avulla voit luoda suodatussääntöjä, jotka sisällyttävät tai sulkevat pois metodeja instrumentoinnista sellaisten merkkijonojen perusteella, joita verrataan pakettien, luokkien ja metodien nimiin sekä metodin allekirjoitukseen. Merkkijonoissa voi olla yleismerkkejä, joista "*" vastaa nollaa tai useampaa merkkiä.
Jos kohteen yleismerkin sisältävät merkkijonot vastaavat metodin pakettia, luokkaa, nimeä ja allekirjoitusta, type-ominaisuus määrittää metodin instrumentoinnin (include) tai ei (exclude). Jos merkkijonot eivät vastaa metodin pakettia, luokkaa, nimeä ja allekirjoitusta, oletusarvon mukaan metodi instrumentoidaan.
Ominaisuus | Kuvaus |
---|---|
type | Pakollinen. type-ominaisuus määrittää, käytetäänkö luotausta kohdemetodiin vai ei. Määritä include-arvo, jos haluat käyttää luotausta luokissa ja metodeissa, jotka vastaavat yleismerkin sisältäviä merkkijonoja, tai exclude-arvo, jos et halua. |
package | Valinnainen. Määritä yleismerkin sisältävä merkkijono, jota verrataan luokkanimien pakettiosaan. Esimerkki: java.util* vastaa jokaista luokkaa java.util-paketissa ja sen alipaketeissa. Jos arvoa ei ole määritetty, oletusarvo on *. |
className | Valinnainen. Määritä yleismerkin sisältävä merkkijono, jota verrataan luokkanimiin. Jos arvoa ei ole määritetty, oletusarvo on *. |
method | Valinnainen. Määritä yleismerkin sisältävä merkkijono, jota verrataan metodinimiin. Jos arvoa ei ole määritetty, oletusarvo on *. |
signature | Valinnainen. Määritä yleismerkin sisältävä merkkijono, jota verrataan metodin allekirjoitukseen. (Allekirjoitus on merkkijono, joka edustaa metodin argumentteja ja palautustyyppiä.) Käytä Javan sisäistä muotoa metodien allekirjoituksissa. Esimerkki: (Ljava/lang/Object;)D on sellaisen metodin parametri, joka ottaa parametriksi objektin ja palauttaa kaksoistarkkuusliukuluvun. Tämän yleismerkin sisältävän merkkijonon avulla voi erotella ylikuormitetut metodit. Jos arvoa ei ole määritetty, oletusarvo on *. |
Huomautukset:
Voit määrittää kohteen valitsemalla Kohde-vaihtoehdon Luotaukset-sivun rakenneruudussa, valitsemalla Lisää-vaihtoehdon ja valitsemalla sitten Muokkaa-vaihtoehdon muokkausruudussa.
Tämä esimerkki käyttää luotausta vain metodeihin, joiden nimet alkavat Get luokissa, joiden nimet loppuvat Proxy paketissa com.example. Include- ja exclude-tyyppien kohdemerkinnät; exclude-kohdemerkinnässä tähti yleismerkkinä sulkee kaikki pois; include-merkintä määrittää kohdemetodit. Kaikki muut luokat ja metodit on suljettu pois instrumentoinnista.