JViews Charts Release Notes

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

Incompatibilities
New Rich Web Charts Component
New Treemap Chart
Customizer Components
DHTML JavaServer Faces Popup Menus
DHTML JavaServer Faces Select Interactor
Tag Library Changes
Portable SWT Support
PDF Generation
NaN Value
Multithreading in a Server
CSS Pseudo-Classes per Chart
Interactor Event Handling
Interactor Event Masks
Millisecond Time Unit
Logarithmic Axis Improvement
Customization of 3D Views
Other Improvements in the Data Source Classes
Other Improvements in the DHTML JavaServer Faces Components
Internationalization
Other Changes in Charts Classes
Other Changes in Utility Classes
Example Changes

Incompatibilities

Library

• Data sets can now contain NaN values. Therefore, when testing a data set for an undefined value, it was sufficient to compare a value against getUndefValue(); now you have to compare it against getUndefValue() and test it with isNaN().
• The role of the inner class IlvSwingTableDataSource.Mapping has been taken over by the new inner class of its superclass, IlvAbstractTableDataSource.Mapping.
• Classes that extend the IlvIMapDefinition abstract class must now also implement the added getAttributes(IlvTreeListModel, TreePath) method.
• Classes that extend the IlvChartServletSupport class must be updated: in the class IlvChartServletSupport, the methods generateImage and generateImageMT have been renamed to generateImageAWT and generateImageCT, respectively, and now take additional arguments.

JavaServer Faces

• For better flexibility the interactor property of the IlvChartView component is now of the IlvFacesInteractor interface type instead of the IlvInteractor class type.

New Rich Web Charts Component

Two Rich Web Charts samples have been added, a Dashboard and a Stock viewer.

For more details, refer to Building Web Applications documentation.

New Packages

This is the base package of the Rich Web Charts component that renders as SVG on a Web Client.

This is the package containing the JSF UI Component for the Rich Web Charts.

This is the package containing the JSF events for the Rich Web Charts.

New Treemap Chart

New Packages

Provides extended data models and bridges from/to Swing models.

Provides predefined bridges between data models. Features filtering, sorting and partitioning.

Provides predefined connectors to object property mechanisms.

Provides interfaces and algorithms for partitioning of data models.

Provides interfaces and algorithms for sorting of data models.

New Interfaces and Classes

This class encapsulates a tree-table or table-like model in an IlvDataSource.

Describes changes made to an IlvTreeTableDataSource object.

Defines the interface for objects that listen to changes in an ilog.views.chart.data.IlvTreeTableDataSource.

A data source that displays elements of a table.

The IlvSimpleChartRenderer is the base class for all atomic renderers of the entire data source.

A renderer displaying treemap charts.

This class represents a legend associated with a color, as displayed by this renderer.

Represents a display area that corresponds to a projected data point.

Represents a display area that corresponds to a model object.

An interactor that provides a kind of "drill down" for a treemap.

Describes changes related to the focus of a treemap renderer.

Defines the interface for listening to changes of the focus of a treemap.

This class describes how to arrange rectangles in a treemap.

This class describes how to arrange rectangles in a treemap.

This class contains information about the area that should be assigned to a tree node during the treemap packing algorithm.

This abstract class denotes a color scheme.

This abstract class denotes a color scheme which chooses the color as a function of a continuous real value.

This class denotes a color scheme which provides a model-independent color distribution for the interval [0,1] and maps the range of values to this interval through a simple linear mapping.

An instance of this interface maps a value from a given interval onto the interval [0,1].

An instance of this interface associates a color with every number in a given range.

An instance of this interface associates a color with every object among a given finite set of objects.

Modified Classes

• New methods:
  • addPseudoClass(Object, String): Adds a pseudo-class to the specified model object.
  • addTreemapFocusListener(TreemapFocusListener): Adds a new treemap focus listener.
  • setPseudoClasses(Object, String[]): Sets the pseudo-classes of the specified model object.
  • getPseudoClasses(Object): Returns the pseudo-classes of the specified model object.
  • removePseudoClass(Object, String): Removes a pseudo-class from the specified model object.
  • removeTreemapFocusListener(TreemapFocusListener): Removes l from the renderer listeners.
