jfreechart報表圖表使用詳細(xì)教程

1、 動態(tài)圖表JFreeChart1頁簡介 JFreeChart是Java中開源的制圖組件，主要用于生成各種動態(tài)圖表。在Java的圖形報表技術(shù)中，JFreeChart組件提供了方便、快捷、靈活的制圖方法。 作為一個功能強(qiáng)大的圖形報表組件，JFreeChart為Java的圖形報表技術(shù)提供了解決方案。在Java項目的應(yīng)用中，JFreeChart組件幾乎可以滿足目前圖形報表的所有需求。 JFreeChart組件可以生成各種各樣的圖形報表，如常用的柱形圖、區(qū)域圖、餅形圖、折線圖、時序圖、甘特圖等；而對于同一種類型的圖表，JFreeChart組件還提供了不同的表現(xiàn)方式。 2頁JFreeChart的下載與使用

2、 JFreeChart是開放源代碼的圖形報表組件（開源站點 上的一個Jave項目），其主頁為 。在主頁中單擊DOWNLOAD導(dǎo)航鏈接將進(jìn)入下載頁面，選擇所要下載的JfreeChart版本即可進(jìn)行下載，目前最新版本為1.0.13。在下載成功后將得到一個名為jfreechart-1.0.13.zip的壓縮包，此壓縮包包含JFreeChart組件源碼、示例、支持類庫等文件，將其解壓縮后的文件結(jié)構(gòu)如右圖所示。 3頁其中jfreechart-1.0.13-demo.jar 文件為JFreeChart組件提供的演示文件，運(yùn)行此文件將可以看到利用JFreeChart組件制作的各種圖表的樣式及效果；sourc

3、e文件夾為JFreeChart的源代碼文件夾，在此文件夾中可以查看到JFreeChart組件的源代碼；lib文件夾為JFreeChart的支持類庫。 3頁常見統(tǒng)計圖介紹柱狀圖：也稱條圖、長條圖、條狀圖，是一種以長方形的長度為變量的表達(dá)圖形的統(tǒng)計報告圖，由一系列高度不等的縱向條紋表示數(shù)據(jù)分布的情況，用來比較兩個或以上的價值（不同時間或者不同條件），只有一個變量，通常利用于較小的數(shù)據(jù)集分析。柱狀圖圖亦可橫向排列，或用多維方式表達(dá)。 4頁餅形圖：一個劃分為幾個扇區(qū)的圓形圖表，用于描述量、頻率或百分比之間的相對關(guān)系。在餅圖中，每個扇區(qū)的弧長（以及（圓心角）和面積）大小為其所表示的數(shù)量的比例。這些扇區(qū)合

4、在一起剛好是一個完全的圓形。顧名思義，這些扇區(qū)拼成了一個切開的餅形圖案。 5頁折線圖：是用一個單位長度表示一定的數(shù)量，根據(jù)數(shù)量的多少描出各點，然后把各點用線段順次連接起來，以折線的上升或下降來表示統(tǒng)計數(shù)量增減變化。折線統(tǒng)計圖不但可以表示出數(shù)量的多少，而且還能夠清楚的表示出數(shù)量增減變化的情況。 6頁JFreeChart開發(fā)前準(zhǔn)備開發(fā)前的準(zhǔn)備，JfreeChart開發(fā)環(huán)境的搭建分為兩步：導(dǎo)入JFreeChart組件包；配置JFreeChart。 1、導(dǎo)入JFreeChart包：導(dǎo)入在lib目錄下的jfreechart-1.0.13.jar、 mon-1.0.16.jar兩個Jar包到工程。 2、配

