JViews Charts 8.5 Release Notes

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

Incompatibilities
General Changes
Decoration Types: Labels
Decoration Types: Arbitrary Graphic Objects
Decoration Types: Animated Images
Header, Footer Anti-aliasing
Blinking Colors
Legend: Reversing the Order of the Legend Items
Legend: High-Low-Open-Close Charts
Legend: Interaction
Interactions: Picking the Nearest Rendered Item
Interactions: Fast Mouse Movements
Performance: Batching of Data Source Changes
Performance: Batching of Renderer Changes
Handling of Undefined y Values
Treemap Renderer API
IlvIMapArea API
Utility Methods for Shapes
Use of Generic types
Avoiding Memory Leaks
Improved Web Deployment Options
Improved Applet Integration
Improved Eclipse/RCP integration
Improved SWT integration
Other Changes in Charts Classes
Other Changes in DHTML JavaServer Faces Components
Other Changes in Utility Classes
Example Changes

Incompatibilities

General Changes

• Usability improvements in Designer for JViews Charts, in particular in the New Chart Wizard.

Decoration Types: Labels

New Interfaces and Classes

ilog.views.chart.graphic.IlvLabelDecoration

A class to display a label as a chart decoration.

Decoration Types: Arbitrary Graphic Objects

New Interfaces and Classes

ilog.views.chart.graphic.IlvGraphicDecoration

A class that displays an IlvGraphic, a graphic object in the JViews Framework sense, as a chart decoration.

ilog.views.chart.graphic.IlvPositionableDecoration

A chart decoration that can be freely positioned at any place in the chart area.

Decoration Types: Animated Images

Header, Footer Anti-aliasing

New Interfaces and Classes

ilog.views.chart.swing.IlvJLabel

This class is a Swing label, with additional bean properties.

Blinking Colors

New Interfaces and Classes

ilog.views.chart.IlvChartOwnedDrawable

This class denotes an object that is drawn as part of the chart area component, and that may be "owned" by a chart.

ilog.views.util.java2d.IlvBlinkingColor

This class defines a blinking color.

ilog.views.util.java2d.IlvBlinkingDrawingResource

This interface defines colors and paints that can blink.

ilog.views.util.java2d.IlvBlinkingMultiColor

This class defines a blinking color consisting of multiple subcolors.

ilog.views.util.java2d.IlvBlinkingMultiPaint

This class defines a blinking paint consisting of multiple subpaints.

ilog.views.util.java2d.IlvBlinkingObject

A blinking object is an object that supports blinking.

ilog.views.util.java2d.IlvBlinkingObjectOwner

A blinking object owner is an object that owns an object that supports blinking and is able to delay the repaint of the blinking by a sequence

ilog.views.util.java2d.IlvBlinkingPaint

This class defines a blinking paint.

ilog.views.util.swing.color.IlvAlphaColorChooserPanel

IlvAlphaColorChooserPanel is an abstract base class for panels to be added to a JColorChooser.

ilog.views.util.swing.color.IlvBlinkingColorChooserPanel

IlvBlinkingColorChooserPanel defines a panel that allows to choose a blinking color.

ilog.views.util.swing.color.IlvBlinkingColorPreviewPanel

A panel that wraps another panel and enables blinking behavior for the foreground of the wrapped panel.

ilog.views.util.swing.color.IlvJColorChooser

A component that lets you choose a color.

ilog.views.util.swing.color.IlvRGBAColorChooserPanel

IlvRGBAColorChooserPanel defines a panel to be added to a JColorChooser.

Legend: Reversing the Order of the Legend Items

Modified Classes

ilog.views.chart.IlvLegend

• New methods:
  • getHorizontalOrientation(): Returns the orientation used by a horizontal layout.
  • setHorizontalOrientation(int): Sets the orientation used by a horizontal layout.
  • getVerticalOrientation(): Returns the orientation used by a vertical layout.
  • setVerticalOrientation(int): Sets the orientation used by a vertical layout.

ilog.views.chart.IlvLegendLayout

• New methods:
  • getHorizontalOrientation(): Returns the orientation used by a horizontal layout.
  • setHorizontalOrientation(int): Sets the orientation used by a horizontal layout.
  • getVerticalOrientation(): Returns the orientation used by a vertical layout.
  • setVerticalOrientation(int): Sets the orientation used by a vertical layout.

Legend: High-Low-Open-Close Charts

New Interfaces and Classes

ilog.views.chart.IlvHiLoOpenCloseRendererLegendItem

