在一個最近的後勤項目中，客戶要求我們建一個能讓用戶能從一個遺留系統查詢出貨信息的Web站點，有三個主要的需求：
1.出貨信息必須以PDF文檔的格式返回；
2.PDF文件必須能通過浏覽器下載；
3.PDF文件必須能用Adobe Acrobat Reader閱讀；
盡管我們的團隊有很多J2EE Web應用的開發經驗，但在PDF文檔處理上卻沒有多少經驗。我們需要找一個能在服務器端Web應用裡產生復雜的PDF文檔的純Java類庫。最後，我們發現iText(http://www.lowagie.com/iText/)能完全滿足我們的需要。
1.iText類庫
iText是一個創建和處理PDF文檔的開源純Java類庫。Bruno Lowagie和Paulo Soares領導著這個項目。IText API能讓Java開發人員以編程的方式創建PDF文檔。iText提供了很多的特性：
支持PDF和FDF文檔
各種頁面尺寸
橫向和豎向布局
頁邊距
表格
斷字
頁頭
頁腳
頁碼
條形碼
字體
顏色
文檔加密
JPEG,GIF,PNG和WMF圖片
有序和無序列表
陰影
水印
文檔模板
iText是一個開源庫。在寫本文的時候，iText可以在兩個許可協議下使用：Mozilla Public License和LGPL。如果想了解詳細信息，請參考iText站點。在本文中，你將會看到iText API的應用。我們將闡述如何在服務器端應用中使用iText和servlet動態生成PDF文檔。
2.開始(Getting Started)
首先，你需要一個iText Jar文件。訪問iText站點並下載最新的版本。在寫本文時，最新的版本是使0.99。iText站點提供了API文檔和一個全面的指南。
除了iText，我們還要用servlet.如果你不熟悉servlet，你可以通過Jason Hunter的書《Java Servlet Programming》來學習它。你需要一個J2EE應用服務器或可以獨立運行的servlet引擎。開源軟件Tomcat，Jetty和Jboss是不錯的選擇。下文假設你使用的是Jakarta Tomcat 4.1。
1.iText API
iText API簡單易用。通過使用iText，你能創建自定義的PDF文檔。iText庫由下邊的一些包組成：
com.lowagie.servlets
com.lowagie.text
com.lowagie.text.html
com.lowagie.text.markup
com.lowagie.text.pdf
com.lowagie.text.pdf.codec
com.lowagie.text.pdf.hyphenation
com.lowagie.text.pdf.wmf
com.lowagie.text.rtf
com.lowagie.text.xml
com.lowagie.tools
為了生成PDF文件，你只需要com.lowagie.text和com.lowagie.text.pdf兩個包。
我們的例子使用了這些iText類：
com.lowagie.text.pdf.PdfWriter
com.lowagie.text.Document
com.lowagie.text.HeaderFooter
com.lowagie.text.Paragraph
com.lowagie.text.Phrase
com.lowagie.text.Table
com.lowagie.text.Cell
關鍵的類是Document和PdfWriter。在創建PDF文檔時，你將經常使用這兩個類。Document是PDF文檔基於對象的描述。你可以通過調用Document類提供的方法往文檔中加入內容。PdfWriter對象通過java.io.OutputStream對象與Document關聯在一起。
3.在Web應用中使用iText
在設計階段，你必須決定如何使用iText。我們使用了下邊的技術開發了我們的Web應用。
1.A技術
在服務器文件系統上創建PDF文件。應用使用java.io.FileOutputStream把文件寫到服務器文件系統上。用戶通過HTTP GET方法下載該文件。
2.B技術
使用java.io.ByteArrayOutputStream在內存中創建PDF文件。應用通過servlet的輸出流將該PDF文件字節發送到客戶端。
由於應用不需要把文件寫到文件系統上，這樣能保證在集群服務環境中能正常工作，所以我更傾向於使用B技術。如果你的應用運行在集群環境中且服務器集群不提供會話親和的功能，A技術可能會導致失敗。
3.例子：PDFServlet
我們的例子應用由一個類組成：PDFServlet。這個servlet采用B技術。輸出流OutputStream是java.io.ByteArryOutputStream。用ByteArrayOutputStream，PDF文檔字節將存儲在內存中。當PDFServlet接收到一個HTTP請求時，它將動態地生成一個PDF文檔並將該文檔發送到客戶端。
PDFServlet類擴展了javax.servlet.http.HttpServlet類並導入了兩個iText包：com.lowagie.text和com.lowagie.text.pdf。
doGet方法
大多數servlet覆蓋了doPost和doGet方法中的一個方法。我們的servlet沒有什麼不同。PDFServlet類覆蓋了doGet方法。該servlet將在接收到HTTP GET請求後生成一個PDF文件。
在核心部分，servlet的doGet方法做了如下的工作：
1.創建一個包含PDF文檔字節的ByteArrayOutputStream對象；
2.在reponse對象上設置HTTP響應頭內容；
3.得到servlet輸出流；
4.把文檔字節寫到servlet的輸出流中；
5.刷新servlet輸出流；
generatePDFDocumentBytes方法
generatePDFDocumentBytes方法負責創建PDF文檔。在這個方法中三個最重要的對象是Document對象，ByteArrayOutputStream對象和PdfWriter對象。PdfWriter使用ByteArrayOutputStream關聯Document。
Document doc = new Document();
ByteArrayOutputStream baosPDF = new ByteArrayOutputStream();
PdfWriter docWriter = null;
docWriter = PdfWriter.getInstance(doc, baosPDF);
// ...
用add方法把內容添加到Document中。
doc.add(new Paragraph(
"This document was created by a class named: "
+ this.getClass().getName()));
doc.add(new Paragraph(
"This document was created on "
+ new java.util.Date()));
當你添加完內容後，要關閉Document和PdfWriter對象。
doc.close();
docWriter.close();
當關閉文檔後，ByteArrayOutputStream對象返回到調用者。
return baosPDF;
ByteArrayOutputStream包含了PDF文檔的所有字節。
HTTP響應頭
在這個應用中，我們僅僅關注四個HTTP 響應頭：Content-type,Content-disposition,Content-length,和Cache-control。如果你從沒有使用過HTTP頭，請參考HTTP 1.1規范。
研究在PDFServlet中的doGet方法，你會注意到要在任何數據寫到servlet輸出流之前設置HTTP響應頭內容，這是很重要的，也是細微的一點。
讓我們更詳細地說明一下每個響應頭的含義。
Content-type
在servlet中，HttpServletResponse有一個表明響應所包含內容類型的參數。對PDF文件而言，內容類型是application/pdf。如果servlet沒有設置類型，web浏覽器很難決定如何處理這個文件。
PDFServlet用下邊的代碼設置內容類型：
resp.setContentType("application/pdf");
Content-disposition
Content-disposition頭提供給浏覽器確定HTTP響應內容的信息。當浏覽器讀到這些頭信息後，它能確定：
HTTP響應包含一個文件；
包含在響應中的文件名；
該文件是顯示在浏覽器主窗口中還是要用外部的應用查看；
RFC 2183中有對Content-disposition頭完整的解釋。
通過合適地設置Content-disposition的值，servlet能指示浏覽器是“內嵌”顯示文件還是把它當作附件處理。
例1.內嵌顯示一個文件
Content-disposition: inline; filename=foobar.pdf
例2.往response裡附加一個文件
Content-disposition: attachment; filename=foobar.pdf
下邊的偽碼說明了如何設置頭信息：
public void doGet(HttpServletRequest req, HttpServletResponse resp)
{
// ...
resp.setHeader(
"Content-disposition",
"inline; filename=foobar.pdf" );
// ...
}
Cache-Control
根據你應用的特性不同，你可以讓浏覽器緩存或者不緩存你正在生成的PDF文件。服務器端應用可以有很多種HTTP 頭來控制內容緩存。下邊是一些例子：
Cache-Control: no-cache
Cache-Control: no-store
Cache-Control: must-revalidate
Cache-Control: max-age=30
Pragma: no-cache
Expires: 0
關於Cache-Control頭的全面解釋見HTTP 1.1規范。
PDFServlet把Cache-Control設置為max-age=30。這個頭信息告訴浏覽器緩存這個文件的最長時間為30秒。
Content-length
Content-length頭必須設置成PDF文件中字節的數值。如果Content-length沒有設置正確，浏覽器可能不能正確地顯示該文件。下邊是例子代碼：
ByteArrayOutputStream baos = getByteArrayOutputStream();
resp.setContentLength(baos.size());
把PDF文檔送到Web浏覽器
PDFServlet通過把字節流寫到servlet的輸出流的方式把PDF文檔送到客戶端。它通過調用HttpServletResponse對象的getOutputStream方法來獲得輸出流。getOutputStream方法返回一個javax.servlet.ServletOutputStream類型的對象。
ServletOutputStream sos;
sos = resp.getOutputStream();
baos.writeTo(sos);
sos.flush();
在把所有的數據寫到流之後，調用flush()方法把所有的字節發送到客戶端。
打包和部署
為了在Tomcat中運行PDFServlet，你需要把應用打包在WAR文件中。iText JAR文件(itext-0.99.jar)必須放在WAR文件的lib目錄下邊。如果你忘了把iText JAR文件打包進去，servlet會報一個java.lang.NoClassDefFoundError的錯誤並停止運行。
運行應用
在WAR文件部署之後，你已經准備好了測試servlet了。Jakarta Tomcat在8080端口上監聽請求。
在浏覽器中請求http://hostname:8080/pdfservlet/createpdf。servlet將會執行並返回浏覽器一個PDF文檔。
4.iText之外的方案
iText提供了許多產生PDF文檔的底層API。然而，它不是對任何應用都有效。
在我的日常工作中，我結合Microsoft Word和Adobe Acrobat使用iText。首先，我們的團隊使用Microsoft Word設計了一個出貨表單。之後，我們用Acrobat把Word文檔轉換成PDF文檔。然後，我們使用iText的模板的功能，我們把PDF文件裝入到我們的應用中。從這裡，把數據填入表格和輸出最終的PDF文檔是相當容易的。
對基於報表的Web應用，像JasperReports這樣的工具,它提供了比iText更高層次的抽象。
5.總結
當你的應用需要動態地創建PDF文檔的時，iText類庫是一個不錯的方案。你可以通過增強和擴展本文中的代碼來體驗iText的能力。很快，由於提供了完善的PDF文檔，你將會給你的同事和客戶留下深刻的印象。
6.其他資源
http://www.lowagie.com/iText/
http://www.jpedal.org/
http://www.pdfbox.org/
xml.apache.org/fop
HTTP 1.1 protocol specification
RFC 2183
dmoz.org/Computers/Data_Formats/Document/Publishing/PDF
http://www.planetpdf.com/
http://www.pdfzone.com/