5、置JFreeChart： JFreeChart組件能夠成.JPEG、.PNG格式的圖片，其輸出方式可以直接存儲在硬盤中，也可以交給JFreeChart組件進(jìn)行管理。在Web應(yīng)用中，所生成的圖形報表一般均為動態(tài)圖表，如果對每次生成的圖表都進(jìn)行直接存儲，將 7頁會產(chǎn)生大量的垃圾文件，時間長了必須進(jìn)行清理。因此，由JFreeChart組件進(jìn)行管理來生成圖片是一個不錯的選擇，它不僅可以提供圖片的路徑，而且在查看圖片后JFreeChart組件會自動進(jìn)行清理。 JFreeChart組件提供了一個Servlet文件用于獲取生成的圖片，此Servlet文件存在于JFreeChart組件包中，所以在使用過程中，

6、需要將其配置到Web.xml文件中。其配置方法如下： 8頁JFreeChart開發(fā)流程JFreeChart分為三個步驟： 創(chuàng)建數(shù)據(jù)集：創(chuàng)建用來構(gòu)成JFreeChart圖表的數(shù)據(jù)，JFreeChart圖表顯示的數(shù)據(jù)都來源于數(shù)據(jù)集。創(chuàng)建JFreeChart對象：JFreeChart類是一個制圖對象，它代表著一種制圖類型，在制圖過程中，只有在創(chuàng)建制圖對象JFreeChart后，才可以生成實際的圖片。獲取圖片：獲取圖片，在web頁面顯示。 9頁創(chuàng)建數(shù)據(jù)集在JFreeChart組件的圖形報表技術(shù)應(yīng)用中，繪制一個圖表需要一定的數(shù)據(jù)，JFreeChart組件通過提供的數(shù)據(jù)進(jìn)行計算并繪制出圖表信息。由于在數(shù)據(jù)

7、的分析計算中并不是單一的數(shù)值，繪制圖表時就要為JFreeChart組件提供數(shù)據(jù)集合。數(shù)據(jù)集合對象是用于裝載繪制圖表所需要的數(shù)據(jù)集。在JFreeChart組件中，針對不同圖表類型提供了不同的數(shù)據(jù)集合對象，它們所具有的作用也是不同的。常用的數(shù)據(jù)集對象： DefaultCategoryDataset類：默認(rèn)的類別數(shù)據(jù)集合對象，可用于創(chuàng)建柱形圖、折線圖、區(qū)域圖數(shù)據(jù)集合等。 DefaultPieDataset類：默認(rèn)的餅形圖數(shù)據(jù)集合對象，可用于創(chuàng)建餅形圖數(shù)據(jù)集合。 10頁 如下圖所示方法，則創(chuàng)建了一個可用于繪制圖表的數(shù)據(jù)集對象。該數(shù)據(jù)集可以用來用來創(chuàng)建簡單的一維柱狀圖。不同的圖形采用的數(shù)據(jù)集對象不同，同

8、一數(shù)據(jù)集對象設(shè)置的數(shù)據(jù)不同，產(chǎn)生圖形數(shù)據(jù)也不同。所以數(shù)據(jù)集生產(chǎn)圖形內(nèi)容、形狀的關(guān)鍵。 11頁創(chuàng)建JFreeChart對象在生成圖形報表時，制圖對象JFreeChart是必不可少的對象，它可以直接通過new關(guān)鍵字進(jìn)行實例化，也可以通過制圖工廠ChartFactory類進(jìn)行實例化。當(dāng)使用new關(guān)鍵字進(jìn)行實例化時，需要設(shè)置大量的屬性信息，因為JFreeChart組件提供的圖表種類很多，對于每一種圖表都要進(jìn)行特殊的設(shè)置，非常繁瑣。因此在使用過程中，一般都使用制圖工廠ChartFactory類進(jìn)行創(chuàng)建。制圖工廠ChartFactory是一個抽象類，它不能被實例化，但提供了創(chuàng)建各種制圖對象的方法，如創(chuàng)建柱