Represents a legend item associated with a quadruple of data sets (low, high, open, close) displayed by a IlvHiLoChartRenderer in CANDLE or OPENCLOSE mode.

Modified Classes

ilog.views.chart.renderer.IlvHiLoChartRenderer

• New methods:
  • getName(int): Returns the name of the designated child renderer pair.
  • setName(int, String): Sets the name of the designated child renderer pair.
  • getNames(): Returns the list of names of the child renderer pairs.
  • setNames(String[]): Sets the list of names of the child renderer pairs.

Legend: Interaction

Modified Classes

ilog.views.chart.IlvLegend

• New methods:
  • itemClickMayMoveLegend(IlvLegendItem): Called when a mouse button has been pressed on a legend item.

Interactions: Picking the Nearest Rendered Item

Modified Classes

ilog.views.chart.interactor.IlvChartDataInteractor

• New fields:
  • NEARESTITEM_PICKING: The constant describing the nearest item picking mode.

ilog.views.chart.IlvChart

• New methods:
  • getNearestItem(IlvChartDataPicker, double[]): Returns the display point whose renderer drawing is closest to the picking point defined by the specified data picker.

ilog.views.chart.IlvChartRenderer

• New methods:
  • getNearestItem(IlvChartDataPicker, double[]): Returns the display item closest to the picking point defined by the specified data picker.
  • getNearestItem(Iterator, IlvChartDataPicker, double[]): Returns the projected data item closest to the specified point.

ilog.views.chart.IlvStyle

• New methods:
  • distanceToPoints(double[], double[], int, double, double, boolean): Returns the distance between the specified geometry and the specified point.
  • distanceToPolygon(double[], double[], int, double, double, boolean): Returns the distance between the specified polygon and the specified point.
  • distanceToPolyline(double[], double[], int, double, double, boolean): Returns the distance between the specified polyline and the specified point.
  • distanceToShape(Shape, double, double, boolean): Returns the distance between the specified shape and the specified point.

ilog.views.chart.faces.IlvChartConstants

• New fields:
  • NEAREST_ITEM_PICKING: The constant describing the nearest item picking mode.

ilog.views.chart.faces.dhtml.interactor.IlvChartSelectInteractor

• New methods:
  • getPickingMode(): Returns the picking mode.
  • setPickingMode(String): Sets the picking mode.
  • restoreState(FacesContext, Object): Restores the state of this component from the state parameter.
  • saveState(FacesContext): Returns the state of this component.

ilog.views.chart.renderer.IlvCompositeChartRenderer

• New methods:
  • getNearestItem(IlvChartDataPicker, double[]): Returns the display item closest to the picking point defined by the specified data picker.

ilog.views.chart.renderer.IlvSingleChartRenderer

• New methods:
  • getNearestItem(IlvChartDataPicker, double[]): Returns the display item closest to the picking point defined by the specified data picker.

ilog.views.chart.renderer.IlvTreemapChartRenderer

• New methods:
  • getNearestItem(IlvChartDataPicker, double[]): Returns the data object closest to the picking point defined by the specified data picker.

ilog.views.chart.servlet.IlvPickPointAction

• New fields:
  • NEAREST_ITEM_PICKING: The constant describing the nearest item picking mode.

ilog.views.chart.util.IlvGraphicUtil

• New methods:
  • lineIntersectsCircle(Line2D, double, double, double): Returns whether the specified line intersects the specified circle.
  • rectangleIntersectsCircle(Rectangle2D, double, double, double): Returns whether the specified rectangle intersects the specified circle.

Interactions: Fast Mouse Movements

Modified Classes

ilog.views.chart.interactor.IlvChartEditPointInteractor

• New methods:
  • processMouseMovedEvent(MouseEvent): Handles a mouse motion event with no button pressed.

ilog.views.chart.interactor.IlvChartHighlightInteractor

• New methods:
  • processMouseMovedEvent(MouseEvent): Processes a mouse motion event with no button pressed.

ilog.views.chart.interactor.IlvChartLocalReshapeInteractor

• New methods:
  • processMouseMovedEvent(MouseEvent): Handles a mouse motion event with no button pressed.

Performance: Batching of Data Source Changes

New Interfaces and Classes

ilog.views.chart.event.DataSourceListener2

Defines an extended interface for objects that listen to changes in an ilog.views.chart.data.IlvDataSource.

Modified Classes

ilog.views.chart.data.IlvAbstractDataSource

• New methods:
  • endBatch(): Signals the end of a series of changes to the data source.
  • startBatch(): Signals the beginning of a series of changes to the data source.

