安卓图表引擎AChartEngine(二) - 示例源码概述和分析

首先看一下示例中类之间的关系:

1.ChartDemo这个类是整个应用程序的入口,运行之后的效果显示一个list.

2.IDemoChart接口,这个接口定义了三个方法,

getName()返回值是listitem上显示的标题;

getDesc()返回值是listitem上显示的描述内容.

excute(context)返回值是一个Intent,当点击listitem后跳转到此Intent.

3.AbstractDemoChart类是一个抽象类,实现接口IDemoChart接口,这个类中封装了构建DataSet和renderer的方法,目的快速构建我们的dataset和renderer.这个类具体提供了哪些方法呢?见下图.至于为什么要进行这样的封装看完4中ChartFactory.get***Intent()方法的参数类型后您就明白了.

AbstractChartDemo.java:

package org.achartengine.chartdemo.demo.chart;

import java.util.Date;
import java.util.List;

import org.achartengine.chart.PointStyle;
import org.achartengine.model.CategorySeries;
import org.achartengine.model.MultipleCategorySeries;
import org.achartengine.model.TimeSeries;
import org.achartengine.model.XYMultipleSeriesDataset;
import org.achartengine.model.XYSeries;
import org.achartengine.renderer.DefaultRenderer;
import org.achartengine.renderer.SimpleSeriesRenderer;
import org.achartengine.renderer.XYMultipleSeriesRenderer;
import org.achartengine.renderer.XYSeriesRenderer;

public abstract class AbstractDemoChart implements IDemoChart {

  /**
   * 构建 XYMultipleSeriesDataset.
   * 
   * @param titles 每个序列的图例
   * @param xValues X轴的坐标
   * @param yValues Y轴的坐标
   * @return XYMultipleSeriesDataset
   */
  protected XYMultipleSeriesDataset buildDataset(String[] titles, List<double[]> xValues,
      List<double[]> yValues) {
    XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();
    addXYSeries(dataset, titles, xValues, yValues, 0);
    return dataset;
  }
  
  //向DataSet中添加序列.
  public void addXYSeries(XYMultipleSeriesDataset dataset, String[] titles, List<double[]> xValues,
      List<double[]> yValues, int scale) {
    int length = titles.length;
    for (int i = 0; i < length; i++) {
      XYSeries series = new XYSeries(titles[i], scale); //这里注意与TimeSeries区别.
      double[] xV = xValues.get(i);
      double[] yV = yValues.get(i);
      int seriesLength = xV.length;
      for (int k = 0; k < seriesLength; k++) {
        series.add(xV[k], yV[k]);
      }
      dataset.addSeries(series);
    }
  }

  /**
   * 构建XYMultipleSeriesRenderer.
   * 
   * @param colors 每个序列的颜色
   * @param styles 每个序列点的类型(可设置三角,圆点,菱形,方块等多种)
   * @return XYMultipleSeriesRenderer
   */
  protected XYMultipleSeriesRenderer buildRenderer(int[] colors, PointStyle[] styles) {
    XYMultipleSeriesRenderer renderer = new XYMultipleSeriesRenderer();
    setRenderer(renderer, colors, styles);
    return renderer;
  }

  protected void setRenderer(XYMultipleSeriesRenderer renderer, int[] colors, PointStyle[] styles) {
    //整个图表属性设置
	//-->start
	renderer.setAxisTitleTextSize(16);//设置轴标题文字的大小
    renderer.setChartTitleTextSize(40);//设置整个图表标题文字的大小
    renderer.setLabelsTextSize(15);//设置轴刻度文字的大小
    renderer.setLegendTextSize(15);//设置图例文字大小
    renderer.setPointSize(5f);//设置点的大小(图上显示的点的大小和图例中点的大小都会被设置)
    renderer.setMargins(new int[] { 20, 30, 15, 20 });//设置图表的外边框(上/左/下/右)
    //-->end
    
    //以下代码设置没个序列的颜色.
    //-->start
    int length = colors.length;
    for (int i = 0; i < length; i++) {
      XYSeriesRenderer r = new XYSeriesRenderer();
      r.setColor(colors[i]);//设置颜色
      r.setPointStyle(styles[i]);
      renderer.addSeriesRenderer(r);
    }
    //-->end
  }

