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

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上的标题.

条形图	static android.content.Intent	getBarChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer,BarChart.Type type)
条形图	static android.content.Intent	getBarChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer,BarChart.Type type, java.lang.String activityTitle)
条形图	static GraphicalView	getBarChartView(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer,BarChart.Type type)
气泡图	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 GraphicalView	getBubbleChartView(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer)
组合图	static android.content.Intent	getCombinedXYChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, java.lang.String[] types, java.lang.String activityTitle)
组合图	static GraphicalView	getCombinedXYChartView(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, java.lang.String[] types)
立方折线图	static GraphicalView	getCubeLineChartView(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, float smoothness)
立方折线图	static android.content.Intent	getCubicLineChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, 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(android.content.Context context,CategorySeries dataset, DialRenderer renderer, java.lang.String activityTitle)
拨号盘	static GraphicalView	getDialChartView(android.content.Context context, CategorySeries dataset,DialRenderer renderer)
圆环图	static android.content.Intent	getDoughnutChartIntent(android.content.Context context,MultipleCategorySeries dataset, DefaultRenderer renderer, java.lang.String activityTitle)
圆环图	static GraphicalView	getDoughnutChartView(android.content.Context context,MultipleCategorySeries dataset, DefaultRenderer renderer)
圆环图	static android.content.Intent	getLineChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer)
折线图	static android.content.Intent	getLineChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, java.lang.String activityTitle)
折线图	static GraphicalView	getLineChartView(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer)
饼图	static android.content.Intent	getPieChartIntent(android.content.Context context, CategorySeries dataset,DefaultRenderer renderer, java.lang.String activityTitle)
饼图	static GraphicalView	getPieChartView(android.content.Context context, CategorySeries dataset,DefaultRenderer renderer)
范围条形图	static android.content.Intent	getRangeBarChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer,BarChart.Type type, java.lang.String activityTitle)
范围条形图	static GraphicalView	getRangeBarChartView(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer,BarChart.Type type)
散点图	static android.content.Intent	getScatterChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer)
散点图	static android.content.Intent	getScatterChartIntent(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, java.lang.String activityTitle)
散点图	static GraphicalView	getScatterChartView(android.content.Context context,XYMultipleSeriesDataset dataset, 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, XYMultipleSeriesRenderer renderer, java.lang.String format, java.lang.String activityTitle)
时间图	static GraphicalView	getTimeChartView(android.content.Context context,XYMultipleSeriesDataset dataset, XYMultipleSeriesRenderer renderer, java.lang.String format)

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