Agents › Agent Java pour DevTest › Utilisation de l'agent Java › Fichier rules.xml › Spécification de signature

Spécification de signature

Les directives suivantes du fichier rules.xml incluent une spécification de signature :

• exclude (exclure)
• intercept (intercept)
• respond (répondre)
• virtualize (virtualiser)

La spécification de signature permet de décrire les caractéristiques d'une signature de méthode Java.

La première partie de la spécification est le terme signature, suivi du signe égal et d'un point d'interrogation.

La deuxième partie de la spécification contient les arguments, placés entre parenthèses. Même si la méthode ne contient aucun argument, les parenthèses doivent être présentes.

La troisième partie de la spécification contient le type de retour, suivi par un point d'interrogation. Si le type de retour est vide, utilisez la lettre V.

N'incluez pas d'espaces dans la spécification.

Pour spécifier un type de primitive dans les arguments ou le type de retour, utilisez l'une des lettres suivantes :

Pour spécifier une classe complète, suivez la procédure suivante :

• Ajoutez la lettre L au début.
• Utilisez une barre oblique comme séparateur, au lieu du point.
• Ajoutez un point-virgule à la fin.

Par exemple :

Ljava/lang/String;

Exemple : One Argument, Returns Void (Un argument, renvoie une valeur vide)

Supposons que vous voulez intercepter la méthode onMessage() de l'interface javax.jms.MessageListener. Cette méthode a la signature suivante :

• L'argument est un objet javax.jms.Message.
• Le type de retour est vide.

La spécification de signature dans la règle d'intersection se présenterait comme suit :

signature="(Ljavax/jms/Message;)V"

Exemple : No Arguments, Returns Primitive Type (Aucun argument, renvoie le type de primitive)

Supposons que vous voulez intercepter la méthode getPriority() de l'interface javax.jms.MessageProducer. Cette méthode a la signature suivante :

• La méthode ne contient aucun argument.
• Le type de retour est un nombre entier.

La spécification de signature dans la règle d'intersection se présenterait comme suit :

signature="()I"