Agents › Agent Java pour DevTest › Utilisation de l'agent Java › Fichier rules.xml › Règles d'instrumentation pour le VSE

Règles d'instrumentation pour le VSE

Vous pouvez personnaliser la fonctionnalité du VSE en ajoutant la directive virtualize (virtualiser) au fichier rules.xml de l'agent.

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

Ajout d'une classe pour la virtualisation (modes d'enregistrement et de lecture)

<virtualize class="class_name"/>

Exemple :

<virtualize class="javax.ejb.SessionBean"/>

Indication à l'agent de la méthode permettant de déterminer une session d'un protocole spécifique

Pour effectuer cette tâche, fournissez un extrait de code qui renvoie un identificateur de session.

<virtualize>
   <track class="class_name" method="method_name" signature="signature" push="true|false">
      <code><![CDATA[" and ends with "]]></code>
   </track>
</virtualize>

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

Exemples :

<virtualize>
   <track class="javax.servlet.http.HttpServlet" method="service" signature="(Ljavax/servlet/http/HttpServletRequest;Ljavax/servlet/http/HttpServletResponse;)V" push="false">
      <code><![CDATA["return $1.getSession().getId();"]]></code>
   </track>
</virtualize>

<virtualize>
   <track class="javax.ejb.SessionBean" method="setSessionContext" signature="(Ljavax/ejb/SessionContext)V" push="true">
      <code><![CDATA["return $1.getEJBObject().getHandle().toString();"]]></code>
   </track>
</virtualize>

<virtualize>
   <track class="javax.ejb.EntityBean" method="setEntityContext" signature="(Ljavax/ejb/EntityContext)V" push="true">
      <code><![CDATA["return $1.getPrimaryKey().toString();"]]></code>
   </track>
</virtualize>

Ces exemples sont codés de manière irréversible dans l'agent ; ils sont donc inutiles dans votre fichier rules.xml. Toutefois, ces lignes indiquent le fonctionnement du processus pour son implémentation pour des protocoles, autres que les protocoles HTTP et EJB, sans recompiler l'agent.

La valeur de l'attribut class est la classe avec laquelle vous accédez à une session.

La valeur des attributs method et signature déterminent la méthode qui calcule l'identificateur de session lorsqu'elle est appelée. Ce calcul utilise la valeur de l'attribut code. $0 représente l'objet source. $1, $2, etc., sont les arguments de méthode.

L'attribut push (transmettre) définit la méthode de stockage de cette session pour son utilisation ultérieure par les trames du VSE.

• push="true" indique que le conteneur définit la session et qu'un mappage de l'objet est conservé pour la session.
• push="false" signifie que la session est limitée par un thread et que le stockage est effectué dans une variable de thread local.

La session la plus profonde (identificateur) est renvoyée via le VSE dans la méthode com.itko.lisa.remote.vse.VSEFrame getSessionId(). Pour plus d'informations, consultez le document JavaDocs dans le répertoire LISA_HOME\doc.