JFreeChart - APIs referenciadas
Neste capítulo, discutiremos sobre alguns dos pacotes, classes e métodos importantes da biblioteca JFreeChart. Esses pacotes, classes e métodos são os mais frequentemente usados ao criar uma variedade de gráficos usando a biblioteca JFreeChart.
Classe ChartFactory
ChartFactory é uma classe abstrata sob o org.jfree.chartpacote. Ele fornece uma coleção de métodos utilitários para gerar gráficos padrão.
A seguir está uma lista de alguns dos métodos importantes -
Construtor de classe
| S.No | Descrição |
|---|---|
| 1 | ChartFactory() Construtor padrão da classe ChartFactory. |
Métodos de aula
| S.No | Métodos e Descrição |
|---|---|
| 1 | createPieChart(java.lang.String title, PieDataset dataset, boolean legend, boolean tooltips, boolean urls) Este método cria um gráfico de pizza com configurações padrão. Ele retorna o objeto do tipo JfreeChart. |
| 2 | createPieChart3D(java.lang.String title, PieDataset dataset, boolean legend, boolean tooltips, boolean urls Este método cria um gráfico de pizza 3D usando o conjunto de dados 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) O argumento java.lang.String categoryAxisLabel é o rótulo para valores colocados no eixo X. O argumento java.lang.String valueAxisLabel é o rótulo para valores colocados no eixo Y. Este método cria um 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 cria um gráfico de barras com efeito 3D. Ele retorna o objeto do 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 cria um gráfico de linha com configurações padrão. |
| 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 cria um gráfico de linha com efeito 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 cria um gráfico de linha baseado em XYDataset com configurações padrão. |
Classe ChartFrame
A classe ChartFrame do pacote org.jfree.chart fornece todas as funções e utilitários relacionados a quadros. A classe ChartFrame herda funcionalidades das classes pai, como as classes Frame, Window, Container e Component.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | ChartFrame (java.lang.Frame String, JfreeChart chart) Ele constrói uma moldura. |
| 2 | Chart Frame (java.lang.Frame String, JfreeChart chart, boolean scrollpane) Ele constrói uma moldura. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | getChartPanel() Este método retorna o painel do gráfico para um quadro. |
Classe ChartPanel
Classe ChartPanel da org.jfree.chart pacote é usado como um componente de GUI swing para exibir o objeto JfreeChart.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | ChartPanel(JFreeChart chart) Este construtor constrói um painel que exibe o gráfico especificado. |
| 2 | ChartPanel(JFreeChart chart, boolean useBuffer) Este construtor constrói um painel contendo um gráfico. |
| 3 | ChartPanel(JFreeChart chart, boolean properties, boolean save, boolean print, boolean zoom, boolean tooltips) Este construtor constrói um painel JFreeChart. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | setPreferredSize(java.awt.Dimension) Este método é usado para definir o tamanho do quadro usando java.awt. Objeto de classe de dimensão como um argumento. Este método é obtido de javax.swing.JComponent. |
Classe ChartUtilities
Classe CharUtilites da org.jfree.chart O pacote fornece uma coleção de métodos utilitários de JFreeCharts, incluindo métodos para converter gráficos em formato de arquivo de imagem como PNG, JPEG e criar mapas de imagem HTML.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | ChartUtilities() Este é um construtor padrão de uma classe |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | saveChartAsPNG(java.io.File file, JfreeChart chart, int width, int height) Este método converte e salva um gráfico no arquivo especificado no formato PNG. |
| 2 | saveChartAsJPEG(java.io.File file, JfreeChart chart, int width, int height) Este método converte e salva um gráfico no arquivo especificado no formato JPEG. |
Classe JFreeChart
A classe JFreeChart é a classe principal sob o org.jfree.chartpacote. Esta classe fornece o método JFreeChart para criar gráficos de barras, gráficos de linhas, gráficos de pizza e gráficos xy incluindo dados de série temporal.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | JfreeChart(Plot plot) Este construtor cria um novo gráfico com base no gráfico fornecido. |
| 2 | JfreeChart(java.lang.String title, java.awt.Font titleFont, Plot plot, boolean createLegend) Este construtor cria um novo gráfico com o título e gráfico fornecidos. |
| 3 | JfreeChart(java.lang.String title, Plot plot) Este construtor cria um novo gráfico com o título e gráfico fornecidos. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | getXYPlot() Este método retorna o gráfico de plotagem como XYPlot. Usando o XYPolt, podemos fazer algumas operações de utilidade em gráficos xy. |
Classe PiePlot
Esta aula faz parte de org.jfree.chart.plotempacota e estende a classe Plot do mesmo pacote. Esta classe fornece métodos para criar gráficos de pizza.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | PiePlot() Ele cria um novo enredo. |
| 2 | PiePlot(PieDataset dataset) Ele cria um gráfico que desenha um gráfico de pizza para o conjunto de dados especificado. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | setStartAngle(double angle) Este método define o ângulo inicial e envia um PlotChangeEvent para todos os ouvintes registrados |
Classe PiePlot3D
A classe PiePlot3D é uma subclasse da classe PiePlot no mesmo pacote. Portanto, essa classe tem os mesmos recursos da classe PiePlot, exceto que é usada para criar plotagens 3D.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | PiePlot3D() Este construtor cria uma nova instância sem conjunto de dados. |
| 2 | PiePlot3D(PieDataset dataset) Este construtor cria um gráfico de pizza com efeito tridimensional usando um conjunto de dados especificado. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | setForegroundAlpha(float alpha) Ele define a transparência alfa para o gráfico e envia um PlotChangeEvent para todos os ouvintes registrados. Isso é obtido de uma das classes pai de Plot. |
| 2 | setInteriorGap(double percent) Ele define a lacuna interna e envia um PlotChangeEvent para todos os ouvintes registrados. Isso controla o espaço entre as bordas do gráfico de pizza e a própria área do gráfico (ou seja, a região onde os rótulos de seção aparecem). Este método é obtido da classe pai PiePlot. |
Classe PlotOrientation
Esta é uma classe serializada disponível em org.jfree.chart.plotpacote e é usado para mostrar a orientação de um gráfico 2D. A orientação pode servertical ou horizontal. Ele define a orientação do eixo Y. Um gráfico convencional possui um eixo Y vertical.
Resumo do campo
| S.No | Tipo | Campo e Descrição |
|---|---|---|
| 1 | PlotOrientation | HORIZONTAL Para um gráfico onde o eixo do intervalo (eixo Y) é horizontal. |
| 2 | PlotOrientation | VERTICALPara um gráfico onde o eixo do intervalo (eixo Y) é vertical. Esta é a orientação padrão. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | isHorizontal() Este método retorna verdadeiro se a orientação for HORIZONTAL e falso caso contrário. |
| 2 | isVertical() Este método retorna verdadeiro se esta orientação for VERTICAL e falso caso contrário. |
Classe XYPlot
Esta é uma aula geral disponível em org.jfree.chart.plotpacote e é usado para os dados de plotagem na forma de pares (x, y). Este gráfico pode usar dados de qualquer outra classe que implemente a interface XYDataSet. O XYPlot usa um XYItemRenderer para desenhar cada ponto no gráfico.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | XYPlot() Este contratante cria uma nova instância XYPlot sem conjunto de dados, sem eixos e sem renderizador. |
| 2 | XYPlot(XYDataset dataset, ValueAxis domainAxis, ValueAxis rangeAxis, XYItemRenderer renderizador) Este construtor cria um novo gráfico com o conjunto de dados, eixo e renderizador especificados. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | setRenderer(XYItemRenderer renderizador) Este método define o renderizador para o conjunto de dados primário e envia um evento de mudança para todos os ouvintes registrados. |
Classe NumberAxis
Esta aula está disponível em org.jfree.chart.axispacote e pode acessar os dados numéricos de qualquer eixo. Quando definimos o intervalo de qualquer eixo como padrão, ele se ajusta de acordo com o intervalo dos dados. Mas usando NumberAxis, classe, podemos definir a margem inferior e a margem superior dos eixos de domínio e intervalo.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | NumberAxis( ) Este é um construtor padrão de NumberAxis. |
| 2 | NumberAxis( java.lang.String label) O construtor NumberAxis usa valores padrão quando necessário. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | setLowerMargin(double margin) Ele define a margem inferior do eixo (como uma porcentagem do intervalo do eixo) e envia um AxisChangeEventa todos os ouvintes registrados. Este método é obtido da classe pai da classe ValueAxis. |
| 2 | setUpperMargin(double margin) Ele define a margem superior do eixo (como uma porcentagem do intervalo do eixo) e envia um AxisChangeEventa todos os ouvintes registrados. Este método também está presente na classe ValueAxis. |
Classe XYLineAndShapeRenderer
Esta é a aula, disponível em org.jfree.chart.renderer.xypacote, que se encarrega de conectar os pontos de dados com linhas e desenha formas em cada ponto de dados. Esta classe de renderizador é projetada para uso com oXYPlot classe.
Construtor de classe
| S.No | Construtor e descrição |
|---|---|
| 1 | XYLineAndShapeRenderer() Ele cria um novo renderizador com linhas e formas visíveis. |
| 2 | XYLineAndShapeRenderer (linhas booleanas, formas booleanas) Ele cria um novo renderizador com propriedade específica. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | setSeriesPaint(int series, java.awt.Paint paint) Este método define a tinta usada para uma série e envia um RendererChangeEventa todos os ouvintes registrados. Este método é obtido da classe abstrata AbstratRenderer do pacote renderizador na API JFreeChart. |
| 2 | setSeriesStroke(int series, java.awt.Stroke stroke) Este método define o traço usado para uma série e envia um RendererChangeEventa todos os ouvintes registrados. Este método é obtido da classe abstrata AbstratRenderer, que é a superclasse deste pacote. |
Conjuntos de dados gerais XYItemRenderer
Esta é uma interface para renderizar o formato de um único item (x, y) em um XYPlot. O pacote éorg.Jfree.data.general, que tem classes e interfaces para definir diferentes tipos de conjuntos de dados para construir gráficos.
PieDataset
Esta é uma interface usada como um conjunto de dados de propósito geral, onde os valores são associados a chaves. Como o nome sugere, você pode usar este conjunto de dados para fornecer dados para gráficos de pizza. Essa interface estende as interfaces KeyedValues e DataSet. Todos os métodos usados para esta interface são retirados das interfaces KeyedValues, Values e Dataset.
Classe DefaultPieDataset
Esta é uma classe de implementação padrão de uma interface PieDataset.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | DefaultPieDataset() Este construtor cria um novo conjunto de dados, inicialmente vazio. |
| 2 | DefaultPieDataset(KeyedValues data) Ele cria um novo conjunto de dados, copiando dados de um KeyedValues instância. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | setValue(java.lang.Comparable key, double value) Ele define o valor dos dados para uma chave e envia um DatasetChangeEvent a todos os ouvintes registrados. |
| 2 | setValue(java.lang.Comparable key, java.lang.Number value) Ele define o valor dos dados para uma chave e envia um DatasetChangeEvent a todos os ouvintes registrados. |
Classe SeriesException
Esta é uma classe de exceção. Ele levanta uma exceção ocorrida na série temporal de dados no conjunto de dados. Exceções são levantadas na ocorrência de dados duplicados ou inválidos. A série temporal não deve ser aplicada com duplicatas e o formato deve ser válido.
DefaultCategoryDataset
Esta é uma classe de implementação padrão da interface CategoryDataset.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | DefaultCategoryDataset() Este construtor cria um novo conjunto de dados vazio. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | addValue(double value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) Este método adiciona um valor à tabela usando chaves comparáveis. |
| 2 | addValue(java.lang.Number value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) Este método adiciona um valor à tabela. |
| 3 | setValue(double value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) Este método adiciona ou atualiza um valor na tabela e envia um DatasetChangeEvent a todos os ouvintes registrados. |
| 4 | setValue(java.lang.Number value, java.lang.Comparable rowKey, java.lang.Comparable columnKey) Este método adiciona ou atualiza um valor na tabela e envia um DatasetChangeEvent a todos os ouvintes registrados. |
Consulte a API JFreeChart para obter mais informações sobre vários outros métodos e campos.
Conjuntos de dados da série
O conjunto de dados da série é usado por gráficos XY. O pacote éorg.Jfree.data.xy, que contém classes e interfaces pertencentes a gráficos xy. A interface principal é XYDataset.
XYDataset
Esta é uma interface através da qual os dados na forma de itens (x, y) podem ser acessados. Como o nome sugere, você pode usar este conjunto de dados para servir o gráfico XY. Alguns dos métodos nesta interface são retirados da interface SeriesDateset.
XYZDataset
Esta é uma interface por meio da qual os dados na forma de itens (x, y, z) podem ser acessados. Como o nome sugere, você pode usar este conjunto de dados para servir o gráfico XYZ. Alguns dos métodos nesta interface são retirados de SeriesDateset.
Série X
Esta é uma classe, que representa uma sequência de zero ou mais itens de dados no formulário (x, y). Por padrão, os itens da série são classificados em ordem crescente por valor x, e valores x duplicados são permitidos. Os padrões de classificação e duplicados podem ser alterados no construtor. Os valores Y podem ser denotados como nulos para representar os valores ausentes.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | XYSeries(java.lang.Comparable key) Este construtor cria uma nova série vazia. |
| 2 | XYSeries(java.lang.Comparable key, boolean autoSort) Ele constrói uma nova série vazia, com o sinalizador de classificação automática definido conforme solicitado, e valores duplicados são permitidos. |
| 3 | XYSeries(java.lang.Comparable key, boolean autoSort, boolean allowDuplicateXValues) Ele constrói uma nova série xy que não contém dados. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | add(double x, double y) Este método adiciona itens de dados à série. |
O método acima é usado no exemplo do tutorial. Se você quiser aprender os métodos e campos restantes, consulte a API JFreeChart.
XYSeriesCollection
A classe XYSeriesCollection tem classes pai como AbstractIntervelDataset, AbstractXYDatset, AbstractSeriesDataset e AbstractDataset. Alguns dos métodos desta classe pertencem às classes pai desta classe.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | XYSeriesCollection() Ele constrói um conjunto de dados vazio. |
| 2 | XYSeriesCollection(XYSeries xyseries) Ele constrói um conjunto de dados e o preenche com uma única série. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | addSeries(XYSeries series) Este método adiciona uma série à coleção e envia um DatasetChangeEvent a todos os ouvintes registrados. |
Consulte a API JFreeChart para os métodos e campos restantes.
XYZDataset padrão
A classe DefaultXYZDataset tem classes-pai como AbstractIntervelDataset, AbstractXYDatset, AbstractSeriesDataset, AbstractDataset e AbstractXYZDataset. Alguns dos métodos desta classe pertencem às classes pai desta classe.
construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | DefaultXYZDataset() Ele constrói um conjunto de dados vazio. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | addSeries(java.lang.Comparable seriesKey, double[ ][ ] data ) Este método adiciona uma série à coleção e envia um DatasetChangeEvent a todos os ouvintes registrados. |
Consulte a API JFreeChart para os métodos e campos restantes.
Séries temporais em JFreeCharts
O pacote é org.jfree.data.time. Este pacote contém classes e interfaces, que são usadas para os dados relacionados ao tempo.
TimeSeries
Essa classe representa uma sequência de itens de dados na forma de valores de período, onde período é alguma instância da classe abstrata RegularTimePeriod, como as classes Time, Day, Hour, Minute e Second.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | TimeSeries(java.lang.Comparable name) Ele cria novas séries vazias. |
| 2 | TimeSeries(java.lang.Comarable name, java.lang.String domain, java.lang.Strin range) Ele cria uma nova série temporal que não contém dados. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | add(RegularTimePeriod period,double value) Este método adiciona um novo item de dados à série. |
Consulte a API JFreeChart para os métodos e campos restantes.
TimeSeriesCollection
Esta é uma classe usada como uma coleção de objetos de série temporal. Esta classe implementa a interface XYDataset, bem como estende a interface IntervelXYDataset. Isso torna conveniente coletar objetos de dados de série.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | TimeSeriesCollection() Ele constrói um conjunto de dados vazio, vinculado ao fuso horário padrão. |
| 2 | TimeSeriesCollection(TimeSeries Series) Ele constrói um conjunto de dados contendo uma única série (mais podem ser adicionadas), vinculado ao fuso horário padrão. |
| 3 | TimeSeriesCollection(TimeSeries série, zona java.util.TimeZone) Ele constrói um conjunto de dados contendo uma única série (mais podem ser adicionadas), vinculado a um fuso horário específico. |
| 4 | TimeSeriesCollection(zona java.util.TimeZone) Ele constrói um conjunto de dados vazio, vinculado a um fuso horário específico. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | addSeries(TimeSeries Series) Este método adiciona uma série à coleção e envia um DatasetChangeEvent a todos os ouvintes registrados. |
Consulte a API JFreeChart para os métodos e campos restantes.
Segundo
Esta classe representa um segundo em um determinado dia. Essa classe é imutável, o que é um requisito para todas as subclasses RegularTimePeriod.
Construtor de classe
| S.No | Construtor e Descrição |
|---|---|
| 1 | Second() Ele constrói um novo segundo, com base na data / hora do sistema. |
| 2 | Second(java.util.Date time) Ele constrói uma nova instância a partir da data / hora especificada e do fuso horário padrão. |
| 3 | Second(java.util.Date time, java.util.TimeZone zone, java.util.Locale locale) Ele cria um novo segundo com base no horário e fuso horário fornecidos. |
| 4 | Second(int second, int minute, int hour, int day, int month, int year Isso cria um novo segundo. |
| 5 | Second(int second, Minute minute) Ele constrói um novo Segundo. |
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | getSecond() Ele retorna o segundo dentro do minuto. |
| 2 | next() Ele retorna o segundo após o segundo presente. |
Consulte a API JFreeChart para os métodos e campos restantes.
Quadros em JFreeCharts
O pacote é org.jfree.ui. Este é o pacote que pertence à API JCommons de JFreeChart. Ele contém classes utilitárias usadas para criar quadros para gráficos pré-configurados.
ApplicationFrame
Esta é uma classe base para criar o quadro principal para aplicativos simples. O quadro escuta eventos de fechamento de janela e responde desligando a JVM. Isso é bom para pequenos aplicativos de demonstração. Para aplicativos corporativos, você precisa usar algo mais robusto. Os principais métodos básicos desta classe são obtidos das classes Component, Container, Window, Frame e Jframe.
Construtor de classe
| S.No | Construtor e descrição |
|---|---|
| 1 | ApplicationFrame(java.lang.String title) Ele cria um quadro de aplicativo com o título da string. |
Esta classe ajuda a criar quadros AWT. Esta é a razão pela qual usamos esta classe como superclasse nos exemplos deste tutorial.
Os métodos, que são obtidos das classes pai, são usados para abrir um quadro, fechar um quadro, mudar o tamanho, mudar a cor do fundo ou do primeiro plano e ouvintes.
RefineryUtilities
Esta é uma coleção de classes de métodos utilitários relacionados à interface do usuário.
Método de Classe
| S.No | Método e Descrição |
|---|---|
| 1 | centerFrameOnScreen(java.awt.Window frame) Ele posiciona o quadro especificado no meio da tela. |
O método acima é usado no exemplo do tutorial. Consulte a API JFreeChart para os métodos e campos restantes.