ilog.views.chart.IlvChartRenderer

• New methods:
  • dataSetsChangesBatchEnding(): Called when a series of data sets insertions or removals is terminating.
  • dataSetsChangesBatchStarting(): Called when a series of data sets insertions or removals is starting.

ilog.views.chart.renderer.IlvBarChartRenderer

• New methods:
  • dataSetsChangesBatchEnding(): Called when a series of data sets insertions or removals is terminating.
  • dataSetsChangesBatchStarting(): Called when a series of data sets insertions or removals is starting.

ilog.views.chart.renderer.IlvBubbleChartRenderer

• New methods:
  • dataSetsChangesBatchEnding(): Called when a series of data sets insertions or removals is terminating.
  • dataSetsChangesBatchStarting(): Called when a series of data sets insertions or removals is starting.

ilog.views.chart.renderer.IlvComboChartRenderer

• New methods:
  • dataSetsChangesBatchEnding(): Called when a series of data sets insertions or removals is terminating.
  • dataSetsChangesBatchStarting(): Called when a series of data sets insertions or removals is starting.

ilog.views.chart.renderer.IlvHiLoChartRenderer

• New methods:
  • dataSetsChangesBatchEnding(): Called when a series of data sets insertions or removals is terminating.
  • dataSetsChangesBatchStarting(): Called when a series of data sets insertions or removals is starting.

ilog.views.chart.renderer.IlvPolylineChartRenderer

• New methods:
  • dataSetsChangesBatchEnding(): Called when a series of data sets insertions or removals is terminating.
  • dataSetsChangesBatchStarting(): Called when a series of data sets insertions or removals is starting.

Performance: Batching of Renderer Changes

New Interfaces and Classes

ilog.views.chart.event.ChartRendererListener2

Defines an extended interface for objects that listen to changes in an ilog.views.chart.IlvChartRenderer.

Modified Classes

ilog.views.chart.IlvChart

• New methods:
  • endRendererChanges(): Terminates a batch of renderer changes.
  • startRendererChanges(): Starts a batch of renderer changes.

ilog.views.chart.IlvChartRenderer

• New methods:
  • endRendererChanges(): Terminates a batch of renderer changes.
  • startRendererChanges(): Starts a batch of renderer changes.

Handling of Undefined y Values

Modified Classes

ilog.views.chart.data.IlvAbstractDataSet

• New methods:
  • isXRangeIncludingUndefinedPoints(): Returns true if points with an undefined y value are included when computing the x range.
  • setXRangeIncludingUndefinedPoints(boolean): Specifies whether points with an undefined y value are included when computing the x range.

Treemap Renderer API

Modified Classes

ilog.views.chart.renderer.IlvTreemapChartRenderer

• New methods:
  • getDisplayArea(Object): Returns the displayed data object containing the specified data object.

IlvIMapArea API

Modified Classes

ilog.views.chart.servlet.IlvIMapArea

• New constructors:
  • IlvIMapArea(IlvPolygon2D, IlvIMapAttributes): Initializes a polygonal area with the specified IlvPolygon2D and attributes.


• New methods:
  • createTag(IlvPolygon2D, IlvIMapAttributes): Returns the tag corresponding to a polygonal map area.
  • getAttributes(): Returns the attributes of the area.
  • getShape(): Returns the shape of the area.

Utility Methods for Shapes

New Interfaces and Classes

ilog.views.util.java2d.IlvShapeUtil

The class IlvShapeUtil contains static methods that are useful when working with Java2D Shape objects.

ilog.views.util.java2d.IlvTranslatedShape

This class is a translation of a given shape by a given translation vector.

ilog.views.util.java2d.IlvPolygon2D

An IlvPolygon2D instance describes a closed (circular) polyline with no specific starting or end points, in other words, a polygon.

Use of Generic types

Avoiding Memory Leaks

Modified Classes

ilog.views.chart.data.IlvCombinedDataSet

• New methods:
  • dispose(): Cleans up this data set and drops references to objects to help garbage collection.

ilog.views.chart.data.lod.IlvDataTileController

• New methods:
  • dispose(): Stops the load-on-demand mechanism.

Improved Web Deployment Options

• Along with JSP pages, JViews 8.5 also supports Facelets (1.1.14).
• Updated JSF support with migration for the reference implementation 1.1 and 1.2, and support for alternate implementations such as Apache MyFaces (1.2.3).
• New support of leading PPR frameworks such as ICEsoft ICEfaces (1.7.2), Apache Trinidad (1.2.8), and JBoss RichFaces (3.2.1) JSF component libraries.
• New support of ICEsoft ICEfaces server push.
• Updated support for JSR168 portals such as Apache Pluto (1.1.4) and LifeRay (5.1).

