En målspecifikation angiver de klasser og metoder, som proben skal anvendes på.
Det er valgfrit, om du vil angive en målspecifikation.Når der ikke er angivet nogen målspecifikation, anvendes proben på alle de klasser, der behandles af instrumenteringsprogrammet.
Med målspecifikationerne kan du oprette regler for filtrering, så du kan inkludere eller udelukke metoder fra instrumenteringen ud fra mønstre, der skal svare til pakken, klassen og metodenavnet plus metodens signatur. Mønstrene kan indeholde jokertegn, hvor en stjerne (*) matcher et eller flere tegn.
Hvis målets mønster af jokertegn matcher en metodes pakke, klasse, navn og signatur, bestemmer egenskaben type, om metoden er instrumenteret (include) eller ikke (exclude). Hvis mønstrene ikke matcher en metodes pakke, klasse og signatur, er metoden som standard instrumenteret.
Egenskab | Beskrivelse |
---|---|
type | Påkrævet. Egenskaben type bestemmer, om en probe skal anvendes på en målmetode. Angiv include for at anvende proben på de klasser og metoder, som matcher mønstret af jokertegn, exclude for at udelukke dem. |
package | Valgfrit. Angiv jokertegn i et mønster, der matcher pakkedelen af klassenavnet. Eksempel: java.util* matcher alle klasser i pakken java.util og de tilhørende underpakker. Hvis der ikke angives noget, er standardværdien *. |
className | Valgfrit. Angiv jokertegn i et mønster, der matcher klassenavne. Hvis der ikke angives noget, er standardværdien *. |
method | Valgfrit. Angiv jokertegn i et mønster, der matcher metodenavne. Hvis der ikke angives noget, er standardværdien *. |
signature | Valgfrit. Angiv jokertegn i et mønster, der matcher signaturen for en metode. (signature er den streng, der repræsenterer metodens argumenter og returtype). Brug det interne Java-format til metodesignaturer. Eksempel: (Ljava/lang/Object;)D er signaturen for en metode, som bruger et objekt som en parameter og returnerer en dobbelt. Dette mønster af jokertegn kan bruges til at skelne blandt overbelastede metoder. Hvis der ikke angives noget, er standardværdien *. |
Bemærkninger:
Hvis du vil angive et mål, skal du vælge Mål i delvinduet med træstrukturen på siden Prober, klikke på Tilføj og derefter på Redigér i redigeringsdelvinduet.
I dette eksempel anvendes proben kun på metoder, hvis navne begynder med Get i klasser, hvis navne slutter med Proxy i pakken com.example. Målindgange af typen include og exclude. I målindgangen exclude bruges jokertegnet stjerne (*) til at udelukke alt, i målindgangen include angives præcist de metoder, der skal målrettes. Alle andre klasser og metoder er udelukket fra instrumentering.