Requirements
Chart FX for Java requires J2EE or J2SE 1.3 or higher. For "headless" environments, 1.4 or higher is recomended, for more information see Running Chart FX for Java on a headless Server.
Compatibility List
Chart FX for Java will run on any Java Application Server running Java 1.3 or higher, and has been tested with the following servers:
- Tomcat 3.x, 4x and 5.x
- IBM WebSphere 4.0 and 5.0
- BEA Weblogic 7.x and 8.x
- Macromedia JRun 4
- Sun ONE Application Server 7 and 8
- Sun ONE Web Server
- Oracle AS 9 and 10
- Orion Application Server
- JBoss
- ColdFusion MX
For an updated list of tested Java Servers, please visit: http://support.softwarefx.com/cfxjava/.
Chart FX FX for Java Installation
After installing Chart FX for Java in your installation directory you will find the following files and folders.
- samples: contains the Chart FX for Java server-side Java bean and JSP samples
- doc: Chart FX for Java Resource Center which contains a Programmer's Guide and the Javadoc API.
- designer: contains the Chart FX for Java Designer.
- plugins: contains the Eclipse and Netbeans plug ins.
- License.txt: Chart FX for Java license agreement.
- readme.txt: readme file (same content as this page).
Please note that Chart FX for Java must be Activated to complete the installation. For more information about this process and a detailed description of the installation, please see Installation and Activation.
The cfxjava.war
After installation, you may find a cfxjava.war in your <install folder>/server. This is a web application deployment file containing everything inside the server folder. You can use this file to deploy Chart FX for Java and its samples. This file is created during installation.
If you cannot find this file, you can create it running the following command, inside the server folder:
If you want a war file containing ONLY Chart FX for Java and not the samples, you can create it running the following command:
jar cf cfxjava.war chartfx6 WEB-INF
|
The Chart FX for Java Samples
You may use the above described war file to deploy the Chart FX for Java samples to an application server; or you can deploy them by just copying the files. While this is not the recomended wya, some application application servers will allow it, for example Tomcat.
Most aplication server provide mecanisms to deploy applications, either from a war file or from a folder, please consult our application server documentation for more detail.
Quick Start: How to use Chart FX for Java in a JSP Page:
<%@page import="SoftwareFX.ChartFX.*"%> <% ChartServer chart1 = new ChartServer(application,request,response); // Your code here... %> <%=chart1.getHtmlTag("450","280","PNG")%>
|
Quick Start: How to use Chart FX for Java in a Java Class:
import SoftwareFX.ChartFX.*; Chart chart1 = new Chart(); // Your code here... chart1.exportChart(FileFormat.PNG,"filepath\filename.png");
|
Note: chartfx.jar and the JAI api jars must be in the classpath.
Quick Start: How to use Chart FX for Java in a Servlet:
protected void processRequest(HttpServletRequest request, HttpServletResponse response) throws ServletException, java.io.IOException { ChartServer chart1 = new ChartServer(this.getServletContext(),request,response); // Your code here... chart1.getHtmlData("450","300","PNG"); }
|
Important Note: The getHtmlData Method "writes" the Chart directly to the response OuputStream by calling the getOutputStream() method, which will throw an exception if the getWriter() method is also called in the same servlet.
|