En målspecifikation anger de klasser och metoder som proben ska användas på.
Målspecifikationen är valfri. När inget mål har angetts kommer proben att användas på alla klasser som bearbetas av instrumentationsmotorn.
Med målspecifikationen kan du skapa filterregler som inkluderar eller utesluter metoder från instrumentationen beroende på mönster som matchas mot paket, klass och metodnamn, samt metodens signatur. Mönstren kan innehålla jokertecken där "*" matchar noll eller fler tecken.
Om målets jokerteckenmönster stämmer med metodens paket, klass, namn och signatur bestämmer egenskapen type om metoden instrumenteras (include) eller inte (exclude). Om mönstren inte matchar metodens paket, klass, namn och signatur instrumenteras metoden som standard.
Egenskap | Beskrivning |
---|---|
type | Krävs. Med egenskapen type bestämmer du om en prob ska användas på en målmetod. Ange include om du vill använda proben på klasser och metoder som stämmer med jokerteckenmönstren. Använd exclude om du vill utesluta dem. |
package | Valfritt. Ange ett jokerteckenmönster som ska matchas mot paketdelen i klassnamn.Exempel: java.util* matchar alla klasser i java.util-paketet och dess delpaket. Om du inte anger något är standardvärdet *. |
className | Valfritt. Ange ett jokerteckenmönster som matchas mot klassnamnen. Om du inte anger något är standardvärdet *. |
method | Valfritt. Ange ett jokerteckenmönster som matchas mot metodnamnen. Om du inte anger något är standardvärdet *. |
signature | Valfritt. Ange ett jokerteckenmönster som matchas mot metodens signatur. (signature är den sträng som representerar metodens argument och returtyp.) Använda internt Java-format för metodsignaturer. Exempel: (Ljava/lang/Object;)D är signaturen för en metod som kan använda Object som parameter och som returnerar Double. Det här jokerteckenmönstret kan användas till att urskilja överbelastade metoder. Om du inte anger något är standardvärdet *. |
Obs!
Du anger ett mål genom att markera Mål i trädfönstret på sidan Prober och klicka på Lägg till, och sedan på Redigera i redigeringsfönstret.
I det här exemplet används proben endast på de metoder vars namn börjar med Get i de klasser vars namn slutar med Proxy i paketet com.example. Målposter av typerna "include" och "exclude": målposten "exclude" använder asterisker som jokertecken för att utesluta allt, målposten "include" anger de exakta metoder som proben ska köras mot. Alla övriga klasser och metoder utesluts från instrumentationen.