JViews Charts 8.8 Release Notes

Release Notes

JViews Charts 8.8 Release Notes

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

Incompatibilities
General Changes
Globalization
Accessibility
Styling
Renderers
Hitmap Web Technology
Multiple Browser Sessions
Security I: Servlet Parameter Checking
Security II: Database Query Checking
Printing
PDF Generation
Other Changes in Charts Classes
Other API Changes in Web Technologies
Example Changes

Incompatibilities

New methods have been added to the abstract class ilog.views.chart.IlvChartRenderer: getRenderingHint, and drawSelectionHandles.
New methods have been added to the interface ilog.views.chart.renderer.IlvVariableWidthRenderer: isUseCategorySpacingAtBorders, and setUseCategorySpacingAtBorders.
New methods have been added to the interface ilog.views.chart.servlet.IlvChartHitmapDefinition: getAttributes, drawIntoHitmap, and createHitmapInfoGenerator.

General Changes

JViews Charts now offers:

Globalization:
- Advanced locale support: Not only the language and country, but also the script, calendar, collation, and number script can be specified, and are respected by JViews.
- Advanced bidi support: Everywhere where bidirectional text is displayed, the base text direction can be specified through API.
Accessibility:
- Keyboard navigation in a chart is supported and can be customized.
- Different styling for high-contrast mode can be specified in CSS, for rich client display.
- Documentation is provided that explains how to create accessible applications with JViews.
Web technologies:
- The Hitmap, one of the important JViews web technologies, has been improved and extended in this release. JViews web application developers can now extend and customize hitmap generation more easily to achieve more responsive interactions. Numerous demos or samples give tips on how to use hitmaps for some advanced interactions.
- Templates are available to format tooltips when moving the mouse pointer over graphic items. You can use the tooltip template to create a tooltip by using either HTML or JavaScript. This technique reduces network traffic and improves web application performance.
- You can use percentages to specify the width and the height of some JViews JSF View components.
- JViews web application accessibility improvements. Keyboard accessibility for JViews web applications enables you to interact with JViews image buttons, graphic elements, and more, by using a keyboard.
- JViews web application bidirectional text support enables you to use bidirectional text for your web applications.
- Improved event handling, on both server side and client side. JViews web application developers can now install client side or server side event listeners.
- Introduction of Page Identifier (ID) concept. It is now easier to design a web application so that the user can simultaneously open multiple instances of the same web application in a browser, each page preserving its own context.
- JViews web application security improvements. JViews web client server exchange protocols have been documented. A mechanism to validate an HTTP request sent to the server has been implemented and can be enabled if neccessary. It is now possible to check the parameters included in a request so that attacks on JViews web application servers can be easily rejected.

Globalization

Advanced locale support is achieved through the use of ICU ULocale.
New Interfaces and Classes

ilog.views.util.IlvULocaleAware

Interface to be implemented by classes that can store a locale.

Modified Classes

ilog.views.util.IlvLocaleUtil
- New methods:
  - getComponentULocale(Component): Returns the ULocale that is in effect for a given AWT or Swing component.
  - getCurrentULocale(): Returns the current locale as an ICU ULocale.
  - getServerULocale(): Returns the server locale.
  - getThreadULocale(): Returns the ICU ULocale that is currently assigned to the current thread, or null for none.
  - setThreadULocale(ULocale): Assigns the given ICU ULocale to the current thread.
  - initJComponentULocale(JComponent): Initializes the ULocale of a Swing component, in a way that is consistent with the initialization of the Locale of the same component during the JComponent constructor.
- New fields:
  - ULOCALE_PROPERTY: Property indicating the ULocale of a JComponent.
ilog.views.util.servlet.IlvServletLocaleUtil
- New methods:
  - getULocale(IlvServletLocaleUtil.LocaleContext, HttpServletRequest): Returns the ULocale in a different context.
ilog.views.chart.IlvChart
- New methods:
  - getULocale(): Returns the locale of this component.
  - setULocale(ULocale): Sets the locale of this component.
ilog.views.chart.graphic.IlvGraphicDecoration
- New methods:
  - getULocale(): Returns the locale of the chart to which this decoration belongs.
  - setULocale(ULocale): This method is implemented as part of the IlvULocaleAware interface. The implementation does nothing.
ilog.views.chart.data.IlvSwingTableDataSource
- New methods:
  - getULocale(): Returns the locale that is used by the converter for objects of type String.
  - setULocale(ULocale): Sets the locale.
ilog.views.chart.data.IlvTreeTableDataSource
- New methods:
  - getULocale(): Returns the locale used to sort cluster ids when getIdComparator() is null.
  - setULocale(ULocale): Changes the locale used to sort cluster ids when getIdComparator() is null.
ilog.views.chart.data.IlvStringConverter
- New constructors:
  - IlvStringConverter(ULocale): Creates a new IlvStringConverter object that performs a conversion using the conventions for the given locale.
ilog.views.util.convert.IlvConvert
- New methods:
  - convert(Object, Class, ULocale): Converts the type of a value to a new type.
ilog.views.util.convert.IlvLocalizedConverter
- New methods:
  - convert(Object, Class, ULocale): Converts the specified value to the given type.
ilog.views.util.convert.IlvLocalizedPropertyEditorFactory
- New methods:
  - getPropertyEditor(ULocale): Returns a property editor for the given locale.
ilog.views.util.print.IlvHeaderFooter
- New constructors:
  - IlvHeaderFooter(String, String, String, ULocale): Creates a header or a footer.
