安卓圖表引擎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:

1. [size=3]package org.achartengine.chartdemo.demo.chart;  
   
2. 
   
3.     import java.util.Date;  [/size]      [size=3]
   
4.     import java.util.List;  
   
5. 
   
6.     import org.achartengine.chart.PointStyle;  [/size]      [size=3]
   
7.     import org.achartengine.model.CategorySeries;  
   
8.     import org.achartengine.model.MultipleCategorySeries;  
   
9.     import org.achartengine.model.TimeSeries;  
   
10.     import org.achartengine.model.XYMultipleSeriesDataset;  
    
11.     import org.achartengine.model.XYSeries;  
    
12.     import org.achartengine.renderer.DefaultRenderer;  
    
13.     import org.achartengine.renderer.SimpleSeriesRenderer;  
    
14.     import org.achartengine.renderer.XYMultipleSeriesRenderer;  
    
15.     import org.achartengine.renderer.XYSeriesRenderer;  
    
16. 
    
17.     public abstract class AbstractDemoChart implements IDemoChart {  [/size]      [size=3]
    
18. 
    
19.       /** [/size]      [size=3]
    
20.        * 構建 XYMultipleSeriesDataset.
    
21.        *  
    
22.        * @param titles 每個序列的圖例
    
23.        * @param xValues X軸的座標
    
24.        * @param yValues Y軸的座標
    
25.        * @return XYMultipleSeriesDataset
    
26.        */  
    
27.       protected XYMultipleSeriesDataset buildDataset(String[] titles, List<double[]> xValues,  
    
28.           List<double[]> yValues) {  
    
29.         XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();  
    
30.         addXYSeries(dataset, titles, xValues, yValues, 0);  
    
31.         return dataset;  
    
32.       }  
    
33. 
    
34.       //向DataSet中添加序列.  [/size]        [size=3]
    
35.       public void addXYSeries(XYMultipleSeriesDataset dataset, String[] titles, List<double[]> xValues,  
    
36.           List<double[]> yValues, int scale) {  
    
37.         int length = titles.length;  
    
38.         for (int i = 0; i < length; i++) {  
    
39.           XYSeries series = new XYSeries(titles[i], scale); //這裏注意與TimeSeries區別.  
    
40.           double[] xV = xValues.get(i);  
    
41.           double[] yV = yValues.get(i);  
    
42.           int seriesLength = xV.length;  
    
43.           for (int k = 0; k < seriesLength; k++) {  
    
44.             series.add(xV[k], yV[k]);  
    
45.           }  
    
46.           dataset.addSeries(series);  
    
47.         }  
    
48.       }  
    
49. 
    
50.       /** [/size]      [size=3]
    
51.        * 構建XYMultipleSeriesRenderer.
    
52.        *  
    
53.        * @param colors 每個序列的顏色
    
54.        * @param styles 每個序列點的類型(可設置三角,圓點,菱形,方塊等多種)
    
55.        * @return XYMultipleSeriesRenderer
    
56.        */  
    
57.       protected XYMultipleSeriesRenderer buildRenderer(int[] colors, PointStyle[] styles) {  
    
58.         XYMultipleSeriesRenderer renderer = new XYMultipleSeriesRenderer();  
    
59.         setRenderer(renderer, colors, styles);  
    
60.         return renderer;  
    
61.       }  
    
62. 
    
63.       protected void setRenderer(XYMultipleSeriesRenderer renderer, int[] colors, PointStyle[] styles) {  [/size]      [size=3]
    
64.         //整個圖表屬性設置  
    
65.         //-->start  
    
66.         renderer.setAxisTitleTextSize(16);//設置軸標題文字的大小  
    
67.         renderer.setChartTitleTextSize(40);//設置整個圖表標題文字的大小  
    
68.         renderer.setLabelsTextSize(15);//設置軸刻度文字的大小  
    
69.         renderer.setLegendTextSize(15);//設置圖例文字大小  
    
70.         renderer.setPointSize(5f);//設置點的大小(圖上顯示的點的大小和圖例中點的大小都會被設置)  
    
71.         renderer.setMargins(new int[] { 20, 30, 15, 20 });//設置圖表的外邊框(上/左/下/右)  
    
72.         //-->end  
    
73. 
    
74.         //以下代碼設置沒個序列的顏色.  [/size]          [size=3]
    
75.         //-->start  
    
76.         int length = colors.length;  
    
77.         for (int i = 0; i < length; i++) {  
    
78.           XYSeriesRenderer r = new XYSeriesRenderer();  
    
79.           r.setColor(colors[i]);//設置顏色  
    
80.           r.setPointStyle(styles[i]);  
    
81.           renderer.addSeriesRenderer(r);  
    
82.         }  
    
83.         //-->end  
    
84.       }  
    
85. 
    
86.       /** [/size]      [size=3]
    
87.        * 設置renderer的一些屬性.
    
88.        *  
    
89.        * @param renderer 要設置的renderer
    
90.        * @param title 圖表標題
    
91.        * @param xTitle X軸標題
    
92.        * @param yTitle Y軸標題
    
93.        * @param xMin X軸最小值
    
94.        * @param xMax X軸最大值
    
95.        * @param yMin Y軸最小值
    
96.        * @param yMax Y軸最大值
    
97.        * @param axesColor X軸顏色
    
98.        * @param labelsColor Y軸顏色
    
99.        */  
    
100.       protected void setChartSettings(XYMultipleSeriesRenderer renderer, String title, String xTitle,  
     
101.           String yTitle, double xMin, double xMax, double yMin, double yMax, int axesColor,  
     
102.           int labelsColor) {  
     
103.         renderer.setChartTitle(title);  
     
104.         renderer.setXTitle(xTitle);  
     
105.         renderer.setYTitle(yTitle);  
     
106.         renderer.setXAxisMin(xMin);  
     
107.         renderer.setXAxisMax(xMax);  
     
108.         renderer.setYAxisMin(yMin);  
     
109.         renderer.setYAxisMax(yMax);  
     
110.         renderer.setAxesColor(axesColor);  
     
111.         renderer.setLabelsColor(labelsColor);  
     
112.       }  
     
113. 
     
114.       /** [/size]      [size=3]
     
115.        * 構建和時間有關的XYMultipleSeriesDataset,這個方法與buildDataset在參數上區別是需要List<Date[]>作參數.
     
116.        *  
     
117.        * @param titles 序列圖例
     
118.        * @param xValues X軸值
     
119.        * @param yValues Y軸值
     
120.        * @return XYMultipleSeriesDataset
     
121.        */  
     
122.       protected XYMultipleSeriesDataset buildDateDataset(String[] titles, List<Date[]> xValues,  
     
123.           List<double[]> yValues) {  
     
124.         XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();  
     
125.         int length = titles.length;  
     
126.         for (int i = 0; i < length; i++) {  
     
127.           TimeSeries series = new TimeSeries(titles[i]);//構建時間序列TimeSeries,  
     
128.           Date[] xV = xValues.get(i);  
     
129.           double[] yV = yValues.get(i);  
     
130.           int seriesLength = xV.length;  
     
131.           for (int k = 0; k < seriesLength; k++) {  
     
132.             series.add(xV[k], yV[k]);  
     
133.           }  
     
134.           dataset.addSeries(series);  
     
135.         }  
     
136.         return dataset;  
     
137.       }  
     
138. 
     
139.       /** [/size]      [size=3]
     
140.        * 構建單個CategorySeries,可用於生成餅圖,注意與buildMultipleCategoryDataset(構建圓環圖)相區別.
     
141.        *  
     
142.        * @param titles the series titles
     
143.        * @param values the values
     
144.        * @return the category series
     
145.        */  
     
146.       protected CategorySeries buildCategoryDataset(String title, double[] values) {  
     
147.         CategorySeries series = new CategorySeries(title);  
     
148.         int k = 0;  
     
149.         for (double value : values) {  
     
150.           series.add("Project " + ++k, value);  
     
151.         }  
     
152. 
     
153.         return series;  [/size]      [size=3]
     
154.       }  
     
155. 
     
156.       /** [/size]      [size=3]
     
157.        * 構建MultipleCategorySeries,可用於構建圓環圖(每個環是一個序列)
     
158.        *  
     
159.        * @param titles the series titles
     
160.        * @param values the values
     
161.        * @return the category series
     
162.        */  
     
163.       protected MultipleCategorySeries buildMultipleCategoryDataset(String title,  
     
164.           List<String[]> titles, List<double[]> values) {  
     
165.         MultipleCategorySeries series = new MultipleCategorySeries(title);  
     
166.         int k = 0;  
     
167.         for (double[] value : values) {  
     
168.           series.add(2007 + k + "", titles.get(k), value);  
     
169.           k++;  
     
170.         }  
     
171.         return series;  
     
172.       }  
     
173. 
     
174.       /** [/size]      [size=3]
     
175.        * 構建DefaultRenderer.
     
176.        *  
     
177.        * @param colors 每個序列的顏色
     
178.        * @return DefaultRenderer
     
179.        */  
     
180.       protected DefaultRenderer buildCategoryRenderer(int[] colors) {  
     
181.         DefaultRenderer renderer = new DefaultRenderer();  
     
182.         renderer.setLabelsTextSize(15);  
     
183.         renderer.setLegendTextSize(15);  
     
184.         renderer.setMargins(new int[] { 20, 30, 15, 0 });  
     
185.         for (int color : colors) {  
     
186.           SimpleSeriesRenderer r = new SimpleSeriesRenderer();  
     
187.           r.setColor(color);  
     
188.           renderer.addSeriesRenderer(r);  
     
189.         }  
     
190.         return renderer;  
     
191.       }  
     
192. 
     
193.       /** [/size]      [size=3]
     
194.        * 構建XYMultipleSeriesDataset,適用於柱狀圖.
     
195.        *  
     
196.        * @param titles 每中柱子序列的圖列
     
197.        * @param values 柱子的高度值
     
198.        * @return XYMultipleSeriesDataset
     
199.        */  
     
200.       protected XYMultipleSeriesDataset buildBarDataset(String[] titles, List<double[]> values) {  
     
201.         XYMultipleSeriesDataset dataset = new XYMultipleSeriesDataset();  
     
202.         int length = titles.length;  
     
203.         for (int i = 0; i < length; i++) {  
     
204.           CategorySeries series = new CategorySeries(titles[i]);  
     
205.           double[] v = values.get(i);  
     
206.           int seriesLength = v.length;  
     
207.           for (int k = 0; k < seriesLength; k++) {  
     
208.             series.add(v[k]);  
     
209.           }  
     
210.           dataset.addSeries(series.toXYSeries());  
     
211.         }  
     
212.         return dataset;  
     
213.       }  
     
214. 
     
215.       /** [/size]      [size=3]
     
216.        * 構建XYMultipleSeriesRenderer,適用於柱狀圖.
     
217.        *  
     
218.        * @param colors 每個序列的顏色
     
219.        * @return XYMultipleSeriesRenderer
     
220.        */  
     
221.       protected XYMultipleSeriesRenderer buildBarRenderer(int[] colors) {  
     
222.         XYMultipleSeriesRenderer renderer = new XYMultipleSeriesRenderer();  
     
223.         renderer.setAxisTitleTextSize(16);  
     
224.         renderer.setChartTitleTextSize(20);  
     
225.         renderer.setLabelsTextSize(15);  
     
226.         renderer.setLegendTextSize(15);  
     
227.         int length = colors.length;  
     
228.         for (int i = 0; i < length; i++) {  
     
229.           SimpleSeriesRenderer r = new SimpleSeriesRenderer();  
     
230.           r.setColor(colors[i]);  
     
231.           renderer.addSeriesRenderer(r);  
     
232.         }  
     
233.         return renderer;  
     
234.       }  
     
235. 
     
236.     }  [/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)