问题场景

在用ITEXT写PDF的过程中遇到表与表格标题不分开，图与图片标题不分开的需求。

分析

通常报表中的表格和图片的标题会遵循表上图下，为了方便读者阅读一般要求表格与表格标题不分开，图片也是。通过查询API发现ITEXT提供了table.setKeepTogether(true)的方法，由此可以解决上述问题。

解决思路

以表格为例：

1. 建立一个总的table，a
2. 设置属性
3. 为表格标题建立一个table，b
4. 为表格内容建立一个table，c
5. 把b,c这两个table作为单元格嵌套到table a

图片情况：
图片当成b，把图片标题当成c即可。

效果

CODE

需要导入的包：itext-pdfa-5.5.6.jar、itext-xtra-5.5.6.jar、itext-5.5.6.jar、itext-asian.jar

package itext;
import com.itextpdf.text.*;
import com.itextpdf.text.pdf.*;
import java.io.FileNotFoundException;
import java.io.FileOutputStream;
/** * Created on 2017/5/16 * Author: youxingyang. */
public class TableAndTitle {
    /** * @param args */
    public static void main(String[] args) throws Exception {
        String fileName = "tableAndTitle.pdf";
        TableAndTitle.test(fileName);
    }
    private static void test(String fileName) {
        Document document = new Document();
        try {
            PdfWriter.getInstance(document, new FileOutputStream(fileName));
            document.open();
            //加一些测试内容
            for (int i = 0; i < 35; i++) {
                document.add(new Paragraph("content" + (i + 1)));
            }
            PdfPTable table = new PdfPTable(1);
            table.setKeepTogether(true);
            table.setSplitLate(false);
            PdfPTable table1 = new PdfPTable(1);
            PdfPCell cell0 = new PdfPCell();
            Paragraph p = new Paragraph("table title sample");
            p.setAlignment(1);
            p.setSpacingBefore(15f);
            cell0.setHorizontalAlignment(PdfPCell.ALIGN_CENTER);
            cell0.setVerticalAlignment(PdfPCell.ALIGN_MIDDLE);//然并卵
            cell0.setPaddingTop(-2f);//把字垂直居中
            cell0.setPaddingBottom(8f);//把字垂直居中
            cell0.addElement(p);
            cell0.setBorder(0);
            table1.addCell(cell0);
            PdfPTable table2 = new PdfPTable(2);
            for (int a = 0; a < 20; a++) {
                PdfPCell cell = new PdfPCell();
                Paragraph pp;
                if (a == 0 || a == 1) {
                    pp = str2ParaByTwoFont("tableTitle" + (a + 1), 9f, BaseColor.BLACK, Font.BOLD); //小五 加粗
                    cell.setBackgroundColor(new BaseColor(128, 128, 255));
                } else {
                    pp = str2ParaByTwoFont("tableContent" + (a - 1), 9f, BaseColor.BLACK); //小五
                }
                pp.setAlignment(1);
                cell.setHorizontalAlignment(PdfPCell.ALIGN_CENTER);
                cell.setVerticalAlignment(PdfPCell.ALIGN_MIDDLE);//然并卵
                cell.setPaddingTop(-2f);//把字垂直居中
                cell.setPaddingBottom(8f);//把字垂直居中
                cell.addElement(pp);
                table2.addCell(cell);
            }
            PdfPCell c1 = new PdfPCell();
            c1.setBorder(0);
            c1.addElement(table1);
            PdfPCell c2 = new PdfPCell();
            c2.setBorder(0);
            c2.addElement(table2);
            table.addCell(c1);
            table.addCell(c2);
            document.add(table);
            document.close();
        } catch (DocumentException | FileNotFoundException e) {
            e.printStackTrace();
        }
    }
    /** * 两种字体显示文字 * @param cont * @param size * @param color * @return */
    private static Paragraph str2ParaByTwoFont(String cont, float size, BaseColor color) {
        Paragraph res = new Paragraph();
        FontSelector selector = new FontSelector();
        //非汉字字体颜色
        Font f1 = FontFactory.getFont(FontFactory.TIMES_ROMAN, size);
        f1.setColor(color);
        //汉字字体颜色
        Font f2 = FontFactory.getFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED, size);
        f2.setColor(color);
        selector.addFont(f1);
        selector.addFont(f2);
        Phrase ph = selector.process(cont);
        res.add(ph);
        return res;
    }
    /** * 两种字体显示文字 * @param cont * @param size * @param color * @param bold * @return */
    private static Paragraph str2ParaByTwoFont(String cont, float size, BaseColor color, int bold) {
        Paragraph res = new Paragraph();
        FontSelector selector = new FontSelector();
        //非汉字字体颜色
        Font f1 = FontFactory.getFont(FontFactory.TIMES_ROMAN, size);
        f1.setColor(color);
        f1.setStyle(bold);
        //汉字字体颜色
        Font f2 = FontFactory.getFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED, size);
        f2.setColor(color);
        f2.setStyle(bold);
        selector.addFont(f1);
        selector.addFont(f2);
        Phrase ph = selector.process(cont);
        res.add(ph);
        return res;
    }
}