Unitils JPA

Erweitertes Beispiel: Unitils mit Java Persistence API

Einleitung:

Dieses Beispiel soll JPA Tests mit Unitils veranschaulichen. Dafür wird das einführende Beispiel erweitert, um die Persistierung von dem "Object-Rational Mapping" (ORM) Framework Hibernate verwalten zu lassen. Unitils soll dabei die Konfiguration der Datenbank-Verbindung und Vorbereitung der Datenbank erleichtern.

Vorbereitung:

Als Basis dient das einführende Beispiel, das um eine "Persistence Unit", eine Unitils "properties" Datei, eine Entity Klasse "Ergebnis" und eine Testklasse mit zugehörigem DbUnit Datensatz erweitert wird. Außerdem müssen die entsprechenden Unitils Bibliotheken für JPA Tests mit eingebunden werden.

NetBeans Projekt Download.
Nach dem Öffnen des Projektes, muss eventuell die "unitils.properties" Datei an die verwendete Datenbank angepasst werden:

unitils.properties

Auch muss in der "persistence.xml" eine vorhandene und passende Datenquelle (Datenbank) ausgewählt sein.

persistence.xml

Testklasse: DBTests.java

package tests;

import java.util.ArrayList;
import java.util.List;
import javax.persistence.EntityManager;
import javax.persistence.EntityManagerFactory;
import javax.persistence.NoResultException;
import lotteriespiel.entities.Ergebnis;
import lotteriespiel.module.Persistenz;
import org.junit.Before;
import org.junit.Test;
import org.unitils.UnitilsJUnit4;
import org.unitils.dbunit.annotation.DataSet;
import org.unitils.orm.jpa.util.provider.hibernate.UnitilsHibernatePersistenceProvider;

/**
 *
 * @author Andre Heidt
 */
public class DBTests extends UnitilsJUnit4 {

    Persistenz persistenz;

    UnitilsHibernatePersistenceProvider prov = new UnitilsHibernatePersistenceProvider();
    EntityManagerFactory emf = prov.createEntityManagerFactory("UnitilsBeispielPU"
        ,null);
     private EntityManager em = emf.createEntityManager();

    @Before
    public void before() {

        persistenz=new Persistenz();
    }

    //@DataSet("DBTests.xml")
    @Test
    public void persistiereZahl() {
        String gewinnzahl = "99999";
        persistenz.persistiereZahl(gewinnzahl);
         assert zahlVorhanden(gewinnzahl);
    }

    private Boolean zahlVorhanden(String zahl) {
        List<Ergebnis> ergList;
        Ergebnis erg = null;
        try {
            ergList =  em.createQuery(
                    "select t from Ergebnis t where t.gewinnzahl = :zahl")
                    .setParameter("zahl", zahl).getResultList();
        } catch (NoResultException e) {
            ergList = new ArrayList<Ergebnis>();
        }

        return !ergList.isEmpty();
    }
}

Erklärung des Tests:

Der Test legt einen Entity Manager an und nutzt das JPA Framework zum Persistieren einer Gewinnzahl, verpackt in einem Entity Objekt, in der Datenbank. Als nächstes überprüft der Testfall, ob die Zahl tatsächlich in der Datenbank vorhanden ist. DbUnit sollte dabei den Datensatz aus DBTests.xml in die Datenbank laden, bevor der entsprechend annotierte Test ausgeführt wird.

Datensatz: DBTests.xml

<?xml version='1.0' encoding='UTF-8'?>
<dataset>
  <ERGEBNIS ID="1" GEWINNZAHL="12345" DATUM="2011-06-17 00:00:00.0"/>
  <ERGEBNIS ID="2" GEWINNZAHL="54321" DATUM="2011-06-18 00:00:00.0"/>
  <ERGEBNIS ID="3" GEWINNZAHL="15243" DATUM="2011-06-19 00:00:00.0"/>
</dataset>

Durchführung:

Der Testfall kann wie ein normaler JUnit Test ausgeführt werden.

Probleme:

Beim Durchführen der Tests stößt man auf einige Probleme. Die auf Annotationen basierende Initialisierung des Entity Managers verursacht Nullpointer-Exceptions. Dagegen hilft die Verwendung des "UnitilsHibernatePersistenceProvider".
Ein weiteres Problem taucht bei der gemeinsamen Verwendung von Hibernate JPA mit DbUnit auf. Die Frameworks scheinen sich gegenseitig zu blockieren und führen zum Scheitern des Tests. Aus diesem Grund ist die DbUnit Datenbankverwaltung in dem Testfall auskommentiert, bis eine Lösung gefunden wird.