使用iTextSharp來填充PDF模板文件

需求簡介：

    遇到了這樣一個需求：某公司需要為所有用戶的培訓生成一個培訓記錄，過程如下：

    （1）用戶在培訓完之后會進入到一個填寫信息的界面。

    （2）用戶填寫信息。

    （3）生成PDF格式的培訓記錄。

    （4）用戶下載並打印歸檔。

思路：

    因為每次培訓后生成的PDF文件內容都不完全一樣，但是格式卻是完全相同的，所以很容易讓人聯想到使用模板文件。每次只需要提取用戶輸入的有效信息，然后復制模板、填充模板、彈出下載即可。

解決過程：

    （1）制作模板：我先使用Microsoft Office 2010編輯模板文件，在保存的時候將文件保存為pdf文件。然后用Adobe Acrobat X編輯剛剛生成的PDF文件，把Textbox、Checkbox等域拖動到指定的位置，然后通過預覽功能調整各個域的位置和其中文字的字體、大小，完成后保存。模板完成！（我用Google搜索的時候也看到過用OpenOffice來完成模板的，不過沒點開看）

    （2）編程填充PDF文件：本人使用的編程語言是C#，所以使用對應的免費開源類庫iTextSharp來完成填充的功能。程序的執行過程是：先讀取網頁中的有效信息，然后打開模板文件填充到模板文件的域中間，最后另存為一個PDF文件。代碼見下文。

    （3）服務器端推送文件給瀏覽器下載。

遇到的問題：

    （1）首先遇到的問題是Checkbox的傳參問題。一開始本人是從一些英文網站查看的相關資料，里面在設置Checkbox使用的語句是：pdfFormFields.SetField(“male”, “Yes”); 試了很多遍，結果就是不行，Checkbox並沒有被勾選上。后來無奈了點開Checkbox屬性中的選項值一欄，發現它有一欄名為導出值，其中的值為“是”。我猜想我的模板由於使用中文版，其中參數的設置也發生了相應的變化，一試之下果然如此。pdfFormFields.SetField(“male”, “是”); 就是行得通。

    （2）顯示中文的問題。如果直接把中文字符串設置到PDF模板中去的話中文字符一個都不會顯示。Google了一下，應該是亞洲的文字都不能顯示，為此還需要兩個附加組件：iTextAsianCmaps.dll和iTextAsian.dll。這兩個組件可以在sourceforge上面下載。大家不妨參考：http://www.cnblogs.com/haogj/archive/2011/09/05/2167659.html 。

    （3）以為這就好了？差遠了！在輸入第一句BaseFont.AddToResourceSearch("iTextAsian.dll");的時候有錯誤？對了！目前iTextSharp最新的版本是5.4.4，也就是我當時使用的版本。估計版本的變遷使得方法的調用也出了問題，於是果斷換成了5.1.2的版本。

    （4）改完之后一路順暢地寫完了方法。試驗一下，又出錯！BaseFont bf = BaseFont.CreateFont("STSong-Light", "UniGB-UCS2-H", BaseFont.EMBEDDED);中的STSong-Light和UniGB-UCS2-H無法被識別！這個問題我直到最后都沒能解決（看了好幾篇帖子還是沒能解決，大家如果有成功的通知小弟一聲，謝謝啊！），退而求其次我只好使用TTF 字體。注：使用TTF 字體貌似是在PDF文件中嵌入字體文件，這使得PDF文件體積巨大，成了我的心病。

代碼：

    Anyway，代碼還是最重要的，以下的靜態類用來填充PDF模板：

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Diagnostics;
using System.IO;
using iTextSharp.text.pdf;

