Kapitel 2. Quickstart

Angenommen, Sie haben ein Projekt, das PDF-Dokumente erzeugt und möchten sicherstellen, dass die beteiligten Programme das tun, was sie sollen. Weiter angenommen, ein Test-Dokument soll genau eine Seite umfassen sowie die Grußformel „Vielen Dank für die Nutzung unserer Serviceleistungen“ und eine Rechnungssumme von „30,34 Euro“ enthalten. Dann könnten Sie diese Anforderungen folgendermaßen mit PDFUnit testen:

<testcase name="hasOnePage_de">
  <assertThat testDocument="quickstart/quickstartDemo_de.pdf">
    <hasNumberOfPages>1</hasNumberOfPages>
  </assertThat>
</testcase>

<testcase name="hasGreeting_de">
  <assertThat testDocument="quickstart/quickstartDemo_de.pdf">
    <hasText on="LAST_PAGE">
      <containing>Vielen Dank für die Nutzung unserer Serviceleistungen</containing>
    </hasText>
  </assertThat>
</testcase>

<testcase name="hasExpectedCharge_de">
  <assertThat testDocument="quickstart/quickstartDemo_de.pdf">
    <hasText on="FIRST_PAGE">
      <inClippingArea upperLeftX="172" upperLeftY="178" width="20" height="9" >
        <containing>29,89 Euro</containing> <!-- This value is intentionally false. -->
      </inClippingArea>
    </hasText>
  </assertThat>
</testcase>

Der typische JUnit-Report zeigt entweder den Erfolg oder eine aussagekräftige Fehlermeldung an:

So einfach geht's. Die folgenden Kapitel beschreiben den Funktionsumfang, typische Testfälle und Probleme beim Umgang mit PDF-Dokumenten.