JViews Charts 8.7 Release Notes

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

Incompatibilities
General Changes
Globalization
Unclipped Annotations
Scale Ticks in Polar and Radar Charts
Hitmap Web Technology: Highlighting and Tool Tips
Other Changes in Charts Classes
Other API Changes in Web Technologies
Example Changes

Incompatibilities

• 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 method IlvChart.synchronizeAxis no longer replaces the axis with the axis instance from the other chart. Therefore if you had code that moves or reinstalls the AxisListener objects that were attached to the original axis, this code should be removed for use with JViews 8.7.

General Changes

• The license management mechanism is 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.

  Modified Classes

  ilog.views.util.IlvProductUtil

  • New methods:
    • DeploymentLicenseRequired(String): This method allows you to declare which feature set, part of JViews, you intend 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.
  
  

  New Interfaces and Classes

  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_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.

• The performance of adding many data points to a data set has been improved.

Globalization

Modified Classes

ilog.views.chart.datax.adapter.partition.IlvDateClusterId

• New constructors:
  • IlvDateClusterId(IlvObjectModelWithColumns, IlvDataColumnInfo, int, int, Locale): Creates an instance of this class.

ilog.views.chart.datax.adapter.partition.IlvDatePartitioner

• New constructors:
  • IlvDatePartitioner(IlvObjectModelWithColumns, IlvDataColumnInfo, int[], Locale): Creates an instance of this class.
  • IlvDatePartitioner(IlvObjectModelWithColumns, IlvDataColumnInfo, int[], Locale, Calendar): Creates an instance of this class.

ilog.views.chart.datax.adapter.partition.IlvDatePartitionerFactory

• New constructors:
  • IlvDatePartitionerFactory(IlvDataColumnInfo, int[], Locale): Creates an instance of this class.
  • IlvDatePartitionerFactory(IlvDataColumnInfo, int[], Locale, Calendar): Creates an instance of this class.

Unclipped Annotations

Modified Classes

ilog.views.chart.IlvChart.Area

• New methods:
  • isPlotRectIncludingAnnotations(): Returns true if the layout is made in such a way that the plotting rectangle contains the markers and annotations of the visible data points.
  • setPlotRectIncludingAnnotations(boolean): Specifies whether the layout is made in such a way that the plotting rectangle contains the markers and annotations of the visible data points.

ilog.views.chart.event.ChartRendererEvent

• New fields:
  • ANNOTATION_CHANGED: The type of the event when an annotation (IlvDataAnnotation) used by the renderer has changed, or an annotation has been added to or removed from the renderer.

ilog.views.chart.IlvChartRenderer

• New methods:
  • getBounds(Rectangle2D, boolean): Returns the bounds of the graphical representation for the visible data.
  • holdsAnnotations(): Returns true if some annotations are defined for some data sets, data points, or data objects, in this renderer.

ilog.views.chart.renderer.IlvCompositeChartRenderer

• New methods:
  • getBounds(Rectangle2D, boolean): Returns the bounds of the graphical representation for the visible data.

ilog.views.chart.renderer.IlvSingleChartRenderer

• New methods:
  • getBounds(Rectangle2D, boolean): Returns the bounds of the graphical representation for the visible data.

ilog.views.chart.renderer.IlvTreemapChartRenderer

• New methods:
  • getBounds(Rectangle2D, boolean): Returns the bounds of the graphical representation for the visible data.

Scale Ticks in Polar and Radar Charts

Modified Classes

ilog.views.chart.IlvScale

• New methods:
  • getCircleSide(): Returns the side of the labels, title, and "outside" ticks along the circular scale of a polar or radial chart.
  • setCircleSide(int): Sets the side where to place the labels, title, and "outside" ticks along the circular scale of a polar or radial chart.
  • getRadialSide(): Returns the side of the labels, title, and "outside" ticks along the radial scale of a polar or radial chart.
  • setRadialSide(int): Sets the side where to place the labels, title, and "outside" ticks along the radial scale of a polar or radial chart.


• New fields:
  • INSIDE: Circular scale side (x scale in polar or radar chart): Labels, title, and "outside" ticks are drawn inside the circle.
  • LEFT_SIDE: Radial scale side (y scale in polar or radar chart): Labels, title, and "outside" ticks are drawn to the left of the radial scale.
  • OUTSIDE: Circular scale side (x scale in polar or radar chart): Labels, title, and "outside" ticks are drawn outside the circle.
  • RIGHT_SIDE: Radial scale side (y scale in polar or radar chart): Labels, title, and "outside" ticks are drawn to the right of the radial scale.

Hitmap Web Technology: Highlighting and ToolTips

• Data points can be highlighted in browsers without roundtrip to server.
• ToolTips can be shown when hovering over data points or data series. This is a new implementation of the ToolTips based on hitmap technology that can work simultaneously with other interactors. To maintain the compatibility with previous releases, the image-map based ToolTip implementation is still maintained. However, hitmap based ToolTips are preferable when implementing new JViews Web applications.
• The highlight interactor, the ToolTip interactor, and zoom interactors can be added in an interactor group so users can have these interaction at the same time without switching from one interactor to another.

New Interfaces and Classes

ilog.views.chart.servlet.IlvChartHitmapDefinition

This class defines how a hitmap of a chart is constructed.

