Perforce JViews Charts Code Example: JavaServer Faces Charts Components

Description

These examples show how to use the Perforce JavaServer Faces components in order to display and interact on a chart.

Installing the Thin-Client Code Example

The code example contains a WAR file (Web Archive) that allows you to easily install the code example on any server that supports the Servlet API 2.1 or later. For your convenience, the WAR will be copied to the Tomcat web server that is supplied with the Perforce JViews installation when you start the server using the supplied scripts. Tomcat is the official reference implementation of the Servlet and JSP specifications. If you are already using an up-to-date Web or application server, there is a good chance that it already has everything you need. The sample can also be deployed to WebSphere Application Server (WAS).

Running the Code Example Using Tomcat

If you intend to use the Tomcat Web server provided with this installation, follow these instructions to start the server: Running the Server-Side Samples. The scripts to start the server can be found in the tools/tomcat-jsf directory.
Note: if you are running on Windows then you will find menu items in the Windows "start" menu to start and stop the Tomcat server.

Once the server is running, you can see the code example by opening the following page:

• Perforce JViews Charts Code Example: JavaServer Faces Charts Components
  http://localhost:8080/jsf-chart-code-fragments

Running the Code Example Using WebSphere Application Server

In addition to the instructions provided for using Tomcat, the samples can be viewed on WebSphere Application Server. Follow the instructions: Running the Server-Side Samples and use the scripts to start the server and deploy the sample.

Once the server is running, you can see the code example by opening the following page: http://localhost:9443/jsf-chart-code-fragments
The WAS administrative console can be used to verify or modify server settings: http://localhost:9043/ibm/console/

Note: the WAS server can start on a range of port numbers, therefore the value is not guaranteed to remain the same. The scripts provided with the samples can be used to obtain the port numbers used by the Admin Console and by the deployed Web applications. To retrieve a list of all the WAS port numbers, run the command line instruction: ant -f build_was.xml ws.list.ports

Topics Covered

• JavaServer Faces Charts
• Thin client
• User Manual

Detailed Description

This page gathers several code examples.

Each code example is a JavaServer Page (JSP).

If a component uses a Bean in a EL (for example #{myBean.myProperty}), it refers to the Java class that has the same class name as the Bean name.

A small description of the code example is present in the JSP page.

Installation Directory

The JavaServer Faces Charts Components code example is installed here.

Classes Involved

• ilog.views.chart.data.IlvDataSetPoint
• ilog.views.chart.data.IlvDataSource
• ilog.views.chart.faces.dhtml.IlvFacesChartImageMapGenerator
• ilog.views.chart.faces.dhtml.component.IlvChartDHTMLView
• ilog.views.faces.dhtml.event.FacesViewActionEvent
• ilog.views.faces.dhtml.interactor.IlvObjectSelectInteractor
• ilog.views.util.servlet.IlvMenuFactory

Source Files

• faces.dhtml.DataBean

  A Bean that contains a data source.

• faces.dhtml.ChartBean

  A Bean that contains a logic methods and properties used in code examples.

• faces.dhtml.ImapGenerator

  An image map generator.

• faces.dhtml.MenuFactory

  A contextual menu factory.

• code_fragment1

  This JSP page shows how to declare an empty chart.

• code_fragment2

  This JSP page shows how to display a project created with the Designer for Perforce JViews Charts.

• code_fragment3

  This JSP page shows how to display an XML file following the Perforce JViews Charts DTD.

• code_fragment4

  This JSP page shows how to use an IlvDataSource instance.

• code_fragment5

  This JSP page shows how to use an IlvChart instance.

• code_fragment6

  This JSP page shows how to style the chart through CSS.

• code_fragment7

  This JSP page shows how to use an image map.

• code_fragment8

  This JSP page shows how to install an interactor on the chart view.

• code_fragment9

  This JSP page shows how to connect a message box to the chart view.

• code_fragment10

  This JSP page shows how to connect an overview to a chart view.

• code_fragment11

  This JSP page shows how to mix standard JavaServer Faces components with Perforce JViews JSF components.

• code_fragment12

  This JSP page shows how to use the JavaScript proxies to interactor on Perforce JViews JSF components without a page submit.

• code_fragment13

  This JSP page shows how to attach a static pop-up to a chart view.

• code_fragment14

  This JSP page shows how to attach a contextual pop-up menu to a chart view.

• code_fragment15

  This JSP page shows how to trigger an action in the image servlet when picking a point on a chart view.

• code_fragment16

  This JSP page shows how to trigger an action in the JSF lifecycle when picking a point on a chart view.