In diesem Thema wird beschrieben, wie ein Codeabdeckungs-Plug-In erstellt wird. Sie sollten mit dem Silk Central-Baseline-Konzept vertraut sein. In Silk Central wird vor jedem Lauf eine Baseline benötigt. Eine Baseline enthält alle Namensräume/Pakete/Klassen/Methoden der Testanwendung.
Anmerkung: Das Silk Central-API erfordert die Rücksendung einer XML-Datei für Codeabdeckungsläufe. Dies bedeutet, dass Sie zusätzliche Schritte unternehmen
müssen, um Ihre Daten abzurufen, wenn das Codeabdeckungs-Tool die Codeabdeckungsinformationen in einer Datenbank speichert.
Anmerkung: Testläufe des Codeanalyse-Systems von verschiedenen Ausführungsservern zur gleichen Zeit werden nicht unterstützt.
- Fügen Sie dem Klassenpfad die Bibliothek scc.jar hinzu. Diese Bibliothek enthält die Schnittstellen, die Sie erweitern müssen. Sie finden die jar-Datei im Verzeichnis lib des Silk Central-Installationsverzeichnisses.
- Fügen Sie die folgenden zwei Importanweisungen hinzu:
import com.segue.scc.published.api.codeanalysis.CodeAnalysisProfile;
import com.segue.scc.published.api.codeanalysis.CodeAnalysisProfileException;
import com.segue.scc.published.api.codeanalysis.CodeAnalysisResult;
- Erstellen Sie eine Klasse, die CodeAnalysisProfile implementiert.
- Fügen Sie alle benötigten Methoden aus der Codeabdeckungsschnittstelle hinzu, welche in den folgenden Schritten aufgelistet
sind. Sie können sich für dessen Definition entweder auf die Sample Interface Class beziehen und die Methoden manuell implementieren, oder Sie können den Inhalt von Sample Profile Class kopieren und einfügen, da es die Definitionen für Importe und Methoden bereits enthält.
Anmerkung: Die Methoden in den folgenden Schritten, die Sie schreiben werden, werden von Silk Central abgerufen, wenn sie benötigt werden. Das heißt, Sie werden diese nicht direkt abrufen.
- Code getBaseline. Diese Methode sollte eine XML-Datei erzeugen, die alle Namensräume/Pakete/Klassen/Methoden der Anwendung enthält. Details
über das Format der Datei finden Sie in der Themendatei XML-Beispieldatei. Überprüfen Sie die XML-Daten unter Verwendung der XSD-Beispieldatei. Details über XSD finden Sie im Thema Codeabdeckung XSD.
Diese Funktion wird aufgerufen, bevor mit der Abdeckung begonnen wird, und wird entweder durch das Starten eines Testlaufs
des Silk Central-Ausführungsservers ausgelöst, um die Codeanalyse zu starten und alle abzudeckenden Objekte darzustellen. Die Ausgabe muss
unter Verwendung des im XML-Schema spezifizierten Formats, welches im Installationsorder CA-Framework enthalten ist, in XML
konvertiert werden.
- Code startCoverage. Dieser Aufruf sollte dem Codeabdeckungs-Tool mitteilen, mit der Datensammlung zu beginnen. Geben Sie true zurück, wenn die Operation gestartet wurde.
Dies wird durch das Silk Central-Codeabdeckungssystem aufgerufen, nachdem die Methode getBaseLine() abgeschlossen ist. Jetzt sollten Sie das Codeabdeckungs-Tool zum Sammeln von Codeabdeckungsdaten starten.
- Code stopCoverage. Dieser Aufruf sollte dem Codeabdeckungs-Tool mitteilen, die Datensammlung zu beenden. Geben Sie true zurück, wenn die Operation erfolgreich durchgeführt wurde.
Dies wird nach startCoverage aufgerufen und wird ausgelöst wenn der Silk Central-Ausführungsserver einen Testlauf beendet hat.
- Code getCoverage. Dies erzeugt eine XML-Datei mit den gesammelten Daten von den zwischen den Methoden startCoverage undstopCoverage gesammelten Daten. Details über das Format der Datei finden Sie im Thema XML-Beispieldatei. Überprüfen Sie die XML-Daten unter Verwendung der XSD-Beispieldatei. Details über XSD finden Sie im Thema Codeabdeckung XSD.
Diese Funktion wird nach stopCoverage() aufgerufen und gibt alle gesammelten Abdeckungsdaten zurück. Die Ausgabe muss unter Verwendung des im XML-Schema spezifizierten
Formats in XML konvertiert werden.
- Code GetName. Dies sollte den Namen bereitstellen, der als Referenz für das Codeabdeckungs-Tool verwendet wird. So wird zum Beispiel dieser
Wert als einer der Werte im Listenfeld Codeanalyse Profil im Dialog Einstellungen für die Codeanalyse bearbeiten verwendet.
Dies wird zuerst durch das Silk Central-Codeabdeckungssystem aufgerufen. Der Name des Plug-Ins wird in der Codeabdeckungs-Liste in Silk Central angezeigt.
- Integrieren Sie das Plug-In in ein Jar-Archiv, und platzieren Sie das Jar-Archiv in einer ZIP-Datei.
- Verteilen Sie Ihr Plug-In auf die folgenden Servergruppen:
- Im Verzeichnis Plugins des Silk Central-Installationsordners.
- Im Verzeichnis Plugins der CA-Framework-Installation.