JViews Framework 8.7 Release Notes

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

Incompatibilities
General Changes
Library Changes

New Interfaces and Classes

• ilog.views.appframe.util.IlvCurrentDirectoryURLResolver
• ilog.views.faces.dhtml.interactor.IlvFacesAjaxInteractor
• ilog.views.faces.dhtml.interactor.IlvFacesInteractorGroup
• ilog.views.faces.dhtml.renderkit.IlvFacesAjaxInteractorRenderer
• ilog.views.faces.dhtml.renderkit.IlvFacesHighlightInteractorRenderer
• ilog.views.faces.dhtml.renderkit.IlvFacesInteractorGroupRenderer
• ilog.views.faces.dhtml.renderkit.IlvFacesTooltipInteractorRenderer
• ilog.views.faces.dhtml.taglib.IlvFacesHighlightInteractorTag
• ilog.views.faces.dhtml.taglib.IlvFacesTooltipInteractorTag
• ilog.views.faces.dhtml.taglib.IlvInteractorGroupTag
• ilog.views.faces.interactor.IlvFacesHighlightInteractor
• ilog.views.faces.interactor.IlvFacesTooltipInteractor
• ilog.views.linkconnector.IlvCachingLinkConnector
• ilog.views.servlet.IlvHitmapDefinition
• ilog.views.servlet.IlvHitmapSupport
• ilog.views.util.IlvFeatureUseNotAcknowledgedException
• ilog.views.util.IlvLocaleUtil
• ilog.views.util.IlvThreadUtil
• ilog.views.util.convert.IlvLocalizedPropertyEditorFactory
• ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Charts_Deployment
• ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Diagrammer_Deployment
• ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Enterprise_Deployment
• ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Gantt_Deployment
• ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Graph_Layout_for_Eclipse_Deployment
• ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Maps_Deployment
• ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Maps_for_Defense_Deployment
• ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_TGO_Deployment
• ilog.views.util.servlet.IlvScriptMessageServletSupport
• ilog.views.util.servlet.IlvSelectionResizable
• ilog.views.util.servlet.IlvServletLocaleUtil
• ilog.views.util.servlet.IlvServletRunnable
• ilog.views.util.servlet.IlvServletThreadUtil
• ilog.views.util.swing.IlvJComboBox
• ilog.views.util.text.IlvListFormat
• ilog.views.util.text.IlvPatternBasedListFormat
• ilog.views.util.text.IlvSimpleListFormat

Modified Classes

• ilog.views.appframe.plugin.IlvPlugin
• ilog.views.appframe.plugin.IlvPluginManager
• ilog.views.faces.IlvFacesUtil
• ilog.views.faces.IlvFrameworkConstants
• ilog.views.faces.component.IlvFacesView
• ilog.views.faces.dhtml.IlvDHTMLConstants
• ilog.views.faces.dhtml.renderkit.IlvScriptManager
• ilog.views.faces.dhtml.taglib.IlvFacesViewTag
• ilog.views.graphic.IlvIcon
• ilog.views.graphic.IlvZoomableLabel
• ilog.views.linkconnector.IlvClippingLinkConnector
• ilog.views.linkconnector.IlvPinLinkConnector
• ilog.views.servlet.IlvManagerServletSupport
• ilog.views.swing.IlvToolTipManager
• ilog.views.util.IlvImageUtil
• ilog.views.util.IlvProductUtil
• ilog.views.util.IlvResourceUtil
• ilog.views.util.collections.IlvCollections
• ilog.views.util.convert.IlvConvert
• ilog.views.util.print.IlvHeaderFooter
• ilog.views.util.print.IlvPrintPreviewPanel
• ilog.views.util.servlet.IlvSelectionSupport
• ilog.views.util.servlet.IlvSelectionSupport.IlvSelectionResponse
• ilog.views.util.styling.IlvMutableStyleSheet
• ilog.views.util.swing.IlvSwingUtil
• ilog.views.util.swing.table.IlvDefaultTableCellRenderer
• ilog.views.util.text.IlvDateFormat
• ilog.views.util.text.IlvDateFormatFactory

