Neue Funktionen und Features

• Die ComponentAddon Funktionalität wird durch eine neue Klasse com.levigo.jadice.swing.ui.ComponentAddonManagement angeboten. 
  • Die Methoden com.levigo.util.swing.plaf.LookAndFeelAddons.contribute(ComponentAddon) und com.levigo.util.swing.plaf.LookAndFeelAddons.uncontribute(ComponentAddon) wurden ersetzt durch die entsprechenden Methoden der Klasse ComponentAddonManagement.

• Die Methoden der Klasse com.levigo.jadice.swing.ui.UIs sind mit Hilfe von CallOnEDT Annotationen mit Bedienungshinweisen bereichert worden.

• DOCPV-462: Laufende Lesevorgänge auf einem Reader können nun abgebrochen werden.
• Die API ist erweitert worden um eine neue Klasse com.levigo.jadice.annotation.render.AnnotationGraphicsRenderer. Sie bietet die Möglichkeit eine Annotation in ein beliebiges Graphics2D zu rendern. 

• Text-Format 

  • Text-Format bietet Byte-Order-Mark (BOM) Support an
    BOM-Erkennung ist standardmäßig aktiviert, kann über die com.levigo.jadice.format.text.TextReaderSettings Klasse entsprechend konfiguriert werden:

    Methode	Funktion
    public void enableByteOrderMarkDetection(boolean enableByteOrderMarkDetection)	Ein-/Ausschalten der BOM-Erkennung
    public boolean isByteOrderMarkDetectionEnabled()	Aktuellen BOM-Erkennungsstatus abfragen

    Unterstützte Byte-Order-Marks:

    • UTF-8 8-bit Unicode Transformation Format

    • UTF-16BE 16-bit Unicode Transformation Format, big-endian byte order

    • UTF-16LE 16-bit Unicode Transformation Format, little-endian byte order

    • UTF-32BE 32-bit Unicode Transformation Format, big-endian byte order

    • UTF-32LE 32-bit Unicode Transformation Format, little-endian byte order

    Bei einer BOM-Erkennung wird intern das Encoding entsprechend überschrieben, d.h. das in den com.levigo.jadice.format.text.TextReaderSettings definierte Encoding wird ignoriert.

  • Textformat erlaubt die zur Anzeige verwendete Auflösung vorzugeben.

    Die Auflösung kann nun pro Text Dokument über die com.levigo.jadice.format.text.TextReaderSettings Klasse konfiguriert werden:

    Methode	Funktion
    public void setResolution(int resolution)	Legt die zur Anzeige verwendete Auflösung fest
    public int getResolution()	Zur Anzeige verwendete Auflösung abfragen

• Die BookmarkDemoApplication wurde entfernt. Eine beispielhafte Implementierung der Bookmark Funktionalität auf Basis der Outline-API wurde in die BasicDemoApplication aufgenommen.
• Neue Klassen in com.levigo.jadice.document.marshalling, um Marshalling zu konfigurieren. 
• DOCPV-1897: Die FitModeCommands in der BasicDemoApplication wurden durch neue Commands aus der neuen Klasse com.levigo.jadice.appbase.commands.FitCurrentPageCommand ersetzt. Die alten Commands sind aber weiterhin vorhanden. Für Details, siehe 
  Fehler beim Rendern des Makros 'jira': Der Jira-Server für dieses Makro konnte nicht gefunden werden. Das könnte an der Konfiguration des Anwendungslinks liegen.
  .
• Das VisibleBoundsTool ist um einige Konfigurationsmöglichkeiten erweitert worden. Neben der Border um den sichtbaren Bereich kann nun auch eine Border entlang der Seitengrenze gemalt werden.;Der Bereich außerhalb des sichtbaren Bereiches und der sichtbare Bereich selbst können nun eingefärbt werden. Diese Border und Farben können über die folgenden Properties-Strings über den UIManager konfiguriert werden: "ThumbnailView.visibleBoundsPageBorder", "ThumbnailView.visibleBoundsAreaColor", "ThumbnailView.visibleBoundsPageAreaColor". Alternativ können diese Einstellungen dem Tool auch über entsprechende Setter gesetzt werden.
• DOCPV-3069: Die Legendenannotation (CalloutAnnotation) besitzt nun einen passenden Wrangler, um die Annotation GUI-seitig anzupassen. Für Details, siehe  Der Jira-Server für dieses Makro konnte nicht gefunden werden. Das könnte an der Konfiguration des Anwendungslinks liegen.

Auftrennung von Komponenten

Aus der Historie heraus ist die document platform als ein Swing-Viewer entstanden. Im Laufe der Jahre entwickelten sich nach und nach weitere jadice Produkte, wie das jadice webtoolkit oder jadice server, die nur die Kernbestandteile der document platform, wie Document oder spezifische Formate, verwendeten. Parallel dazu häuften sich ebenfalls immer mehr Kunden Szenarios, die keine Swing Komponenten nutzten.
Vor diesem Hintergrund häuften sich die Forderungen nach einer Trennung der monolithischen Struktur der platform in einen Kern- und einen Swing Komponenten Anteil.

