Geschichte von Mockito

Mockito trat in der Java-Community erstmals 2007 in Erscheinung und stammt von Szczepan Faber. Faber’s Ziel: Ein einfacheres und effektiveres Tool als die damals verfügbaren Mocking-Frameworks erschaffen. Die Hauptziele waren Klarheit, Einfachheit und die Vermeidung von redundanter Testcode-Erstellung. Dank dieser Prinzipien hat es sich schnell zu einem der beliebtesten Mocking-Frameworks für Java entwickelt.

Grundlagen und Einrichtung von Mockito

Mockito ist ein Java-basiertes Framework, dass es Entwicklern ermöglicht, externe Abhängigkeiten in Unit-Tests zu simulieren. Damit kann man sicherstellen, dass der zu testende Code korrekt funktioniert, ohne sich auf externe Faktoren zu verlassen. Hier geht es zu der offiziellen Website.

Zur Integration in ein Java-Projekt empfiehlt sich die Verwendung von Build-Tools wie Maven oder Gradle. Für Maven kann die folgende Dependency in die pom.xml (Siehe auch meinen Beitrag über XML) eingefügt werden:

<dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-core</artifactId>
    <version>3.x.x</version>
    <scope>test</scope>
</dependency>

Best Practices für die Verwendung von Mockito

1. Vermeide any() wo möglich: Es kann verlockend sein, den any()-Matcher von Mockito zu verwenden, um alle möglichen Eingaben abzudecken. Allerdings kann dies zu ungenauen Tests führen. Stattdessen sollte man versuchen, genaue Matcher oder konkrete Werte zu verwenden.
2. Nutze verify() zur Überprüfung der Interaktion: Mit verify() kann man den Abruf einer bestimmten Methode auf einem Mock-Objekt überprüfen. Dies stellt sicher, dass die erwarteten Interaktionen tatsächlich stattfinden.

Mockito.verify(mockObjekt).methode();

3. Bevorzuge thenReturn() gegenüber thenAnswer(): Wenn es nicht notwendig ist, auf die konkreten Argumente einer Methode zuzugreifen, sollte man thenReturn() verwenden, da es den Testcode sauberer und verständlicher macht.

Mockito.when(mockObjekt.methode()).thenReturn(wert);

Fazit

Mockito hat sich als unverzichtbares Tool in der Java-Entwicklungslandschaft etabliert. Durch die Fähigkeit, komplexe externe Abhängigkeiten zu simulieren, ermöglicht es präzise und zuverlässige Unit-Tests. Bei der Verwendung sollte man immer darauf achten, klaren und präzisen Testcode zu schreiben, um die Vorteile des Frameworks voll auszuschöpfen.

Ein gezieltes Verständnis und die richtige Anwendung von Mockito in Java-Projekten können die Qualität der Software maßgeblich beeinflussen und sicherstellen, dass sie den gewünschten Anforderungen entspricht.

Der Beitrag Mockito – Framework für Unit-Tests in Java erschien zuerst auf CEOsBay.

Was ist JAXB-2?

JAXB-2 ist ein leistungsfähiges Tool, das Java-Entwicklern dabei hilft, XML-Schemata in Java-Klassen umzuwandeln und umgekehrt. Es basiert auf der JAXB-API und man verwendet es hauptsächlich für das Parsen, Validieren, Marshallen und Unmarshallen von XML-Dokumenten.

Kurze Zeitreise

JAXB, einschließlich seiner Version 2, ist ein Teil der Java-Plattform, Standard Edition (Java SE). Es entstand aus dem Bedürfnis, eine standardisierte Methode für das Binden von XML-Schemata an Java-Objekte bereitzustellen. Dies ist eine häufige Anforderung für viele Java-Anwendungen, da XML eine weit verbreitete Technologie für den Datenaustausch zwischen Systemen und Anwendungen ist.

