iText:PDF报表组件

1.简介

一种基于Java的服务器端报表技术，用于制作PDF格式的报表。

iText7以前的版本是免费的，7及之后的版本收费。

2.快速入门

Maven坐标

<!--iText报表-->
<dependency>
  <groupId>com.lowagie</groupId>
  <artifactId>itext</artifactId>
  <version>4.2.1</version>
</dependency>
<!--中文支持组件-->
<dependency>
  <groupId>com.itextpdf</groupId>
  <artifactId>itext-asian</artifactId>
  <version>5.2.0</version>
</dependency>

• iText包5.5.9及之后的版本由于厂家易主，groupId变为com.itextpdf
• 注意：如果使用的文字Itext不支持，那么Itext在生成PDF的时候会直接跳过这些文字，不会报错

使用步骤

1. 创建Document文档对象

   空参构造器：

   Document document = new Document();

   有参构造器：

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

   参数一为纸张大小，后四个参数为边距。

2. 设置输出位置

   PdfWriter.getInstance(document,new FileOutputStream(new File(path)));

3. 打开文档

   document.open();

4. 写入内容

   document.add(new Paragraph("hello world"));
   

5. 关闭文档

   document.close();

中文输出支持问题

中文的输出问题是Java本身的问题。

为了让IText支持中文输出，必须要导入Itext-Asian.jar亚洲语言包。而后在代码中为Paragraph对象设置字体：

//定义中文基础字体  参数：1.字体 2.横竖排版样式 3.是否内嵌
BaseFont bfChinese = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);
//用中文基础字体实例化一个字体类   参数：1.中文基础字体 2.字号 3.是否斜体、加粗 4.颜色
Font FontChinese = new Font(bfChinese, 12, Font.NORMAL,BaseColor.PINK);
//将字体用到一个段落中
Paragraph par = new Paragraph("薇薇的小龙虾",FontChinese)；

输出表格

1. 定义表格

   PdfPTable table = new PdfPTable(3);

   • 其中构造器的参数为表格的列数。

2. 定义单元格

   PdfPCell cell = new PdfPCell(new Phrase("月份", titleFont));

3. 添加单元格到表格

   table.addCell(cell);

• iText中的表格与POI不同，并不需要设置行。只是按照添加顺序依次排列单元格，达到列数就自动换行。

3.范例：

public class ITextTest02 {

    public static void main(String[] args) throws Exception{
        //准备数
        List<String[]> list = new ArrayList<String[]>();
        list.add(new String[]{"七月","1000","1100"});
        list.add(new String[]{"八月","950","1000"});
        list.add(new String[]{"九月","1000","1200"});
        //创建文档对象
        /**
         * 第一个参数：PageSize：设置纸张的大小：A1，A2，A3，A4(默认值),A5
         * 第2--5个参数：左右上下：纸张的边距
         */
        Document document = new Document(PageSize.A4, 20, 20, 20, 20);
        //设置输出位置
        PdfWriter.getInstance(document, new FileOutputStream(new File("d://a.pdf")));
        //打开文档
        document.open();
        //写入内容
        //创建亚洲中文字体
        /**
         * 第一个参数：当前的字体：宋体、楷体...
         * 第二个参数：编码
         * 第三个参数：是否以内嵌的样式显示，值是boolean类型
         *        true：以内嵌的方式显示，比较占用资源
         *        false：不适用内嵌的方式显示，（更常用） 
         */
        BaseFont baseFont = BaseFont.createFont(AsianFontMapper.ChineseSimplifiedFont, 
                AsianFontMapper.ChineseSimplifiedEncoding_H, BaseFont.NOT_EMBEDDED);
        /**********大标题的输出***********/
        //设置字体样式
        /**
         * 第一个参数：字体
         * 第二个参数：字体大小
         * 第三个参数：加粗、倾斜..
         * 第四个参数：颜色
         */
        Font bigTitleFont = new Font(baseFont, 30f, Font.BOLD, BaseColor.PINK);
        //设置内容
        /**
         * 第一个参数：内容
         * 第二个参数：字体格式
         */
        Paragraph bigTitleParagraph = new Paragraph("销量表", bigTitleFont);
        //设置对其方式
        bigTitleParagraph.setAlignment(Paragraph.ALIGN_CENTER);
        //添加至文档中
        document.add(bigTitleParagraph);
        /**********表格作者***********/
        //设置字体样式
        Font authorFont = new Font(baseFont, 20f, Font.NORMAL, BaseColor.BLACK);
        //设置内容
        Paragraph authorParagraph = new Paragraph("Ivon", authorFont);
        //设置对其方式
        authorParagraph.setAlignment(Paragraph.ALIGN_RIGHT);
        //添加至文档中
        document.add(authorParagraph);
        /**********表格的创建***********/
        PdfPTable table = new PdfPTable(3);
        //设置当前面table的上边距
        table.setSpacingBefore(20f);
        
        /**********表格标题***********/
        //设置字体样式
        Font titleFont = new Font(baseFont, 15f, Font.BOLD, BaseColor.GREEN);
        //设置内容 参数：1.内容 2.字体样式
        table.addCell(new PdfPCell(new Phrase("月份", titleFont)));
        table.addCell(new PdfPCell(new Phrase("去年销量", titleFont)));
        table.addCell(new PdfPCell(new Phrase("今年销量", titleFont)));
        /**********表格内容***********/
        //设置字体样式
        Font contentFont = new Font(baseFont, 15f, Font.NORMAL, BaseColor.GREEN);
        //设置内容  
        for(String[] values:list){
            table.addCell(new PdfPCell(new Phrase(values[0], contentFont)));
            table.addCell(new PdfPCell(new Phrase(values[1], contentFont)));
            table.addCell(new PdfPCell(new Phrase(values[2], contentFont)));
        }
        
        //将表格添加至document中
        document.add(table);
        
        //关闭文档
        document.close();
        System.out.println("输出完成");
    }

}