Einführung in Cobertura

Um mit der Berechnung der Codeabdeckung in Ihrem Java-Projekt zu beginnen, müssen Siedeclare the Cobertura Maven plugin in your pom.xml file im Berichtsabschnitt eingeben:

Sie können immer die neueste Version des Plugins inMaven central repository überprüfen.

Sobald Sie fertig sind, führen Sie Maven aus und geben Siecobertura:cobertura als Ziel an.

Dadurch wird ein detaillierter Bericht im HTML-Stil erstellt, der Statistiken zur Codeabdeckung enthält, die über die Codeinstrumentierung erfasst wurden:

The line coverage metric shows how many statements are executed in den Unit Tests laufen, währendthe branch coverage metric focuses on how many branches are covered by those tests.

Für jede Bedingung haben Sie zwei Zweige. Im Grunde haben Sie also doppelt so viele Zweige wie Bedingungen.

The complexity factor reflects the complexity of the code - steigt an, wenn die Anzahl der Zweige im Code zunimmt.

Je mehr Zweige Sie haben, desto mehr Tests müssen Sie theoretisch implementieren, um die Zweigabdeckungsbewertung zu verbessern.

Sie können einen bestimmten Satz von Klassen mit den Tagsignore undexclude ignorieren / von der Code-Instrumentierung ausschließen:

Nach der Berechnung der Codeabdeckung folgt diecheck-Phase. The check phase ensures that a certain level of code coverage is reached.

Hier ist ein grundlegendes Beispiel für die Konfiguration dercheck-Phase:

Bei Verwendung deshaltOnFailure-Flags führt Cobertura dazu, dass der Build fehlschlägt, wenn eine der angegebenen Prüfungen fehlschlägt.

DiebranchRate/lineRate-Tags geben die nach der Code-Instrumentierung erforderliche Mindestanzahl für die Abdeckung von Zweigen / Leitungen an. Diese Prüfungen können mit den TagspackageLineRate/packageBranchRateauf Paketebene erweitert werden.

Es ist auch möglich, bestimmte Regelprüfungen für Klassen mit Namen zu deklarieren, die einem bestimmten Muster folgen, indem das Tagregexverwendet wird. Im obigen Beispiel stellen wir sicher, dass für Klassen im Paketcom.example.algorithms.dijkstraund darunter eine bestimmte Bewertung der Leitungs- / Zweigabdeckung erreicht werden muss.

Cobertura ist auch als Eclipse-Plugin namenseCobertura verfügbar. UmeCobertura für Eclipse zu installieren, müssen Sie die folgenden Schritte ausführen und Eclipse Version 3.5 oder höher installieren:

Step 1: Wählen Sie im Eclipse-MenüHelp →Install New Software. Geben Sie dann beiwork with im Feldhttp://ecobertura.johoop.de/update/ ein:

Step 2: Wählen SieeCobertura Code Coverage aus, klicken Sie auf „Weiter“ und befolgen Sie die Schritte im Installationsassistenten.

NachdemeCobertura installiert ist, starten Sie Eclipse neu und zeigen Sie die Ansicht der Abdeckungssitzung unterWindows → Show View → Other → Cobertura an.

Bei der neueren Version von Eclipse (Kepler, Luna usw.) kann die Installation voneCobertura einige Probleme im Zusammenhang mit JUnit -the newer version of JUnit packaged with Eclipse is not fully compatible with eCobertura‘s dependencies checker: verursachen

Um dieses Problem zu umgehen, können Sie eine ältere Version von JUnit herunterladen und im Ordner der Eclipse-Plugins ablegen.

Dies kann erreicht werden, indem der Ordnerorg.junit.*** aus%ECLIPSE_HOME%/plugins gelöscht und dann derselbe Ordner aus einer älteren Eclipse-Installation kopiert wird, die miteCobertura kompatibel ist.

Sobald dies erledigt ist, verwendetrestart your Eclipse IDE and re-install the plugindie entsprechende Update-Site.

Um die Codeabdeckung durch einen Komponententest zu berechnen, klicken Sie mit der rechten Maustaste auf Ihr Projekt / Ihren Test, um das Kontextmenü zu öffnen, und wählen Sie dann die OptionCover As → JUnit Test.

In der AnsichtCoverage Sessionkönnen Sie den Bericht zur Leitungs- / Zweigabdeckung pro Klasse überprüfen:

Java 8-Benutzer können bei der Berechnung der Codeabdeckung auf einen häufigen Fehler stoßen:

In diesem Fall beschwert sich Java über einige Methoden, die aufgrund der in neueren Java-Versionen eingeführten strengeren Bytecode-Überprüfung keine ordnungsgemäße Stapelzuordnung haben.

Dieses Problem kann behoben werden, indem die Überprüfung in der Java Virtual Machine deaktiviert wird.

Klicken Sie dazu mit der rechten Maustaste auf Ihr Projekt, um das Kontextmenü zu öffnen, wählen SieCover As aus und öffnen Sie dann die AnsichtCoverage Configurations. Fügen Sie auf der Registerkarte Argumente das Flag-noverifyals VM-Argument hinzu. Klicken Sie abschließend auf die Schaltflächecoverage, um die Deckungsberechnung zu starten.

Sie können auch das Flag-XX:-UseSplitVerifier verwenden, dies funktioniert jedoch nur mit Java 6 und 7, da der Split-Verifizierer in Java 8 nicht mehr unterstützt wird.