iText经验总结

因为前些日子在一个项目中用到了iText，稍有收获，便总结于此，以供他人所需。

iText是一个比较底层的pdf库，很多项目的pdf操作都是以它为基础的。像spring，以及另一个比较有名的报表工具jasperreports。简单的pdf报表输出用它比较合适，比较复杂的话使用起来就比较困难了，你要手工编写太多的代码。

比较好的是iText网站上提供相当多的示例代码，比较容易入门。我这里只说一些在它的文档里并没有直接讲到的东西。

1 关于Document

Document的几种构造函数：
public Document();
public Document(Rectangle pageSize);
public Document(Rectangle pageSize,
int marginLeft,
int marginRight,
int marginTop,
int marginBottom);
下面两种比较有用，如果是你想定义纸张大小和边缘的时候。对于Margin，iText上提到“You can also change the margins while you are adding content. Note that the changes will only be noticed on the NEXT page. If you want the margins mirrored (odd and even pages), you can do this with this method: setMarginMirroring(true). ”不过，对于table似乎并不好使。table并不会了理会你设定的margin，如果想改变它的magin还是需要去改变它的宽度（setWidth）。

2 pdf表单

使用PdfStamper是可以填充pdf表单的，这样就给出了一种很好的报表生成思路。
word制作报表样式-->acrobat转pdf-->itext填充数据-->输出pdf
这做非常简单，因为可以比较容易的控制pdf的样式。我对于Java的报表工具了解的并不多，不过在jasperreports，即使用GUI工具做一个样式比较复杂的报表也不是怎么容易。比如有那种斜线的表头，比较花哨的嵌套表格。这样的情况还是比较多见的，客户不会关系你实现起来是否困难。不过想要使用这种方式也有不足的地方。首先是acrobat把word转化成pdf的时候，格式总是保持不好，特别的是字体。然后是文件的体积这样生成的pdf会比直接用iText生成的pdf文件大很多，acrobat在pdf里加入了太多无用的信息。初次使用iText填充Adobe Designer生成的pdf表单时会有点小麻烦。在Designer中设计了一个name的text文本框的绑定名为name。照着iText中例子使用使用PdfStamper的setField方法去这样写form.setField("name", "XXXX");并不会成功。原因是Adobe Designer生成的表单名都是具有层次的，它可能是这个样子form1[0].#subform[0].name[0]。不过我们可以用一个方法把它们列出来，只要做一次就知道结构了，可以使用类似下面的代码：
PdfReader reader = new PdfReader("form.pdf");
PdfStamper stamp = new PdfStamper(reader, new FileOutputStream("registered_flat.pdf"));
AcroFields form = stamp.getAcroFields();
for (Iterator it = form.getFields().keySet().iterator(); it
.hasNext();) {
System.out.println(it.next());
}
如果直接用iText编程生成的表单就不会有这样的问题，设定的什么名字就是什么名字。

3 表单元素

pdf 并不像html那样具有良好清晰的结构，而是一个有层次的文档类型。在它的maillist里，作者说明了iText虽然可以操作现存的pdf文件但是没办法去还原它的结构的。没办法像html一样，能从一个pdf文件获得一个清晰的“源文件”的。关于层次，可以从iText上得到详细的讲述，获取去看看 pdf规范。表单和普通文本是不在一个层上的。没办法适用对待文本表各一样把它们简单的add进Document对象。获取一个cb直接去用绝对定位的方法可以加入表单元素，不过很多的时候因为排版并不能那么简单的去做。就是在html中布局一样可以使用表格定位。想把一个表单元素加入cell，要借助 cell的setCellEvent方法。以一个checkbox为例。新建一个类CheckBoxForm，实现PdfPCellEvent接口。需要实现一个cellLayout的方法。
  public void cellLayout(PdfPCell cell, Rectangle position, PdfContentByte[] canvases)
position可以好好利用，它包含当前cell的位置信息，你可以用它来确定自己checkbox的位置。
position.top ()-position.bottom()就能得到高position.right()-position.left()可以得到长，如果需要这两个值得花可以如此计算。下面的代码就是定义一个宽度为a的checkbox的rectangle 。它在cell中水平居中，垂直也居中。
    float bo = (position.top()-position.bottom()-a)/2;
    float ao = (position.right()-position.left()-a)/2;    
    Rectangle rectangle = new Rectangle(position.left() + ao, position
          .bottom() + bo, position.left() +ao+ a, position.bottom()+ bo + a);
然后把它加入Document
    RadioCheckField tf = new RadioCheckField(writer, rectangle, fieldname,
          "f");
    tf.setCheckType(RadioCheckField.TYPE_SQUARE);
    tf.setBorderWidth(1);
    tf.setBorderColor(Color.black);
    tf.setBackgroundColor(Color.white);      
    try {
        PdfFormField field = tf.getCheckField();        
        writer.addAnnotation(field);
    } catch (IOException e) {
        e.printStackTrace();
    } catch (DocumentException e) {
        e.printStackTrace();
    }
其它的元素与此类似。
(来源 www.iocblog.net)
4 PdfPTable和Table

说不上哪种更好用，有时候不能不使用PdfPTable。可惜它只有setColspan方法，没有setRowspan。嵌套的时候也有区别， PdfPTable是用addcell（）加入嵌套表的，table则有一个更明了的方法insertTable（）。PdfPTable想进行设置 border之类的操作要先获得一个默认cell，
pdfPTableName.getDefaultCell().setBorder(Rectangle.NO_BORDER);//设置无框的表
另外在PdfPTable中，一些修饰属性会因为设置的时机不正确而没有效果。如，适用cell的构造函数加入了文本，在cell的 setVerticalAlignment（）fangfa去设定垂直对齐方式就不会有效。还有一个有意思的不同是table默认外边框是加粗的，而 PdfPTable则一样粗细。

5 字体

iText的例子有很多足够用，给出一些pdf的字体名称和编码，如果想使用内嵌字体的话。
语言 PDF 字体名
简体中文 STSong-Light
繁体中文 MHei-Medium
MSung-Light
日语 HeiseiKakuGo-W5
HeiseiMin-W3
韩语 HYGoThic-Medium
HYSMyeongJo-Medium

字符集 编码
简体中文 UniGB-UCS2-H
UniGB-UCS2-V
繁体中文 UniCNS-UCS2-H
UniCNS-UCS2-V
日语 UniJIS-UCS2-H
UniJIS-UCS2-V
UniJIS-UCS2-HW-H
UniJIS-UCS2-HW-V
韩语 UniKS-UCS2-H
UniKS-UCS2-H
必须要有Asian的包才可以用，也可以使用TrueType字体。



ps：因为隔了一段时间了，所以有些现在一时也想不起来了，也可能会有理解的错误。另外，适用iText的时候自己最好抽象一下，可能会省不少力气。