Improved Applet Integration

Modified Classes

ilog.views.util.IlvResourceUtil

• New methods:
  • isInApplet(): Tests whether we are running inside an applet.

Improved Eclipse/RCP integration

New Interfaces and Classes

ilog.views.util.event.ClassLoaderLifetimeEvent

This class describes a turning point in the lifetime of a ClassLoader.

ilog.views.util.event.ClassLoaderLifetimeListener

This interface allows to react on turning points of class loaders.

Modified Classes

ilog.views.util.IlvClassLoaderUtil

• New methods:
  • registerClassLoaderLifetimeListener(ClassLoader, ClassLoaderLifetimeListener): Registers a ClassLoaderLifetimeListener to be invoked when the given ClassLoader stops being actively used.
  • unregisterClassLoaderLifetimeListener(ClassLoader, ClassLoaderLifetimeListener): Unregisters a ClassLoaderLifetimeListener from being associated with a given ClassLoader.
  • unregisterClassLoaderLifetimeListeners(ClassLoader): Unregisters all ClassLoaderLifetimeListeners associated with a given ClassLoader.

Improved SWT integration

New Interfaces and Classes

ilog.views.util.swt.IlvAWTEventFilter

This interface specifies a filter that allows to ignore some events on the AWT side, knowing that the SWT side of the GUI will handle them.

Modified Classes

ilog.views.util.swt.IlvEventThreadUtil

• New methods:
  • getAWTEventFilter(): Returns the currently active AWT event filter.
  • setAWTEventFilter(IlvAWTEventFilter): Specifies the AWT event filter.

Other Changes in Charts Classes

Modified Classes

ilog.views.chart.IlvLegendLayout

• New methods:
  • clearCaches(): Clears the caches of the layout delegates.

ilog.views.chart.IlvChartRenderer

• New methods:
  • toDisplay(IlvDoublePoints, IlvChartProjector, Rectangle, IlvCoordinateSystem): Projects points using this renderer coordinate system and projector area.

ilog.views.chart.renderer.IlvSingleChartRenderer

• New methods:
  • toDisplay(IlvDoublePoints, IlvChartProjector, Rectangle, IlvCoordinateSystem): Projects points using this renderer coordinate system and projector area.

ilog.views.chart.renderer.IlvTreemapChartRenderer

• New methods:
  • toDisplay(IlvDoublePoints, IlvChartProjector, Rectangle, IlvCoordinateSystem): Projects points using this renderer coordinate system and projector area.

Other Changes in DHTML JavaServer Faces Components

New Interfaces and Classes

ilog.views.chart.faces.dhtml.component.IlvChartFacesContextualMenu

This class defines a base class for DHTML component that displays a contextual menu for a chart.

Modified Classes

ilog.views.faces.IlvFacesUtil

• New methods:
  • isAdfPartial(FacesContext): Returns whether the current request is a PPR request in an ADF context.
  • isPartialRequest(FacesContext): Returns whether the current request is a PPR request or a regular one (full page refresh).

ilog.views.faces.component.IlvFacesContextualMenu

• New methods:
  • broadcast(FacesEvent): Overrides the implementation of the super class.

ilog.views.faces.dhtml.IlvDHTMLConstants

• New fields:
  • PARTIAL_SUBMIT: The partial submit property determines if an object select interactor subclass should partially submit its enclosing form on the selection event.

ilog.views.faces.dhtml.interactor.IlvFacesObjectSelectInteractor

• New methods:
  • getDefaultObjectSelectedFinder(): Overrides the implementation of the super class.

ilog.views.faces.dhtml.interactor.IlvFacesObjectSelectRectInteractor

• New methods:
  • getDefaultObjectSelectedFinder(): Overrides the implementation of the super class.

ilog.views.faces.dhtml.interactor.IlvObjectSelectInteractor

• New methods:
  • broadcast(FacesEvent): Overrides the implementation of the super class.
  • getDefaultObjectSelectedFinder(): Return the default IlvObjectSelectedFinder instance if no specified instance is provided.
  • isPartialSubmit(): Returns the partial submit mode.
  • setPartialSubmit(boolean): Sets the partial submit mode.


• New fields:
  • PARTIAL_SUBMIT_DEFAULT_VALUE: Default value of partialSubmit property

ilog.views.faces.dhtml.renderkit.IlvFacesContextualMenuRenderer

