Getting started with JViews Charts Web applications

In order to follow this Getting Started guide, you must have previously created your jsf-hello-world project as described in Getting started with a basic JViews JSF application. This guide will reuse the workspace and jviews-web-samples that you have previously created.

When developing JViews Charts JSF applications you must use the following jars (in addition to the JViews jars required by a basic JViews JSF application). These jars must also be distributed with your Web applications.

To create a customized user library for the jars required when developing JViews Charts JSF applications:

1. Start Eclipse and open the workspace C:\Rogue Wave\jviews-web-samples (or the folder you chose when creating your workspace).

Note that the JViews Framework library used for basic JViews JSF application is already there.

3. Click New and enter a user library name of your choice, for example, JViews Charts and then click OK.

4. Click Add External JARs and add all the jars shown listed under JViews Charts (or the user library name you have chosen) and click OK.

The number of jars and their directory paths might vary depending on your version ofJViews.

The workspace is now configured and ready to receive JViews Charts JSF applications.

To create your JViews Charts JSF application project

2. Enter jsf-hello-chart as the Project name and select JavaServer Faces v1.1 Project as the Configuration.

3. Click Next three times consecutively to obtain the following window:

4. Select the JViews Framework,and JViews Charts check boxes (or the user library names of your choice).

Select *.jsp* from the URL Mapping Patterns and click Remove, as this pattern might cause problems.

5. If necessary, switch to a Java perspective (you can ignore any Eclipse prompts requesting you to switch to the Java EE perspective) by selecting Windows>Open Perspective>Other…>Java and then click OK.

The aim of a JViews Charts application is to display diagrams through Web browsers. There are many ways to create diagrams with JViews Charts.

This example shows you one of the simplest ways: the diagram has been previously prepared using JViews desktop applications and saved as an IGPR file. The purpose of this JSF application is to display the diagram stored in this IGPR file on the Web.

To obtain the required data:

Copy the files chart.icpr and chart.css from <installdir> \jviews-charts\codefragments\jsf-hello-chart\webpages to the WebContent folder of your project. The location of this example might change depending on the version of your JViews product.

For alternative ways to provide or to create diagrams with JViews Charts, refer to the demos and samples provided with your JViews product.

You must repeat the procedure previously described in Getting started with a basic JViews JSF application. For more information, refer to Configuring the JViews servlet.

You must repeat the procedure previously described in Getting started with a basic JViews JSF application. For more information, refer to Creating the main JSP page.

To add a JSF chart view:

Open the new index.jsp file located in the WebContent folder and add the code shown in bold in the following code example:

<%@ page language="java" contentType="text/html; charset=ISO-8859-1" pageEncoding="ISO-8859-1"%>

<%@ taglib uri="http://www.ilog.com/jviews/tlds/jviews-chart-faces.tld" prefix="jvcf"%>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

The component <jvcf:chartView> enables you to show the chart produced with JViews Charts. The data attribute of this component references a JViews Charts project file. Note also that <jvcf:chartView> must be inserted with in a <h:form> component.

This completes the coding of your JViews Charts JSF application. You can now proceed to deploy and test it.

Your JViews Charts JSF application has been compiled and built automatically by Eclipse™ providing that you have not turned off the Build Automatically option. If you do not have any compilation errors you can deploy your application on the Tomcat server that you previously configured.

To deploy your JViews JSF application on the Tomcat™ server:

1. In the Server tab, right-click Tomcat v7.0 Server at localhost and select Add and Remove…:

2. You can see the jsf-hello-world application you previously created in the right pane. Select jsf-hello-chart in the left pane and click Add >:

a. Make sure that you can see both jsf-hello-worldand jsf-hello-chart in the right pane and click Finish.

Your application is now deployed on the Tomcat server and ready for testing.

To test your JViews Charts JSF application:

1. In the Servers tab, right-click Tomcat v7.0 Server at localhost and select Start (or Restart).

You have now created your first JViews Charts JSF application.

This Getting Started example is shipped with your JViews product and is located in the directory <installdir> \jviews-charts\codefragments\jsf-hello-chart\index.html. The location of this directory might vary depending on the version of your product.

This Getting Started guide shows you how to create a JViews Charts JViews JSF view. For information on interactions, such as selection and zoom, see the following sections in this product guide. A number of samples and demos are provided with this product showing different ways to use JViews Charts JSF components.