public class FillPdfTemplate
{
    public static void GetEnPdf(string templatePath, string newFilePath, Dictionary<string, string> parameters)
    {
        PdfReader pdfReader = new PdfReader(templatePath);
        PdfStamper pdfStamper = new PdfStamper(pdfReader, new FileStream(newFilePath,
FileMode.Create));
        //獲取域的集合;
        AcroFields pdfFormFields = pdfStamper.AcroFields;
        //為需要賦值的域設置值;
        foreach (KeyValuePair<string, string> parameter in parameters)
        {
            pdfFormFields.SetField(parameter.Key, parameter.Value);
        }
        //這句很重要，如果為false那么生成的PDF文件還能編輯，一定要設為true;
        pdfStamper.FormFlattening = true;
        pdfStamper.Close();
        pdfReader.Close();
    }

    public static void GetChPdf(string templatePath, string newFilePath, string iTextAsianCmapsPath, Dictionary<string, string> parameters)
    {
        PdfReader pdfReader = new PdfReader(templatePath);
        PdfStamper pdfStamper = new PdfStamper(pdfReader, new FileStream(newFilePath, FileMode.Create));
        //獲取域的集合;
        AcroFields pdfFormFields = pdfStamper.AcroFields;

        BaseFont.AddToResourceSearch(iTextAsianCmapsPath);
        //創建中文字體，第一個參數是中文字體的路徑，第二個參數表示文字方向水平，第三個貌似是字體嵌入PDF文件;
        BaseFont baseFT = BaseFont.CreateFont(@"C:\Windows\Fonts\simsun.ttc,1", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);
        foreach (KeyValuePair<string, string> parameter in parameters)
        {
            //要輸入中文就要設置域的字體;
            pdfFormFields.SetFieldProperty(parameter.Key, "textfont", baseFT, null);
            //為需要賦值的域設置值;
            pdfFormFields.SetField(parameter.Key, parameter.Value);
        }
        //這句很重要，如果為false那么生成的PDF文件還能編輯，一定要設為true;
        pdfStamper.FormFlattening = true;
        pdfStamper.Close();
        pdfReader.Close();
    }
}

下面是參數的獲取和調用的過程和推送PDF文件下載的方法：

protected void btnDownLoad_Click(object sender, EventArgs e)
{
    string position = Text1.Value;
    string venue = Text2.Value;
    string method = Text3.Value;
    string date = Text4.Value;
    string teacher = Text5.Value;
    string content = TextArea1.Value;
    string examination = Checkbox1.Checked ? "是" : "否";
    string selfassessment = Checkbox2.Checked ? "是" : "否";
    string certificate = Checkbox3.Checked ? "是" : "否";
    string etc = Checkbox4.Checked ? "是" : "否";
    string trainee = Text6.Value;

    Dictionary<string, string> dict = new Dictionary<string, string>();
    dict.Add("TextPosition", position);
    dict.Add("TextVenue", venue);
    dict.Add("TextMethod", method);
    dict.Add("TextDate", date);
    dict.Add("TextTeacher", teacher);
    dict.Add("TextContent", content);
    dict.Add("TextTrainee", trainee);
    dict.Add("CheckBoxExamination", examination);
    dict.Add("CheckBoxSelf-assessment", selfassessment);
    dict.Add("CheckBoxCertificate", certificate);
    dict.Add("CheckBoxEtc", etc);

    string template = Server.MapPath("~/PDFTemplate/ch.pdf");
    string newFile = Server.MapPath("~/PDFTemplate") + "\\" + Session["UserID"].ToString() + ".pdf";
    string iTextAsianCmaps = Server.MapPath("~/Libs/iTextAsianCmaps.dll");
    TrainingRecordToPDF.GetChPdf(template, newFile, iTextAsianCmaps, dict);

    OutFile(newFile);
}

public void OutFile(string  filename)
{
    System.IO.FileInfo file = new System.IO.FileInfo(filename);
    Response.Clear();
    Response.Charset = "GB2312";
    Response.ContentEncoding = System.Text.Encoding.UTF8;
    Response.AddHeader("Content-Disposition", "attachment; filename=" + Server.UrlEncode(file.Name));
    Response.AddHeader("Content-Length", file.Length.ToString());
    Response.ContentType = "application/x-bittorrent";
    Response.WriteFile(file.FullName);
    Response.End();

}