OpenHandX-Chart 1.0
2010-2-7
作者:彭明華
本文檔中的任何部分都不得以任何手段任何形式進行復(fù)制與傳播
目錄
1 前言
OpenHandx-chart核心采用了jfreechart,并集成了jfreechart的主要功能。雖然jfreechart的功能很強大,但使用起來也非常復(fù)雜。OpenHandx-chart目的有3個,第一是簡化jfreechart使用、第二是增加圖表工具的數(shù)據(jù)加工處理功能、第三是為OpenHandx平臺提供圖表處理能力。
OpenHandx-chart能生成的圖表有AreaChart(區(qū)域圖)、BarChart(柱狀圖)、DialChart(儀表圖)、LineChart(折線圖)、PieChart(餅圖)、PolarChart(雷達圖)、RingChart(環(huán)狀圖)、ScatterChart(點圖)、WaterfallChart(瀑布圖)。
2 需求
OpenHandx-chart 1.0需要:
l Java 5
l jfreechart-1.0.13
l open-common
l commons-beanutils-1.7
l commons-logging-1.0.4
3 名次解釋
l 交叉表數(shù)據(jù):分析型數(shù)據(jù)庫星型(雪花型)結(jié)構(gòu)的數(shù)據(jù)
如數(shù)據(jù)有3個維度:城市編號、品種編號、月份編號
2個度量值公斤、總金額
4列來自事實表的字段城市、品種、單價
城市編號 |
城市 |
品種編號 |
品種 |
單價 |
月份編號 |
月份 |
公斤 |
總金額 |
1 |
北京 |
1 |
白菜 |
1.60 |
1 |
1月 |
1,069.00 |
1,710.40 |
1 |
北京 |
1 |
白菜 |
1.60 |
2 |
2月 |
891.00 |
1,425.60 |
1 |
北京 |
1 |
白菜 |
1.60 |
11 |
11月 |
1,407.00 |
2,251.20 |
1 |
北京 |
1 |
白菜 |
1.60 |
12 |
12月 |
674.00 |
1,078.40 |
1 |
北京 |
2 |
青椒 |
4.00 |
1 |
1月 |
1,321.00 |
5,284.00 |
1 |
北京 |
7 |
橙子 |
5.00 |
8 |
8月 |
1,312.00 |
6,560.00 |
1 |
北京 |
7 |
橙子 |
5.00 |
9 |
9月 |
1,012.00 |
5,060.00 |
1 |
北京 |
7 |
橙子 |
5.00 |
10 |
10月 |
689.00 |
3,445.00 |
1 |
北京 |
7 |
橙子 |
5.00 |
11 |
11月 |
660.00 |
3,300.00 |
1 |
北京 |
7 |
橙子 |
5.00 |
12 |
12月 |
599.00 |
2,995.00 |
2 |
石家莊 |
1 |
白菜 |
1.60 |
1 |
1月 |
1,124.00 |
1,798.40 |
2 |
石家莊 |
1 |
白菜 |
1.60 |
2 |
2月 |
3,447.00 |
5,515.20 |
2 |
石家莊 |
1 |
白菜 |
1.60 |
8 |
8月 |
2,901.00 |
4,641.60 |
2 |
石家莊 |
2 |
青椒 |
4.00 |
8 |
8月 |
2,145.00 |
8,580.00 |
2 |
石家莊 |
2 |
青椒 |
4.00 |
9 |
9月 |
2,538.00 |
10,152.00 |
2 |
石家莊 |
2 |
青椒 |
4.00 |
10 |
10月 |
1,346.00 |
5,384.00 |
2 |
石家莊 |
2 |
青椒 |
4.00 |
11 |
11月 |
1,543.00 |
6,172.00 |
2 |
石家莊 |
2 |
青椒 |
4.00 |
12 |
12月 |
687.00 |
2,748.00 |
2 |
石家莊 |
3 |
土豆 |
2.00 |
1 |
1月 |
869.00 |
1,738.00 |
2 |
石家莊 |
3 |
土豆 |
2.00 |
2 |
2月 |
1,345.00 |
2,690.00 |
2 |
石家莊 |
3 |
土豆 |
2.00 |
3 |
3月 |
1,101.00 |
2,202.00 |
2 |
石家莊 |
3 |
土豆 |
2.00 |
4 |
4月 |
2,738.00 |
5,476.00 |
2 |
石家莊 |
3 |
土豆 |
2.00 |
5 |
5月 |
2,185.00 |
4,370.00 |
2 |
石家莊 |
4 |
芹菜 |
3.00 |
1 |
1月 |
902.00 |
2,706.00 |
2 |
石家莊 |
4 |
芹菜 |
3.00 |
2 |
2月 |
1,027.00 |
3,081.00 |
2 |
石家莊 |
4 |
芹菜 |
3.00 |
3 |
3月 |
1,444.00 |
4,332.00 |
2 |
石家莊 |
4 |
芹菜 |
3.00 |
4 |
4月 |
976.00 |
2,928.00 |
2 |
石家莊 |
4 |
芹菜 |
3.00 |
5 |
5月 |
953.00 |
2,859.00 |
… |
… |
… |
… |
… |
… |
… |
… |
… |
l 列表(多維度)數(shù)據(jù):關(guān)系型數(shù)據(jù)庫的列表數(shù)據(jù)
如數(shù)據(jù)有3個維度:城市編號、品種編號、月份編號
n個值字段:1月售量、2月售量、3月售量、xxx售量
4列來自關(guān)系表的字段:城市、品種
城市編號 |
城市 |
品種編號 |
品種 |
1月售量 |
2月售量 |
3月售量量 |
xxx售量 |
1 |
北京 |
1 |
白菜 |
1,069.00 |
2,502.00 |
1,019.00 |
… |
1 |
北京 |
1 |
白菜 |
891.00 |
2,861.00 |
819.00 |
… |
1 |
北京 |
1 |
白菜 |
1,407.00 |
3,162.00 |
1,834.00 |
… |
1 |
北京 |
1 |
白菜 |
674.00 |
1,096.00 |
533.00 |
… |
1 |
北京 |
2 |
青椒 |
1,321.00 |
1,683.00 |
1,926.00 |
… |
1 |
北京 |
7 |
橙子 |
1,312.00 |
3,308.00 |
1,227.00 |
… |
1 |
北京 |
7 |
橙子 |
1,012.00 |
962.00 |
1,467.00 |
… |
1 |
北京 |
7 |
橙子 |
689.00 |
1,407.00 |
1,918.00 |
… |
1 |
北京 |
7 |
橙子 |
660.00 |
674.00 |
877.00 |
… |
1 |
北京 |
7 |
橙子 |
599.00 |
1,321.00 |
1,097.00 |
… |
2 |
石家莊 |
1 |
白菜 |
1,124.00 |
3,347.00 |
1,994.00 |
… |
2 |
石家莊 |
1 |
白菜 |
3,447.00 |
2,772.00 |
991.00 |
… |
2 |
石家莊 |
1 |
白菜 |
2,901.00 |
2,346.00 |
1,153.00 |
… |
2 |
石家莊 |
2 |
青椒 |
2,145.00 |
3,446.00 |
856.00 |
… |
2 |
石家莊 |
2 |
青椒 |
2,538.00 |
3,229.00 |
1,089.00 |
… |
2 |
石家莊 |
2 |
青椒 |
1,346.00 |
1,614.00 |
953.00 |
… |
2 |
石家莊 |
2 |
青椒 |
1,543.00 |
2,650.00 |
1,284.00 |
… |
2 |
石家莊 |
2 |
青椒 |
687.00 |
2,090.00 |
1,233.00 |
… |
2 |
石家莊 |
3 |
土豆 |
869.00 |
2,045.00 |
1,169.00 |
… |
2 |
石家莊 |
3 |
土豆 |
1,345.00 |
2,290.00 |
1,186.00 |
… |
2 |
石家莊 |
3 |
土豆 |
1,101.00 |
2,389.00 |
1,435.00 |
… |
2 |
石家莊 |
3 |
土豆 |
2,738.00 |
1,009.00 |
1,300.00 |
… |
2 |
石家莊 |
3 |
土豆 |
2,185.00 |
826.00 |
773.00 |
… |
2 |
石家莊 |
4 |
芹菜 |
902.00 |
2,381.00 |
537.00 |
… |
2 |
石家莊 |
4 |
芹菜 |
1,027.00 |
1,931.00 |
803.00 |
… |
2 |
石家莊 |
4 |
芹菜 |
1,444.00 |
904.00 |
823.00 |
… |
2 |
石家莊 |
4 |
芹菜 |
976.00 |
1,084.00 |
3,350.00 |
… |
2 |
石家莊 |
4 |
芹菜 |
953.00 |
3,209.00 |
826.00 |
… |
4 圖表分類
OpenHandx-chart從數(shù)據(jù)的展現(xiàn)上分為3大類:第一類可以展示兩個維度,支持交叉表數(shù)據(jù)和列表多列數(shù)值的數(shù)據(jù),第二類可以展示一個維度的RingChart、WaterfallChart只能展示列表一個維度數(shù)據(jù),第三類DialChart(儀表圖)展示特殊數(shù)據(jù)。
4.1 兩個維度
支持此類的圖表有AreaChart(區(qū)域圖)、BarChart(柱狀圖)、LineChart(折線圖)、PieChart(餅圖)、PolarChart(雷達圖)、ScatterChart(點圖)。此類的圖都有相同的特點:橫坐標能表示一個維度,不同的分類(顏色)表示能另一個維度。
4.1.1 區(qū)域圖
4.1.2 柱狀圖
4.1.3 折線圖
4.1.4 餅圖
4.1.5 點圖
4.1.6 雷達圖
4.2 單維度
支持此類的圖表有RingChart(環(huán)狀圖)、WaterfallChart(瀑布圖),此類的圖都只能展示一個維度。
4.2.1 環(huán)狀圖
4.2.2 瀑布圖
4.3 特殊
支持此類的圖表有DialChart(儀表圖)。儀表圖里有最小值、最大值分別代表數(shù)值的下、上限,另外還有綠色、黃色、紅色分別代表安全、警戒、危險等狀況。指針代表當(dāng)前值,指針所處的刻度可以看出當(dāng)前值所處狀態(tài)。用此圖表可很好展現(xiàn)庫存、資金、降雨量、水位、溫度報警等。
5 使用和開發(fā)
OpenHandx-chart開發(fā)思路比較簡單,有以下步驟:
1、構(gòu)造圖表的配置
2、創(chuàng)建當(dāng)前的圖表實例
3、將圖表輸出到文件或輸出流中
5.1 圖表配置
圖表配置的類在open.chart.config下,通過構(gòu)造方法創(chuàng)建。配置類主要設(shè)置圖表的展示數(shù)據(jù)字段、標題、顏色、字體、是否堆積、是否3D、是否透明、是否縱坐標顯示、是否顯示值、數(shù)據(jù)加工中除法的精度等。具體設(shè)置參考Open-chart的javadoc配置類部分。
5.1.1 兩個維度配置
兩個維度的配置有AreaChart(區(qū)域圖)、BarChart(柱狀圖)、LineChart(折線圖)、PieChart(餅圖)、PolarChart(雷達圖)、ScatterChart(點圖)。指定需要值字段有3個方法:
1、設(shè)定圖表的度量值字段,如果setGroupField為空valueField可以設(shè)定多列,否則valueField只能設(shè)定一列
public void setValueField(List<ChartValueField> valueField)
2、設(shè)定圖表的列字段(橫坐標字段)
public void setListField(ChartCrossField listField)
3、設(shè)定圖表的分組字段(第二個維度字段)
public void setGroupField(ChartCrossField groupField)
5.1.2 單維度配置
單維度的配置有RingChart(環(huán)狀圖)、WaterfallChart(瀑布圖),此類的圖都只能展示一個維度。指定需要值字段有2個方法:
1、設(shè)定圖表的度量值字段
publicvoid setValueField(ChartValueField valueField)
2、設(shè)定圖表的維度字段
public void setListField(ChartCrossField listField)
5.1.3 特殊配置
此類表有DialChart(儀表圖)。
1、指定當(dāng)前值字段(指針)
publicvoid setValueField(ChartValueField valueField)
2、值定最小值字段(最小刻度)
publicvoid setMinField(ChartValueField minField)
3、值定最大值字段(最大刻度)
publicvoid setMaxField(ChartValueField maxField)
4、值定警告字段(黃色區(qū)域)
publicvoid setWarningField(ChartValueField warningField)
5、值定嚴重值字段(紅色區(qū)域)
publicvoid setGravenessField(ChartValueField gravenessField)
5.2 圖表實例
圖表實例類定義在open.chart.jfreechart,通過構(gòu)造方法創(chuàng)建。圖表實例處理圖表數(shù)據(jù)加工和圖表模型的構(gòu)建,構(gòu)造方法一般有3個參數(shù),第一參數(shù)設(shè)置圖表的配置、第二個參數(shù)為圖表明細數(shù)據(jù)、第三個參數(shù)為圖表標題數(shù)據(jù)。
如:
public OpenAreaChart(AreaChart config,IRecordSetVO rsvo,RecordVO rvo) throws ModelException
如果想了解圖表數(shù)據(jù)加工原理請參考javadoc的open.chart.calculate部分
IRecordSetVO和RecordVO的使用參考請參考OpenHandx的另一個開源項目open-common的javadoc
5.3 圖表輸出
圖表輸出在open.chart.jfreechart.ChartUtil類里,分別以文件或流的方式輸出,同時提供兩種文件格式JPG和PNG。其中文件方式用于文件歸檔或目標報表,流方式用于不落地的web頁面輸出或?qū)懭肫渌募髦小?/span>
5.4 例子
1、 明細數(shù)據(jù)
publicstatic IRecordSetVO getRecordSetVO() throws ModelException{ IRecordSetVO rsvo = new RecordSetVO(); rsvo.addField("area", DataType.STRING); rsvo.addField("category", DataType.STRING); rsvo.addField("number", DataType.INTEGER); rsvo.addField("number2", DataType.INTEGER);
RowVO rvo = new RowVO(rsvo); rvo.setValue("area", "北京"); rvo.setValue("category", "蘋果"); rvo.setValue("number", 672); rvo.setValue("number2", 1); rsvo.add(rvo); . . . . . . rvo = new RowVO(rsvo); rvo.setValue("area", "深圳"); rvo.setValue("category", "梨子"); rvo.setValue("number", 106); rvo.setValue("number2", 1); rsvo.add(rvo); rvo = new RowVO(rsvo); rvo.setValue("area", "深圳"); rvo.setValue("category", "葡萄"); rvo.setValue("number", 526); rvo.setValue("number2", 1); rsvo.add(rvo);
return rsvo; } |
2、標題數(shù)據(jù)
publicstatic RecordVO getRecordVO(){ RecordVO rvo = new RecordVO(); rvo.add("title", "CityInfoPort公司組織架構(gòu)圖"); rvo.add("valueAxisLabel", "數(shù)量"); rvo.add("categoryAxisLabel", "地區(qū)"); return rvo; } |
3、圖表配置
publicstatic BarChart getConfig(){ BarChart config = new BarChart(); ChartLabel label = new ChartLabel("_title_"); label = new ChartLabel("_valueAxisLabel_"); label.getFont().setColor(Font.COLOR_RED); config.setValueAxisLabel(label); label = new ChartLabel("_categoryAxisLabel_"); config.setGroupAxisLabel(label); List<ChartValueField> list = new ArrayList<ChartValueField>(); list.add(new ChartValueField("number2","number/sum_number")); config.setValueField(list); config.setListField(new ChartCrossField("area")); config.setGroupField(new ChartCrossField("category")); return config; } |
4、輸出圖表
publicstaticvoid main(String[] arg) throws IOException, ModelException{ ChartUtil.saveChartAsPNG("d:/1.png", new OpenBarChart(getConfig(),getRecordSetVO(),getRecordVO()),800,600); } |
下載地址:http://code.google.com/p/openhandx2/downloads/list