JViews Framework 8.6 Release Notes

This document describes the main changes that have been made to JViews Framework since version 8.5.

Incompatibilities
General Changes
Library Changes
New Packages

• info.clearthought.layout

New Interfaces and Classes

• ilog.views.IlvExpandCollapseUtil
• ilog.views.IlvExpandCollapseUtil.CustomAdjustmentPolicy
• ilog.views.util.swing.IlvAbstractRepaintManager

Modified Classes

• ilog.views.graphic.IlvText
• ilog.views.graphic.linkpolicy.IlvBundleLinkShapePolicy
• ilog.views.swing.IlvJManagerViewPanel
• ilog.views.swing.IlvJScrollManagerView
• ilog.views.swing.IlvToolTipManager
• ilog.views.util.IlvResourceUtil
• ilog.views.util.styling.IlvCSSAttributeSelector
• ilog.views.util.styling.IlvCSSSelector
• ilog.views.util.swing.IlvCursorFactory

Incompatibilities

• In ilog.views.util.IlvResourceUtil, the methods getBundle(String) and getBundle(String, Locale) deliver inconsistent results on different JDKs if multiple class loaders are used. Therefore, the methods have been deprecated. Please use the variants of getBundle that get a class loader as argument.

General Changes

• All products in the JViews suite are shipped with a large set of images and icons, used in the samples and in the provided editing tools. These have all been upgraded to conform to the latest IBM standards.
• An utility class has been added: ilog.views.IlvExpandCollapseUtil. This class contains static methods that are useful when dealing with nested managers that are collapsed or expanded.
• The class ilog.views.swing.IlvToolTipManager now allows you to customize the tooltip change delay.
• A configuration file has been added for CSS functions that are known by default in the CSS engine. The configuration file is in the jar jviews-framework-all.jar and jviews-framework-lib.jar at the location ilog/views/util/css/cssfunctions.properties. Editing this configuration file allows you to make additional CSS functions available in all CSS-based tools, such as the JViews Diagrammer Symbol Editor and the JViews Diagrammer Symbol Compiler.
• The class ilog.views.util.text.IlvRuleBasedNumberFormat now subclasses ICU4J's com.ibm.icu.text.RuleBasedNumberFormat class. As a result, IlvRuleBasedNumberFormat has been deprecated and you should use the ICU4J classes instead.
• Web deployment and JSF:
• JViews JSF components now support JBoss RichFaces. The recommended version is RichFaces 3.3.0 GA.
• For legal reasons, portlet-related jars are no longer shipped with JViews. To run Pluto demos, you need to download portlet-related jars. Please check the index.html of the portlet demos for how to run Pluto demos.

Library Changes

New Packages

info.clearthought.layout

Contains Swing layout managers.

New Interfaces and Classes

ilog.views.IlvExpandCollapseUtil

Utility class for expanding and collapsing an IlvManager.

ilog.views.IlvExpandCollapseUtil.CustomAdjustmentPolicy

Policy to adjust the contents of a manager after a submanager was collapsed or expanded.

ilog.views.util.swing.IlvAbstractRepaintManager

This class is an abstract RepaintManager whose behavior can be customized in subclasses.

Modified Classes

ilog.views.graphic.IlvText

• New methods:
  • getAnchorPoints(boolean, IlvTransformer): Returns the array of anchor points for all the lines if the text contains multiline labels.

ilog.views.graphic.linkpolicy.IlvBundleLinkShapePolicy

• New methods:
  • recalculateAllBundles(IlvGraphic, boolean): Recalculates the link bundles incident to the input node.

ilog.views.swing.IlvJManagerViewPanel

• New methods:
  • getToolTipDelay(): Returns the delay between showing tooltips.
  • getToolTipText(MouseEvent): Returns the string to be used as the tooltip.

ilog.views.swing.IlvJScrollManagerView

• New methods:
  • getToolTipDelay(): Returns the delay between showing tooltips.
  • getToolTipText(MouseEvent): Returns the string to be used as the tooltip.

ilog.views.swing.IlvToolTipManager

• Overview of new features:
  • Now allows you to customize the tooltip change delay.
• New methods:
  • getToolTipChangeDelay(): Returns the tooltip change delay.
  • setToolTipChangeDelay(int): Sets the tooltip change delay.

ilog.views.util.IlvResourceUtil

• Incompatibilities:
  • The methods getBundle(String) and getBundle(String, Locale) deliver inconsistent results on different JDKs if multiple class loaders are used. Therefore, the methods have been deprecated. Please use the variants of getBundle that get a class loader as argument.
• New methods:
  • getBundle(String, ClassLoader): Returns a resource bundle, examining the available resource suffixes.
  • setAvailableResourceLocales(Locale[]): Sets the available resource locales.

ilog.views.util.styling.IlvCSSAttributeSelector

• New methods:
  • deepEquals(Object): Returns true if this attribute selector is considered logically identical to the input object.
  • deepHashCode(): Returns a hash code of this attribute selector that is compatible with deepEquals(Object).

ilog.views.util.styling.IlvCSSSelector

• New methods:
  • deepEquals(Object): Returns true if this simple selector is equal to the input simple selector.
  • deepHashCode(): Returns a hash code of this simple selector that is compatible with deepEquals(Object).

ilog.views.util.swing.IlvCursorFactory

• New fields:
  • LARGE_PAN_CURSOR: A cursor type showing a large cross with arrows (a pan cursor).
  • SMALL_PAN_CURSOR: A cursor type showing a small cross with arrows (a pan cursor).

Example Changes

• Many of the examples and code fragments are shipped with a set of data files, images, and icons. These have been upgraded to conform to the latest IBM standards.
• The sample "Reading an SVG file" has been repackaged. It is now located in samples/readingsvg.

Known Limitations

• The class ilog.views.util.swing.IlvExpensiveDrawingRepaintManager currently provides no speedup, contrary to what is stated in its documentation.
• The class ilog.views.util.swt.IlvSwingControl currently has severe bugs on Linux/gtk, especially with JDK 1.6.