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
ilog.views.chart.graphic.IlvLabelDecoration
A class to display a label as a chart decoration.
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.
IlvImageDecoration
class now supports animated images.
ilog.views.chart.swing.IlvJLabel
This class is a Swing label, with additional bean properties.
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 aJColorChooser
.
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 aJColorChooser
.
ilog.views.chart.IlvLegend
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
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.IlvHiLoOpenCloseRendererLegendItem
Represents a legend item associated with a quadruple of data sets (low, high, open, close) displayed by a
IlvHiLoChartRenderer
inCANDLE
orOPENCLOSE
mode.
ilog.views.chart.renderer.IlvHiLoChartRenderer
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.
ilog.views.chart.IlvLegend
itemClickMayMoveLegend(IlvLegendItem)
:
Called when a mouse button has been pressed on a legend item.
NEARESTPOINT_PICKING
where the user has to click near the displayed data point (with a tolerance), and
ITEM_PICKING
where the user can click in the entire rendered item, for example a bar in the case of a bar
chart. Now a third mode has been added:
NEARESTITEM_PICKING
which is like
ITEM_PICKING
,
except that it allows a tolerance.
ilog.views.chart.interactor.IlvChartDataInteractor
NEARESTITEM_PICKING
:
The constant describing the nearest item picking mode.
ilog.views.chart.IlvChart
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
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
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
NEAREST_ITEM_PICKING
:
The constant describing the nearest item picking mode.
ilog.views.chart.faces.dhtml.interactor.IlvChartSelectInteractor
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
getNearestItem(IlvChartDataPicker, double[])
:
Returns the display item closest to the picking point defined by the specified data picker.
ilog.views.chart.renderer.IlvSingleChartRenderer
getNearestItem(IlvChartDataPicker, double[])
:
Returns the display item closest to the picking point defined by the specified data picker.
ilog.views.chart.renderer.IlvTreemapChartRenderer
getNearestItem(IlvChartDataPicker, double[])
:
Returns the data object closest to the picking point defined by the specified data picker.
ilog.views.chart.servlet.IlvPickPointAction
NEAREST_ITEM_PICKING
:
The constant describing the nearest item picking mode.
ilog.views.chart.util.IlvGraphicUtil
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.
ilog.views.chart.interactor.IlvChartEditPointInteractor
processMouseMovedEvent(MouseEvent)
:
Handles a mouse motion event with no button pressed.
ilog.views.chart.interactor.IlvChartHighlightInteractor
processMouseMovedEvent(MouseEvent)
:
Processes a mouse motion event with no button pressed.
ilog.views.chart.interactor.IlvChartLocalReshapeInteractor
processMouseMovedEvent(MouseEvent)
:
Handles a mouse motion event with no button pressed.
ilog.views.chart.event.DataSourceListener2
Defines an extended interface for objects that listen to changes in an
ilog.views.chart.data.IlvDataSource
.
ilog.views.chart.data.IlvAbstractDataSource
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
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
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
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
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
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
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.event.ChartRendererListener2
Defines an extended interface for objects that listen to changes in an
ilog.views.chart.IlvChartRenderer
.
ilog.views.chart.IlvChart
endRendererChanges()
:
Terminates a batch of renderer changes.
startRendererChanges()
:
Starts a batch of renderer changes.
ilog.views.chart.IlvChartRenderer
endRendererChanges()
:
Terminates a batch of renderer changes.
startRendererChanges()
:
Starts a batch of renderer changes.
ilog.views.chart.data.IlvAbstractDataSet
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.
ilog.views.chart.renderer.IlvTreemapChartRenderer
getDisplayArea(Object)
:
Returns the displayed data object containing the specified data object.
addImageMapAreas
of a renderer and manipulate the returned list of IlvIMapArea
objects.
ilog.views.chart.servlet.IlvIMapArea
IlvIMapArea(IlvPolygon2D, IlvIMapAttributes)
:
Initializes a polygonal area with the specified IlvPolygon2D
and attributes.
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.
ilog.views.util.java2d.IlvShapeUtil
The class
IlvShapeUtil
contains static methods that are useful when working with Java2DShape
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.
Collection
, List
,
Set
, Iterator
, etc., the argument type or return type uses generics.
This allows for stricter type checking and more useful warnings.
ilog.views.chart.data.IlvCombinedDataSet
dispose()
:
Cleans up this data set and drops references to objects to help garbage collection.
ilog.views.chart.data.lod.IlvDataTileController
dispose()
:
Stops the load-on-demand mechanism.
ilog.views.util.IlvResourceUtil
isInApplet()
:
Tests whether we are running inside an applet.
ClassLoader
s has been added.
In situations where class loaders have a limited lifetime, for example in
Eclipse/RCP, JViews will now drop cached objects that belong to a class
loader when unregisterClassLoader
is called.
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.
ilog.views.util.IlvClassLoaderUtil
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
ClassLoaderLifetimeListener
s associated with a given ClassLoader
.
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.
ilog.views.util.swt.IlvEventThreadUtil
getAWTEventFilter()
:
Returns the currently active AWT event filter.
setAWTEventFilter(IlvAWTEventFilter)
:
Specifies the AWT event filter.
ilog.views.chart.IlvLegendLayout
clearCaches()
:
Clears the caches of the layout delegates.
ilog.views.chart.IlvChartRenderer
toDisplay(IlvDoublePoints, IlvChartProjector, Rectangle, IlvCoordinateSystem)
:
Projects points using this renderer coordinate system and projector area.
ilog.views.chart.renderer.IlvSingleChartRenderer
toDisplay(IlvDoublePoints, IlvChartProjector, Rectangle, IlvCoordinateSystem)
:
Projects points using this renderer coordinate system and projector area.
ilog.views.chart.renderer.IlvTreemapChartRenderer
toDisplay(IlvDoublePoints, IlvChartProjector, Rectangle, IlvCoordinateSystem)
:
Projects points using this renderer coordinate system and projector area.
ilog.views.chart.faces.dhtml.component.IlvChartFacesContextualMenu
This class defines a base class for DHTML component that displays a contextual menu for a chart.
ilog.views.faces.IlvFacesUtil
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
broadcast(FacesEvent)
:
Overrides the implementation of the super class.ilog.views.faces.dhtml.IlvDHTMLConstants
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
getDefaultObjectSelectedFinder()
:
Overrides the implementation of the super class.ilog.views.faces.dhtml.interactor.IlvFacesObjectSelectRectInteractor
getDefaultObjectSelectedFinder()
:
Overrides the implementation of the super class.ilog.views.faces.dhtml.interactor.IlvObjectSelectInteractor
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.
PARTIAL_SUBMIT_DEFAULT_VALUE
:
Default value of partialSubmit
property
ilog.views.faces.dhtml.renderkit.IlvFacesContextualMenuRenderer
configureObjectFinder(UIComponent, IlvObjectSelectedFinder)
:
Configures the default object finder instance.
ilog.views.faces.dhtml.taglib.IlvObjectSelectInteractorTag
getPartialSubmit()
:
Returns the partialSubmit mode.
setPartialSubmit(String)
:
Sets the partialSubmit mode.
ilog.views.faces.taglib.IlvBaseTag
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
getPartialSubmit()
:
Returns the partialSubmit
property.
setPartialSubmit(String)
:
Sets the partialSubmit
property.
ilog.views.util.java2d.IlvMultipleGradientPaintConstants
Constants for gradient paints.
ilog.views.util.collections.IlvCollections
concurrentModificationException(String, Throwable)
:
Returns a concurrent modification exception that has a cause.
ilog.views.util.collections.IlvUnsynchronizedStack
clone()
:
Returns a shallow copy of this IlvUnsynchronizedStack instance.
ilog.views.util.data.IlvTableModelMappingException
IlvTableModelMappingException(String, Throwable)
:
Builds an IlvTableModelMappingException
IlvTableModelMappingException(String, String, Throwable)
:
Builds an IlvTableModelMappingException
ilog.views.util.java2d.IlvLinearGradientPaint
IlvLinearGradientPaint(IlvLinearGradientPaint)
:
Creates a linear gradient paint by copying an existing one.
ilog.views.util.java2d.IlvMultipleGradientPaint
IlvMultipleGradientPaint(IlvMultipleGradientPaint)
:
Creates a multiple gradient paint by copying an existing one.
ilog.views.util.java2d.IlvRadialGradientPaint
IlvRadialGradientPaint(IlvRadialGradientPaint)
:
Creates a radial gradient paint by copying an existing one.
ilog.views.util.print.IlvPage
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
cleanPrintPreview(boolean)
:
Cleans the Print Preview dialog box.
ilog.views.util.styling.IlvCSSFunction
getDependencies(String[])
:
Returns the dependencies of this function.
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
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
actionPerformed(ActionEvent)
:
Notifies listeners when an action occurs in this component.
ilog.views.util.swing.layout.IlvVerticalFlowLayout
IlvVerticalFlowLayout(int, int, int, boolean)
:
Constructs a new IlvVerticalFlowLayout
object.
ilog.views.util.swing.tree.IlvDefaultTreeCellRenderer
getPreferredSize()
:
Returns the preferred size of the renderer.
ilog.views.util.time.IlvTimeIterator
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.
jsf-chart-facelets
shows how to use
a JViews chart in a Facelets context.
jsf-chart-ice
shows how to integrate
JViews Charts with ICEfaces.