JFreeChart - API referenciadas
En este capítulo, analizaremos algunos de los paquetes, clases y métodos importantes de la biblioteca JFreeChart. Estos paquetes, clases y métodos son los que se utilizan con más frecuencia al crear una variedad de gráficos utilizando la biblioteca JFreeChart.
Clase ChartFactory
ChartFactory es una clase abstracta bajo la org.jfree.chartpaquete. Proporciona una colección de métodos de utilidad para generar gráficos estándar.
A continuación se muestra una lista de algunos de los métodos importantes:
Constructor de clases
| S. No | Descripción |
|---|---|
| 1 | ChartFactory() Constructor predeterminado de la clase ChartFactory. |
Métodos de clase
| S. No | Métodos y descripción |
|---|---|
| 1 | createPieChart(java.lang.String title, PieDataset dataset, boolean legend, boolean tooltips, boolean urls) Este método crea un gráfico circular con la configuración predeterminada. Devuelve el objeto de tipo JfreeChart. |
| 2 | createPieChart3D(java.lang.String title, PieDataset dataset, boolean legend, boolean tooltips, boolean urls Este método crea un gráfico circular 3D utilizando el conjunto de datos especificado. |
| 3 | createBarChart(java.lang.String title, java.lang.String categoryAxisLabel, java.lang.String valueAxisLabel, CategoryDataset dataset, PlotOrientation orientation, boolean legend, boolean tooltips, boolean urls) El argumento java.lang.String categoryAxisLabel es la etiqueta de los valores colocados en el eje X. El argumento java.lang.String valueAxisLabel es la etiqueta de los valores colocados en el eje Y. Este método crea un gráfico de barras. |
| 4 | createBarChart3D(java.lang.String title, java.lang.String categoryAxisLabel, java.lang.String valueAxisLabel, CategoryDataset dataset, PlotOrientation orientation, boolean legend, boolean tooltips, boolean urls) Este método crea un gráfico de barras con efecto 3D. Devuelve el objeto de tipo JfreeChart. |
| 5 | createLineChart(java.lang.String title, java.lang.String categoryAxisLabel, java.lang.String valueAxisLabel, CategoryDataset dataset, PlotOrientation orientation, boolean legend, boolean tooltips, boolean urls) Este método crea un gráfico de líneas con la configuración predeterminada. |
| 6 | createLineChart3D(java.lang.String title, java.lang.String categoryAxisLabel, java.lang.String valueAxisLabel, CategoryDataset dataset, PlotOrientation orientation, boolean legend, boolean tooltips, boolean urls) Este método crea un gráfico de líneas con efecto 3D. |
| 7 | createXYLineChart(java.lang.String title, java.lang.String xAxisLabel, java.lang.String yAxisLabel, XYDataset dataset, PlotOrientation orientation, boolean legend, boolean tooltips, boolean urls) Este método crea un gráfico de líneas basado en XYDataset con la configuración predeterminada. |
Clase ChartFrame
La clase ChartFrame en el paquete org.jfree.chart, proporciona todas las funciones y utilidades relacionadas con el marco. La clase ChartFrame hereda las funcionalidades de las clases principales, como las clases Frame, Window, Container y Component.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | ChartFrame (java.lang.Frame String, JfreeChart chart) Construye un marco. |
| 2 | Chart Frame (java.lang.Frame String, JfreeChart chart, boolean scrollpane) Construye un marco. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | getChartPanel() Este método devuelve el panel de carta de un marco. |
Clase ChartPanel
Clase ChartPanel del org.jfree.chart El paquete se utiliza como un componente GUI swing para mostrar el objeto JfreeChart.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | ChartPanel(JFreeChart chart) Este constructor construye un panel que muestra el gráfico especificado. |
| 2 | ChartPanel(JFreeChart chart, boolean useBuffer) Este constructor construye un panel que contiene un gráfico. |
| 3 | ChartPanel(JFreeChart chart, boolean properties, boolean save, boolean print, boolean zoom, boolean tooltips) Este constructor construye un panel JFreeChart. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | setPreferredSize(java.awt.Dimension) Este método se usa para establecer el tamaño del marco usando java.awt. Objeto de clase de dimensión como argumento. Este método se toma de javax.swing.JComponent. |
Clase ChartUtilities
Clase CharUtilites de la org.jfree.chart El paquete proporciona una colección de métodos de utilidad de JFreeCharts que incluyen métodos para convertir gráficos en formato de archivo de imagen como PNG, JPEG y crear mapas de imagen HTML.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | ChartUtilities() Este es un constructor predeterminado de una clase. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | saveChartAsPNG(java.io.File file, JfreeChart chart, int width, int height) Este método convierte y guarda un gráfico en el archivo especificado en formato PNG. |
| 2 | saveChartAsJPEG(java.io.File file, JfreeChart chart, int width, int height) Este método convierte y guarda un gráfico en el archivo especificado en formato JPEG. |
Clase JFreeChart
La clase JFreeChart es la clase principal bajo la org.jfree.chartpaquete. Esta clase proporciona el método JFreeChart para crear gráficos de barras, gráficos de líneas, gráficos circulares y gráficos xy, incluidos datos de series de tiempo.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | JfreeChart(Plot plot) Este constructor crea un nuevo gráfico basado en el gráfico proporcionado. |
| 2 | JfreeChart(java.lang.String title, java.awt.Font titleFont, Plot plot, boolean createLegend) Este constructor crea un nuevo gráfico con el título y la trama dados. |
| 3 | JfreeChart(java.lang.String title, Plot plot) Este constructor crea un nuevo gráfico con el título y la trama dados. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | getXYPlot() Este método Devuelve el gráfico de la gráfica como XYPlot. Usando XYPolt, podemos hacer algunas operaciones de utilidad en gráficos xy. |
Clase PiePlot
Esta clase es parte de org.jfree.chart.plotpackage y extiende la clase Plot del mismo paquete. Esta clase proporciona métodos para crear gráficos circulares.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | PiePlot() Crea una nueva trama. |
| 2 | PiePlot(PieDataset dataset) Crea un gráfico que dibuja un gráfico circular para el conjunto de datos especificado. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | setStartAngle(double angle) Este método establece el ángulo de inicio y envía un PlotChangeEvent a todos los oyentes registrados |
PiePlot3D (clase)
La clase PiePlot3D es una subclase de la clase PiePlot en el mismo paquete. Por lo tanto, esta clase tiene las mismas características que la clase PiePlot, excepto que se usa para crear gráficos 3D.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | PiePlot3D() Este constructor crea una nueva instancia sin conjunto de datos. |
| 2 | PiePlot3D(PieDataset dataset) Este constructor crea un gráfico circular con efecto tridimensional utilizando un conjunto de datos específico. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | setForegroundAlpha(float alpha) Establece la transparencia alfa para el gráfico y envía un PlotChangeEvent a todos los oyentes registrados. Esto se toma de una de las clases Plot padre. |
| 2 | setInteriorGap(double percent) Establece el espacio interior y envía un PlotChangeEvent a todos los oyentes registrados. Esto controla el espacio entre los bordes del gráfico circular y el área del gráfico en sí (es decir, la región donde aparecen las etiquetas de sección). Este método se toma de la clase padre PiePlot. |
Clase PlotOrientation
Esta es una clase serializada disponible en org.jfree.chart.plotpaquete y se utiliza para mostrar la orientación de un gráfico 2D. La orientación puede servertical o horizontal. Establece la orientación del eje Y. Una gráfica convencional tiene un eje Y vertical.
Campo Resumen
| S. No | Tipo | Campo Descripción |
|---|---|---|
| 1 | PlotOrientation | HORIZONTAL Para una gráfica donde el eje de rango (eje Y) es horizontal. |
| 2 | PlotOrientation | VERTICALPara una gráfica donde el eje de rango (eje Y) es vertical. Ésta es la orientación predeterminada. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | isHorizontal() Este método devuelve verdadero si esta orientación es HORIZONTAL y falso en caso contrario. |
| 2 | isVertical() Este método devuelve verdadero si esta orientación es VERTICAL y falso en caso contrario. |
Clase XYPlot
Esta es una clase general disponible en org.jfree.chart.plotpaquete y se utiliza para trazar los datos en forma de pares (x, y). Este gráfico puede usar datos de cualquier otra clase que implemente la interfaz XYDataSet. XYPlot utiliza un XYItemRenderer para dibujar cada punto del gráfico.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | XYPlot() Este contratista crea una nueva instancia de XYPlot sin conjunto de datos, sin ejes ni renderizador. |
| 2 | XYPlot(XYDataset dataset, ValueAxis domainAxis, ValueAxis rangeAxis, XYItemRenderer renderizador) Este constructor crea una nueva gráfica con el conjunto de datos, el eje y el renderizador especificados. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | setRenderer(XYItemRenderer renderizador) Este método establece el renderizador para el conjunto de datos principal y envía un evento de cambio a todos los oyentes registrados. |
Clase NumberAxis
Esta clase está disponible en org.jfree.chart.axispaquete y puede acceder a los datos numéricos de cualquier eje. Cuando establecemos el rango de cualquier eje por defecto, se ajusta según el rango de los datos. Pero usando NumberAxis, class podemos establecer el margen inferior y el margen superior de los ejes de dominio y rango.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | NumberAxis( ) Este es un constructor predeterminado de NumberAxis. |
| 2 | NumberAxis( java.lang.String label) El constructor NumberAxis usa valores predeterminados cuando es necesario. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | setLowerMargin(double margin) Establece el margen inferior para el eje (como porcentaje del rango del eje) y envía un AxisChangeEventa todos los oyentes registrados. Este método se toma de la clase principal de la clase ValueAxis. |
| 2 | setUpperMargin(double margin) Establece el margen superior para el eje (como un porcentaje del rango del eje) y envía un AxisChangeEventa todos los oyentes registrados. Este método también está presente en la clase ValueAxis. |
Clase XYLineAndShapeRenderer
Esta es la clase, disponible en org.jfree.chart.renderer.xypackage, que se encarga de conectar puntos de datos con líneas y dibuja formas en cada punto de datos. Esta clase de renderizador está diseñada para su uso conXYPlot clase.
Constructor de clases
| S. No | Constructor y descripción |
|---|---|
| 1 | XYLineAndShapeRenderer() Crea un nuevo renderizador con líneas y formas visibles. |
| 2 | XYLineAndShapeRenderer (líneas booleanas, formas booleanas) Crea un nuevo renderizador con una propiedad específica. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | setSeriesPaint(int series, java.awt.Paint paint) Este método fija la pintura utilizada para una serie y envía un RendererChangeEventa todos los oyentes registrados. Este método se toma de la clase abstracta AbstratRenderer del paquete renderizador en la API JFreeChart. |
| 2 | setSeriesStroke(int series, java.awt.Stroke stroke) Este método establece el trazo utilizado para una serie y envía un RendererChangeEventa todos los oyentes registrados. Este método se toma de la clase abstracta AbstratRenderer, que es la superclase de este paquete. |
Conjuntos de datos generales de XYItemRenderer
Esta es una interfaz para representar el formato de un solo elemento (x, y) en un XYPlot. El paquete esorg.Jfree.data.general, que tiene clases e interfaces para definir diferentes tipos de conjuntos de datos para construir gráficos.
PieDataset
Esta es una interfaz utilizada como un conjunto de datos de propósito general, donde los valores están asociados con claves. Como sugiere el nombre, puede utilizar este conjunto de datos para proporcionar datos para gráficos circulares. Esta interfaz amplía las interfaces KeyedValues y DataSet. Todos los métodos utilizados para esta interfaz se toman de las interfaces KeyedValues, Values y Dataset.
Clase DefaultPieDataset
Esta es una clase de implementación predeterminada de una interfaz PieDataset.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | DefaultPieDataset() Este constructor crea un nuevo conjunto de datos, inicialmente vacío. |
| 2 | DefaultPieDataset(KeyedValues data) Crea un nuevo conjunto de datos copiando datos de un KeyedValues ejemplo. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | setValue(java.lang.Comparable key, double value) Establece el valor de los datos para una clave y envía un DatasetChangeEvent a todos los oyentes registrados. |
| 2 | setValue(java.lang.Comparable key, java.lang.Number value) Establece el valor de los datos para una clave y envía un DatasetChangeEvent a todos los oyentes registrados. |
Clase SeriesException
Esta es una clase de excepción. Provoca una excepción que se produjo en la serie temporal de datos del conjunto de datos. Se plantean excepciones ante la aparición de datos duplicados o no válidos. La serie temporal no debe aplicarse con duplicados y el formato debe ser válido.
DefaultCategoryDataset
Esta es una clase de implementación predeterminada de la interfaz CategoryDataset.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | DefaultCategoryDataset() Este constructor crea un nuevo conjunto de datos vacío. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | addValue(double value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) Este método agrega un valor a la tabla usando claves comparables. |
| 2 | addValue(java.lang.Number value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) Este método agrega un valor a la tabla. |
| 3 | setValue(double value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) Este método agrega o actualiza un valor en la tabla y envía un DatasetChangeEvent a todos los oyentes registrados. |
| 4 | setValue(java.lang.Number value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) Este método agrega o actualiza un valor en la tabla y envía un DatasetChangeEvent a todos los oyentes registrados. |
Consulte la API de JFreeChart para obtener más información sobre otros métodos y campos.
Conjuntos de datos en serie
Los gráficos XY utilizan el conjunto de datos de la serie. El paquete esorg.Jfree.data.xy, que contiene clases e interfaces que pertenecen a gráficos xy. La interfaz principal es XYDataset.
XYDataset
Se trata de una interfaz a través de la cual se puede acceder a datos en forma de elementos (x, y). Como sugiere el nombre, puede usar este conjunto de datos para servir el gráfico XY. Algunos de los métodos de esta interfaz se toman de la interfaz SeriesDateset.
XYZDataset
Se trata de una interfaz a través de la cual se puede acceder a datos en forma de elementos (x, y, z). Como sugiere el nombre, puede usar este conjunto de datos para servir el gráfico XYZ. Algunos de los métodos de esta interfaz se toman de SeriesDateset.
XYSeries
Esta es una clase, que representa una secuencia de cero o más elementos de datos en la forma (x, y). De forma predeterminada, los elementos de la serie se clasifican en orden ascendente por valor de x, y se permiten valores de x duplicados. Tanto la clasificación como los valores por defecto duplicados se pueden cambiar en el constructor. Los valores Y se pueden denotar como nulos para representar los valores perdidos.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | XYSeries(java.lang.Comparable key) Este constructor crea una nueva serie vacía. |
| 2 | XYSeries(java.lang.Comparable key, boolean autoSort) Construye una nueva serie vacía, con la marca de clasificación automática establecida según lo solicitado, y se permiten valores duplicados. |
| 3 | XYSeries(java.lang.Comparable key, boolean autoSort, boolean allowDuplicateXValues) Construye una nueva serie xy que no contiene datos. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | add(double x, double y) Este método agrega elementos de datos a la serie. |
El método anterior se utiliza en el ejemplo del tutorial. Si desea conocer los métodos y campos restantes, consulte la API de JFreeChart.
XYSeriesCollection
La clase XYSeriesCollection tiene clases principales como AbstractIntervelDataset, AbstractXYDatset, AbstractSeriesDataset y AbstractDataset. Algunos de los métodos de esta clase pertenecen a clases principales de esta clase.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | XYSeriesCollection() Construye un conjunto de datos vacío. |
| 2 | XYSeriesCollection(XYSeries xyseries) Construye un conjunto de datos y lo completa con una sola serie. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | addSeries(XYSeries series) Este método agrega una serie a la colección y envía un DatasetChangeEvent a todos los oyentes registrados. |
Consulte la API de JFreeChart para conocer los métodos y campos restantes.
XYZDataset predeterminado
La clase DefaultXYZDataset tiene clases principales como AbstractIntervelDataset, AbstractXYDatset, AbstractSeriesDataset, AbstractDataset y AbstractXYZDataset. Algunos de los métodos de esta clase pertenecen a clases principales de esta clase.
constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | DefaultXYZDataset() Construye un conjunto de datos vacío. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | addSeries(java.lang.Comparable seriesKey, double[ ][ ] data ) Este método agrega una serie a la colección y envía un DatasetChangeEvent a todos los oyentes registrados. |
Consulte la API de JFreeChart para conocer los métodos y campos restantes.
Series temporales en JFreeCharts
El paquete es org.jfree.data.time. Este paquete contiene clases e interfaces, que se utilizan para los datos relacionados con el tiempo.
Series de tiempo
Esta clase representa una secuencia de elementos de datos en forma de valores de período, donde período es una instancia de la clase abstracta RegularTimePeriod, como las clases Hora, Día, Hora, Minuto y Segundo.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | TimeSeries(java.lang.Comparable name) Crea nuevas series vacías. |
| 2 | TimeSeries(java.lang.Comarable name, java.lang.String domain, java.lang.Strin range) Crea nuevas series de tiempo que no contienen datos. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | add(RegularTimePeriod period,double value) Este método agrega un nuevo elemento de datos a la serie. |
Consulte la API de JFreeChart para conocer los métodos y campos restantes.
TimeSeriesCollection
Esta es una clase que se utiliza como colección de objetos de series de tiempo. Esta clase implementa la interfaz XYDataset, así como extiende la interfaz IntervelXYDataset. Esto hace que sea conveniente recopilar objetos de datos en serie.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | TimeSeriesCollection() Construye un conjunto de datos vacío, vinculado a la zona horaria predeterminada. |
| 2 | TimeSeriesCollection(TimeSeries serie) Construye un conjunto de datos que contiene una sola serie (se pueden agregar más), vinculado a la zona horaria predeterminada. |
| 3 | TimeSeriesCollection(TimeSeries series, java.util.TimeZone zone) Construye un conjunto de datos que contiene una sola serie (se pueden agregar más), vinculado a una zona horaria específica. |
| 4 | TimeSeriesCollection(zona java.util.TimeZone) Construye un conjunto de datos vacío, vinculado a una zona horaria específica. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | addSeries(TimeSeries serie) Este método agrega una serie a la colección y envía un DatasetChangeEvent a todos los oyentes registrados. |
Consulte la API de JFreeChart para conocer los métodos y campos restantes.
Segundo
Esta clase representa un segundo en un día en particular. Esta clase es inmutable, lo cual es un requisito para todas las subclase RegularTimePeriod.
Constructor de clases
| S. No | Constructor y Descripción |
|---|---|
| 1 | Second() Construye un nuevo segundo, basado en la fecha / hora del sistema. |
| 2 | Second(java.util.Date time) Construye una nueva instancia a partir de la fecha / hora especificada y la zona horaria predeterminada. |
| 3 | Second(java.util.Date time, java.util.TimeZone zone, java.util.Locale locale) Crea un nuevo segundo basado en la hora y la zona horaria proporcionadas. |
| 4 | Second(int second, int minute, int hour, int day, int month, int year Crea un nuevo segundo. |
| 5 | Second(int second, Minute minute) Construye un nuevo Segundo. |
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | getSecond() Devuelve el segundo dentro del minuto. |
| 2 | next() Devuelve el segundo siguiente al segundo presente. |
Consulte la API de JFreeChart para conocer los métodos y campos restantes.
Marcos en JFreeCharts
El paquete es org.jfree.ui. Este es el paquete que pertenece a la API de JCommons de JFreeChart. Contiene clases de utilidad que se utilizan para crear marcos para gráficos preconfigurados.
ApplicationFrame
Esta es una clase base para crear el marco principal para aplicaciones simples. El marco escucha los eventos de cierre de ventanas y responde apagando la JVM. Esto está bien para aplicaciones de demostración pequeñas. Para las aplicaciones empresariales, necesita usar algo más sólido. Los métodos principales de esta clase se toman de las clases Component, Container, Window, Frame y Jframe.
Constructor de clases
| S. No | Constructor y descripción |
|---|---|
| 1 | ApplicationFrame(java.lang.String title) Crea un marco de aplicación con el título de la cadena. |
Esta clase ayuda a crear AWT Frames. Esta es la razón por la que usamos esta clase como superclase en los ejemplos de este tutorial.
Los métodos, que se toman de las clases principales, se utilizan para abrir un marco, cerrar un marco, cambiar el tamaño, cambiar el color de fondo o de primer plano y los oyentes.
RefineríaUtilidades
Ésta es una colección de clases de métodos de utilidad relacionados con la interfaz de usuario.
Método de clase
| S. No | Método y descripción |
|---|---|
| 1 | centerFrameOnScreen(java.awt.Window frame) Coloca el marco especificado en el medio de la pantalla. |
El método anterior se utiliza en el ejemplo del tutorial. Consulte la API de JFreeChart para conocer los métodos y campos restantes.