Agents › Agent Java pour DevTest › Utilisation de l'agent Java › Exclusion de l'interception et de la virtualisation

Exclusion de l'interception et de la virtualisation

Vous pouvez empêcher l'agent Java pour DevTest d'intercepter ou de virtualiser une méthode, une classe ou un package en ajoutant la directive exclude (exclure) au fichier rules.xml de l'agent.

Le format de la directive exclude (exclure) se présente comme suit :

<exclude class="nom_classe" method="nom_méthode" signature="signature"/>

Vous pouvez placer la directive exclude dans l'élément group ou agent du fichier rules.xml.

Le format de la signature est décrit dans la section Spécification de signature.

Les hiérarchies de classes ne sont pas prises en compte. Supposons que la classe B étend la classe A et que les deux classes définissent la méthode M. Si vous excluez la classe A, la méthode M de la classe A ne sera pas capturée. Toutefois, la méthode M de la classe B le sera.

Si vous voulez exclure une classe ou un package sans tenir compte de la méthode ou de la signature, vous pouvez procéder de l'une des manières suivantes :

• Spécifiez method="*" signature="*".
• Ignorez les attributs method et signature.

Si vous ajoutez ou supprimez la directive exclude vous devez redémarrer l'agent.

Par défaut, CA Continuous Application Insight ne capture pas les méthodes getter et setter. Il n'est pas nécessaire d'exclure les méthodes getter et setter.

Exemples

Dans l'exemple suivant, la méthode serviceComposition() de la classe com.itko.examples.ejb3.OrdinaryBean est exclue. La méthode ne contient aucun argument. La méthode renvoie un objet java.lang.String.

<exclude class="com.itko.examples.ejb3.OrdinaryBean" method="serviceComposition" signature="()Ljava/lang/String;"/>

Dans l'exemple suivant, la classe com.itko.examples.ejb3.OrdinaryBean est exclue.

<exclude class="com.itko.examples.ejb3.OrdinaryBean"/>

Dans l'exemple suivant, le package com.itko.examples.ejb est exclu. Vous pouvez observer l'utilisation d'un caractère générique unique.

<exclude class="com.itko.examples.ejb.*"/>

L'exemple suivant exclut le package com.itko.examples et tous ses sous-packages. Vous pouvez observer l'utilisation de deux caractères génériques.

<exclude class="com.itko.examples.**"/>