ilog.views.util.print.IlvHeader
- New constructors:
  - IlvHeader(String, String, String, ULocale): Creates a header.
ilog.views.util.print.IlvFooter
- New constructors:
  - IlvFooter(String, String, String, ULocale): Creates a footer.
ilog.views.chart.print.IlvChartDocumentSetupDialog
- New methods:
  - getULocale(): Returns the locale that is used for formatting numbers and dates.
ilog.views.util.print.IlvDocumentSetupDialog
- New methods:
  - getULocale(): Returns the locale that is used for formatting numbers and dates.
ilog.views.util.swing.table.IlvDefaultTableCellRenderer
- New methods:
  - getULocale(): Returns the locale to be used for this object.
  - setULocale(ULocale): Sets the locale to be used for this object.
ilog.views.util.swing.IlvSwingUtil
- New methods:
  - setDefaultULocale(ULocale): Sets the default locale used to initialize each JComponent's locale property upon creation.
Sorting respects the collation of the locale.
New Interfaces and Classes

ilog.views.chart.datax.adapter.partition.IlvDefaultClusterIdComparator

This class is the default comparator for IlvClusterId objects.
Number formatting respects the locale, including the number script specified in the locale.
New Interfaces and Classes

ilog.views.util.text.IlvNumberFormatFactory

This class provides NumberFormat objects for specified locales.

Modified Classes

ilog.views.chart.IlvStepsDefinition
- New methods:
  - getLocale(): Returns the current locale.
  - getULocale(): Returns the current locale.
  - localeChanged(): This method is invoked when the current locale has changed.
ilog.views.chart.IlvTimeUnit
- New methods:
  - format(DateFormat, Calendar, Locale): Returns the label corresponding to the specified time.
  - getFormatString(Locale): Returns a string pattern used by the IlvTimeStepsDefinition class.
ilog.views.chart.IlvMultipleTimeUnit
- New methods:
  - getFormatString(Locale): Returns a string pattern used by the IlvTimeStepsDefinition class to create a java.util.SimpleDateFormat object.
Date formatting respects the locale, including the calendar and the number script specified in the locale.
New Interfaces and Classes

ilog.views.util.time.IlvCalendarFactory

This class provides Calendar objects for specified locales.

Modified Classes

ilog.views.util.text.IlvDateFormat
- New constructors:
  - IlvDateFormat(ULocale): Creates a default date and time formatter that uses the SHORT style for both the date and the time in the given locale and the default timezone.
  - IlvDateFormat(String, ULocale, TimeZone): Creates a date and time formatter using the specified pattern for the given locale and timezone.
  - IlvDateFormat(int, int, ULocale, TimeZone): Returns a formatter with the given date and time styles for the given locale and timezone.
- New methods:
  - getULocale(): Returns the locale.
  - registerPreferenceForICU(String): Registers a preference for ICU based formatting instead of JRE based formatting for the given language.
ilog.views.util.text.IlvDateFormatFactory
- New methods:
  - getDateInstance(int, ULocale): Returns a date formatter with the given DateFormat style for the given locale.
  - getDateTimeInstance(int, int, ULocale): Returns a date and time formatter with the given date and time DateFormat styles for the given locale, in the default timezone.
  - getDateTimeInstance(int, int, ULocale, TimeZone): Returns a date and time formatter with the given date and time DateFormat styles for the given locale and timezone.
  - getInstance(ULocale): Returns a default date and time formatter that uses the DateFormat.SHORT style for both the date and the time in the given locale and default timezone.
  - getInstance(String, ULocale, TimeZone): Returns a date and time formatter instance by using the specified pattern for the given locale and timezone.
  - getTimeInstance(int, ULocale): Returns a time formatter with the given time DateFormat style for the given locale, in the default timezone.
  - getTimeInstance(int, ULocale, TimeZone): Returns a time formatter with the given time DateFormat style for the given locale and timezone.
ilog.views.util.time.IlvCalendarUtil
- New methods:
  - dayFloor(Calendar): Truncates the given Calendar downwards to the nearest day boundary.
  - halfDayFloor(Calendar): Truncates the given Calendar downwards to the nearest half-day or AM-PM boundary.
  - hourFloor(Calendar): Truncates the given Calendar downwards to the nearest hour boundary.
  - minuteFloor(Calendar): Truncates the given Calendar downwards to the nearest minute boundary.
  - monthFloor(Calendar): Truncates the given Calendar downwards to the nearest month boundary.
  - secondFloor(Calendar): Truncates the given Calendar downwards to the nearest second boundary.
  - weekFloor(Calendar): Truncates the given Calendar downwards to the nearest week boundary.
  - yearFloor(Calendar): Truncates the given Calendar downwards to the nearest year boundary.
ilog.views.chart.datax.adapter.partition.IlvDateClusterId
- New constructors:
  - IlvDateClusterId(IlvObjectModelWithColumns, IlvDataColumnInfo, int, int, ULocale): Creates an instance of this class.
ilog.views.chart.datax.adapter.partition.IlvDatePartitioner
- New constructors:
  - IlvDatePartitioner(IlvObjectModelWithColumns, IlvDataColumnInfo, int[], ULocale): Creates an instance of this class.
  - IlvDatePartitioner(IlvObjectModelWithColumns, IlvDataColumnInfo, int[], ULocale, Calendar): Creates an instance of this class.
ilog.views.chart.datax.adapter.partition.IlvDatePartitionerFactory
- New constructors:
  - IlvDatePartitionerFactory(IlvDataColumnInfo, int[], ULocale): Creates an instance of this class.
  - IlvDatePartitionerFactory(IlvDataColumnInfo, int[], ULocale, Calendar): Creates an instance of this class.
