Diese Anleitung gilt für JWT Version 5.7.0.0 vom FIXME
Inhalt
Neue Funktionen und Features
Beibehaltung dokumentbezogener RenderControls ist nun konfigurierbar
Rendercontrols, die sich auf das komplette Dokument beziehen, werden nun beim Dokumentenwechsel standardmäßig verworfen. Sollen diese wie bisher beibehalten werden muss dies explizit in ClientConfigurationManager.getClientConfiguration().setPreserveRenderControlsOnDocumentChange(true) gesetzt werden. Das zugehörige Ticket ist JWT-2657.
Web-Fonts
Durch Änderungen in der Behandlung von Schriftarten muss der Browser-Cache bei der ersten Verwendung zunächst geleert werden. Wird der Cache nicht geleert, kann es zu Darstellungsfehlern kommen.
Um zu gewährleisten, dass Schriftarten vor der Anzeige eines Dokumentes clientseitig zur Verfügung stehen, wird empfohlen, in der EntryPoint-Implementation der Anwendung in onModuleLoad direkt zu Beginn FontConfig.get() aufzurufen. Dadurch wird sichergestellt, dass die Standard-Fonts Arimo, Cousine und Tinos rechtzeitig geladen werden. Dabei ist zu beachten, dass zuvor eine ServerConnection erzeugt werden muss, um die Server-Adresse ermitteln zu können. Dieses Verhalten ist beispielsweise im EnterpriseDemoEntryPoint der Enterprise Demo implementiert.
Aktualisierung der jadice documentplatform
Ab Version 5.7.0.0 verwendet das jadice web toolkit Version 5.5 der jadice documentplatform. Bei umfangreicher integrationsspezifischer Nutzung der jadice documentplatform in Serverkomponenten sind dadurch sehr wahrscheinlich Anpassungen erforderlich, detaillierte Informationen auch zu den API-Änderungen in der documentplatform sind in den Migrationshinweisen der documentplatform aufgelistet.
Geänderte Modulstruktur
In Version 5.5 der jadice documentplatform wurde die Modulstruktur optimiert, um logisch zusammengehörende Funktionalitäten zu bündeln. Durch diese Auftrennung können die einzelnen Funktionalitäten unabhängiger voneinander entwickelt werden. Entsprechend sind auch die Versionsverläufe der verschiedenen Module unterschiedlich.
Die Kernfunktionalitäten der documentplatform, wie beispielsweise das Dokument-Modell, sind im neuen Modul jadice-core zusammengefasst.
Die maven-Koordinaten des jadice-core sind:
<dependency>
<groupId>com.levigo.jadice.documentplatform.core</groupId>
<artifactId>jadice-core</artifactId>
<version>${jadicecore.version}</version>
</dependency>
Die derzeit (September 2018) aktuelle Version des jadice-core ist 1.0.9
Ebenfalls haben sich die maven-Koordinaten der levigo-utils geändert. Diese sind in den jadice-utils aufgegangen. Die dazugehörigen maven-Koordinaten sind:
<dependency>
<groupId>org.jadice.util</groupId>
<artifactId>jadice-utils</artifactId>
<version>${jadiceutils.version}</version>
</dependency>
Die derzeit (September 2018) aktuelle Version der jadice-utils ist 1.1.3
Die maven-Koordinaten und aktuelle Versionen aller Module sind jeweils über die Suchfunktion in Nexus verfügbar.
Unterstützung von log4j2
Die neuen jadice-utils unterstützen nun log4j2. Über die folgende Dependency kann das log4j2-Modul eingebunden werden:
<dependency>
<groupId>org.jadice.util</groupId>
<artifactId>logging-log4j2</artifactId>
<version>${jadiceutils.version}</version>
</dependency>
API-Änderungen und Umbenennungen von Klassen und Packages
| alt | neu | Anmerkung | siehe JIRA-Ticket |
|---|---|---|---|
com.levigo.util.* | com.jadice.web.util.* | Die Packages der jadice web toolkit utils wurden konsistent benannt. Auch die | JWT-677 |
| com.levigo.util.* | org.jadice.util.* | Die Packages der restlichen levigo utils wurden im Rahmen der Veröffentlichung der jadice documentplatform 5.5 verschoben. Die import-Statements im jadice web toolkit wurden entsprechend angepasst. | JWT-677 |
com.jadice.web.util.icon.client.iconfont.JWTIconFont.DOWN com.jadice.web.util.icon.client.iconfont.JWTIconFont.UP | com.jadice.web.util.icon.client.iconfont.JWTIconFont.DOWN_A com.jadice.web.util.icon.client.iconfont.JWTIconFont.UP_A | Es wurde eine zweite Variante an Down und Up Arrows hinzugefügt (welche im Thumbnail Tool verwendet werden). Aus diesem Grund wurden die bestehenden Icons umbenannt. Für eine vollständige Übersicht über den Icon Font siehe: http://webtoolkit.levigo.de/showcase/index.html?connection=longpoll#!DefaultIconFont | JWT-2350 |
| com.levigo.jadice.document.creator.* | com.levigo.jadice.document.contentscreator.* | Das Package Hilfen zur Anwendung der neuen API gibt es in der jadice knowledge base in den Artikeln Wasserzeichen und Kopfzeilen im jadice web toolkit und Wasserzeichen und Kopfzeilen mit dem ContentsCreatorPageSegment | - |
Änderungen im Annotationsprofil
| alt | neu | Anmerkung | siehe JIRA-Ticket |
|---|---|---|---|
| - | Mit der Integration der neuen jadice document platform bzw. deren core-Modul wurden die Dependencies auf die Swing-Module der jadice document platform entfernt. Demzufolge müssen alle Swing-Dependencies aus den Annotationsprofilen entfernt werden. (Achtung: dies betrifft nur die Wrangler und Editoren, nicht aber die Renderer, welche auch das | JWT-677 |
<property name="lineWrap">CHARACTER</property> | <property name="lineWrap">CHARACTER_CR</property> | Die als deprecated markierten LineWrap Modi CHARACTER und WORD wurden entfernt. Stattdessen sollten die LineWrap Modi CHARACTER_CR und WORD_CR verwendet werden. Renderer-Definitionen, bei denen diese Modi verwendet werden, müssen angepasst werden. | JWT-2355 |
<property name="lineWrap">WORD</property> | <property name="lineWrap">WORD_CR</property> |