The following components 
are required to run Tomcat from within Eclipse
  
  
    | Component | Location in 
      the local environment | 
  
    | BIRT 2.2, 
      Report Designer Full Eclipse Install (includes Eclipse 3.3, BIRT 2.2 and 
      the required dependent plugins) | C:\Eclipse_3.3 | 
  
    | Sun Java 
      JDK1.5.0_06 | C:\jdk1.5.0_06 | 
  
    | Tomcat 
    5.5.x | C:\Tomcat | 
Configuring Tomcat 
in the Eclipse Servers view 
  - Launch Eclipse. 
  
- Open the J2EE Perspective, then the Servers view. 
  
- Right-click from within the Servers view to bring up the context menu, 
  then select New > Server. 
  
- Select the application server you have installed, in this example, Apache 
  Tomcat v5.5 Server, then click Next. 
  
- Browse to the directory where you installed the Apache Tomcat v5.5 Server, 
  and make sure the Installed JRE is at least Java version 5 (Tomcat 5.5.x 
  requires this.). Then click Finish. 
Starting Tomcat 
from Eclipse
  - Go to the Servers view and bring up the context menu from the server you 
  just created. 
  
- Select Start. 
  
- The status in the Servers view should now say Started. Refer to the 
  Console view if any problems occur. 
TOP
  
  
- Select the context menu from within the Project Explorer view and select 
  New > Project. Select Web > Dynamic Web Project, then click Next. 
  
  
  
- The Dynamic Web Project wizard appears. Give the project a name, for 
  example, BirtChartExample, and make sure the target runtime is the Tomcat 
  server you just created. Click Next. 
  
  
  
- On the Project Facets page, select the BIRT Reporting Runtime Component 
  checkbox. This adds the BIRT runtime libraries to the dynamic web application. 
  Also make sure the Dynamic Web Module, and the Java project facet is checked. 
  Click Next. On the Web Module page click Finish. 
  
  
  
- Now the JSPs, servlet, Java files and some additional BIRT libraries need 
  to be imported into the project. 
 These additional libraries need to be 
  added to the web application and are available from the BIRT All-in-One Report 
  Designer download or the standalone Chart Engine download:
  
    - org.eclipse.birt.chart.device.extension_2.2.0vXXXXXXXX-XXXX.jar 
    
- org.eclipse.birt.chart.device.svg_2.2.0vXXXXXXXX-XXXX.jar 
    
- org.eclipse.birt.chart.engine.extension_2.2.0vXXXXXXXX-XXXX.jar 
    
  
  
- To add these libraries, expand the WebContent folder under the web 
  application just created, and select the lib folder under the WEB-INF folder. 
  Right-click the lib folder and select Import..., then General > File 
  System. Click Next. 
  Browse to the 
  eclipse/plugins directory where the jar files listed above have been unpacked 
  to. Select these jar files and import them into the web application's 
  WebContent/WEB-INF/lib folder. Click Finish. (Note: A bug in the Project 
  Explorer view prevents the files in the lib folder from being displayed. To 
  double-check you imported them, switch to the Navigator view.) 
Importing the JSPs, servlet and Java files
  - 
  From the Project Explorer view, select the WebContent folder at the top 
  level of the web application and right-click it to import the JSPs. Import the 
  JSPs to the WebContent folder from the file system as you did above. 
  Alternately, you can copy the JSPs, chartImage.jsp, control.jsp, and 
  UserPreference.jsp, to the WebContent folder.  
- 
  From the Project Explorer view select the Java Resources: src folder, bring 
  up the context menu and select New > Package. Create a package called 
  org.eclipse.birt.chart.examples.api.preference. Now import or copy into this 
  package these Java source files;  
    - PreferenceServlet.java 
    
- ChartModels.java 
    
- LabelStyleProcessor.java 
 from the 
  org.eclipse.birt.chart.examples/src/org/eclipse/birt/chart/examples/api/preference 
  folder.  
Edit the 
web.xml
Edit the web.xml file under 
the WebContent/WEB-INF folder to add the servlet mapping. This text should be 
added after the <-welcome-file-list> and before the closing 
<web-app> tag.
  <servlet>
<servlet-name>PreferenceServlet</servlet-name>
<servlet-class>org.eclipse.birt.chart.examples.api.preference.PreferenceServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>PreferenceServlet</servlet-name>
<url-pattern>/PreferenceServlet</url-pattern>
</servlet-mapping>
Running the 
JSPs
  - From the Project Explorer view select the control.jsp file, and select Run 
  As > Run On Server from the context menu. 
  
- In the Define a New Server page, select Choose an existing server, 
  ensuring that the Tomcat server you set up earlier is selected. Check the Set 
  server as project default checkbox, then click Next. 
  
- In the Add and Remove Projects page, the Web project you are working with 
  should be in the Configured Projects side. If it is not, add it to this side. 
  Click Next. Do not check the Update context root for your Web module and click 
  Finish. The page should appear, allowing for selection of font, size, style 
  and color of the bar graph which appears when the Submit button is pushed. 
  
TOP
To generate a dynamic, 
revisable chart in your web pages, the required components include a JSP page, a 
Servlet and a chart model.
JSPs
The JSP pages allow the 
user to set the characteristics of the rendered chart by passing parameters to 
the PreferenceServlet. 
1. Set the action for the 
form to call the Servlet. 
<form action="PreferenceServlet" method="POST"> 
2. 
Assign values to the selection or input components 
<option value="value">XXX</option> 
Servlet
1. Set the rendering device 
in the constructor
PluginSettings 
  ps = PluginSettings.instance( ); 
IDeviceRenderer idr = 
  ps.getDevice("dv.SWING" ); 
2. The doGet() 
method
  - Create a chart 
  model 
  
- Modify the chart model 
  according to the values from JSP 
  
- Set the output content 
  type, in this case to a JPEG 
  
- Output the chart 
  image 
3. Chart image 
rendering
  - Create a buffered 
  image 
  
- Build, then render a 
  chart in the buffered image 
  
- Output the chart 
  image 
Chart 
Model
The ChartModel.java class 
is the same class used in the other chart examples plugins.
TOP