Schritt 1: Erzeugen eines ReadConfigurer
Um Dokumentdaten einzulesen muss zunächst eine Instanz von ReadConfigurer
erzeugt (und konfiguriert) werden. Es
existieren dafür zwei unterschiedliche Varianten, die den Lesevorgang entweder synchron oder
asynchron durchführen. Erzeugt werden die Konfigurationen durch statische Methodenaufrufe
der Klasse Read
:
SyncReadConfigurer conf = Read.synchronously();
oder:
AsyncReadConfigurer conf = Read.asynchronously();
In den pre jadice 5 Versionen arbeitete der Ladevorgang standardmäßig asynchron.
Dies führte häufig zu der fehlerhaften Annahme, dass nach dem Aufruf
Loader.loadDocument(...)
das Dokument bereits vollständig geladen vorliegt. Die Fluent API
schafft hier mehr Klarheit. Die bewusste Entscheidung, welche Art des ReadConfigurer
verwendet werden soll, vermeidet
Missverständnisse und daraus resultierende Bedienungsfehler.