• New methods:
  • configureObjectFinder(UIComponent, IlvObjectSelectedFinder): Configures the default object finder instance.

ilog.views.faces.dhtml.taglib.IlvObjectSelectInteractorTag

• New methods:
  • getPartialSubmit(): Returns the partialSubmit mode.
  • setPartialSubmit(String): Sets the partialSubmit mode.

ilog.views.faces.taglib.IlvBaseTag

• New methods:
  • getPartialTriggers(): Returns the space separated list of partial trigger IDs.
  • setPartialTriggers(String): Sets the space separated list of partial trigger IDs.
  • getStringArray(String): Decodes the specified space separated list of strings.

ilog.views.faces.taglib.IlvMenuTag

• New methods:
  • getPartialSubmit(): Returns the partialSubmit property.
  • setPartialSubmit(String): Sets the partialSubmit property.

Other Changes in Utility Classes

New Interfaces and Classes

ilog.views.util.java2d.IlvMultipleGradientPaintConstants

Constants for gradient paints.

Modified Classes

ilog.views.util.collections.IlvCollections

• New methods:
  • concurrentModificationException(String, Throwable): Returns a concurrent modification exception that has a cause.

ilog.views.util.collections.IlvUnsynchronizedStack

• New methods:
  • clone(): Returns a shallow copy of this IlvUnsynchronizedStack instance.

ilog.views.util.data.IlvTableModelMappingException

• New constructors:
  • IlvTableModelMappingException(String, Throwable): Builds an IlvTableModelMappingException
  • IlvTableModelMappingException(String, String, Throwable): Builds an IlvTableModelMappingException

ilog.views.util.java2d.IlvLinearGradientPaint

• New constructors:
  • IlvLinearGradientPaint(IlvLinearGradientPaint): Creates a linear gradient paint by copying an existing one.

ilog.views.util.java2d.IlvMultipleGradientPaint

• New constructors:
  • IlvMultipleGradientPaint(IlvMultipleGradientPaint): Creates a multiple gradient paint by copying an existing one.

ilog.views.util.java2d.IlvRadialGradientPaint

• New constructors:
  • IlvRadialGradientPaint(IlvRadialGradientPaint): Creates a radial gradient paint by copying an existing one.

ilog.views.util.print.IlvPage

• New methods:
  • printObjects(Graphics, PageFormat, int): Prints the objects that have been added to this page.
  • printTemplate(Graphics, PageFormat, int): Prints the template page of the document.

ilog.views.util.print.IlvPrintingController

• New methods:
  • cleanPrintPreview(boolean): Cleans the Print Preview dialog box.

ilog.views.util.styling.IlvCSSFunction

• New methods:
  • getDependencies(String[]): Returns the dependencies of this function.


• New fields:
  • ANY: This placeholder can be used in dependencies sets, and can be returned from the getDependencies() method, indicating anything: all possible properties, all possible pseudoclasses, and even influenced from outside (such as state contained in the closure, or random numbers).
  • ANY_PROPERTIES: This placeholder can be used in dependencies sets, and can be returned from the getDependencies() method, indicating all possible model properties.
  • ANY_PSEUDOCLASSES: This placeholder can be used in dependencies sets, and can be returned from the getDependencies() method, indicating all possible pseudoclasses.

ilog.views.util.swing.IlvSwingUtil

• New methods:
  • invokeLater(List): Executes the given list of tasks by sequentially posting them to the current AWT/Swing event thread.

ilog.views.util.swing.calendar.IlvJTimeChooser

• New methods:
  • actionPerformed(ActionEvent): Notifies listeners when an action occurs in this component.

ilog.views.util.swing.layout.IlvVerticalFlowLayout

• New constructors:
  • IlvVerticalFlowLayout(int, int, int, boolean): Constructs a new IlvVerticalFlowLayout object.

ilog.views.util.swing.tree.IlvDefaultTreeCellRenderer

• New methods:
  • getPreferredSize(): Returns the preferred size of the renderer.

ilog.views.util.time.IlvTimeIterator

• Methods with changed return type::
  • next(): Returns the next Date in the iteration.

Example Changes

• A new Eclipse sample ilog.views.eclipse.chart.examples.model has been added. It shows how to display data contained in an EMF/Ecore model in a JViews chart, by making use of the Eclipse model-to-model transformation facilities.
• A new JSF code sample jsf-chart-facelets shows how to use a JViews chart in a Facelets context.
• A new JSF code sample jsf-chart-ice shows how to integrate JViews Charts with ICEfaces.