New JSF Components

• jv:interactorGroup
• jvf:tooltipInteractor
• jvf:highlightInteractor

Modified JSF Components

• jvf:view

New JavaScript Classes

• IlvInteractorGroup
• IlvLinkInteractor
• IlvResizeInteractor
• IlvSelection
• IlvSelectionLink
• IlvHighlightInteractor
• IlvHitmap
• IlvTooltipInteractor
• IlvAjaxInteractorProxy
• IlvFacesHighlightInteractorProxy
• IlvFacesTooltipInteractorProxy
• IlvInteractorGroupProxy

Modified JavaScript Classes

• IlvAjax
• IlvAbstractView
• IlvView

Incompatibilities

• The change of the license management mechanism requires you to declare in your program which features are used. For instance, to declare that Gantt is used, call:

            IlvProductUtil.DeploymentLicenseRequired(IlvProductUtil.IBM_ILOG_JViews_Gantt_Deployment);
          

• The Clearthought TableLayout manager classes for Swing, in the info.clearthought.layout package, have been removed from the JViews Framework and are now supplied as an external library. These classes are required by the Designers, Map Builder, the Charts customizers, and the calendar Swing components.
• All JViews product jars are now signed. This can result in a SecurityException if your application has classes in the same ilog.* packages as the JViews library. You can either repackage your application so that it no longer shares packages with JViews or you can remove the signatures from the JViews jars. These are the ILOGKEYS.* files in the jars' META-INF directory.
• The Applet thin client implementation has been retired since JViews 8.7.

General Changes

• All JViews products have improved globalization support for messages and resources, including better translatability support on editor tools. The JViews Web technologies improvements include client dependent locale support.
• The license management mechanism got replaced by a mechanism to declare the used feature set. Before you can use a certain feature such as Maps or Gantt, your application needs to enable that feature once by using the API of ilog.views.util.IlvProductUtil. An additional keys.jlm license file is no longer needed. Before deployment, use of jlmdeploy is no longer needed either. The jlmdeploy tool has been removed.

• The Hitmap technology enabling client side high responsive interactions:
  • Graphic objects can be highlighted in browsers without roundtrip to server.
  • ToolTips can be shown when hovering graphic objects. This a new implementation of the ToolTips that can work simultaneously with other interactors such as the zoom and the pan interactor. To maintain the compatibility with previous releases, the image-map based ToolTips implementation is still maintained. However, hitmap based ToolTips are preferable when implementing new JViews Web applications.
• New interactor group component to combine several interactors that are all active and work together. For example, it allows to have the ToolTip interactor, the highlight interactor and the zoom interactor at the same time.
• Progressive zoom effect has been added. The progressive zoom is not activated by default to keep compatibilities. It can be activated by API.
• Scroll bars can be enabled for jvf:view.

Library Changes

New Interfaces and Classes

ilog.views.appframe.util.IlvCurrentDirectoryURLResolver

Defines a URL resolver that looks on the file system, in a location relative to the current directory of the process (System.getProperty("user.dir")).

ilog.views.faces.dhtml.interactor.IlvFacesAjaxInteractor

The IlvFacesAjaxInteractor is the class for JViews JSF Ajax interactor component.

ilog.views.faces.dhtml.interactor.IlvFacesInteractorGroup

The IlvFacesInteractorGroup is the class for JViews JSF interactor group components.

ilog.views.faces.dhtml.renderkit.IlvFacesAjaxInteractorRenderer

The IlvFacesAjaxInteractorRenderer is the renderer class for IlvFacesAjaxInteractor.

ilog.views.faces.dhtml.renderkit.IlvFacesHighlightInteractorRenderer

