安卓图表引擎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: [size=3]package org.achartengine.chartdemo.demo.chart;       import java.util.Date;  [/size]      [size=3]     import java.util.List;       import org.achartengine.chart.PointStyle;  [/size]      [size=3]     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 {  [/size]      [size=3]       /** [/size]      [size=3]        * 构建 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中添加序列.  [/size]        [size=3]       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);           }         }         /** [/size]      [size=3]        * 构建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) {  [/size]      [size=3]         //整个图表属性设置           //-->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           //以下代码设置没个序列的颜色.  [/size]          [size=3]         //-->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         }         /** [/size]      [size=3]        * 设置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);         }         /** [/size]      [size=3]        * 构建和时间有关的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;         }         /** [/size]      [size=3]        * 构建单个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;  [/size]      [size=3]       }         /** [/size]      [size=3]        * 构建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;         }         /** [/size]      [size=3]        * 构建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;         }         /** [/size]      [size=3]        * 构建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;         }         /** [/size]      [size=3]        * 构建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;         }       }  [/size]       复制代码 4.  其他的以*Chat结尾的类大都继承自AbstractDemoChart这个类实现了接口IDemoChart.我们可以重点看一下execute(context)方法,分析之后发现这个方法中构建Intent的步骤大同小异,第一步构建dataset,第二步构建renderer,第三步调用ChartFactory.get***Intent()方法或ChartFactory.get***View()方法,二者的区别在于一个返回Intent,这个intent可以启动一个特定的activity,另一个返回[url=]GraphicalView[/url],对这个[url=]GraphicalView[/url]可以灵活设置也可以仅作为一部分显示在任何activity上.对于ChartFactory.get***Intent()上的参数activityTitle是指设置显示在activity上的标题. 条形图 static android.content.Intent getBarChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer,[url=]BarChart.Type type) 条形图 static android.content.Intent getBarChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer,BarChart.Type type, java.lang.String activityTitle) 条形图 static [url=]GraphicalView[/url] getBarChartView(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer,BarChart.Typetype) 气泡图 static android.content.Intent getBubbleChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer) 气泡图 static android.content.Intent getBubbleChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, java.lang.String activityTitle) 气泡图 static [url=]GraphicalView[/url] getBubbleChartView(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRendererrenderer) 组合图 static android.content.Intent getCombinedXYChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, java.lang.String[] types, java.lang.String activityTitle) 组合图 static [url=]GraphicalView[/url] getCombinedXYChartView(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, java.lang.String[] types) 立方折线图 static [url=]GraphicalView[/url] getCubeLineChartView(android.content.Context context,XYMultipleSeriesDatasetdataset, XYMultipleSeriesRendererrenderer, float smoothness) 立方折线图 static android.content.Intent getCubicLineChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRendererrenderer, float smoothness) 立方折线图 static android.content.Intent getCubicLineChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, float smoothness, java.lang.String activityTitle) 拨号盘 static android.content.Intent getDialChartIntent[/url](android.content.Context context,[url=]CategorySeries[/url] dataset, [url=]DialRenderer renderer, java.lang.String activityTitle) 拨号盘 static [url=]GraphicalView[/url] getDialChartView(android.content.Context context, CategorySeries dataset,DialRenderer renderer) 圆环图 static android.content.Intent [url=]getDoughnutChartIntent[/url](android.content.Context context,[url=]MultipleCategorySeries[/url] dataset, [url=]DefaultRenderer[/url] renderer, java.lang.String activityTitle) 圆环图 static [url=]GraphicalView[/url] [url=]getDoughnutChartView[/url](android.content.Context context,[url=]MultipleCategorySeries[/url] dataset, [url=]DefaultRenderer[/url] renderer) 圆环图 static android.content.Intent [url=]getLineChartIntent[/url](android.content.Context context,[url=]XYMultipleSeriesDataset[/url] dataset, [url=]XYMultipleSeriesRenderer[/url] renderer) 折线图 static android.content.Intent [url=]getLineChartIntent[/url](android.content.Context context,[url=]XYMultipleSeriesDataset[/url] dataset, [url=]XYMultipleSeriesRenderer[/url] renderer, java.lang.String activityTitle) 折线图 static [url=]GraphicalView[/url] [url=]getLineChartView[/url](android.content.Context context,[url=]XYMultipleSeriesDataset[/url] dataset, [url=]XYMultipleSeriesRenderer[/url] renderer) 饼图 static android.content.Intent [url=]getPieChartIntent[/url](android.content.Context context, [url=]CategorySeries[/url] dataset,[url=]DefaultRenderer[/url] renderer, java.lang.String activityTitle) 饼图 static [url=]GraphicalView[/url] [url=]getPieChartView[/url](android.content.Context context, [url=]CategorySeries[/url] dataset,[url=]DefaultRenderer[/url] renderer) 范围条形图 static android.content.Intent [url=]getRangeBarChartIntent[/url](android.content.Context context,[url=]XYMultipleSeriesDataset[/url] dataset, [url=]XYMultipleSeriesRenderer[/url] renderer,[url=]BarChart.Type[/url] type, java.lang.String activityTitle) 范围条形图 static [url=]GraphicalView[/url] [url=]getRangeBarChartView[/url](android.content.Context context,[url=]XYMultipleSeriesDataset[/url] dataset, [url=]XYMultipleSeriesRenderer[/url] renderer,[url=]BarChart.Type[/url] type) 散点图 static android.content.Intent [url=]getScatterChartIntent[/url](android.content.Context context,[url=]XYMultipleSeriesDataset[/url] dataset, [url=]XYMultipleSeriesRenderer[/url] renderer) 散点图 static android.content.Intent [url=]getScatterChartIntent[/url](android.content.Context context,[url=]XYMultipleSeriesDataset[/url] dataset, [url=]XYMultipleSeriesRenderer[/url] renderer, java.lang.String activityTitle) 散点图 static [url=]GraphicalView[/url] getScatterChartView[/url](android.content.Context context,XYMultipleSeriesDatasetdataset, XYMultipleSeriesRenderer renderer) 时间图 static android.content.Intent getTimeChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, java.lang.String format) 时间图 static android.content.Intent getTimeChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRendererrenderer, java.lang.String format, java.lang.String activityTitle) 时间图 static [url=]GraphicalView[/url] getTimeChartView(android.content.Context context,XYMultipleSeriesDatasetdataset, XYMultipleSeriesRenderer renderer, java.lang.String format)