Where text can be displayed, the base text direction can be specified. It has an influence on the order of text segments in the display of a text string or paragraph.
New Interfaces and Classes

ilog.views.util.text.IlvBaseTextDirectionInterface

An interface to be implemented by objects that provide base text direction control.

ilog.views.util.IlvComponentOrientationAware

Interface to be implemented by classes that can store a component orientation.

ilog.views.util.text.IlvBidiUtil

The IlvBidiUtil class consists of static definitions and methods that are of general use when working with bidirectional text.

Modified Classes

ilog.views.chart.IlvChart
- New methods:
  - baseTextDirectionChanged(): This method is invoked when the effective base text direction has changed.
  - componentOrientationChanged(ComponentOrientation, ComponentOrientation): This method is invoked when the component orientation of this chart has changed.
  - getBaseTextDirection(): Returns the base text direction for this chart.
  - setBaseTextDirection(int): Sets the base text direction for this chart.
  - getResolvedBaseTextDirection(): Returns the resolved base text direction.
  - setComponentOrientation(ComponentOrientation): Sets the component orientation of this chart.
ilog.views.chart.IlvLegend
- New methods:
  - baseTextDirectionChanged(): This method is invoked when the effective base text direction has changed.
  - componentOrientationChanged(ComponentOrientation, ComponentOrientation): This method is invoked when the component orientation of this legend has changed.
  - getBaseTextDirection(): Returns the base text direction for this legend.
  - setBaseTextDirection(int): Sets the base text direction for this legend.
  - getResolvedBaseTextDirection(): Returns the resolved base text direction.
  - setComponentOrientation(ComponentOrientation): Sets the component orientation of this legend.
ilog.views.chart.IlvLegendItem
- New methods:
  - baseTextDirectionChanged(): This method is invoked when the effective base text direction has changed.
  - componentOrientationChanged(ComponentOrientation, ComponentOrientation): This method is invoked when the component orientation of this legend item has changed.
  - getResolvedBaseTextDirection(): Returns the resolved base text direction.
  - setComponentOrientation(ComponentOrientation): Sets the component orientation of this legend item.
ilog.views.chart.IlvScale
- New methods:
  - baseTextDirectionChanged(): This method is invoked when the effective base text direction has changed.
  - componentOrientationChanged(ComponentOrientation, ComponentOrientation): This method is invoked when the component orientation of the chart that displays this scale has changed.
  - getComponentOrientation(): Returns the component orientation of the chart that displays this scale.
  - getResolvedBaseTextDirection(): Returns the resolved base text direction.
ilog.views.chart.IlvChartDecoration
- New methods:
  - baseTextDirectionChanged(): This method is invoked when the effective base text direction of the chart has changed.
  - componentOrientationChanged(ComponentOrientation, ComponentOrientation): This method is invoked when the component orientation of the chart has changed.
ilog.views.chart.graphic.IlvGraphicDecoration
- New methods:
  - getBaseTextDirection(): Returns the base text direction of the chart to which this decoration belongs.
  - setBaseTextDirection(int): This method is implemented as part of the IlvBaseTextDirectionInterface. The implementation does nothing.
  - getComponentOrientation(): Returns the component orientation of the chart to which this decoration belongs.
  - setComponentOrientation(ComponentOrientation): This method is implemented as part of the IlvComponentOrientationAware interface. The implementation does nothing.
  - getResolvedBaseTextDirection(): Returns the resolved base text direction of the chart to which this decoration belongs.
Other globalization improvements:
New Interfaces and Classes

ilog.views.util.swing.IlvJSlider

This class is a variant of the Swing JSlider that contains an enhancement for globalization.

ilog.views.util.swing.IlvJSpinner

This class is a variant of the Swing JSpinner that contains a workaround against a Swing globalization bug.

Accessibility

Keyboard navigation in a chart: The user can navigate through the renderers, data sets, and data points of a chart using Tab, Shift-Tab, or the Arrow keys.
New Package

ilog.views.chart.accessibility

This package contains classes for the accessible elements of a chart.

New Interfaces and Classes

ilog.views.chart.accessibility.IlvChartAreaAccessible

This interface denotes an accessible element of a chart area.

ilog.views.chart.accessibility.IlvAccessibleDataSet

This class denotes the rendering of a data set.

ilog.views.chart.accessibility.IlvAccessibleDataPoint

This class denotes the rendering of a data point.

ilog.views.chart.accessibility.IlvAccessibleDataObject

This class denotes the rendering of a data object.

ilog.views.chart.accessibility.IlvChartAreaAccessibleHierarchy

This abstract class describes how the accessible elements of a chart area (scales, renderers, data sets, data points, and data objects) are grouped together, enabling a user to navigate through them.

ilog.views.chart.accessibility.IlvDefaultChartAreaAccessibleHierarchy

This class describes how the accessible elements of a chart area (scales, renderers, data sets, data points, and data objects) are grouped together, enabling a user to navigate through them.

ilog.views.chart.interactor.IlvChartCycleSelectInteractor

This class enables the user to navigate through the accessible elements of a chart area (scales, renderers, data sets, data points, and data objects).

ilog.views.chart.interactor.IlvChartAreaNavigationMode

Instances of this interface define ways to navigate through a hierarchy of accessible elements in a chart area.

ilog.views.chart.interactor.IlvChartAreaSelectionManager

This class manages a concept of "selection" in the chart area.

ilog.views.chart.util.IlvHandlesSelectionStyle