• New fields:
  • TREEMAP: The type for a TREEMAP chart.

• New methods:
  • fireTreemapFocusEvent(TreemapFocusEvent): Fires a treemap focus change event to the registered listeners.
  • getDefaultLegendTitle(): Returns the default legend title.
• New fields:
  • TREEMAP: Treemap chart renderer type.

• New methods:
  • getAttributes(IlvTreeListModel, TreePath): Returns the area attributes for the specified tree model element.

• New methods:
  • getAttributes(IlvTreeListModel, TreePath): Returns the area attributes for the specified tree model element.
  • setTreeNodeAttributes(Map): Sets the tree node attributes for this area definition.

New Examples

• A Swing-based sample: treemap,
• A servlet based thin-client sample: servlet-chart-treemap,
• A JavaServer Faces based thin-client sample: jsf-chart-treemap.

Customizer Components

New Packages

This package provides the base class of the checked exceptions that can be thrown when using customizers.

This package contains the customizer mechanism that allows you to customize the appearance of a JViews Chart component.

This package contains the base class of component CSS adapters, and the rule customizer interface.

Contains classes related to component styling.

DHTML JavaServer Faces Popup Menus

New Interfaces and Classes

This class defines a popup menu support for the JSF chart.

This servlet action handles the action triggered by a popup menu component in IMAGE_SERVLET_CONTEXT.

This class is the chart DHTML renderer for a IlvFacesContextualMenu component.
This renderer generates an instance of the IlvFacesChartContextualMenuProxy JavaScript proxy class.

The contextual menu is a menu which is attached to a view (its parent) and that can display a menu generated from the object clicked on this view.

This class defines a menu whose parent is a view or another menu.

A view action event triggered by a menu component.

This listener is the default listener of a ilog.views.faces.component.IlvFacesMenu.

This class is the renderer for a ilog.views.faces.component.IlvFacesContextualMenu component.
This renderer generates an instance of the IlvPopupMenuProxy JavaScript proxy class.

This class is the DHTML renderer for a IlvFacesContextualMenu component.
This renderer generates an instance of the IlvFacesContextualMenuProxy JavaScript proxy class.

This class is the base renderer class of JViews Faces DHTML components that represents a menu.

This class defines the popup servlet support for the JSF graphic framework.

This class defines an action listener triggered by a menu in IMAGE_SERVLET_CONTEXT.

This class is the chart specific servlet support for dynamic popup menu requests from the client.

This action must be registered on the chart servlet support in order to support the popup menus.
Its purpose is translate to the IlvChartServerActionEvent into a ServletActionEvent used in the popup menu model and to delegate the processing of this event to the selected menu item action listener.

This abstract class defines a servlet support used to handle dynamic popup menu request requests.

This class defines an encoder of an IlvMenu.

This class is responsible for encoding an IlvMenu into a code comprehensible to the client and to write it into the selected writer.

This interface defines a factory that generates IlvMenus depending on:

• The graphic component that renders the image.
• The object selected by the use when he triggered the menu.
• The menu model ID sent by the client.

An implementation of a menu that contains menu items.

This class defines a menu item that should be contained by an IlvMenu.

This class represents a divider between menu items in a menu.

Modified Classes

• Overview of new features:
  • Management of popup menu queries.
• New methods:
  • createPopupMenuSupport(): Creates a new instance of popup menu servlet support.
  • getPopupMenuSupport(): Returns the popup menu servlet support that manage popup menu requests.
  • isPopupEnabled(): Returns true if the servlet is set to handle popup menu requests.
  • setPopupEnabled(boolean): Sets whether this support can handle popup menu requests.

• Overview of new features:
  • This class now handles the popup menu requests.
• New methods:
  • getMenuFactory(HttpServletRequest, HttpServletResponse): Retrieves or creates the menu factory used in this popup menu request.

DHTML JavaServer Faces Select Interactor

