Das Zieltestobjekt ist eine Spezifikation der Klassen und Methoden, auf die der Test angewendet wird.
Das Zielobjekt ist optional. Wenn kein Ziel angegeben wird, so wird der Test auf alle Klassen angewendet, die von der Instrumentierungsengine verarbeitet werden.
Mit dem Zielobjekt lassen sich Filterregeln erstellen, mit Hilfe derer Methoden auf der Basis von Mustern, die mit dem Paket, der Klasse, dem Methodennamen und der Methodenkennung abgeglichen werden, in die Instrumentierung ein- oder von ihr ausgeschlossen werden können. Die Muster können Platzhalterzeichen enthalten, wobei "*" keinem oder mehreren Zeichen entsprechen kann.
Wenn die Platzhalterzeichen eines Ziels mit Paket, Klasse, Namen und Kennung einer Methode übereinstimmen, so bestimmt die Eigenschaft type, ob die Methode instrumentiert wird (include) oder nicht (exclude). Wenn die Muster nicht mit Paket, Klasse, Namen und Kennung einer Methode übereinstimmen, so wird die Methode standardmäßig instrumentiert.
Eigenschaft | Beschreibung |
---|---|
type | Erforderlich. Die Eigenschaft type bestimmt, ob ein Test auf eine Zielmethode angewendet wird, oder nicht. Wird include angegeben, so wird der Test auf die Klassen und Methoden angewandt, die mit den Platzhalterzeichen übereinstimmen, mit exclude werden sie ausgeschlossen. |
package | Optional. Geben Sie ein Platzhalterzeichen ein, um gegen Klassennamen des Paketteils abzugleichen.Zum Beispiel: java.util* gleicht alle Klassen im Paket java.util sowie den entsprechenden Unterpaketen ab. Wenn nicht angegeben, ist der Standardwert *. |
className | Optional. Geben Sie ein Platzhalterzeichen ein, um gegen Klassennamen abzugleichen. Wenn nicht angegeben, ist der Standardwert *. |
method | Optional. Geben Sie ein Platzhalterzeichen ein, um gegen Methodennamen abzugleichen. Wenn nicht angegeben, ist der Standardwert *. |
signature | Optional. Geben Sie ein Platzhalterzeichen ein, um gegen die Kennung einer Methode abzugleichen - d.h. die Zeichenfolge, welche die Argumente und die Rückgabeart der Methode darstellt. Dies ist das Java-interne Format für Methodenkennungen. Zum Beispiel: (Ljava/lang/Object;)D ist die Kennung einer Methode, die ein Objekt als Parameter annimmt, und ein Gegenstück zurückgibt. Dieses Platzhalterzeichen kann verwendet werden, um zwischen Überlastungsmethoden zu unterscheiden. Wenn nicht angegeben, ist der Standardwert *. |
Hinweise:
<target type="include" package="." class="SomeClass" method="*" /> <target type="exclude" package="*" class="*" method="*" />Diese beiden Zielregeln setzen den Test auf die Klasse IrgendeineKlasse im globalen Paket an, während alle anderen Klassen ausgeschlossen werden. Nach diesen Regeln wird eine andere Klasse mit Namen IrgendeineKlasse, das sich in irgendeinem anderen Paket befindet, ausgeschlossen.
<target type="include" package="com.example" className="*Proxy" method="Get*" />
Enthalten in
Das Testobjekt
Übergeordnetes Thema: Probekit-Beispiele