9、形圖對象、區(qū)域圖對象、餅形圖對象、折線圖對象等方法，這些方法都是靜態(tài)的方法，可直接創(chuàng)建JFreeChart對象，并且是屬于某一種具體的圖表類型的JFreeChart對象，使用非常方便。 12頁ChartFactory常用方法及說明如下： 圖 表 類 型方 法說 明柱形圖public static JFreeChart createBarChart()創(chuàng)建一個常規(guī)的柱形圖對象public static JFreeChart createBarChart3D()創(chuàng)建一個3D效果的柱形圖對象餅形圖public static JFreeChart createPieChart()創(chuàng)建一個常規(guī)的餅形圖對

10、象public static JFreeChart createPieChart3D()創(chuàng)建一個3D效果的餅形圖對象折線圖public static JFreeChart createLineChart()創(chuàng)建一個常規(guī)的折線圖對象public static JFreeChart reateLineChart3D()創(chuàng)建一個3D效果的折線圖對象13頁如下圖所示方法，通過制圖工廠對象，創(chuàng)建了一個JFreeChart對象，其中createDataSet()方法返回數(shù)據(jù)集對象作為JFreeChart對象的數(shù)據(jù)來源。 14頁獲取圖片獲取圖片有兩種方式，第一種方式會在tomcat temp目錄生產(chǎn)圖片文件

11、，第二種方式采用輸出流的方式獲取圖片，不會產(chǎn)生垃圾文件。（1）在輸出圖片之前，首先要生成JFreeChart組件所繪制的圖片。此操作通過調(diào)用ServletUtilities類的saveChartAsJPEG()方法來實現(xiàn)，它返回一個.JPEG格式的圖片名稱。 15頁通過此方法生成圖片后，調(diào)用已注冊的JFreeChart提供的Servlet類DisplayChart，即可獲取圖片的相對路徑。輸出圖片在Jsp中的應(yīng)用關(guān)鍵代碼如下，可參照該代碼將其運(yùn)用到servlet或Struts2的Action中。 16頁（2）如下所示為采用輸出流方式輸出圖片在struts2中的應(yīng)用。調(diào)用ChartUtiliti

12、es的writeChartAsJPEG 方法則可直接將圖片輸出到頁面，而不用存儲在硬盤中。 17頁ChartUtilities的writeChartAsJPEG 方法介紹：如果想在Jsp頁面調(diào)用該圖片，把圖片的src請求路徑設(shè)置為產(chǎn)生輸出流的Action即可，例如： 18頁兩種圖片獲取方式分析通過對比，我們可發(fā)現(xiàn)，第一種圖片獲取方式是在Action中生成圖片到硬盤，在Action返回時通過給頁面?zhèn)鬟f該圖片的路徑來訪問圖片。這樣，在同一個顯示頁面，無論你有多少個圖片要顯示，都可以通過一個Action去生成多個圖片，傳遞其路徑來實現(xiàn)，圖片路徑只是Action傳遞的眾多參數(shù)中的普通一員。而且該Act

13、ion能配置返回值，所以該Action實際上就是我們的業(yè)務(wù)Action，用來實現(xiàn)跳轉(zhuǎn)。通過給該Action傳遞參數(shù)，處理數(shù)據(jù)，生成圖片，跳轉(zhuǎn)到頁面，流程清晰，也符合我們一貫的程序設(shè)計思維。我們再來看第二種圖片獲取方式。該方式?jīng)]有實際生成圖片，而是通過在Action中將圖片的數(shù)據(jù)流直接寫到頁面上。首 19頁先該Action不能擁有返回值，無法實現(xiàn)頁面跳轉(zhuǎn)，不能作為我們的業(yè)務(wù)Action。所以處理業(yè)務(wù)單元，我們還得有另外的業(yè)務(wù)Action。這樣就會出現(xiàn)兩個問題：一是參數(shù)的傳遞，比如在頁面我們有參數(shù)傳遞給業(yè)務(wù)Action，處理完業(yè)務(wù)，傳遞一些參數(shù)跳轉(zhuǎn)到頁面，但這時并沒有涉及到圖片的生成，圖片的生成是