New Interfaces and Classes

This class defines an interactor that contains the ilog.views.chart.data.IlvDataSetPoint selected by the user in its value property.

This class is responsible for finding the data set point picked on the view.

This class is the renderer for an IlvChartSelectInteractor component.
This renderer generates an instance of the IlvChartSelectInteractorProxy JavaScript proxy class.

This chart server action is executed out of the JSF lifecycle, in the image generating servlet.
Its purpose is to translate this action event into a JSF valueChangeEvent and to invoke the value change listener passed as parameter with this translated event.

This is the base class for interactors. It can be used to select one or several objects on a view and to move the current selection.

This class is a base renderer for a IlvFacesSelectInteractor component.

This server action is executed out of the JSF lifecycle, in the image generating servlet.
Its purpose is to translate this action event into a JSF valueChangeEvent and to invoke the value change listener passed as parameter with this translated event.

This server action is executed out of the JSF lifecycle, in the image generating servlet.
Its purpose is to translate this action event into a JSF valueChangeEvent and to invoke the value change listener passed as parameter with this translated event.

This class describes a servlet support for selection requests.

Modified Classes

• Overview of new features:
  • This class now handles the select interactor.
• New methods:
  • addSelectAction(): Adds the server action that invokes the select interactor's value change listener.

Tag Library Changes

• A Rich Web Charts tag library has been added.
• The JViews Charts JavaServer Faces tag library has been updated:
  • The chartContextualMenu tag has been added. It defines a static or a contextual popup menu on the chart view.
  • The chartSelectInteractor tag has been added. It allows you to pick a data point. This interactor should be preferred to the chartPickInteractor which is now deprecated.
  • Several new attributes chartView tag have been added:
    • data specifies the data to display: Designer for JViews Charts project, XML file, IlvDataSource instance or a data source component ID.
    • imageMapGenerator specifies the generator that will generate the image map areas on the chart view.
    • imageMapGeneratorClass specifies the generator fully qualified class name that will generate the image map areas on the chart view.
    • keepVisibleWindow specifies whether the visible window should be reused by the client when a new JSF request occurs.

New Interfaces and Classes

This class defines the JSP custom tag handler for the IlvFacesContextualMenu component and its DHTML renderer for the Charts product.

This class defines the JSP custom tag handler for the IlvChartSelectInteractor component and its DHTML renderer.

This class defines the JSP custom tag handler for the IlvFacesContextualMenu component and its DHTML renderer for graphic framework.

This class defines a base JSP custom tag handler for a ilog.views.faces.dhtml.interactor.IlvFacesSelectInteractor component.

This class defines the JSP custom tag handler for the IlvFacesContextualPopupMenu component and its DHTML renderer.

This JSP custom tag handler manages menu item tag instances.

This JSP custom tag handler manages menu separator tag instances.

This JSP custom tag handler manages menu item tag instances.

This abstract class is the base custom tag handler class of styled menu components.

Portable SWT Support

Furthermore, the class IlvEventThreadUtil is also provided to solve multithreading problems usually occurring in mixed SWT/Swing applications.

New Interfaces and Classes

Embeds a Swing JComponent in an SWT Control with double-buffered drawing.

This class contains utility functions for dealing with the SWT and AWT/Swing event threads in an SWT environment.

This class contains a registry for java.awt.Cursor shapes.

Modified Classes

• Overview of new features:
  • Added a few methods needed for interactors that run on Swing components embedded in SWT windows.
• New methods:
  • convertPoint(Component, Point, Component): Converts a aPoint in source coordinate system to destination coordinate system.
  • convertPointFromScreen(Point, Component): Converts a point from screen coordinates to a component coordinate system.
  • convertPointToScreen(Point, Component): Converts a point from component coordinate system to screen coordinates.
  • convertRectangle(Component, Rectangle, Component): Converts the rectangle aRectangle in source coordinate system to destination coordinate system.
  • getLocationOnScreen(Component): Returns the screen coordinates of a component.
  • invokeNowOrLater(Runnable): Executes the given task in the current AWT/Swing event thread, if not already executing in this thread.
  • isDispatchThread(): Returns true if the calling thread is the current AWT/Swing event dispatch thread.