This class encapsulates the graphic style parameters used for drawing a selection using handles.

Modified Classes

ilog.views.chart.IlvScale
- New methods:
  - drawSelectionHandles(Graphics, IlvHandlesSelectionStyle): Draws this scale with selection handles.
  - isViewable(): Indicates whether this scale can be displayed.
ilog.views.chart.IlvChartRenderer
- New methods:
  - drawSelectionHandles(Graphics, IlvHandlesSelectionStyle): Draws this renderer with selection handles.
  - drawSelectionHandles(Graphics, IlvHandlesSelectionStyle, IlvDataSet): Draws a data set with selection handles.
  - drawSelectionHandles(Graphics, IlvHandlesSelectionStyle, IlvDataSet, int): Draws a data point with selection handles.
  - drawSelectionHandles(Graphics, IlvHandlesSelectionStyle, IlvObjectModelWithColumns, Object): Draws a data object with selection handles.
ilog.views.chart.renderer.IlvSimpleChartRenderer
- New methods:
  - drawSelectionHandles(Graphics, IlvHandlesSelectionStyle): Draws this renderer with selection handles.
ilog.views.chart.renderer.IlvCompositeChartRenderer
- New methods:
  - drawSelectionHandles(Graphics, IlvHandlesSelectionStyle): Draws this renderer with selection handles.
ilog.views.chart.renderer.IlvSingleChartRenderer
- New methods:
  - drawSelectionHandles(Graphics, IlvHandlesSelectionStyle): Draws this renderer with selection handles.
  - drawSelectionHandles(Graphics, IlvHandlesSelectionStyle, IlvDataSet): Draws a data set with selection handles.
ilog.views.chart.renderer.IlvSinglePieRenderer
- New methods:
  - drawSelectionHandles(Graphics, IlvHandlesSelectionStyle, IlvDataSet, int): Draws a data point with selection handles.
ilog.views.chart.renderer.IlvTreemapChartRenderer
- New methods:
  - drawSelectionHandles(Graphics, IlvHandlesSelectionStyle, IlvObjectModelWithColumns, Object): Draws a data object with selection handles.
ilog.views.chart.util.IlvSelectionUtil
- New methods:
  - getGlobalHandlesSelectionStyle(): Returns a reference to the global handles selection style used by the static methods of this class.
Support for high-contrast mode in Swing display:
Modified Classes

ilog.views.util.swing.IlvSwingUtil
- New methods:
  - getSystemColor(int): Returns the system color.
  - isHighContrastMode(): Detects whether the operating system has the high-contrast acccessibility mode enabled.

Styling

A pseudo-class can be added to a chart.
Modified Classes

ilog.views.chart.IlvChart
- New methods:
  - addPseudoClass(String): Adds a pseudo-class to this chart.
  - getPseudoClasses(): Returns the pseudo-classes of this chart.
  - setPseudoClasses(String[]): Sets the pseudo-classes of this chart.
  - initPseudoClasses(): Initializes the pseudo-classes of this chart.
  - removePseudoClass(String): Removes a pseudo-class from this chart.
ilog.views.chart.faces.servlet.IlvFacesChart
- New methods:
  - initPseudoClasses(): Initializes the pseudo-classes of this chart.
The runtime routines used by compiled CSS symbols are now documented.
New Interfaces and Classes

ilog.views.util.styling.runtime.IlvExpressionEvaluation

This class contains routines for the evaluation of expressions in CSS declarations.

ilog.views.util.styling.runtime.IlvCSSFunctionEvaluation

This class contains routines for the evaluation of function calls in CSS declarations.

Renderers

The border spacing of high-low charts can now be customized, in the same way as for bar charts.
Modified Classes

ilog.views.chart.renderer.IlvVariableWidthRenderer
- New methods:
  - isUseCategorySpacingAtBorders(): Returns true if the category spacing is also used on the left and right borders.
  - setUseCategorySpacingAtBorders(boolean): Determines whether the category spacing is also used on the left and right borders.
ilog.views.chart.renderer.IlvHiLoChartRenderer
- New methods:
  - isUseCategorySpacingAtBorders(): Returns true if the category spacing is also used on the left and right borders.
  - setUseCategorySpacingAtBorders(boolean): Determines whether the category spacing is also used on the left and right borders.
ilog.views.chart.renderer.IlvSingleHiLoRenderer
- New methods:
  - isUseCategorySpacingAtBorders(): Returns true if the category spacing is also used on the left and right borders.
  - setUseCategorySpacingAtBorders(boolean): Determines whether the category spacing is also used on the left and right borders.
When the user clicks a point in a chart, there is now an API to retrieve all data items at that point.
Modified Classes

ilog.views.chart.IlvChartRenderer
- New methods:
  - collectDisplayItems(IlvChartDataPicker, ArrayList): Collects the display items containing the specified picking point.
ilog.views.chart.renderer.IlvCompositeChartRenderer
- New methods:
  - collectDisplayItems(IlvChartDataPicker, ArrayList): Collects the display items containing the specified picking point.
It is now possible to set the y axis index of a renderer before it is attached to a chart. It is also possible to connect non top-level renderers to a different y axis.
Modified Classes

ilog.views.chart.IlvChartRenderer
- New methods:
  - setYAxisIdx(int): Connects the specified renderer to the specified ordinate axis.
The rendering hint associated with an entire data set in a renderer can now be accessed.
Modified Classes

ilog.views.chart.IlvChartRenderer
- New methods:
  - getRenderingHint(IlvDataSet): Returns the rendering hint that was specified globally for all the points of the given data set.
