Hinweise zur Migration von jadice document platform 5.6 zu jadice viewer 6.0
- David Werth
- Matthias Thiele
- Andre Nagel
Inhalt
Neue Funktionen und Features
VCardFormat: Das standardmäßige Encoding ist nun UTF-8 und kann bei Bedarf über die neu eingeführten VCardReaderSettings konfiguriert werden.
Einführung der neuen Sucharchitektur
Mit der jadice viewer 6 Version wird eine neue Architektur zum Anbinden eigener Suchen aus dem experimentellen Status in einen stabilen Stand überführt. Weitere Informationen zur Anbindung & Verwendung finden Sie hier.
Mit dieser Einführung wird die vorherige API zur Anbindung, Verwendung & Anzeige der Suche deprecated.
Anpassung der Versionsnummern
Mit Veröffentlichung der neuen Version 6 wird die jadice document platform zu jadice viewer. Einige der beinhaltete jadice-Submodule werden damit auf die Version 6 angehoben. Bei direkter Einbindung der Submodule wird es zu größeren Versionssprüngen kommen, wie bspw. von einer 3.5.4 auf eine 6.0.0. Folgende Module werden zukünftig nur noch mit einer Version 6.* im jadice viewer enthalten sein:
- jadice-utils
- jadice-core
- jadice-swing
Die Minor-Versionen der einzelnen Module können sich aber sowohl untereinander, als auch zu der jadice viewer 6 Version unterscheiden.
Update von JAXB-API
Die Abhängigkeit javax.xml.bind:jaxb-api wurde durch jakarta.xml.bin:jakarta.xml.bind-api ersetzt. Dadurch war es möglich, auf eine 4.*-Version zu upgraden. Integrationen, welche sich auf die bereitgestellte Version verlassen, müssen die Imports anpassen.
Änderungen in der Modulstruktur / Integration via maven
Verbesserungen
Icon Update
In der neuen Viewer 6 Version hat unsere Demo einige Anpassungen am Look and Feel, sowie ein neues Design erhalten. Hierzu wurden einige Icons angepasst. Sollten in der Integration die alten Icons benötigt werden, können die entsprechenden Ressourcen hier aus dem Anhang geladen und wie im Knowledgebase-Artikel Laden eigener Icons beschrieben in die Integration aufgenommen werden.
Verschiebungen/Umbenennungen von Klassen
alt | neu | Anmerkungen |
|---|---|---|
| org.jadice.util.glazedlists.migrationkit.AbstractFilterList | org.jadice.util.glazedlists.migrationkit.FilterList | Die Klasse ist ebenfalls nicht mehr abstrakt |
Änderungen innerhalb von Klassen
Klasse | Änderung | Anmerkungen |
|---|---|---|
| com.levigo.jadice.annotation.StampAnnotation | Entfernung der Einstellung allowRotation. | Die Anpassung kann über com.levigo.jadice.swing.internal.annotation.wranglers.TextAnnotationWrangler.showRotationHandle erreicht werden. |
| com.levigo.jadice.annotation.embedded.EmbeddedAnnotation | Rückgabewert von getType auf com.levigo.jadice.annotation.profiles.AnnotationType geändert | |
| com.levigo.jadice.swing.annotation.commands.AnnotationVisibilityCommand#toogleAnnotationVisibility | Methode umbenannt zu toggleAnnotationVisibility | |
com.levigo.jadice.format.text.TextReaderSettings | Entfernung der Konstante EBCDIC_CHARSET. | |
com.levigo.jadice.document.read.ReaderSettings | Ist nicht mehr Serializable | |
com.levigo.jadice.document.write.WriterSettings | Ist nicht mehr Serializable | |
com.levigo.jadice.document.contentscreator.settings.ContentsCreatorSettings | Ist nicht mehr Serializable | |
com.levigo.jadice.document.marshalling.MarshallingSettings | Ist nicht mehr Serializable | |
com.levigo.jadice.format.xfdf.annotation.XFDFTextAnnotation | Änderung der Methoden:
| |
com.levigo.jadice.swing.annotation.xfdf.RubberTool | Umbenennung zu com.levigo.jadice.swing.annotation.xfdf.XFDFRubberTool | |
com.levigo.jadice.swing.annotation.xfdf.PopupAnnotationTool | Umbenennung zu com.levigo.jadice.swing.annotation.xfdf.XFDFPopupAnnotationTool | |
| com.levigo.jadice.format.hocr.settings.ResolutionDetector | Umbenannt & Rückgabewert angepasst com.levigo.jadice.format.hocr.settings.SizeDetector | |
| com.levigo.jadice.format.hocr.settings.HocrReaderSettings#resolutionDetector | Umbenannt zu com.levigo.jadice.format.hocr.settings.HocrReaderSettings#sizeDetector |
Nicht mehr unterstützte und entfernte Elemente
Applets
- Mit der jadice Versionslinie 5.5. wurde der produktive Einsatz von jadice Technologie in Applet nicht mehr empfohlen und supported. Die betreffenden jadice Klassen waren seitdem als "Deprecated" markiert und stehen mit der aktuellen Versionslinie 6.0 nicht mehr zur Verfügung. Für Web Lösungen wird als Alternative die Verwendung von jadice web toolkit (https://jadice.com/produkte/web-toolkit/) empfohlen.
EmbeddedAnnotationType
Die verschiedenen Typen von eingebetteten Annotationen werden nicht mehr auf die Klasse com.levigo.jadice.annotation.embedded.EmbeddedAnnotationType abgebildet, sondern auf com.levigo.jadice.annotation.profiles.AnnotationType. Bei der Verwendung von Commands zum ein/ausblenden von eingebetteten Annotationen, kann hier eine Anpassung nötig sein. Gelöscht wurden die Klassen:
- com.levigo.jadice.annotation.embedded.EmbeddedAnnotationType
- com.levigo.jadice.annotation.embedded.EmbeddedAnnotationTypeImpl
- com.levigo.jadice.annotation.embedded.EmbeddedAnnotationTypeProvider (ersetzt durch die Klasse com.levigo.jadice.annotation.embedded.EmbeddedAnnotationTypesProvider)
HTTPRangeRequestStream
Die Klasse wurde entfernt
SimpleLoggerFactory
Die Klasse wurde entfernt. Die Alternative hierzu ist SimpleLoggerFactoryDelegate
Workaround für OpenJDK
Die Property GraphicsContextRenderer.enableWorkaroundOpenJDK zur Unterstützung älterer OpenJDK-Versionen mit alternativen Renderern wurde entfernt. Durch der Umstellung innerhalb der JDKs auf Marlin als Standard-Renderer sollte die Property nicht mehr benötigt werden.
Nicht mehr unterstützte und entfernte Klassen
| Klassenname | Alternative |
|---|---|
| java.util.concurrent.CompletableFuture (statische Methoden completedFuture und failedFuture) | |
| . | java.util.concurrent.CompletableFuture |
| com/l2fprod/common/util/JVM.java | java.lang.Runtime |
Nicht mehr unterstützte und entfernte Methoden
| Klassenname.Methodenname | Alternative |
|---|---|
| com.levigo.jadice.annotation.StampAnnotation#isAllowRotation | com.levigo.jadice.swing.internal.annotation.wranglers.StampAnnotationWrangler#showRotationHandle |
| com.levigo.jadice.annotation.StampAnnotation#setAllowRotation | com.levigo.jadice.swing.internal.annotation.wranglers.StampAnnotationWrangler#showRotationHandle |
| com.levigo.jadice.document.util.SystemEnvironment#getLineSeparator | System#lineSeparator |
| og.jadice.util.swing.action.factories.BasicActionFactory#putLookupProperty og.jadice.util.swing.action.factories.BasicCommandFactory#putLookupProperty og.jadice.util.swing.action.factories.BasicMenuComponentFactory#putLookupProperty og.jadice.util.swing.action.factories.DefaultActionFactory#putLookupProperty og.jadice.util.swing.action.factories.DefaultCommandFactory#putLookupProperty og.jadice.util.swing.action.factories.DefaultMenuComponentFactory#putLookupProperty | og.jadice.util.swing.action.factories.BasicActionFactory#setLookupProperty og.jadice.util.swing.action.factories.BasicCommandFactory#setLookupProperty og.jadice.util.swing.action.factories.BasicMenuComponentFactory#setLookupProperty og.jadice.util.swing.action.factories.DefaultActionFactory#setLookupProperty og.jadice.util.swing.action.factories.DefaultCommandFactory#setLookupProperty og.jadice.util.swing.action.factories.DefaultMenuComponentFactory#setLookupProperty |
| org.jadice.util.swing.panel.CollapsiblePane#getOrientation | org.jadice.util.swing.panel.CollapsiblePane#getStyle |
| org.jadice.util.swing.panel.CollapsiblePane#setOrientation | org.jadice.util.swing.panel.CollapsiblePane#setStyle |
| org.jadice.util.glazedlists.RangeList#setRange | org.jadice.util.glazedlists.RangeList#setHeadRange |
| org.jadice.util.glazedlists.GlazedLists#beanPropertyMatcher | org.jadice.util.glazedlists.matchers.Matchers#beanPropertyMatcher |
| org.jadice.util.glazedlists.migrationkit.AbstractFilterList#filterMatches | Filtern über Hereingabe eines Matchers in die Klasse |
| org.jadice.util.glazedlists.gui.EventSelectionModel#getEventList | org.jadice.util.glazedlists.gui.EventSelectionModel#getSelected |
org.jadice.util.glazedlists.gui.EventSelectionModel#getListSelectionModel | Die Klasse selbst ist ein ListSelectionModel |
com.levigo.jadice.swing.thumbnailview.dnd.ReorderPageImportHandler#didPerformImport() com.levigo.jadice.swing.thumbnailview.dnd.ReorderPageImportHandler#clearDidPerformImport() | Dieser Wert liegt als Property in den ImportParameter. Der zugehörige Property Name ist com.levigo.jadice.swing.thumbnailview.dnd.ReorderPageImportHandler#REORDER_PAGE_SUCCESS Ein manuelles Zurücksetzen ist nicht mehr notwendig und kann ersatzlos gestrichen werden. |
Nicht mehr unterstützte und entfernte Konstruktoren
| Klassenname.Konstruktor | Alternative |
|---|---|
| org.jadice.util.glazedlists.TreeList#TreeList(EventList<E>, Format<E>) | - |
| org.jadice.util.glazedlists.CompositeList#CompositeList(ReadWriteLock) | - |
| org.jadice.util.glazedlists.BasicEventList#BasicEventList(List<E>) | - |
| org.jadice.util.glazedlists.gui.TableComparatorChooser#TableComparatorChooser(JTable, SortedList<E>, boolean) | - |
| org.jadice.util.glazedlists.gui.TableComparatorChooser#TableComparatorChooser(JTable, SortedList<E>, Object) |
Systemvoraussetzungen
- Die unterstützten Versionen der Java Virtual Machine wurden geändert. Vorausgesetzt wird nun (Stand März 2024) eine Java VM in Version 11 bis inklusive Version 17.
- Es wird sowohl Oracle JDK als auch Open JDK unterstützt. Beachten Sie hierzu jedoch folgende Hinweise: Unterstützung neuer Oracle-Java-Versionen und OpenJDK
- Die Version 6.0 der jadice document platform benötigt mindestens die Javaversion 11. Java 8 wird nicht mehr unterstützt.