ilog.views.chart.servlet.IlvDefaultChartHitmapDefinition

This class defines a default way for constructing a hitmap of a chart.

ilog.views.chart.servlet.IlvDefaultChartToolTip

This class implements a simple ToolTip, consisting of two lines of text: a title and a main information line.

ilog.views.chart.servlet.IlvChartHitmapSupport

This class generates hitmaps and related information.

ilog.views.chart.servlet.IlvChartHitmapAccumulator

This class accumulates a hitmap.

Modified Classes

ilog.views.chart.servlet.IlvChartServletSupport

• New methods:
  • getHitmapSupport(): Returns the hitmap support that should be an instance of IlvChartHitmapSupport.


• New fields:
  • HITMAP_REQUEST: The hitmap request value for REQUEST_PARAM.

ilog.views.chart.IlvChartRenderer

• New methods:
  • drawIntoHitmap(IlvChartHitmapDefinition, IlvChartHitmapAccumulator): Draws the rendering into a hitmap.

ilog.views.chart.IlvLegend

• New methods:
  • drawIntoHitmap(IlvChartHitmapDefinition, IlvChartHitmapAccumulator): Draws the rendering into a hitmap.

ilog.views.chart.IlvLegendItem

• New methods:
  • drawIntoHitmap(IlvChartHitmapDefinition, IlvChartHitmapAccumulator): Draws this item as an object into the hitmap.

ilog.views.chart.renderer.IlvCompositeChartRenderer

• New methods:
  • drawIntoHitmap(IlvChartHitmapDefinition, IlvChartHitmapAccumulator): Draws the rendering into a hitmap.

ilog.views.chart.renderer.IlvSingleChartRenderer

• New methods:
  • drawIntoHitmap(IlvChartHitmapDefinition, IlvChartHitmapAccumulator): Draws the rendering into a hitmap.

ilog.views.chart.renderer.IlvTreemapChartRenderer

• New methods:
  • drawIntoHitmap(IlvChartHitmapDefinition, IlvChartHitmapAccumulator): Draws the rendering into a hitmap.

Modified JavaScript Classes

IlvLegendView

• New methods:
  • enableHitmap(enable, tolerance): Enables or disables the hitmap support.

Other Changes in Charts Classes

New Interfaces and Classes

ilog.views.chart.event.LabelRendererPropertyEvent

Describes the change of a bean property of an IlvLabelRenderer.

Modified Classes

ilog.views.chart.IlvChart

• New methods:
  • updateDataRangeAndRepaint(): Updates the data range for all coordinate systems, and initiates a repaint of the chart area.

ilog.views.chart.IlvChartDecoration

• New methods:
  • updateBoundsCache(): Updates the bounds cache of this decoration.

ilog.views.chart.IlvChartRenderer

• New methods:
  • getDataSetMainIndex(IlvDataSet): Returns the index of the specified data set in the data source connected to the main renderer in the parent chain of this renderer.
  • getDataSetMainRenderer(IlvDataSet): Returns the main renderer of the specified data set in the parent chain of this renderer.

ilog.views.chart.IlvLabelRenderer

• New methods:
  • addPropertyChangeListener(PropertyChangeListener): Adds a property change listener to this object.
  • firePropertyChange(String, Object, Object, int): Notifies the listeners when a property change occurred.
  • getBackgroundShape(JComponent, double, double, String): Returns the combined background shapes of the text lines, according to the given position.
  • removePropertyChangeListener(PropertyChangeListener): Removes a property change listener from this object.

ilog.views.chart.IlvScale

• New methods:
  • getTitleBackgroundShape(): Returns the background shape of the title.

ilog.views.chart.data.IlvAbstractDataSet

• New methods:
  • computeMinimumXDifference(IlvDataSet): Computes the minimum positive difference among adjacent X values in the sequence of X values, sorted into ascending order.
  • getMinimumXDifference(): Returns the minimum positive difference among adjacent X values in the sequence of X values, sorted into ascending order.
  • invalidateLimits(int, int, boolean): Invalidates the x range cache and y range cache from index firstIdx to index lastIdx (inclusive).

ilog.views.chart.event.AxisRangeEvent

• New methods:
  • getStoredRange(): Returns the range that is stored as non-redundant information in this event.

Other API Changes in Web Technologies

Modified Classes

ilog.views.chart.servlet.IlvChartServletSupport

• New methods:
  • getScriptMessageSupport(): Returns the script message support which is usually an instance of IlvScriptMessageServletSupport.

Modified JavaScript Classes

IlvChartSelectInteractorProxy

• Deprecated methods:
  • setMode(mode): Deprecated, replaced by setPickingMode(mode).
  • getMode(): Deprecated, replaced by getPickingMode().
• New methods:
  • setPickingMode(mode): Sets the picking mode.
  • getPickingMode(): Returns the picking mode.

Example Changes

• The new js-chart-hitmap sample is an extension of the earlier servlet-chart-imgmap sample. It demonstrates the use of the hitmap for rapid thin-client interactions.
• The samples rwc-chart-dashboard and rwc-chart-stock have been retired from this release because the RWC technology has been deprecated.
• The samples servlet-chart-basic, servlet-chart-imgmap, servlet-chart-jsp, and servlet-chart-treemap showed obsolete techniques to implement JViews Charts Web applications. They are replaced by a new sample js-chart-hitmap.