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 document platform
Ab Version 5.7.0.0 verwendet das jadice web toolkit Version 5.5 der jadice document platform. Bei umfangreicher integrationsspezifischer Nutzung der jadice document platform in Serverkomponenten sind dadurch sehr wahrscheinlich Anpassungen erforderlich, detaillierte Informationen auch zu den API-Änderungen in der document platform sind in den Migrationshinweisen der document platform aufgelistet.
Geänderte Modulstruktur
In Version 5.5 der jadice document platform 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. Das Versionsnummernschema der einzelnen Module hat sich auf eine dreistellige Versionsnummer geändert.
Die wichtigsten Änderungen der maven-Koordinaten sind im folgenden Expandable zusammengefasst:
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 document platform 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> |