14、在通過頁面中的img標(biāo)簽的src去請求額外的生成圖片的Action，通過數(shù)據(jù)流方式將圖片寫到頁面。這樣就還會涉及到用來處理圖片邏輯的參數(shù)的二次傳遞，顯然這種設(shè)計是比較雞肋的。二是當(dāng)一個業(yè)務(wù)單元中需要多個圖片，就得為每張圖片設(shè)計一個輸出圖片數(shù)據(jù)流的Action，顯然不可取。 20頁綜合分析：圖片輸出，我們采用第一種方式。但第一種方式時間久了，會產(chǎn)生大量的垃圾圖片文件。JFreeChart也考慮到了這一問題，為我們設(shè)計了一個監(jiān)聽器用來刪除垃圾圖片。該監(jiān)聽器的原理是：當(dāng)session失效時，則刪除由該session產(chǎn)生的圖片文件。監(jiān)聽器在web.xml中配置如下：Session失效并不是瀏覽器關(guān)閉時

15、，默認(rèn)時間是30分鐘，可以自己設(shè)置。 21頁至此，經(jīng)過以上三步，一個簡單統(tǒng)計圖就展現(xiàn)在頁面上了。通常情況下，為了使所生成的圖片更加美觀、大方，需要對所生成的圖片進(jìn)行一定的設(shè)置?？梢酝ㄟ^以下幾個對象對生成的圖片進(jìn)行設(shè)置。制圖工廠對象ChartFactory：該對象提供了一個對圖片主題進(jìn)行設(shè)置的方法。其中standardChartTheme為StandardChartTheme對象。制圖對象JFreeChart：通過該對象提供的方法可以對圖片標(biāo)題字體、背景圖片、背景顏色、邊框等進(jìn)行設(shè)置。JFreeChart類常用方法及說明如下表： 22頁坐標(biāo)軸對象。繪圖區(qū)對象。圖片渲染對象。 方 法說 明publ

16、ic void setAntiAlias(boolean flag)設(shè)置字體模糊邊界public void setBackgroundImage(Image image)設(shè)置背景圖片public void setBackgroundImageAlignment(int alignment)設(shè)置背景圖片對齊方式，其參數(shù)常量定義在org.jfree.ui.Align類中public void setBackgroundImageAlpha(float alpha)設(shè)置背景圖片透明度public void setBackgroundPaint(Paint paint)設(shè)置背景顏色public voi

17、d setBorderPaint(Paint paint)設(shè)置邊界線條顏色public void setBorderVisible(boolean visible)設(shè)置邊界線條是否可見23頁坐標(biāo)軸對象在JFreeChart組件中涉及到坐標(biāo)軸類型的圖表時，其樣式與屬性由坐標(biāo)軸對象Axis類進(jìn)行控制。此類是坐標(biāo)軸對象的父類，其常用方法及說明如下表所示： 方 法說 明public void setVisible(boolean flag)設(shè)置坐標(biāo)軸是否可見public void setAxisLinePaint(Paint paint)設(shè)置坐標(biāo)軸線條顏色，此設(shè)置在3D效果下無效public void

18、 setAxisLineVisible(boolean visible)設(shè)置坐標(biāo)軸線條是否可見public void setLabel(String label)設(shè)置坐標(biāo)軸標(biāo)題public void setLabelFont(Font font)設(shè)置坐標(biāo)軸標(biāo)題字體public void setLabelPaint(Paint paint)設(shè)置坐標(biāo)軸標(biāo)題顏色public void setLabelAngle(double angle)設(shè)置坐標(biāo)軸標(biāo)題旋轉(zhuǎn)角度24頁JFreeChart組件針對不同類型的圖表對象，提供了不同類型的坐標(biāo)軸對象，由Axis類的子類進(jìn)行擴(kuò)展，其常用子類主要有：Categor