PDF Generation

New Interfaces and Classes

This class contains utility functions for converting graphic components to XSL-FO.

Modified Classes

• New methods:
  • paintToFO(Document, boolean): Generates an XSL-FO element representing this chart.
  • paintToFOCurrentThread(Document, boolean, Color): Generates an XSL-FO element representing this chart.

Modified Examples

NaN Value

Multithreading in a Server

Methods that draw a chart entirely in the caller thread have now been added.

An IlvPrintableChart can now be printed entirely in the caller thread.

Methods have been added that produce a PNG image with given size of a chart entirely in the caller thread.

Modified Classes

• New methods:
  • isUsingEventThread(): Determines whether this component may transfer updates to the AWT-Event thread.
  • setUsingEventThread(boolean): Sets whether this component may be visible from an AWT/Swing GUI.
  • paintCurrentThread(Graphics2D, Color): Draws the contents of this chart entirely in the caller thread.
  • printCurrentThread(Graphics, IlvChartPrintContext): Prints this chart according to the specified printing context.
  • toPNG(OutputStream, int, int, boolean): Dumps the chart as a PNG stream.
  • toPNG(OutputStream, int, int): Dumps this chart as a PNG stream.

• New methods:
  • paintCurrentThread(Graphics2D, Color): Draws the contents of this chart area entirely in the caller thread.

• New methods:
  • generateImageAWT(IlvServletRequestParameters, IlvChart, String, int, int): Generates the requested image.
  • generateImageCT(IlvServletRequestParameters, IlvChart, String, int, int): Generates the requested image.

CSS Pseudo-Classes per Chart

Modified Classes

• New methods:
  • addPseudoClass(IlvDataSet, String): Adds a pseudo-class to the specified data set in the context of this chart.
  • addPseudoClass(IlvDataSet, int, String): Adds a pseudo-class to the specified data point in the context of this chart.
  • clearAllPseudoClasses(): Removes all pseudo-classes from all data sets, all data points and all objects.
  • clearPseudoClass(String): Removes a pseudo-class from all data sets, all data points and all objects.
  • getPseudoClasses(IlvDataSet): Returns the pseudo-classes of the specified data set in the context of this chart.
  • setPseudoClasses(IlvDataSet, int, String[]): Sets the pseudo-classes of the specified data point in the context of this chart.
  • setPseudoClasses(IlvDataSet, String[]): Sets the pseudo-classes of the specified data set in the context of this chart.
  • getPseudoClasses(IlvDataSet, int): Returns the pseudo-classes of the specified data point in the context of this chart.
  • removePseudoClass(IlvDataSet, String): Removes a pseudo-class from the specified data set in the context of this chart.
  • removePseudoClass(IlvDataSet, int, String): Removes a pseudo-class from the specified data point in the context of this chart.

Interactor Event Handling

Modified Classes

• New methods:
  • isConsumeEvents(): Returns true if this interactor consumes the events that it has recognized.
  • setConsumeEvents(): Determines whether this interactor should consume the events that it has recognized.

Interactor Event Masks

Modified Classes

• New methods:
  • getEventMaskEx(): Returns the action event mask, according to the conventions of java.awt.event.InputEvent.getModifiersEx().

• New methods:
  • getAngleEventMaskEx(): Returns the event mask used for rotating the view, according to the conventions of java.awt.event.InputEvent.getModifiersEx().
  • getZoomEventMaskEx(): Returns the event mask used for zooming the view, according to the conventions of java.awt.event.InputEvent.getModifiersEx().

• New methods:
  • getZoomInEventMaskEx(): Returns the zoom in event mask, according to the conventions of java.awt.event.InputEvent.getModifiersEx().
  • getZoomOutEventMaskEx(): Returns the zoom out event mask, according to the conventions of java.awt.event.InputEvent.getModifiersEx().

Millisecond Time Unit