ilog.views.chart.renderer.IlvCompositeChartRenderer
- New methods:
  - getRenderingHint(IlvDataSet): Returns the rendering hint that was specified globally for all the points of the given data set.
ilog.views.chart.renderer.IlvSingleChartRenderer
- New methods:
  - getRenderingHint(IlvDataSet): Returns the rendering hint that was specified globally for all the points of the given data set.
ilog.views.chart.renderer.IlvTreemapChartRenderer
- New methods:
  - getRenderingHint(IlvDataSet): This method always returns null, because this renderer is associated with the entire data source, not with a single data set.

The Hitmap API has been extended to include other uses in addition to tooltips, in particular, highlighting, keyboard navigation, and cursor shaping. The scales of a chart can now be represented in the hitmap.

New Interfaces and Classes

ilog.views.chart.servlet.IlvChartHitmap

This class contains a hitmap, plus a hitmap info for the tooltip interactor.

ilog.views.util.hitmap.IlvHitmapInfoGenerator

Implementations of this interface construct all region infos of a single info type for the whole hitmap.

ilog.views.chart.servlet.IlvAbstractChartHitmapInfoGenerator

This class is the superclass of all classes that generate hitmap information for Charts.

ilog.views.chart.servlet.IlvAbstractChartTooltipInfoGenerator

A specialized class of hitmap information generator.

ilog.views.chart.servlet.IlvDefaultChartTooltipInfoGenerator

The default generator for tooltip information in a chart.

ilog.views.chart.servlet.IlvAbstractChartNavigationInfoGenerator

A specialized class of hitmap information generator.

ilog.views.chart.servlet.IlvDefaultChartNavigationInfoGenerator

The default generator for the keyboard navigation info in a chart.

ilog.views.util.hitmap.IlvHitmapConstants

The hitmap constants.

ilog.views.util.hitmap.IlvNavigationInfo

This class encodes how the keyboard navigation within a component reacts when a certain region (such as a graphic object) has the focus and the user presses one of the four Arrow keys (up, down, left, right).

Modified Classes

ilog.views.chart.servlet.IlvChartHitmapDefinition

New methods:
- createHitmapInfoGenerator(String, IlvChartHitmap): Creates an IlvHitmapInfoGenerator instance according to the hitmap information type.
- drawIntoHitmap(IlvChart, IlvScale, IlvChartHitmapAccumulator): Draws interactive effects for a given scale into the hitmap.
- getAttributes(IlvChart, IlvScale): Returns the interactive effects attributes for the given scale.
- getAttributes(IlvChart, IlvSingleChartRenderer, IlvDataSet): Returns the interactive effects attributes for a series of data points in the given data set.

ilog.views.chart.servlet.IlvDefaultChartHitmapDefinition

New methods:
- createHitmapInfoGenerator(String, IlvChartHitmap): Creates an IlvHitmapInfoGenerator instance according to the hitmap information type.
- drawIntoHitmap(IlvChart, IlvScale, IlvChartHitmapAccumulator): Draws interactive effects for a given scale into the hitmap.
- getAttributes(IlvChart, IlvScale): Returns the interactive effects attributes for the given scale.
- getAttributes(IlvChart, IlvSingleChartRenderer, IlvDataSet): Returns the interactive effects attributes for a series of data points in the given data set.

ilog.views.chart.servlet.IlvChartHitmapAccumulator

New methods:
- addHitmapAttribute(IlvChartAreaAccessible, IlvIMapAttributes): Adds a hitmap IlvIMapAttributes attribute into the hitmap accumulator.
- addRegionToGroup(int): Adds a given region to the current region, transforming it into a group.
- addRegionToGroup(int, int): Adds a given region to another region, transforming it into a group.
- getElementOfRegion(int): Returns the chart area element that is associated with a given region.
- getGroupedRegions(int): For a group region, returns the regions that are part of the group.
- getRegionAttributes(int): Returns the interactive effects that are associated with a given region.
- getRegionOfElement(IlvChartAreaAccessible): Returns the index denoting the region that is associated with a given chart area element.
- getRegionsCount(): Returns the number of hitmap regions stored in this accumulator.
- nextRegion(): Starts a new region in the hitmap, with unchanged coordinate system.
- nextRegion(int, int): Starts a new region in the hitmap, with an offset in the coordinate system compared to the origin of the hitmap.
- nextRegion(IlvChart): Starts a new region in the hitmap, with an offset that corresponds to the chart's drawing rectangle.
- setGraphics(Graphics2D): Sets the Graphic2D object.

ilog.views.chart.IlvScale

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

ilog.views.chart.servlet.IlvChartHitmapSupport

New methods:
- getHitmap(): Gets the hitmap object.
- registerHitmapInfoGenerator(String, IlvAbstractChartHitmapInfoGenerator): Registers a hitmap info generator to be used for a given hitmap information type.

Multiple Browser Sessions

It is now easier to design a web application so that the user can simultaneously open multiple instances of the same web application in a browser, each page preserving its own context.

New Interfaces and Classes

ilog.views.faces.IlvFacesPageIdUtil

This class provides utility methods used to support multiple pages per session (multiple tabs in a browser) in a Faces context.

ilog.views.util.servlet.IlvServletPageIdUtil

This class provides utility methods used to support multiple pages per session (multiple tabs in a browser) on a Servlet context.

Security I: Servlet Parameter Checking