The IlvFacesHighlightInteractorRenderer is a specialized renderer for using the IlvFacesHighlightInteractor component.
This renderer generates an instance of the IlvFacesHighlightInteractorProxy JavaScript class.

ilog.views.faces.dhtml.renderkit.IlvFacesInteractorGroupRenderer

The IlvFacesInteractorGroupRenderer is a specialized renderer for using the IlvFacesInteractorGroup component.
This renderer generates an instance of the IlvFacesInteractorGroupProxy JavaScript class.

ilog.views.faces.dhtml.renderkit.IlvFacesTooltipInteractorRenderer

The IlvFacesTooltipInteractorRenderer is a specialized renderer for using the IlvFacesTooltipInteractor component.
This renderer generates an instance of the IlvFacesTooltipInteractorProxy JavaScript class.

ilog.views.faces.dhtml.taglib.IlvFacesHighlightInteractorTag

This class defines the JSP custom tag handler for the IlvFacesHighlightInteractor component and its DHTML renderer, IlvFacesHighlightInteractorRenderer.

ilog.views.faces.dhtml.taglib.IlvFacesTooltipInteractorTag

This class defines the JSP custom tag handler for the IlvFacesTooltipInteractor component and its DHTML renderer, IlvFacesTooltipInteractorRenderer.

ilog.views.faces.dhtml.taglib.IlvInteractorGroupTag

This class defines the custom tag handler for the IlvInteractorGroupTag component.

ilog.views.faces.interactor.IlvFacesHighlightInteractor

A JSF highlight interactor.

ilog.views.faces.interactor.IlvFacesTooltipInteractor

A JSF tooltip interactor.

ilog.views.linkconnector.IlvCachingLinkConnector

A link connector that has a cache of the link connection points.

ilog.views.servlet.IlvHitmapDefinition

This class generates hitmap relation information such as ToolTips.

ilog.views.servlet.IlvHitmapSupport

This class generates hitmaps and related information.

ilog.views.util.IlvFeatureUseNotAcknowledgedException

This exception is thrown when a JViews service is being used without or before the use of the corresponding feature set has been acknowledged.

ilog.views.util.IlvLocaleUtil

This class defines a concept of "current locale" for use by all of JViews.

ilog.views.util.IlvThreadUtil

This class contains utility functions related to threads.

ilog.views.util.convert.IlvLocalizedPropertyEditorFactory

Factory to produce localized property editors.

ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Charts_Deployment

This class is a servlet context listener that allows you to declare that you are intending to use the feature set of JViews Charts.

ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Diagrammer_Deployment

This class is a servlet context listener that allows you to declare that you are intending to use the feature set of JViews Diagrammer.

ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Enterprise_Deployment

This class is a servlet context listener that allows you to declare that you are intending to use the feature set of JViews Enterprise.

ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Gantt_Deployment

This class is a servlet context listener that allows you to declare that you are intending to use the feature set of JViews Gantt.

ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Graph_Layout_for_Eclipse_Deployment

This class is a servlet context listener that allows you to declare that you are intending to use the feature set of JViews Graph Layout for Eclipse.

ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Maps_Deployment

This class is a servlet context listener that allows you to declare that you are intending to use the feature set of JViews Maps.

ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_Maps_for_Defense_Deployment

This class is a servlet context listener that allows you to declare that you are intending to use the feature set of JViews Maps for Defense.

ilog.views.util.servlet.DeploymentLicenseRequired_for_IBM_ILOG_JViews_TGO_Deployment

This class is a servlet context listener that allows you to declare that you are intending to use the feature set of JViews TGO.

ilog.views.util.servlet.IlvScriptMessageServletSupport

The IlvScriptMessageServletSupport class defines a servlet support dedicated to load script message requests.

ilog.views.util.servlet.IlvSelectionResizable

Use the IlvSelectionResizable interface to test if the selected object can be resized.

ilog.views.util.servlet.IlvServletLocaleUtil

