利用iText在JSP中產生PDF報表

問題的由來

　　前不久做了一個通過JSP產生PDF報表的小項目，算得上開了一次眼界。企業的一些資訊通過網路形成Html報表，雖然IE可以直接列印顯示在其中的內容，但是從介面上來看，如果直接將Html的顯示結果列印出來，顯得不太美觀。如果將它轉成PDF檔案再列印，則列印效果會好很多。

　　iText簡介

　　iText是一個開放源碼的Java類庫，可以用來方便地產生PDF檔案。大家通過訪問http://sourceforge.net/project/showfiles.php?group_id=15255&release_id=167948下載最新版本的類庫，下載完成之後會得到一個.jar包，把這個包加入JDK的classpath即可使用。如果產生的PDF檔案中需要出現中文、日文、韓文字元，則還需要通過訪問http://itext.sourceforge.net/downloads/iTextAsian.jar下載iTextAsian.jar包。

　　關於iText類庫的使用，http://www.lowagie.com/iText/tutorial/index.html有比較詳細的教程。該教程從入門開始，比較系統地介紹了在PDF檔案中放入文字、圖片、表格等的方法和技巧。讀完這片教程，大致就可以做一些從簡單到複雜的PDF檔案了。不過，試圖通過教程解決在產生PDF檔案過程中遇到的所有困難無疑是一種奢望。所以，閱讀iText的api文檔顯得非常重要。讀者在下載類庫的同時，也可以下載類庫的文檔。

　　如何利用iText在java程式中產生PDF報表

　　以下是上述教程中一個最簡單的例子，這個例子刻畫了通過iText產生PDF檔案的一般程式架構。讀者只需要在document.open();和document.close();兩條語句中間加入自己希望放在PDF檔案中的內容即可。該例子只在PDF檔案中加了“Hello World“一行文字。

Document document = new Document();

try

{

　PdfWriter.getInstance(document, new FileOutputStream ("Chap0101.pdf"));

　document.open();

　document.add(new Paragraph("Hello World"));

}

catch(DocumentException de)

{

　System.err.println(de.getMessage());

}

catch(IOException ioe)

{

　System.err.println(ioe.getMessage());

}

document.close();

　　由以上的例子可見，程式的架構十分清楚明了。然而在PDF中指定文字、圖畫、表格的位置是一件非常麻煩的事情。除了不斷地在程式中修改位置、然後運行程式、產生PDF檔案、觀察元素在PDF中的位置是否合理這樣的過程以外，似乎還沒有其它更好的方法。

　　如何通過JSP產生PDF報表

　　這一部分是在iText的教程中所沒有的，網上的相關資料也比較少。我曾在CSDN上看過有人開帖詢問實現細節，有人回複了實現的原理：先在伺服器上產生PDF檔案，然後使用者通過點擊指向PDF檔案的超連結選擇下載或開啟。這是一個思路，或者說是思路之一。本文實現了這個思路，又給出另外一個思路並通過兩種途徑實現之。

　　1）直接在伺服器上產生PDF檔案。

＜%@ page import ="com.lowagie.text.*,com.lowagie.text.pdf.*, java.io.*"%＞

＜%

　String filename = "PDF"+(new Random()).nextInt()+".pdf" ;

　Document document = new Document(PageSize.A4);

　ServletOutputStream out1 = response.getOutputStream();

　try

　{

　　PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream(filename) );

　　document.open();

　　document.add(new Paragraph("Hello World"));

　　document.close();

　}

　catch(Exception e){}%＞

　　上面的程式在伺服器上產生了一個靜態PDF檔案。顯然，每次運行所得的PDF檔案的名稱應該是獨一無二不能有重的。本程式通過隨機函數來命名產生的PDF檔案。本程式的缺點就是，每次運行都會在伺服器上產生一個PDF檔案，如果不及時刪除，數量會越來越大，這顯然是網站維護者所不願意看到的。

　　2）將PDF檔案通過流的形式輸送到用戶端的緩衝。這樣做的好處是不會在伺服器上留下任何“遺迹”。

　　i）直接通過JSP頁面產生

＜%@

page import="java.io.*,java.awt.Color,com.lowagie.text.*,com.lowagie.text.pdf.*"%＞

＜%

　response.setContentType( "application/pdf" );

　Document document = new Document();

　ByteArrayOutputStream buffer = new ByteArrayOutputStream();

　PdfWriter writer=PdfWriter.getInstance( document, buffer );

　document.open();

　document.add(new Paragraph("Hello World"));

　document.close();

　DataOutput output = new DataOutputStream( response.getOutputStream() );

　byte[] bytes = buffer.toByteArray();

　response.setContentLength(bytes.length);

　for( int i = 0; i ＜ bytes.length; i++ )

　{

　　output.writeByte( bytes[i] );

　}

%＞

　　ii）通過Servlet產生

import java.io.*;

import javax.servlet.*;

import javax.servlet.http.*;

import com.lowagie.text.*;

import com.lowagie.text.pdf.*;

public void doGet(HttpServletRequest request, HttpServletResponse response)

　throws IOException,ServletException

　{

　　Document document = new Document(PageSize.A4, 36,36,36,36);

　　ByteArrayOutputStream ba = new ByteArrayOutputStream();

　　try

　　{

　　　PdfWriter writer = PdfWriter.getInstance(document, ba);

　　　document.open();

　　　document.add(new Paragraph("Hello World"));

　　}

　　catch(DocumentException de)

　　{

　　　de.printStackTrace();

　　　System.err.println("A Document error:" +de.getMessage());

　　}

　　document.close();

　　response.setContentType("application/pdf");

　　response.setContentLength(ba.size());

　　ServletOutputStream out = response.getOutputStream();

　　ba.writeTo(out);

　　out.flush();

　}

　　結束

　　我在項目中採用的是第二種方法。本文的源碼在我的tomcat4上面都是調試通過的。希望可以給大家帶來方便。

　　歡迎大家採用，如需轉載，請註明出處。