Das 5.5 Release setzt diese nachvollziehbare Anforderung um. Die Aufteilung umfasst die Komponenten jadice-core, jadice-swing und dist. jadice-core beinhaltet dabei die Kernbestandteile der document platform, wie Document oder spezifische Formate. jadice-swing beinhaltet Swing relevanten Klassen. Die dist Komponente beinhaltet eine Kombination der beiden oben beschriebenen Komponenten und bindet dabei alle deren Subkomponenten ein. Es kann als ein Nachfolger der ehemals umfassenden Struktur angesehen werden. 

Die einzelnen Komponenten werden zukünftig unabhängig voneinander releast. Daher können die Versionsverläufe der Komponenten künftig divergieren.

Zur sauberen Trennung der Komponenten haben die neu entstandenen Komponenten jeweils eine eigene Maven GroupId erhalten.

Verbesserungen

• Attachments
  • DOCPV-2048: Attachments geben jetzt beim Aufruf von toString() einen technischen Identifikations-String zurück. Die bisherigen Informationen sind künftig über Properties des Attachments zugänglich.
  • DOCPV-2041: Attachment Properties: Es ist nun möglich mit PropertyChangeListenern auf Änderungen an den Properties zu hören. Details, siehe  Der Jira-Server für dieses Makro konnte nicht gefunden werden. Das könnte an der Konfiguration des Anwendungslinks liegen.  
• DOCPV-1703, DOCPV-1704: I18n Properties: In älteren Versionen wurden Klammern und Weißzeichen über I18n abgelegt. In neueren Versionen wird statt dessen die Verwendung von Interpolation bevorzugt.
• DOCPV-2053: Verbesserte Hintergrundgrafik der Gradationskurve
• DOCPV-2194: Im Rahmen von Verbesserungen des Caches wurde die Konfigurationseinstellung jadice.viewer.cache.maximumExpiryObjectCountRatio aus den Jadice.properties korrigiert. Die Einstellung sollte eine Ratio sein, war aber in Wirklichkeit ein absoluter Wert. Dies ist nun korrigiert worden. Der Wertebereich dieser Einstellung liegt zwischen 0 < jadice.viewer.cache.maximumExpiryObjectCountRatio <=1.
• DOCPV-462: Die Preview-Ansicht im Öffnen Dialog bricht nicht mehr benötigte Lesevorgänge nun schneller ab. Zu diesem Zweck gab es Umstellungen in der Klasse FileChooser. Das Setzen einer eigenen ReadStrategy fällt weg.
• DOCPV-2099: Vereinheitlichung/Pattern zur Erstellung/Installation des Contextes

• • Diese Neuerung betrifft die folgenden Klassen. Die genannten Klassen haben durch die Änderung eine neue Methode protected Context initializeContext() erhalten.
    

  • Klasse	vorheriger Methodenname (sofern vorhanden)
    com.levigo.jadice.appbase.preview.NavigablePreviewThumbnailRenderer	-
    com.levigo.jadice.appbase.search.advanced.AlternativeSearchPanel	-
    com.levigo.jadice.appbase.search.RolloutSearch	-
    com.levigo.jadice.appbase.search.SearchFrame	-
    com.levigo.jadice.appbase.search.SearchPanel	-
    com.levigo.jadice.appbase.status.PageLayoutSnapIn	protected Context installContext()
    com.levigo.jadice.appbase.status.PageSnapIn	protected Context installContext()
    com.levigo.jadice.appbase.status.ZoomSnapIn	protected Context installContext()
    com.levigo.jadice.appbase.PageNavScrollBarSnapIn	-
    com.levigo.jadice.demo.applet.DemoAppletPanel	protected Context createContext()
    com.levigo.jadice.iplus.demo.swing.FlexibleTreePanel	-
    com.levigo.jadice.iplus.demo.swing.IPlusFrame	protected Context createContext()
    com.levigo.jadice.iplus.demo.swing.ViewerPanel	protected Context createContext()
    com.levigo.jadice.demo.gradation.GradationFrame	-
    com.levigo.jadice.demo.infotree.InfoTreeFrame	-
    com.levigo.jadice.demo.infotree.InfoTreePanel	-
    com.levigo.jadice.demo.BasicJadicePanel	protected Context createContext()
    com.levigo.jadice.demo.jnlp.JNLPDemoFrame	protected void createContext()
    org.jadice.util.swing.flextree.FlexibleTree	protected Context createContext()