Im Detail ist JAXB ein vom Java Community Process (JCP) spezifiziertes API und wurde ursprünglich als Teil der Java Web Services Development Pack (JWSDP) eingeführt. JAXB 2.0, veröffentlicht im Jahr 2006, stellte eine wichtige Weiterentwicklung dar, die den Benutzern zusätzliche Flexibilität und Leistung bot. Es erlaubte unter anderem die Nutzung von generischen Sammlungstypen, erweiterte Anpassungen und verbesserte Validierungsmöglichkeiten.

Insgesamt ist JAXB-2 aus der Notwendigkeit entstanden, eine effiziente und standardisierte Methode für die Interaktion zwischen Java und XML bereitzustellen, die weitgehend unabhängig von den spezifischen Anforderungen einer Anwendung ist.

Vorteile als Maven Plugin

Das JAXB-2 Maven Plugin bietet eine nahtlose Integration mit Maven, wodurch Entwickler die Möglichkeit erhalten, ihre XML-zu-Java Bindungen direkt in ihre Build-Prozesse zu integrieren. Darüber hinaus unterstützt das Plugin die neuesten JAXB-Versionen und bietet mehrere Erweiterungen, um eine erweiterte Kontrolle über die Generierung von Java-Klassen zu ermöglichen.

Einrichten des Maven Plugins

Um das JAXB-2 Maven Plugin zu verwenden, muss man es zuerst in einer pom.xml-Datei konfigurieren. Hier ist ein Beispiel für eine Grundkonfiguration:

<project>
...
    <build>
        <plugins>
            <plugin>
                <groupId>org.ceosbay.yoyo</groupId>
                <artifactId>jaxb2-maven-plugin</artifactId>
                <version>2.5.0</version>
                <executions>
                    <execution>
                        <id>xjc</id>
                        <goals>
                            <goal>xjc</goal>
                        </goals>
                    </execution>
                </executions>
                <configuration>
                    <schemaDirectory>${project.basedir}/src/main/resources/schema</schemaDirectory>
                    <outputDirectory>${project.basedir}/src/main/java</outputDirectory>
                    <clearOutputDir>false</clearOutputDir>
                </configuration>
            </plugin>
        </plugins>
    </build>
...
</project>

Das Maven Plugin in Aktion

Nachdem man das JAXB-2 Maven Plugin konfiguriert hat, wird Maven automatisch die Java-Klassen aus den in <schemaDirectory> angegebenen XML-Schemas generieren, wann immer man das Projekt baut. Diese Klassen werden im durch <outputDirectory> definierten Verzeichnis gespeichert.

Fazit

Das JAXB-2 Maven Plugin ist ein effektives Werkzeug zur Integration von XML-Bindungen in Java-Projekte. Mit seiner Hilfe kann man Projekte effizienter gestalten und den Build-Prozess weiter automatisieren.

Der Beitrag JAXB-2 (Maven Plugin) – XML in Möglichkeiten verwandeln erschien zuerst auf CEOsBay.

Funktionen

Lombok bietet eine Vielzahl von Funktionen, die Entwicklern helfen, effizienten Code zu schreiben. Hier sind einige der wichtigsten Funktionen:

Getter und Setter:

Lombok ermöglicht es Entwicklern, Getter und Setter-Methoden für Klassenvariablen automatisch zu generieren. Dies ist besonders nützlich, wenn man viele Klassenvariablen hat und nicht jedes Mal manuell Getter und Setter schreiben möchte.

Konstruktoren:

Entwickler können Konstruktoren für ihre Klassen automatisch generieren lassen. Dies ist besonders nützlich, wenn man eine Klasse mit vielen Variablen hat und einen Konstruktor erstellen möchte, der diese Variablen automatisch initialisiert.

Builder:

Mit dem Builder können Entwickler Builder-Klassen automatisch generieren lassen, die es einfach machen, komplexe Objekte zu erstellen. Der Builder generiert eine Methode für jede Klassenvariable, mit der man den Wert der Variable setzen kann. Sobald alle Variablen gesetzt sind, erfolgt die Rückgabe des Objekts.

ToString:

Entwickler können die toString-Methode automatisch generieren lassen. Dies macht es einfach, die Inhalte eines Objekts zu debuggen oder zu protokollieren.

Equals und HashCode:

Entwickler können equals- und hashCode-Methoden automatisch generieren lassen. Dies ist besonders nützlich, wenn man eine Klasse hat, die Verwendung in einer Hash-Map hat.

Log:

Es bietet eine Annotation, mit der Entwickler eine Logger-Variable automatisch generieren können. Dies macht es einfach, Protokolle in der Anwendung zu erstellen.

Installation

Um Lombok in einem Projekt zu verwenden, muss man es installieren. Es gibt mehrere Möglichkeiten, Lombok zu installieren, doch die einfachste Methode besteht darin, die Lombok-JAR-Datei in das Projektverzeichnis zu kopieren und diese dann zu der IDE-Konfiguration hinzuzufügen. Als IDE’s sind beispielsweise IntelliJ oder Eclipse zu erwähnen.

Wenn man Maven verwendet, kann man Lombok einfach zu der POM-File hinzufügen:

<dependency>

   <groupId>org.projectlombok</groupId>

   <artifactId>lombok</artifactId>

   <version>X.XX.XX</version>

   <scope>provided</scope>

</dependency>

Sobald es installiert ist, kann man die verschiedenen Annotationen verwenden, um den Code zu verbessern.

Der Beitrag Lombok – Entwicklerproduktivität steigern und Boilerplate-Code eliminieren für sauberen, effizienten Java-Code erschien zuerst auf CEOsBay.

MapStruct nutzt dabei die Annotationen, die auf den Java-Objekten angebracht sind, um automatisch Mapping-Code (Bean-Mappings) zu generieren. Das Framework generiert dabei standardmäßig Mappings zwischen Objekten mit gleichem Namen und Typ, es können aber auch eigene Mappings definiert werden. Dabei können auch komplexere Mappings erstellt werden, beispielsweise wenn Attribute in den Quell- und Zielobjekten unterschiedliche Namen haben oder wenn sie unterschiedliche Typen haben.

MapStruct ist sehr einfach zu verwenden und erfordert nur eine minimale Konfiguration. Es integriert sich nahtlos in das Build-System, da es als Annotation Processor fungiert und beim Kompilieren des Codes aufgerufen wird. Das Framework ist relativ schnell und hat einen geringen Overhead, da es keine Laufzeit-Abhängigkeiten hat.

Vorteile auf einem Blick

• Schnelle Ausführung durch Verwendung einfacher Methodenaufrufe anstelle von Reflexion (Bedeutet: Ein Programm kennt seine eigene Struktur und kann diese modifizieren)
• Kompilierzeit-Typensicherheit. Nur Objekte und Attribute, die einander zugeordnet sind – Es findet keine versehentliche Zuordnung einer Auftragsentität zu einem Kunden-DTO statt.
• In sich geschlossener Code – keine Laufzeit-Abhängigkeiten
• Eindeutige Fehlerberichte zur Erstellungszeit, wenn: 
  • Mappings unvollständig sind (Wenn nicht alle Zieleigenschaften gemappt sind)
  • Mappings fehlerhaft sind (Wenn es keine geeignete Mapping-Methode oder Typkonvertierung findet)
• Leicht zu debuggender Mapping-Code (Oder manuell editierbar, z. B. im Falle eines Fehlers im Generator)

Fazit

Zusammenfassend ist MapStruct ein leistungsfähiges und einfach zu bedienendes Framework, das die Entwicklung von Mapping-Code vereinfacht und beschleunigt. Vor allem, weil das Übertragen von Daten zwischen Objektmodellen meist eine wiederkehrende Aufgabe bei der Anwendungsentwicklung ist. Es ist eine gute Wahl, wenn man schnell und effizient Mapping-Funktionalitäten in Anwendungen integrieren möchte. Man kann es in Befehlszeilen-Builds (Maven, Gradle usw.) als auch in der bevorzugten IDE wie z.B. IntelliJ oder Eclipse verwenden.

Der Beitrag MapStruct – Schnelle und sichere Objektmapper für saubere und wartungsfreundliche Java-Anwendungen erschien zuerst auf CEOsBay.