Various JViews Locale utilities.

ilog.views.util.servlet.IlvServletRunnable

The IlvServletRunnable interface defines a fragment of servlet code that is intended to be executed by a thread.

ilog.views.util.servlet.IlvServletThreadUtil

This class supports declaring context information for the current thread, for the extent of the handling of a single request.

ilog.views.util.swing.IlvJComboBox

This class is a variant of the Swing JComboBox that handles the alignment of the list pop-up in right to left component orientation correctly.

ilog.views.util.text.IlvListFormat

This class is the abstract base class for classes that format a list of items, producing a single string.

ilog.views.util.text.IlvPatternBasedListFormat

This class formats a list of items, producing a single string.

ilog.views.util.text.IlvSimpleListFormat

This class formats a list of items, producing a single string.

Modified Classes

ilog.views.appframe.plugin.IlvPlugin

• New methods:
  • getNameKey(): Returns the resource key of the name of the plug-in.

ilog.views.appframe.plugin.IlvPluginManager

• New methods:
  • getPluginManagers(IlvApplication): Returns the plugin managers of the application.

ilog.views.faces.IlvFacesUtil

• New methods:
  • getFacesLocale(): Returns the Locale of the current JSF request, or null if not currently executing in JSF context.
  • processValueChange(FacesContext, ValueChangeListener[], MethodBinding, ValueChangeEvent): Process value change event according to different JSF runtime.

ilog.views.faces.IlvFrameworkConstants

• New fields:
  • COLOR: The color property.
  • OPACITY: The opacity property.
  • TOLERANCE: The tolerance property.

ilog.views.faces.component.IlvFacesView

• New methods:
  • getScrollBars(): Gets the scroll bar state of the view.
  • setScrollBars(int): Sets the scroll bar state of the view.
  • isProgressiveZoom(): Checks whether the view is progressive zoom or not.
  • setProgressiveZoom(boolean): Sets progressive zoom.

ilog.views.faces.dhtml.IlvDHTMLConstants

• New fields:
  • ACTION_NAME: The action name of a interactor.

ilog.views.faces.dhtml.renderkit.IlvScriptManager

• New methods:
  • addLocaleScript(Locale, String): Adds a locale script that must be loaded before creating the component JavaScript object.

ilog.views.faces.dhtml.taglib.IlvFacesViewTag

• New methods:
  • getProgressiveZoom(): Gets the progressive zoom property.
  • setProgressiveZoom(String): Sets the progressive zoom property
  • getScrollBars(): Gets the scroll bar state property from view.
  • setScrollBars(String): Sets the scroll bar state property for view.

ilog.views.graphic.IlvIcon

• New fields:
  • hideStackTraceInImageUpdate: Allows to switch off stack traces inside the image update process.

ilog.views.graphic.IlvZoomableLabel

• New methods:
  • setTransformer(IlvTransformer): Sets the transformation used to draw the label.

ilog.views.linkconnector.IlvClippingLinkConnector

• New methods:
  • useCache(): Returns true because this link connector uses the cache.

ilog.views.linkconnector.IlvPinLinkConnector

• New methods:
  • useCache(): Returns true because the pin link connector uses the cache.

ilog.views.servlet.IlvManagerServletSupport

• New methods:
  • getHitmapSupport(): Returns the ilog.views.servlet.IlvHitmapSupport class which defines a servlet support dedicated to hitmaps.
  • getScriptMessageSupport(): Returns the ilog.views.util.servlet.IlvScriptMessageServletSupport class which defines a servlet support dedicated to load script message requests.

ilog.views.swing.IlvToolTipManager

• General changes:
  • The performance of the ToolTip mechanism has been improved.
  • The default value of the bean property IlvTooltipManager.toolTipChangeDelay was changed from 1000 to 20, to match a change of the ToolTip behavior implemented by IlvTooltipManager.