Modified Classes

• New fields:
  • MILLISECOND: Predefined unit for milliseconds.

Logarithmic Axis Improvement

Modified Classes

• New methods:
  • isRoundingToPowers(): Returns true if this transformation attempts to produce intervals that start and end at powers of the logarithmic base.
  • setRoundingToPowers(boolean): Determines whether this transformation shall attempt to produce intervals that start and end at powers of the logarithmic base.

Customization of 3D Views

Modified Classes

• New methods:
  • isZAnnotationColorVarying(): Returns true if the text annotations along the depth axis take the color of the corresponding data series.
  • setZAnnotationColorVarying(boolean): Specifies whether the text annotations along the depth axis take the color of the corresponding data series, or whether they are all of the same color.

Other Improvements in the Data Source Classes

New Interfaces and Classes

This is the base class for data sets that encapsulate other data sets.

Modified Classes

• New methods:
  • getDataSetByName(String): Returns the data set with the given name, of null if there is none.

• New methods:
  • setDataLabel(int, String): Sets a data point label.

Other Improvements in the DHTML JavaServer Faces Components

The interactor invocation context property allows interactor action to be executed in JSF lifecycle context or in the image servlet context.

New Interfaces and Classes

This class is a default implementation of IlvFacesChartImageGenerator.

This interface defines an image map generator.

This exception is thrown when some unauthorized code is executed on a JSF component out of the JSF lifecycle.

This subclass of HtmlCommandButton overrides the getType() method to force the client-side HTML button to be of type "button". This avoids the button to automatically submit the HTML form when it is pressed.

An action listener that wraps a method binding.

The JSF action event for views events.

This class defines the base JSF listener for event on view components.

This interface defines a listener of a generic EventObject event.

The JavaScript action listener is a special listener that will be executed on the client only.

The ServletActionEvent is fired by the servlet support when a client side action involving a graphic component and an object is triggered.

This class defines a server side action listener.

Modified Classes

• Overview of new features:
  • The keepVisibleWindow property specifies whether the visible window should be reused by the client when a new JSF request occurs.
• New methods:
  • isKeepVisibleWindow(): Returns whether the current visible window has to be kept between two JSF requests.
  • setKeepVisibleWindow(boolean): Sets whether the current visible window has to be kept between two JSF requests.

• Overview of new features:
  • The imageMapGenerator property specifies the generation of the image map areas without having to subclass the image servlet support.
• New methods:
  • getImageMapGenerator(): Returns the image map generator.
  • setImageMapGenerator(IlvFacesChartImageMapGenerator): Returns the image map generator.
  • getImageMapGeneratorClass(): Returns the class name of the image map generator.
  • setImageMapGeneratorClass(String): Sets the class name of the image map generator.

Internationalization

Conversion from a string to a number can be made locale dependent.

Modified Classes

• New methods:
  • getInteractorClassByName(String): Returns the interactor class associated with a given short name.
  • getLocalizedName(Class, Locale): Returns the localized name of an interactor class in a given locale.

• New constructors:
  • IlvStringConverter(Locale): Creates a new IlvStringConverter object that performs a conversion using the conventions for the given locale.

• New methods:
  • getDataConverter(Class): Returns the converter of the given data class.
  • getLocale(): Returns the locale that is used by the converter for objects of type String.
  • setLocale(Locale): Sets the locale.

Other Changes in JViews Charts Classes

Modified Classes

• New methods:
  • dispose(): Cleans up this chart and drops references to objects to help garbage collection.
  • invalidateScales(): Invalidates the geometry cache of the scales of this chart.
  • updateScales(): Updates the geometry cache of the scales of this chart.
  • updateScalesIfNeeded(): Updates the geometry cache of the scales of this chart.

• New methods:
  • clone(): Returns a copy of this object.

• New methods:
  • dispose(): Cleans up this renderer and its children renderers, and drops references to objects to help garbage collection.
  • findAppropriateColor(Collection): Tries to find an appropriate color for the style used by this renderer.