JViews web applications are now better protected through security mechanisms that have been introduced for both JSF and JavaScript JViews web applications. The JViews web application sends the request by using client JavaScript libraries in the browser, to the JViews servlet class on the server side. It then updates the client with the information received from the response. The request URL sent by the client is composed of a list of requested parameters. These parameters and expected values on the server side can now be validated for security purposes.

New Interfaces and Classes

ilog.views.util.servlet.IlvRequestParameter

The class defines one specific request parameter.

ilog.views.util.servlet.IlvServletParameterHandler

An abstract superclass is designed to work as the handler for specific Servlet requests.

ilog.views.util.servlet.IlvServletParameterHandlerFactory

An abstract superclass is designed to work as the factory to return the parameter handler for the specific request. The subclass can override IlvServletParameterHandlerFactory.getServletParametersHandler to provide its own parameter handler.

ilog.views.util.servlet.IlvParameterValidationListener

An abstract superclass is designed to work as the parent class for handling requests for parameter validation.

ilog.views.util.servlet.IlvParameterValidationContextListener

A ServletContextListener that attempts to return the value of "ilog.views.servlet.CHECK_PARAM" and "ilog.views.servlet.CHECK_SERVLET_CLASSES" from the web configuration file when the context is initialized.

ilog.views.chart.servlet.IlvChartServletParameterHandlerFactory

The class returns the parameter handler for requests handled by IlvChartServletSupport.

ilog.views.chart.servlet.IlvChartServletParameterValidationListener

The class is designed to work as the parameter validation listener for dealing with requests handled by IlvChartServletSupport.

ilog.views.util.servlet.IlvResourceParameterHandlerFactory

The class returns the parameter handler for requests handled by ilog.views.faces.IlvResourceController.

ilog.views.faces.IlvResourceControlParameterValidationListener

The class is designed to work as the parameter validation listener for requests handled by IlvResourceController.

ilog.views.util.servlet.IlvScriptMessageParameterHandlerFactory

The class returns the parameter handler for requests handled by IlvScriptMessageServletSupport.

ilog.views.util.servlet.IlvSelectionParameterHandlerFactory

The class returns the parameter handler for various selection requests.

Modified Classes

ilog.views.faces.IlvResourceController

New methods:
- getResourceFromAbsolutePath(String): Gets a resource from the absolute file path.

Security II: Database Query Checking

SQL query strings can present security risks if they are constructed dynamically and their syntax is not checked. In JViews, a database query can now not only consist of a string, but also of a string with query parameters. This reduces the number of dynamically created query strings. Utility functions for checking the syntax of SQL query string portions are now provided.

New Interfaces and Classes

ilog.views.util.data.IlvJDBCQueryUtil

This class contains utility functions for manipulating SQL queries.

Modified Classes

ilog.views.util.data.IlvJDBCQueryParameters

New constructors:
- IlvJDBCQueryParameters(String, Object[], IlvJDBCConnectionParameters, IlvTableModelMapper): Creates a new set of parameters for an SQL query.

New methods:
- getQueryParameters(): Returns the parameters of the query, or null, or an empty array if there are none.

ilog.views.chart.data.IlvJDBCDataSource

New constructors:
- IlvJDBCDataSource(String, String, String, String, String, Object[], int, int, boolean): Creates a new IlvJDBCDataSource object.

New methods:
- getQueryParameters(): Returns the parameters of the query, or null, or an empty array if there are none.
- setQueryParameters(Object[]): Sets the query parameters.

ilog.views.util.data.IlvJDBCTableModel

New constructors:
- IlvJDBCTableModel(Connection, String, Object[]): Creates and initializes an IlvJDBCTableModel from a java.sql.Connection and an SQL query.
- IlvJDBCTableModel(String, String, String, String, String, Object[]): Creates and initializes an IlvJDBCTableModel from a set of JDBC parameters.

New methods:
- setConnection(Connection, String, Object[]): Initializes an IlvJDBCTableModel with a java.sql.Connection and an SQL query.
- setConnectionParameters(String, String, String, String, String, Object[]): Initializes an IlvJDBCTableModel with a set of JDBC parameters.

ilog.views.util.data.IlvRowSetTableModel

New methods:
- createRowSet(String, String, String, String, Object[], boolean, int): Creates a RowSet instance with the given parameters that can be used by a IlvRowSetTableModel.
- createRowSet(Connection, String, Object[], boolean, int): Creates a RowSet instance with the given parameters that can be used by a IlvRowSetTableModel.

Printing

It is now possible to create printable documents where the paper size implicitly depends on the printer or the locale.
Modified Classes

ilog.views.chart.print.IlvChartPrintableDocument
- New constructors:
  - IlvChartPrintableDocument(String, IlvChart, int, Paper): Creates an IlvChartPrintableDocument for the specified IlvChart using the specified parameters.
  - IlvChartPrintableDocument(String, IlvChart, boolean, int, boolean, IlvDataWindow, int, Paper): Creates an IlvChartPrintableDocument for the specified IlvChart using the specified parameters.
ilog.views.util.print.IlvPrintableDocument
- New constructors:
  - IlvPrintableDocument(String, int, Paper): Creates an initially empty IlvPrintableDocument with the given page format, provided as an orientation and a paper format.
  - IlvPrintableDocument(String, int): Creates an initially empty IlvPrintableDocument with the given orientation.
- New methods:
  - getOrientation(): Returns the orientation for all contained pages.
  - setOrientation(int): Sets the orientation for all contained pages.
  - getPaperFormat(): Returns the paper format (paper size and imageable area) for all contained pages.
  - setPaperFormat(Paper): Sets the paper format (paper size and imageable area) for all contained pages.