ilog.views.util.IlvImageUtil

• New methods:
  • getScaledImage(Image, int, int, boolean, int): Creates a scaled image.
  • loadImage(byte[]): Loads an image from the specified byte array.

ilog.views.util.IlvProductUtil

• Overview of new features:
  • The license management mechanism got replaced by a mechanism to declare the used feature set. Before you can use a certain feature such as Maps or Gantt, your application needs to enable that feature once by using the API of this class. An additional keys.jlm license file is no longer needed.
• New methods:
  • DeploymentLicenseRequired(String): This method allows you to declare which feature set, part of JViews Enterprise, you are intending to use.


• New fields:
  • IBM_ILOG_JViews_Charts_Deployment: This object denotes all the features of JViews Charts.
  • IBM_ILOG_JViews_Diagrammer_Deployment: This object denotes all the features of JViews Diagrammer.
  • IBM_ILOG_JViews_Enterprise_Deployment: This object denotes all the features of JViews Enterprise.
  • IBM_ILOG_JViews_Gantt_Deployment: This object denotes all the features of JViews Gantt.
  • IBM_ILOG_JViews_Graph_Layout_for_Eclipse_Deployment: This object denotes all the features of JViews Graph Layout for Eclipse.
  • IBM_ILOG_JViews_Maps_Deployment: This object denotes all the features of JViews Maps.
  • IBM_ILOG_JViews_Maps_for_Defense_Deployment: This object denotes all the features of JViews Maps for Defense.
  • IBM_ILOG_JViews_TGO_Deployment: This object denotes all the features of JViews TGO.

ilog.views.util.IlvResourceUtil

• New methods:
  • getCurrentLocaleString(Class, String): Returns a string for the given subkey from the resource bundle named "messages" in the package of the input object. Uses the current client side locale.
  • getServerLocaleString(Class, String): Returns a string for the given subkey from the resource bundle named "messages" in the package of the input object. Uses the current server side locale.

ilog.views.util.collections.IlvCollections

• New methods:
  • toArray(Iterator, Class, boolean): Returns an array that contains the elements produced by the given iterator.

ilog.views.util.convert.IlvConvert

• New methods:
  • addConverter(IlvLocalizedPropertyEditorFactory, Class): Adds a converter to the global list of converters used to convert values.

ilog.views.util.print.IlvHeaderFooter

• New methods:
  • getAuthorKey(): Returns the key for the author.
  • getDateKey(): Returns the key for the date.
  • getFileKey(): Returns the key for the file name.
  • getPageKey(): Returns the key for the page number.
  • getPagesKey(): Returns the key for the number of pages in the book.
  • getTimeKey(): Returns the key for the time.

ilog.views.util.print.IlvPrintPreviewPanel

• New methods:
  • getPrintPreviewTitle(): Returns an internationalized string that can be used as a title of a Print preview dialog.

ilog.views.util.servlet.IlvSelectionSupport

• New methods:
  • isResizable(IlvSelectionSupport.IlvSelectionResponse, Object): Checks the selected object whether is resizable or not.

ilog.views.util.servlet.IlvSelectionSupport.IlvSelectionResponse

• New methods:
  • addToSelection(Rectangle, List, Point2D.Float[]): Adds a selection to the client's selection.
  • removeFromSelection(Rectangle, List, Point2D.Float[]): Removes a selection from the client side selection.

ilog.views.util.styling.IlvMutableStyleSheet

• Overview of new features:
  • More convenience methods to read a mutable style sheet from file have been added.
• New methods:
  • readStyleSheet(URL): Fills this style sheet with all declarations read from a file.
  • readStyleSheet(InputStream): Fills this style sheet with all declarations read from the input stream.
  • readStyleSheet(Reader): Fills this style sheet with all declarations read from the input reader.

ilog.views.util.swing.IlvSwingUtil

