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

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,另一个返回,对这个可以灵活设置也可以仅作为一部分显示在任何activity上.对于ChartFactory.get***Intent()上的参数activityTitle是指设置显示在activity上的标题.

 

条形图	static android.content.Intent	getBarChartIntent(android.content.Context context, dataset,  renderer, type)
条形图	static android.content.Intent	getBarChartIntent(android.content.Context context, dataset,  renderer, type, java.lang.String activityTitle)
条形图	static	getBarChartView(android.content.Context context, dataset,  renderer, type)
气泡图	static android.content.Intent	getBubbleChartIntent(android.content.Context context, dataset,  renderer)
气泡图	static android.content.Intent	getBubbleChartIntent(android.content.Context context, dataset,  renderer, java.lang.String activityTitle)
气泡图	static	getBubbleChartView(android.content.Context context, dataset,  renderer)
组合图	static android.content.Intent	getCombinedXYChartIntent(android.content.Context context, dataset,  renderer, java.lang.String[] types, java.lang.String activityTitle)
组合图	static	getCombinedXYChartView(android.content.Context context, dataset,  renderer, java.lang.String[] types)
立方折线图	static	getCubeLineChartView(android.content.Context context, dataset,  renderer, float smoothness)
立方折线图	static android.content.Intent	getCubicLineChartIntent(android.content.Context context, dataset,  renderer, float smoothness)
立方折线图	static android.content.Intent	getCubicLineChartIntent(android.content.Context context, dataset,  renderer, float smoothness, java.lang.String activityTitle)
拨号盘	static android.content.Intent	getDialChartIntent(android.content.Context context, dataset,  renderer, java.lang.String activityTitle)
拨号盘	static	getDialChartView(android.content.Context context,  dataset, renderer)
圆环图	static android.content.Intent	getDoughnutChartIntent(android.content.Context context, dataset,  renderer, java.lang.String activityTitle)
圆环图	static	getDoughnutChartView(android.content.Context context, dataset,  renderer)
圆环图	static android.content.Intent	getLineChartIntent(android.content.Context context, dataset,  renderer)
折线图	static android.content.Intent	getLineChartIntent(android.content.Context context, dataset,  renderer, java.lang.String activityTitle)
折线图	static	getLineChartView(android.content.Context context, dataset,  renderer)
饼图	static android.content.Intent	getPieChartIntent(android.content.Context context,  dataset, renderer, java.lang.String activityTitle)
饼图	static	getPieChartView(android.content.Context context,  dataset, renderer)
范围条形图	static android.content.Intent	getRangeBarChartIntent(android.content.Context context, dataset,  renderer, type, java.lang.String activityTitle)
范围条形图	static	getRangeBarChartView(android.content.Context context, dataset,  renderer, type)
散点图	static android.content.Intent	getScatterChartIntent(android.content.Context context, dataset,  renderer)
散点图	static android.content.Intent	getScatterChartIntent(android.content.Context context, dataset,  renderer, java.lang.String activityTitle)
散点图	static	getScatterChartView(android.content.Context context, dataset,  renderer)
时间图	static android.content.Intent	getTimeChartIntent(android.content.Context context, dataset,  renderer, java.lang.String format)
时间图	static android.content.Intent	getTimeChartIntent(android.content.Context context, dataset,  renderer, java.lang.String format, java.lang.String activityTitle)
时间图	static	getTimeChartView(android.content.Context context, dataset,  renderer, java.lang.String format)

 

 

 

 

 

 

 

 

 

参数介绍