19、yAxis類、ValueAxis類、NumberAxis類、DateAxis類。（1）CategoryAxis類CategoryAxis類是Axis類的子類，主要用于對分類軸的相關(guān)屬性進(jìn)行設(shè)置，其常用方法及說明如下表所示。 方 法說 明public void setCategoryMargin(double margin)設(shè)置分類軸邊距public void setLowerMargin(double margin)設(shè)置分類軸下邊距或左邊距public void setUpperMargin(double margin)設(shè)置分類軸上邊距或右邊距public void setVerticalCa

20、tegoryLabels(boolean flag)設(shè)置分類軸標(biāo)題是否旋轉(zhuǎn)到垂直public void setMaxCategoryLabelWidthRatio(float ratio)設(shè)置分類軸分類標(biāo)簽的最大寬度25頁（2）ValueAxis類ValueAxis類是Axis類的子類，也是NumberAxis類與DateAxis類的父類，主要用于對數(shù)據(jù)軸的相關(guān)屬性進(jìn)行設(shè)置，其常用方法及說明如下表所示。 方 法說 明public void setAutoRange(boolean auto)設(shè)置數(shù)據(jù)軸數(shù)據(jù)范圍是否為自動public void setFixedAutoRange(double l

21、ength)設(shè)置數(shù)據(jù)軸固定數(shù)據(jù)范圍public void setInverted(boolean flag)設(shè)置數(shù)據(jù)軸是否反向public void setLowerMargin(double margin)設(shè)置分類軸下邊距或左邊距public void setUpperMargin(double margin)設(shè)置分類軸上邊距或右邊距public void setLowerBound(double min)設(shè)置數(shù)據(jù)軸上顯示的最小值public void setUpperBound(double max)設(shè)置數(shù)據(jù)軸上顯示的最大值26頁（3）NumberAxis類NumberAxis類是Valu

22、eAxis類的子類，主要用于對數(shù)值類型數(shù)據(jù)軸的相關(guān)屬性進(jìn)行設(shè)置，其常用方法及說明如下表所示。 方 法說 明public void setAutoRangeIncludesZero(boolean flag)設(shè)置是否強(qiáng)制在自動選擇的數(shù)據(jù)范圍中包含0public void setAutoRangeStickyZero(boolean flag)設(shè)置是否強(qiáng)制在整個數(shù)據(jù)軸中包含0，即使0不在數(shù)據(jù)范圍中public void setNumberFormatOverride(NumberFormat formatter)設(shè)置數(shù)據(jù)軸數(shù)據(jù)標(biāo)簽的顯示格式27頁（4）DateAxis類DateAxis類是Valu

23、eAxis類的子類，主要用于對日期軸的相關(guān)屬性進(jìn)行設(shè)置，其常用方法及說明如下表所示。 方 法說 明public void setMaximumDate(Date maximumDate)設(shè)置日期軸上的最小日期Public void setMinimumDate(Date minimumDate)設(shè)置日期軸上的最大日期public void setDateFormatOverride(DateFormat formatter)設(shè)置日期軸日期標(biāo)簽的顯示格式public void setTickUnit(DateTickUnit unit)設(shè)置日期軸的日期標(biāo)簽28頁繪圖區(qū)對象通過數(shù)據(jù)集合生成的數(shù)據(jù)圖

24、表，可以通過繪圖區(qū)對象進(jìn)行屬性設(shè)置，例如背景色、透明度等。繪圖區(qū)對象是JFreeChart組件中的一個重要對象，由Plot類定義，可以通過此類設(shè)置繪圖區(qū)屬性及樣式，其常用方法及說明如下表所示。 方 法說 明public void setBackgroundImage(Image image)設(shè)置數(shù)據(jù)區(qū)的背景圖片public void setBackgroundImageAlignment(int alignment)設(shè)置數(shù)據(jù)區(qū)的背景圖片對齊方式（參數(shù)常量在org.jfree.ui. Align類中定義）public void setBackgroundAlpha(float alpha)設(shè)置數(shù)