  /**
   * 设置renderer的一些属性.
   * 
   * @param renderer 要设置的renderer
   * @param title 图表标题
   * @param xTitle X轴标题
   * @param yTitle Y轴标题
   * @param xMin X轴最小值
   * @param xMax X轴最大值
   * @param yMin Y轴最小值
   * @param yMax Y轴最大值
   * @param axesColor X轴颜色
   * @param labelsColor Y轴颜色
   */
  protected void setChartSettings(XYMultipleSeriesRenderer renderer, String title, String xTitle,
      String yTitle, double xMin, double xMax, double yMin, double yMax, int axesColor,
      int labelsColor) {
    renderer.setChartTitle(title);
    renderer.setXTitle(xTitle);
    renderer.setYTitle(yTitle);
    renderer.setXAxisMin(xMin);
    renderer.setXAxisMax(xMax);
    renderer.setYAxisMin(yMin);
    renderer.setYAxisMax(yMax);
    renderer.setAxesColor(axesColor);
    renderer.setLabelsColor(labelsColor);
  }

  /**
   * 构建和时间有关的XYMultipleSeriesDataset,这个方法与buildDataset在参数上区别是需要List<Date[]>作参数.
   * 
   * @param titles 序列图例
   * @param xValues X轴值
   * @param yValues Y轴值
   * @return XYMultipleSeriesDataset
   */
  protected XYMultipleSeriesDataset buildDateDataset(String[] titles, List<Date[]> xValues,
      List<double[]> yValues) {
    XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();
    int length = titles.length;
    for (int i = 0; i < length; i++) {
      TimeSeries series = new TimeSeries(titles[i]);//构建时间序列TimeSeries,
      Date[] xV = xValues.get(i);
      double[] yV = yValues.get(i);
      int seriesLength = xV.length;
      for (int k = 0; k < seriesLength; k++) {
        series.add(xV[k], yV[k]);
      }
      dataset.addSeries(series);
    }
    return dataset;
  }

  /**
   * 构建单个CategorySeries,可用于生成饼图,注意与buildMultipleCategoryDataset(构建圆环图)相区别.
   * 
   * @param titles the series titles
   * @param values the values
   * @return the category series
   */
  protected CategorySeries buildCategoryDataset(String title, double[] values) {
    CategorySeries series = new CategorySeries(title);
    int k = 0;
    for (double value : values) {
      series.add("Project " + ++k, value);
    }

    return series;
  }

  /**
   * 构建MultipleCategorySeries,可用于构建圆环图(每个环是一个序列)
   * 
   * @param titles the series titles
   * @param values the values
   * @return the category series
   */
  protected MultipleCategorySeries buildMultipleCategoryDataset(String title,
      List<String[]> titles, List<double[]> values) {
    MultipleCategorySeries series = new MultipleCategorySeries(title);
    int k = 0;
    for (double[] value : values) {
      series.add(2007 + k + "", titles.get(k), value);
      k++;
    }
    return series;
  }

  /**
   * 构建DefaultRenderer.
   * 
   * @param colors 每个序列的颜色
   * @return DefaultRenderer
   */
  protected DefaultRenderer buildCategoryRenderer(int[] colors) {
    DefaultRenderer renderer = new DefaultRenderer();
    renderer.setLabelsTextSize(15);
    renderer.setLegendTextSize(15);
    renderer.setMargins(new int[] { 20, 30, 15, 0 });
    for (int color : colors) {
      SimpleSeriesRenderer r = new SimpleSeriesRenderer();
      r.setColor(color);
      renderer.addSeriesRenderer(r);
    }
    return renderer;
  }

  /**
   * 构建XYMultipleSeriesDataset,适用于柱状图.
   * 
   * @param titles 每中柱子序列的图列
   * @param values 柱子的高度值
   * @return XYMultipleSeriesDataset
   */
  protected XYMultipleSeriesDataset buildBarDataset(String[] titles, List<double[]> values) {
    XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();
    int length = titles.length;
    for (int i = 0; i < length; i++) {
      CategorySeries series = new CategorySeries(titles[i]);
      double[] v = values.get(i);
      int seriesLength = v.length;
      for (int k = 0; k < seriesLength; k++) {
        series.add(v[k]);
      }
      dataset.addSeries(series.toXYSeries());
    }
    return dataset;
  }

  /**
   * 构建XYMultipleSeriesRenderer,适用于柱状图.
   * 
   * @param colors 每个序列的颜色
   * @return XYMultipleSeriesRenderer
   */
  protected XYMultipleSeriesRenderer buildBarRenderer(int[] colors) {
    XYMultipleSeriesRenderer renderer = new XYMultipleSeriesRenderer();
    renderer.setAxisTitleTextSize(16);
    renderer.setChartTitleTextSize(20);
    renderer.setLabelsTextSize(15);
    renderer.setLegendTextSize(15);
    int length = colors.length;
    for (int i = 0; i < length; i++) {
      SimpleSeriesRenderer r = new SimpleSeriesRenderer();
      r.setColor(colors[i]);
      renderer.addSeriesRenderer(r);
    }
    return renderer;
  }

}