ilog.views.util.print.IlvPrintingController
- New methods:
  - getDefaultPageFormat(): Returns the default page format, which depends on the available printers or, if no printer is available, on the current locale.
  - getDefaultPaperFormat(): Returns the default paper dimensions, which depend on the available printers or, if no printer is available, on the current locale.
It is now possible to request the native print dialog instead of the Swing cross-platform print dialog.
Modified Classes

ilog.views.util.print.IlvPrintUtil
- New methods:
  - isNativePrintDialog(): Returns true if the native print dialog is favored over the Swing cross-platform print dialog.
  - setNativePrintDialog(boolean): Sets whether to use a native print dialog instead of the Swing cross-platform print dialog.
It is now possible to reuse the same print settings with a different chart.
Modified Classes

ilog.views.chart.print.IlvChartPrintableDocument
- New methods:
  - setChart(IlvChart): Sets the chart to be printed.
It is now possible to programmatically turn off two-sided printing.
Modified Classes

ilog.views.util.print.IlvPrintableDocument
- New methods:
  - getSides(): Returns the way pages are mapped on the sides of the paper sheets.
  - setSides(Sides): Sets the way pages are mapped on the sides of the paper sheets.
Other new APIs.
Modified Classes

ilog.views.util.print.IlvPrintableDocument
- New methods:
  - enablePrintStyle(boolean): This method displays the contents of the document differently for printing than for on-screen display.
  - maybeInvalidatePages(): This method is called before accessing the pages of the document.
ilog.views.util.print.IlvPrintingController
- New methods:
  - getPreparedPrinterJob(): Returns the PrinterJob used to print the contents.

PDF Generation

It is now easier to get a decently scaled or fitted chart converted to PDF.

New Interfaces and Classes

ilog.views.util.print.IlvFOUtil.ComponentPaintable

This class is a Paintable component that paints a Component without scaling.

Modified Classes

ilog.views.chart.IlvChart

New methods:
- getComponentPaintable(boolean, Color): Returns a IlvFOUtil.Paintable that can be used to convert this chart to a PDF by using XSL-FO.
- getComponentPaintableCurrentThread(boolean, Color): Returns a IlvFOUtil.Paintable that can be used to convert this chart to a PDF by using XSL-FO.

ilog.views.util.print.IlvFOUtil

New methods:
- paintToFOFitted(Document, IlvFOUtil.ComponentPaintable, int, int, int, int): Generates an XSL-FO element representing the given component.
- paintToFOScaled(Document, IlvFOUtil.ComponentPaintable, double): Generates an XSL-FO element representing the given component.
- paintToFOUnscaled(Document, IlvFOUtil.ComponentPaintable): Generates an XSL-FO element representing the given component.

Other Changes in Charts Classes

Modified Classes

ilog.views.chart.IlvStyle

New methods:
- expand(boolean, Rectangle2D): Expands the specified bounds by the current line width.
- getBounds(int[], int[], int, boolean, boolean, Rectangle2D): Returns the bounds of the specified geometry.
- getBounds(double[], double[], int, boolean, boolean, Rectangle2D): Returns the bounds of the specified geometry.

ilog.views.chart.IlvStyle.IntensityChange

New methods:
- getLevel(): Returns the level of intensity change.

ilog.views.chart.graphic.IlvDefaultDataRenderingHint

New constructors:
- IlvDefaultDataRenderingHint(IlvStyle.Change): Creates a new hint that references the specified style change.

New methods:
- getStyleChange(): Returns the referenced style change.

Other API Changes in Web Technologies

Modified JSF Components

jvcf:chartView

New attributes:
- accessible: Sets whether the view is accessible or not.
- hotkeys: Sets the keyboard hot keys for the view.

New Interfaces and Classes

ilog.views.chart.servlet.IlvChartServerActionParser

The IlvChartServerActionParser class is used to parse the server action annotation of the servlet.

ilog.views.util.servlet.IlvAbstractServerActionParser

The abstract server action parser.

ilog.views.faces.component.IlvFacesMenuItem

This class defines a menu item JSF component.

ilog.views.faces.dhtml.interactor.IlvFacesCursorChangeInteractor

The IlvFacesCursorChangeInteractor is the class for JViews Faces cursor change interactor components.

ilog.views.faces.dhtml.interactor.IlvFacesInterceptInteractor

The IlvFacesInterceptInteractor is the class for JViews Faces intercept interactor components.

ilog.views.faces.dhtml.renderkit.IlvFacesCursorChangeInteractorRenderer

The IlvFacesCursorChangeInteractorRenderer is the renderer class for IlvFacesCursorChangeInteractor.

ilog.views.faces.dhtml.renderkit.IlvFacesInterceptInteractorRenderer

The IlvFacesInterceptInteractorRenderer class can intercept the interactor.

ilog.views.faces.dhtml.taglib.IlvCursorChangeInteractorTag

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

ilog.views.faces.dhtml.taglib.IlvInterceptInteractorTag

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

ilog.views.util.servlet.IlvServerActionEvent

A server action event.

ilog.views.util.servlet.IlvServletHTMLUtil

This class contains utility methods for constructing syntactically valid HTML without security bugs, even in the presence of non-ASCII Unicode characters.

Modified Classes

ilog.views.chart.faces.dhtml.component.IlvChartDHTMLViewComponent

New methods:
- getHotkeys(): Returns the hot keys for this view.
- setHotkeys(String): Sets the hot keys for this view.
- isAccessible(): Returns whether the view is accessible or not.
- setAccessible(boolean): Sets whether the view is accessible or not.

