Instalación de JFreeChart

El Proyecto JFreeChart que vio la luz en el año 2000 es una librería de código abierto (Open Source) para Java, que permite crear diagramas de forma práctica y sencilla. Con JFreeChart podremos hacer diferentes tipos de gráficos que van desde los tipos comunes tales como gráficos circulares , gráficos de barras , áreas , gráficos de línea , histogramas , diagramas de Gantt y más específicos y menos frecuentemente utilizados como tipos Candlestick , Viento y Wafer Map . Para mas información sobre esto revisar la documentación Javadoc de las clases JFreeChart y ChartFactory.

I.- REQUISITOS

• El paquete JFreeChart , el cual podremos descargar desde http://sourceforge.net/projects/jfreechart/ aunque el sitio oficial de JFreeChart es  http://www.jfree.org/jfreechart/
• El paquete JCommon, se descarga de http://sourceforge.net/projects/jfreechart/files/3.%20JCommon/
• La documentación del JFreeChart (opcional) .

Es necesario descargar descargar el paquete JFreeChart ; opcionalmente se recomienda descargar también el paquete JCommon. Aunque una versión parcial del mismo ya viene incluido dentro de JFreeChart.

II- CONFIGURACIÓN DE EL JFREECHART Y EL JCOMMON

A continuación iniciaremos los pasos para poder configurar JFreeChart en la IDE NetBeans :

1. Una vez que descargamos el paquete JFreeChart  y el paquete JCommon lo descomprimimos en un directorio de la PC .
2. Ahora abriremos el NetBeans  para configurar las librerías de JFreeChart y JCommon  , por lo tanto en NetBeans nos vamos al menú Tools y Seleccionamos Libraries :
3. Hacemos clic en New Library y escribimos “JCommon-1.0.16” como nombre de la librería luego iremos a  la pestaña Classpath → Add Jar/Folder y luego buscamos la dirección del JCommon descargado anteriormente y seleccionamos el archivo JCommon-1.0.16.jar :
4. Hacemos lo mismo con el jar que descargamos del JfreeChart , OJo que el jar que seleccionamos en este caso es el de la carpeta lib .
5. Hecho esto ya tenemos configurado las librerías de JFreechart y JCommon en el NetBeans ; hora ya podremos generar un gráfico .

OBSERVACIÓN : Hay que tener en cuenta que solo hemos agregado los JAR mas no hemos generado la documentación de los archivos que hemos colocado en las librerías, una forma es mediante el archivo ant que ofrece apache pero no lo coloco porque aún estoy revisándolo, cuando me corra actualizaré el blog o si alguien sabe como hacerlo(generar el javadoc) le agradecería me apoye con la info.

III.- CREANDO UN GRÁFICO EN NETBEANS USANDO JFREECHART

• Creamos un nuevo proyecto , para ello vamos al menú File → New Projct → Java Application y dejamos el Create Main Class activado para que nos pueda generar la clase main (esto no es indispensable pues se puede colocar la generación de los gráficos en una clase aparte – solo que para efectos del ejemplo lo vamos a hacer así – )
• Ahora vamos a agregar las librerías que hemos agregado anteriormente a este nuevo proyecto , para ello vamos a la pestaña Projects → En el nodo Libraries → Clic derecho add Library y seleccionamos las librerías JFreeChart y jCommon .
• Y ahora en la clase Main colocaremos lo siguiente :

  package jfreechart;
  
  import org.jfree.chart.ChartFactory;
  import org.jfree.chart.ChartFrame;
  import org.jfree.chart.JFreeChart;
  import org.jfree.data.general.DefaultPieDataset;
  
  public class Main
  {
      public static void main(String[] args) 
      {
          //Crear un dataset
          DefaultPieDataset data = new DefaultPieDataset();
          data.setValue("Categría 1",43.2);
          data.setValue("Categría 2",27.9);
          data.setValue("Categría 3",79.5);
          //Creamos un Chart
          JFreeChart chart = ChartFactory.createPieChart(
                             "Ejemplo de JFreeChart", //Títrulo del gráfico
                             data,
                             true,//Leyenda
                             true,//ToolTips
                             true);
          //Creamos una especie de frame y mostramos el JFreeChart en él
          //Este constructor nos pide el título del Chart y el chart creado
          ChartFrame frame=new ChartFrame("Primer Chart para javax0711",chart);
          frame.pack();
          frame.setVisible(true);
      }
  }

  
  



• Compilamos , ejecutamos la aplicación y listo ya tenemos nuestro primer gráfico generado