• New methods:
  • paintLabel(JComponent, Color, Graphics, String, int, int): Paints the label at the given position.

• New methods:
  • computeBounds(Rectangle2D): Computes the entire bounds.
  • getBoundsUsingCache(Rectangle2D): Returns the bounds of this scale, without unnecessary recomputations.

• New methods:
  • adjustPosition(Point, Dimension, Rectangle): Adjusts the tooltip location so that it fits into the root component area.
  • getInfoTextDescriptionPart(IlvDisplayPoint): Returns the first part of the text to be displayed.
  • getInfoTextValuePart(IlvDisplayPoint): Returns the second part of the text to be displayed.

Other Changes in Utility Classes

New Interfaces and Classes

This class is a extendable array of double elements.

This class is a extendable array of float elements.

This class is an implementation of the java.util.List interface for ordered sets.

This is a helper class for creating immutable compound objects.

This is an abstract class that provides traversal over a generic tree structure of objects in postorder.

This class represents a last-in-first-out (LIFO) stack of objects.

This is the last resort for memory leak problems related to event listeners.

This class defines the event types used to indicate the notifications to be sent.

This interface describes a rule that selects some of the objects of a model and discards the other objects.

This class is an implementation of the IlvFilter interface which handles the notification to listeners of the filter.

This class describes a change of a filter.

This interface enables the observing of changes to an IlvFilter.

This class is a compatible replacement for the standard SimpleDateFormat class.

This class provides static factory methods that can be used to create date format instances.

This class defines a strategy for stepping through discrete time increments.

This class traverses over time increments that are defined by an IlvTimeIncrementPolicy.

This is an abstract implementation of the data model that provides bounded range components, such as JScrollBar, JSlider, and JProgressBar with their contents.

• New constructors:
  • IlvPreorderIterator(): Constructs a new IlvPreorderIterator without initializing it.
• New methods:
  • init(Object): Initializes the iterator to traverse the subtree of objects that descends from the specified root.

• New methods:
  • size(): Returns the number of listeners in this collection.

Modified Classes

• New methods:
  • getImportance(): Returns the importance of the function.
  • getShortDescription(): Returns a short description of the function.

• New methods:
  • showOptionDialog(Component, Object, String, int, int, Icon, Object[], Object, Component, HashMap): Brings up a dialog with a specified icon, where the initial choice is determined by the initialValue parameter and the number of choices is determined by the optionType parameter.
  • showYesNoCancelDialog(Component, Object, String, Icon): Brings up a confirmation dialog with the buttons 'YES', 'NO' and 'CANCEL'.
  • showYesNoDialog(Component, Object, String, Icon): Brings up a confirmation dialog with the buttons 'YES' and 'NO'.

• New methods:
  • initAvailableLocales(): This method allows you to initialize in advance, at a time point of your choice, the list of available locales needed by the method createLocaleComboBoxModel() and by the class LocaleComboBoxModel.
• New fields:
  • initAvailableLocales: Is true if the initAvailableLocales() method has been called.

• New methods:
  • elapsedDays(Calendar, Calendar): Returns the number of days that have elapsed from one calendar to another.
  • julianDay(GregorianCalendar): Returns the Julian day number of a date in the given GregorianCalendar.
  • julianDay(Calendar): Returns the Julian day number of a date in the given calendar.

Example Changes

• Two Rich Web Charts samples have been added, a Dashboard and a Stock viewer.
• Three treemap chart samples have been added:
  • A Swing-based sample: treemap,
  • A servlet based thin-client sample: servlet-chart-treemap,
  • A JavaServer Faces based thin-client sample: jsf-chart-treemap.
• The servlet-based thin-client samples have been renamed:
  • servlet-chart-basic
  • servlet-chart-imgmap
  • servlet-chart-jsp
• The tablemodel sample has been enhanced with controls that create a PDF document containing the chart.
• The stockswt sample has been removed. Look at the Eclipse sample instead.
• The code examples have been restructured to show one feature per code example.
• Some Rich Web Charts code examples have been added.
• The JavaServer Faces code examples had been redesigned.