New fields:
- ACCESSIBLE_DEFAULT_VALUE: Default value of accessible property.

ilog.views.chart.faces.dhtml.taglib.IlvChartViewComponentTag

New methods:
- getAccessible(): Returns whether the view is accessible or not.
- setAccessible(String): Sets whether the view is accessible or not.
- getHotkeys(): Returns the hot keys for this view.
- setHotkeys(String): Sets the hot keys for this view.

ilog.views.faces.component.IlvFacesView

New methods:
- getHitmapLayers(): Returns the hitmap layers of this view.
- setHitmapLayers(String): Sets the hitmap layers for this view.
- getHotkeys(): Returns the hot keys for this view.
- setHotkeys(String): Sets the hot keys for this view.

ilog.views.faces.dhtml.IlvDHTMLConstants

New fields:
- ACCESSIBLE: The accessible property of a view.
- HOTKEYS: The hitmapLayers of the View component.

ilog.views.faces.dhtml.component.IlvFacesDHTMLOverview

New methods:
- isIgnoreContentAspectRatio(): Returns whether the view is ignore content aspect ratio or not.
- setIgnoreContentAspectRatio(boolean): Sets whether the view is ignore content aspect ratio or not.

New fields:
- IGNORE_CONTENT_DEFAULT_VALUE: Default value of ignore content aspect ratio property.

ilog.views.faces.dhtml.component.IlvFacesDHTMLView

New methods:
- isAccessible(): Returns whether the view is accessible or not.
- setAccessible(boolean): Sets whether the view is accessible or not.

ilog.views.faces.dhtml.component.IlvFacesDHTMLViewSupport

New methods:
- isAccessible(): Returns whether the view is accessible or not.
- setAccessible(boolean): Sets whether the view is accessible or not.

ilog.views.faces.dhtml.component.IlvFacesDHTMLViewSupportImpl

New methods:
- isAccessible(): Returns whether the view is accessible or not.
- setAccessible(boolean): Sets whether the view is accessible or not.

New fields:
- ACCESSIBLE_DEFAULT_VALUE: Default value of accessible property.

ilog.views.faces.dhtml.taglib.IlvFacesHighlightInteractorTag

New methods:
- getGroupable(): Gets the groupable option.
- setGroupable(String): Sets the groupable option.

ilog.views.faces.dhtml.taglib.IlvFacesOverviewTag

New methods:
- getIgnoreContentAspectRatio(): Returns whether the view is ignoreContentAspectRatio or not.
- setIgnoreContentAspectRatio(String): Sets whether the view is ignoreContentAspectRatio or not.

ilog.views.faces.dhtml.taglib.IlvFacesTooltipInteractorTag

New methods:
- getBaseTextDirection(): Returns the baseTextDirection.
- setBaseTextDirection(String): Sets the baseTextDirection.
- getTemplate(): Returns the template.
- setTemplate(String): Sets the template.

ilog.views.faces.dhtml.taglib.IlvFacesViewTag

New methods:
- getAccessible(): Returns whether the view is accessible or not.
- setAccessible(String): Sets whether the view is accessible or not.
- getHitmapLayers(): Returns the hitmap layers of this view.
- setHitmapLayers(String): Sets the hitmap layers for this view.
- getHotkeys(): Returns the keyboard hot keys for the view.
- setHotkeys(String): Sets the keyboard hot keys for the view.

ilog.views.faces.dhtml.taglib.IlvImageButtonTag

New methods:
- getBaseTextDirection(): Returns the baseTextDirection.
- setBaseTextDirection(String): Sets the baseTextDirection.

ilog.views.faces.dhtml.taglib.IlvMessageBoxTag

New methods:
- getBaseTextDirection(): Returns the baseTextDirection.
- setBaseTextDirection(String): Sets the baseTextDirection.

ilog.views.faces.interactor.IlvFacesHighlightInteractor

New methods:
- getGroupable(): Returns the groupable option.
- setGroupable(String): Sets the groupable option.

ilog.views.faces.interactor.IlvFacesTooltipInteractor

New methods:
- getBaseTextDirection(): Returns the baseTextDirection.
- setBaseTextDirection(String): Sets the baseTextDirection.
- getTemplate(): Returns the tooltip template.
- setTemplate(String): Sets the tooltip template.

ilog.views.faces.taglib.IlvFacesMenuItemTag

New methods:
- getBaseTextDirection(): Returns the baseTextDirection.
- setBaseTextDirection(String): Sets the baseTextDirection.
- initBaseTextDirection(): Sets the default base text direction of a menu item.

ilog.views.faces.taglib.IlvFacesMenuTag

New methods:
- doAfterBody(): Performs any processing necessary to handle the content implications of CASE 4 in the class description.

ilog.views.faces.taglib.IlvMenuTag

New methods:
- getBaseTextDirection(): Returns the baseTextDirection.
- setBaseTextDirection(String): Sets the baseTextDirection.

ilog.views.util.servlet.model.IlvMenuItem

New methods:
- getBaseTextDirection(): Returns the baseTextDirection.
- setBaseTextDirection(String): Sets the baseTextDirection.

Example Changes

A new accessibility sample has been added.

The jsf-chart-bank sample now also shows

Accessibility features.
How to use a tooltip template.
How to use the intercept interactor.
How to make the select interactor and the zoom interactor work together, through the hitmap.

The jsf-chart-stock2 sample now also shows how to support multiple browser sessions.

The modeling example for Eclipse now works in Eclipse 3.5.x to 3.7.x.