4. 其他的以*Chat结尾的类大都继承自AbstractDemoChart这个类实现了接口IDemoChart.我们可以重点看一下execute(context)方法,分析之后发现这个方法中构建Intent的步骤大同小异,第一步构建dataset,第二步构建renderer,第三步调用ChartFactory.get***Intent()方法或ChartFactory.get***View()方法,二者的区别在于一个返回Intent,这个intent可以启动一个特定的activity,另一个返回GraphicalView,对这个GraphicalView可以灵活设置也可以仅作为一部分显示在任何activity上.对于ChartFactory.get***Intent()上的参数activityTitle是指设置显示在activity上的标题.

条形图	staticandroid.content.Intent	getBarChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer,BarChart.Typetype)
条形图	staticandroid.content.Intent	getBarChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer,BarChart.Typetype, java.lang.StringactivityTitle)
条形图	staticGraphicalView	getBarChartView(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer,BarChart.Typetype)
气泡图	staticandroid.content.Intent	getBubbleChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer)
气泡图	staticandroid.content.Intent	getBubbleChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer, java.lang.StringactivityTitle)
气泡图	staticGraphicalView	getBubbleChartView(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer)
组合图	staticandroid.content.Intent	getCombinedXYChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer, java.lang.String[]types, java.lang.StringactivityTitle)
组合图	staticGraphicalView	getCombinedXYChartView(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer, java.lang.String[]types)
立方折线图	staticGraphicalView	getCubeLineChartView(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer, floatsmoothness)
立方折线图	staticandroid.content.Intent	getCubicLineChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer, floatsmoothness)
立方折线图	staticandroid.content.Intent	getCubicLineChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer, floatsmoothness, java.lang.StringactivityTitle)
拨号盘	staticandroid.content.Intent	getDialChartIntent(android.content.Contextcontext,CategorySeriesdataset,DialRendererrenderer, java.lang.StringactivityTitle)
拨号盘	staticGraphicalView	getDialChartView(android.content.Contextcontext,CategorySeriesdataset,DialRendererrenderer)
圆环图	staticandroid.content.Intent	getDoughnutChartIntent(android.content.Contextcontext,MultipleCategorySeriesdataset,DefaultRendererrenderer, java.lang.StringactivityTitle)
圆环图	staticGraphicalView	getDoughnutChartView(android.content.Contextcontext,MultipleCategorySeriesdataset,DefaultRendererrenderer)
圆环图	staticandroid.content.Intent	getLineChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer)
折线图	staticandroid.content.Intent	getLineChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer, java.lang.StringactivityTitle)
折线图	staticGraphicalView	getLineChartView(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer)
饼图	staticandroid.content.Intent	getPieChartIntent(android.content.Contextcontext,CategorySeriesdataset,DefaultRendererrenderer, java.lang.StringactivityTitle)
饼图	staticGraphicalView	getPieChartView(android.content.Contextcontext,CategorySeriesdataset,DefaultRendererrenderer)
范围条形图	staticandroid.content.Intent	getRangeBarChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer,BarChart.Typetype, java.lang.StringactivityTitle)
范围条形图	staticGraphicalView	getRangeBarChartView(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer,BarChart.Typetype)
散点图	staticandroid.content.Intent	getScatterChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer)
散点图	staticandroid.content.Intent	getScatterChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer, java.lang.StringactivityTitle)
散点图	staticGraphicalView	getScatterChartView(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer)
时间图	staticandroid.content.Intent	getTimeChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer, java.lang.Stringformat)
时间图	staticandroid.content.Intent	getTimeChartIntent(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer, java.lang.Stringformat, java.lang.StringactivityTitle)
时间图	staticGraphicalView	getTimeChartView(android.content.Contextcontext,XYMultipleSeriesDatasetdataset,XYMultipleSeriesRendererrenderer, java.lang.Stringformat)

安卓图表引擎AChartEngine(一) -简介

http://blog.csdn.net/lk_blog/article/details/7645509

安卓图表引擎AChartEngine(二) -示例源码概述和分析

http://blog.csdn.net/lk_blog/article/details/7642751

安卓图表引擎AChartEngine(三) -示例源码折线图、饼图和柱状图

http://blog.csdn.net/lk_blog/article/details/7645668

安卓图表引擎AChartEngine(四) -源码示例嵌入Acitivity中的折线图

http://blog.csdn.net/lk_blog/article/details/7645665

安卓图表引擎AChartEngine(五) -Render和Dataset参数介绍

http://blog.csdn.net/lk_blog/article/details/7645661

安卓图表引擎AChartEngine(六) -框架源码结构图

http://blog.csdn.net/lk_blog/article/details/7645671