ilog.views.chart.servlet

Class IlvChartSessionAttribute

java.lang.Object

ilog.views.chart.servlet.IlvComponentSessionAttribute

ilog.views.chart.servlet.IlvChartSessionAttribute

All Implemented Interfaces:

EventListener, javax.servlet.http.HttpSessionBindingListener

public class IlvChartSessionAttribute
extends IlvComponentSessionAttribute

The IlvChartSessionAttribute class acts as a proxy for an IlvChart bound to an HttpSession. When you bind a chart as an attribute of an HttpSession, proper cleanup of the chart must occur when the session is invalidated or expires. This allows the chart to be garbage collected or restored to a pool of available charts, depending on your choice of strategies. Instead of binding the chart directly to the session, use an instance of this class as a proxy:

 IlvChart chart = null;
 HttpSession session = request.getSession();
 if (session.isNew()) {
   chart = ... create new chart or fetch from pool ...
   IlvChartSessionAttribute proxy = new IlvChartSessionAttribute(chart);
   session.setAttribute(CHART_KEY, proxy);
 } else {
   IlvChartSessionAttribute proxy =
     (IlvChartSessionAttribute)session.getAttribute(CHART_KEY);
   if (proxy != null)
     chart = proxy.getChart();
 }
 if (chart == null)
   throw new ServletException("session problem");
 

When all the sessions that the proxy and its component are associated with expire, the componentUnbound() method of the proxy will be invoked. You can override this method to customize your strategy for handling charts that are no longer associated with any sessions.

Since:

JViews 5.5

Constructor Summary

Constructors

Constructor and Description
IlvChartSessionAttribute(IlvChart chart) Creates an IlvChartSessionAttribute proxy for the specified chart.

Method Summary

Modifier and Type	Method and Description
protected void	componentUnbound() This method is automatically invoked when the proxy is unbound from its last HTTP session.
IlvChart	getChart() Returns the proxy chart.

Methods inherited from class ilog.views.chart.servlet.IlvComponentSessionAttribute

getComponent, valueBound, valueUnbound

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IlvChartSessionAttribute

public IlvChartSessionAttribute(IlvChart chart)

Creates an IlvChartSessionAttribute proxy for the specified chart.

Parameters:

chart - The chart.

Method Detail

getChart

public IlvChart getChart()

Returns the proxy chart.

Returns:

The chart.

componentUnbound

protected void componentUnbound()

This method is automatically invoked when the proxy is unbound from its last HTTP session. This method is invoked on the Swing event queue, making it safe to change the attributes of the proxy chart.

Overrides:

componentUnbound in class IlvComponentSessionAttribute