• New methods:
  • createMultiLineToolTipText(String, int, int): Creates an HTML text string that will render as a multiline ToolTip if the single line ToolTip is larger than a given maximal width.
  • escapeForHTMLElementVariableSpaces(String, boolean): Converts a string to HTML syntax, for including in an HTML element.
  • invokeLater(Runnable): Enqueues the given task for execution in the current AWT/Swing event thread.
  • showInputDialog(Component, Object, String, int, Icon, Object[], Object): Shows a modal dialog that requests a piece of textual input from the user.
  • isAppropriateLookAndFeel(String): Returns true if the given look-and-feel class can reasonably be used with the given JRE on the given platform.
  • getDefaultAppropriateLookAndFeelClassName(): Returns the look-and-feel class name that is appropriate for the given JRE on the given platform.
  • setDefaultAppropriateLookAndFeel(): Sets the look-and-feel class name to one that is appropriate for the given JRE on the given platform, and handles failures in doing so.

ilog.views.util.swing.table.IlvDefaultTableCellRenderer

• New constructors:
  • IlvDefaultTableCellRenderer(boolean): Creates a new IlvDefaultTableCellRenderer.


• New methods:
  • setValue(Object): Overridden to format dates in a locale dependent way.

ilog.views.util.text.IlvDateFormat

• New constructors:
  • IlvDateFormat(Locale): Creates a default date/time formatter that uses the SHORT style for both the date and the time in the given locale and the default timezone.

ilog.views.util.text.IlvDateFormatFactory

• New methods:
  • getInstance(Locale): Returns a default date/time formatter that uses the java.text.DateFormat.SHORT style for both the date and the time in the given locale and default timezone.

New JSF Components

jv:interactorGroup

It allows combining several interactors that are all active and work together. It allows to have, for example, the ToolTip interactor, the highlight interactor and the zoom interactor at the same time.

jvf:tooltipInteractor

It allows to show ToolTip of graphic objects.

jvf:highlightInteractor

It allows to highlight graphic objects.

Modified JSF Components

jvf:view

• New attributes:
  • progressiveZoom: Enables or disables the progressive zoom effect of the view.
  • scrollBars: Enables or disables scroll bars of the view.

New JavaScript Classes

IlvInteractorGroup

It allows combining several interactors that are all active and work together. It allows to have, for example, the ToolTip interactor, the highlight interactor and the zoom interactor at the same time.

IlvLinkInteractor

Use the IlvLinkInteractor to modify selected links. It can switch a link from one node to another, add or remove a point in the selected link.

IlvResizeInteractor

An IlvResizeInteractor can resize selected nodes in a diagrammer view or selected activities in a Gantt view.

IlvSelection

This class is a base class of IlvSelectionRectangle and IlvSelectionLink.

IlvSelectionLink

A link selection is designed to show a selected node in a diagrammer view or a selected constraint in a Gantt view.

IlvHighlightInteractor

It allows to highlight graphic objects.

IlvHitmap

The Hitmap implementation.

IlvTooltipInteractor

Allows to show ToolTips on graphic objects.

IlvAjaxInteractorProxy

JavaScript implementation for jvf:ajaxInteractor.

IlvFacesHighlightInteractorProxy

JavaScript implementation for jvf:highlightInteractor.

IlvFacesTooltipInteractorProxy

JavaScript implementation for jvf:tooltipInteractor.

IlvInteractorGroupProxy

JavaScript implementation for jv:interactorGroup.

Modified JavaScript Classes

IlvAjax

• New methods:
  • loadJS(url): Synchronously loads a specified JavaScript file.

IlvAbstractView

• New methods:
  • setScrollBarsState(state): Sets the state of scroll bars.

IlvView

• New methods:
  • setProgressiveZoom(canProgressiveZoom): Enables or disables the progressive zoom effects.

Example Changes

• The sample Basic Manager (Servlet & SVG) (svg-servlet) that showed how to build SVG Web application has been removed.