Kapitel 7. Hilfsprogramme zur Testunterstützung

7.1. Allgemeine Hinweise für alle Hilfsprogramme

PDFUnit stellt Hilfsprogramme zur Verfügung, die Teilinformationen von PDF-Dokumenten in Dateien extrahieren, die anschließend in Tests genutzt werden können. Diese Programme sind aber nicht in diesem Handbuch beschreiben, sondern im Handbuch von PDFUnit-Java, letztendlich um Redundanzen zu vermeiden, die über kurz oder lang zu einer fehlerhaften Dokumentation führen würden. Hier der Link zum PDFUnit-Java Handbuch: http://www.pdfunit.com/de/documentation/java/. Folgende Hilfsprogramme stehen zur Verfügung:

# Utility programs belonging to PDFUnit:
# 
# The detailed descriptions can be found in the manual of PDFUnit-Java (to avoid redundancy).
# The names of the methods are exactly the same.
#
# see  http://www.pdfunit.com/de/documentation/java/  
#  

ConvertUnicodeToHex          
ExtractBookmarks             
ExtractEmbeddedFiles         
ExtractFieldInfo             
ExtractFontInfo              
ExtractImages                
ExtractJavaScript            
ExtractNamedDestinations     
ExtractSignatureInfo         
ExtractXFAData               
ExtractXMPData               
ExtractZugferdData           
RenderPdfPageRegionToImage   
RenderPdfToImages

Die Hilfsprogramme erzeugen Dateien, deren Namen sich aus dem der jeweiligen Eingabedatei ableiten. Damit es keine Namenskonflikte mit eventuell bestehenden Dateien gibt, gelten diese Namenskonventionen:

  • Die Namen beginnen mit einem Unterstrich.

  • Die Namen besitzen zwei Suffixe. Das vorletzte lautet .out, das letzte ist der übliche Dateityp.

Beispielsweise wird aus der Datei foo.pdf die Ausgabe _bookmarks_foo.out.xml erzeugt. Benennen Sie sie um, wenn Sie diese Datei in Ihren Tests verwenden.

In den folgenden Kapiteln werden Batchdateien abgebildet, die zeigen, wie die Programme gestartet werden. Die Batchdateien sind Teil des Releases. Sie müssen aber einige der Inhalte, nämlich Classpath, Eingabedatei und Ausgabeverzeichnis an Ihre projektspezifischen Gegebenheiten anpassen.

Werden die Programme fehlerhaft gestartet, wird auf der Konsole ein Hilfetext mit der vollständigen Aufrufsyntax angezeigt.