Im Grunde genommen handelt es sich dabei um zwei Arten von Tools, die zum einen Anweisungen dem Java-Quellcode hinzufügen und dessen Neukompilierung einfordern und zum anderen Tools, die den Bytecode entweder vor oder während der Ausführung instrumentieren. Das Ziel von JaCoCo ist es, herauszufinden, welche Teile des Codes getestet werden, indem es die Codezeilen registriert, die man bei der Ausführung eines Tests ausführt. TDD bzw. Test Driven Development ist diesbezüglich ebenfalls ein gutes Stichwort.

Features von JaCoCo

• Abdeckungsanalyse von Anweisungen (C0), Verzweigungen (C1), Zeilen, Methoden, Typen und zyklomatischer Komplexität (McCabe-Metrik).
• Basiert auf Java-Bytecode und funktioniert daher auch ohne Quelldateien.
• Einfache Integration durch Java-Agent-basierte On-the-fly-Instrumentierung. Andere Integrationsszenarien wie benutzerdefinierte class loader sind über die API möglich.
• Framework-unabhängig: Reibungslose Integration in Java VM-basierte Anwendungen wie einfache Java-Programme, OSGi-Frameworks, Web-Container oder EJB-Server.
• Kompatibel mit allen freigegebenen Java-Klassendateiversionen.
• Unterstützung für verschiedene JVM-Sprachen.
• Verschiedene Berichtsformate (HTML, XML, CSV).
• Remote-Protokoll und JMX-Steuerung zur Anforderung von Ausführungsdaten-Dumps vom Coverage Agent zu jedem beliebigen Zeitpunkt.
• Ant-Tasks zum Sammeln und Verwalten von Ausführungsdaten und zum Erstellen strukturierter Abdeckungsberichte.
• Maven-Plug-in zum Sammeln von Abdeckungsinformationen und Erstellen von Berichten in Maven-Builds.

JaCoCo bietet die Instructions, Line- und Branchabdeckung. Im Gegensatz zu beispielsweise Atlassian Clover und OpenClover, die eine Instrumentierung des Quellcodes erfordern, kann JaCoCo Java Bytecode mit zwei verschiedenen Ansätzen instrumentieren:

1. JCov on the fly, während der Code mit einem Java-Agenten ausgeführt wird beispielsweise wie Cobertura und JCov vor der Ausführung (offline)
2. Man kann es aber auch so konfigurieren, dass man die gesammelten Daten in einer Datei speichert oder via TCP versendet. Im Gegensatz zu Cobertura und EMMA ist die Unterstützung von so ziemlich allen Java Versionen ab der Java Version 7 gewährleistet.

Tools, die JaCoCo verwenden oder enthalten

Einige davon habe ich bereits in diversen Beiträgen thematisiert. Mit einem Klick auf das jeweilige Tool kommt man auf den jeweiligen Beitrag.

• SonarQube JaCoCo Plugin – Standardmäßig für Code Abdeckungsanalysen innerhalb der Code-Qualitätsmanagement-Plattform
• EclEmma Eclipse (Software) Code Coverage Plugin
• Jenkins JaCoCo Plugin
• Netbeans JaCoCo support
• IntelliJ IDEA (Seit Version 11)
• Gradle JaCoCo Plugin
• Visual Studio Team Services
• TeamCity

Fazit

JaCoCo bietet sich für die Codeabdeckungsanalyse bei der modularen Softwareentwicklung bzw. bei den Unit Tests an. Die Abdeckungsgrade geben an, wie viele Anweisungen, Zweige usw. die Tests durchlaufen. Auf Basis der so gewonnenen Erkenntnisse kann man weitere sinnvolle Testfälle ermitteln oder aber nicht beanspruchten bzw. toten Code entfernen. Es gibt kein allgemeingültiges Mindestmaß an Codeabdeckung. Man definiert die jeweils erforderliche Testabdeckung in Anbetracht des Anwendungsfalls nach einer Risikoeinschätzung sowie der eigenen Entwickler-Fähigkeiten.

Der Beitrag JaCoCo – Messen und Optimieren von Testabdeckung für robuste Java-Anwendungen erschien zuerst auf CEOsBay.