• Durch ein neues, verbessertes Font Rendering in der Version 5.5... 

  • ... hat BaseRenderSettings eine neue Antialiasing Einstellung für Shape und Text Rendering erhalten. Diese Einstellung kann über die Methoden BaseRenderSettings.getAntiAliasingMode() und BaseRenderSettings.setAntiAliasingMode(AntiAliasingMode) genutzt werden.

  • ...ist ein neues Enum com.levigo.jadice.document.render.AntiAliasingMode mit den Einstellungen ON und Off geschaffen wurden.
  • ...TextRenderSettings-Klasse nicht mehr benötigt und daher entfernt wurde.
  • ...werden folgende Einstellungen nicht mehr benötigt:

    
    

    Klasse
    ToggleFontRenderModeCommand
    TextRenderSettings.FontRenderMode (wird nicht mehr benötigt, da kein Java-AWT Font-Rendering verwendet wird)
    TextRenderSettings.AntiAliasingMode (Funktion ersetzt durch BaseRenderSettings.setAntiAliasingMode(AntiAliasingMode))
    TiffConvertConfiguration.FontRenderingMode#AUTO, TiffConvertConfiguration.FontRenderingMode#SHAPE_RENDERING

  • sind folgende Einstellungen überflüssig geworden:

    • com.levigo.jadice.format.text.TextReaderSettings#isAntiAliased(), 

    • com.levigo.jadice.format.text.TextReaderSettings#setAntiAliased(..), 

    • com.levigo.jadice.format.text.TextReaderSettings#isUsesFractionalMetrics(), 

    • com.levigo.jadice.format.text.TextReaderSettings#setUsesFractionalMetrics(..)

• Vergabe von Swing Namen für GUI Komponenten
  • An verschiedenen Stellen wurden Namen für Swing GUI Komponenten vergeben. Diese können bei Bedarf in einer Integration geändert werden.
  • Für MenuItems, die via Action/Command Framework erstellt werden, leitet sich der Name aus dem Key in actions.properties ab.
• Einheitliche Namensgebung für Qualified Log Messages. Details, siehe Der Jira-Server für dieses Makro konnte nicht gefunden werden. Das könnte an der Konfiguration des Anwendungslinks liegen.
• Ein neuer Cache wird als Standardcache verwendet, der Geschwindigkeitsvorteile und erweiterte Funktionalitäten (Statistiken, Listener, JMX-Beans, dynamische Expiry-Strategien) bietet. Darüber hinaus wird immer noch die Möglichkeit geboten, den bisherigen Cache zu verwenden. Details sind in der Dokumentation ersichtlich.

• Das Laden von Fonts wurde für Integratoren konfigurierbarer gestaltet. Die im Demo-Code verfügbaren Klassen:

  • com.levigo.jadice.demo.font.SwingFontEnvironments
  • com.levigo.jadice.demo.font.FontEnvironments

  bieten eine beispielhafte Implementierung der Konfiguration und können in Integrationen übernommen werden. Über den Aufruf *FontEnvironments#configureFontEnvironment() können die Fonts beim Start der Anwendung konfiguriert und geladen werden.
  Die Klasse SwingFontEnvironments schließt die Konfiguration aus FontEnvironments mit ein. Sollte keine GUI-Komponente in der Integration vorhanden sein, genügt die Konfiguration aus der Klasse FontEnvironments.

Verschiebungen/Umbenennungen von Klassen

Änderungen innerhalb von Klassen

Nicht mehr unterstützte und entfernte Elemente

Reader reader = new Reader();

// Registration der 'page-size-modification' Definition
reader.getSettings(MODCAReaderSettings.class).getProperties().put("page-size-modification", "220-700x220-700:210x0;209-211x277-279:210x297;192-194x296-298:210x297");

// Registration der 'page-size-modification-ci' Definition
reader.getSettings(MODCAReaderSettings.class).getProperties().put("page-size-modification-ci", "220-700x220-700:210x0;209-211x277-279:210x297;192-194x296-298:210x297");

// Registration der 'page-size-modification-nci' Definition
reader.getSettings(MODCAReaderSettings.class).getProperties().put("page-size-modification-nci", "220-700x220-700:210x0;209-211x277-279:210x297;192-194x296-298:210x297");

// Laden der Properties-Datei
InputStream is = ModcaFormat.class.getResourceAsStream("resources/FontMap.properties");
Properties properties = new Properties();
properties.load(is);

// Registration der 'FontMap.properties' Properties-Instanz
Reader reader = new Reader();
reader.getSettings(MODCAReaderSettings.class).getProperties().put("FontMap.properties", properties); 

Reader reader = new Reader();
// Bereits vorhandene FontFactory holen
FontFactory fontFactory = reader.getSettings(FontFactoryReaderSettings.class).getFontFactory();
// ChainedFontFactory-Instanz erstellen
ChainedFontFactory chainedFontFactory = new ChainedFontFactory(new FontsPropertiesFontFactory(), fontFactory);
// ChainedFontFactory-Instanz registrieren
reader.getSettings(FontFactoryReaderSettings.class).setFontFactory(chainedFontFactory);