25、據(jù)區(qū)的背景透明度，范圍在0.01.0間public void setForegroundAlpha(float alpha)設(shè)置數(shù)據(jù)區(qū)的前景透明度，范圍在0.01.0間public void setDataAreaRatio(double ratio)設(shè)置數(shù)據(jù)區(qū)占整個圖表區(qū)的百分比public void setOutLinePaint(Paint paint)設(shè)置數(shù)據(jù)區(qū)的邊界線條顏色public void setNoDataMessage(String message)設(shè)置沒有數(shù)據(jù)時顯示的消息29頁JFreeChart所能生成的圖形報表是多種多樣的，僅僅一個Plot類并不能滿足繪圖區(qū)樣式的設(shè)置

26、，在對不同類型圖形的設(shè)置中，可以通過Plot的子類進(jìn)行實現(xiàn)，其常用子類主要有：PiePlot類、CategoryPlot類、XYPlot類。（1）PiePlot類PiePlot類是Plot類的子類，主要用于描述PieDataset數(shù)據(jù)集合類型的圖表，通常使用此類來繪制一個餅形圖，其常用方法及說明如下表所示。 30頁 方 法說 明public void setDataset(PieDataset dataset)設(shè)置繪制圖表所需要的數(shù)據(jù)集合public void setCircular(boolean flag)設(shè)置餅形圖是否一定是正圓public void setStartAngle(doub

27、le angle)設(shè)置餅形圖的初始角度public void setDirection(Rotation direction)設(shè)置餅形圖的旋轉(zhuǎn)方向public void setExplodePercent(int section,double percent)在顯示餅形圖時，設(shè)置突出顯示部分的距離public void setLabelFont(Font font)設(shè)置分類標(biāo)簽字體（3D效果下無效）public void setLabelPaint(Paint paint)設(shè)置分類標(biāo)簽字體顏色（3D效果下無效）31頁（2）CategoryPlot類CategoryPlot是Plot類的子類，類

28、主要用于描述CategoryDataset數(shù)據(jù)集合類型的圖表，它支持折線圖、區(qū)域圖等，其常用方法及說明如下表所示。 方 法說 明public void setDataset(PieDataset dataset)設(shè)置繪制圖表所需要的數(shù)據(jù)集合public void setColumnRenderingOrder(SortOrder order)設(shè)置數(shù)據(jù)分類的排序方式public void setAxisOffset(Spacer offset)設(shè)置坐標(biāo)軸到數(shù)據(jù)區(qū)的間距public void setOrientation(PlotOrientation orientation)設(shè)置數(shù)據(jù)區(qū)的方向（橫

29、向或縱向）public void setDomainAxis(CategoryAxis axis)設(shè)置數(shù)據(jù)區(qū)的分類軸public void setRangeAxis(ValueAxis axis)設(shè)置數(shù)據(jù)區(qū)的數(shù)據(jù)軸public void addAnnotation(CategoryAnnotation annotation)設(shè)置數(shù)據(jù)區(qū)的注釋32頁（3）XYPlot類XYPlot類是Plot類的子類，主要用于描述XYDataset數(shù)據(jù)集合類型的圖表。此類可以具有0或多個數(shù)據(jù)集合，并且每一個數(shù)據(jù)集合可以與一個渲染對象相關(guān)聯(lián)，其常用方法及說明如下表所示。 方 法說 明public ValueAxis getDomainAxis()返回X軸public ValueAxis getRangeAxis()返回Y軸public void setDomainAxis(ValueAxis axis)設(shè)置X軸public void setRangeAxis(ValueAxis axis)設(shè)置Y軸33頁圖片渲染對象圖片渲染對象用于渲染和顯示圖表，它在圖表的顯示效果方面起著很大的作用。在JFreeChart組件中，渲染對象定義為AbstractRenderer類，此類是所有渲染對象的父類，但它是一個抽象類，其常用方法及說明如下表所示。在圖片渲染對象中