itextpdf-xmlworker

### iTextPdf 和 XmlWorker 使用教程

#### 导入必要的库
为了使用 `iTextPdf` 及其扩展功能，需先导入相应的 JAR 文件。对于基本操作仅需要 `iTextpdf.jar`；如果涉及 HTML 到 PDF 的转换，则还需要额外引入 `xmlworker.jar` 或者更新版本中的 `xfaworker.jar`[^1]。

// Maven依赖配置示例
<dependency>
    <groupId>com.itextpdf</groupId>
    <artifactId>itextpdf</artifactId>
    <version>5.5.13.2</version> <!-- 版本号应根据实际需求调整 -->
</dependency>

<!-- 如果要支持HTML转PDF还需加入以下依赖 -->
<dependency>
    <groupId>com.itextpdf.tool</groupId>
    <artifactId>xmlworker</artifactId>
    <version>5.5.13.2</version>
</dependency>

#### 创建简单的 PDF 文档
通过创建一个新的 `Document` 对象并指定页面大小来初始化一个空白的 PDF 文档实例。接着利用 `PdfWriter` 将此文档连接到输出流上，在打开文档之后可以向其中添加内容，最后记得关闭文档以完成保存过程[^2]。

import com.itextpdf.text.Document;
import java.io.FileOutputStream;

public class CreateSimplePDF {
    public static void main(String[] args) throws Exception {
        Document document = new Document(PageSize.A4);
        PdfWriter.getInstance(document, new FileOutputStream("simple_pdf_example.pdf"));
        
        document.open();
        // 这里可以插入更多代码用于写入文本或其他元素
        
        document.close();
    }
}

#### 处理复杂的 HTML 内容至 PDF
当面对更复杂的内容比如来自网页的数据时，可以通过加载外部 CSS 并调用 `XMLWorkerHelper` 来解析 XHTML 字符串或输入流形式的数据源。注意这里还涉及到字体提供者的自定义实现以便正确显示特定字符集的文字[^3]。

import com.itextpdf.text.Document;
import com.itextpdf.tool.xml.XMLWorkerHelper;
import javax.servlet.http.HttpServletResponse;
import java.io.InputStream;

public class HtmlToPdfExample {
    private final MyFontProvider fontProvider; // 假设这是一个实现了IFontProvider接口类
    
    public void convertHtmlToPdf(HttpServletResponse response, String htmlContent) throws Exception {
        Document document = new Document();

        PdfWriter pdfWriter = PdfWriter.getInstance(document, response.getOutputStream());
        document.open();
        
        XMLWorkerHelper workerHelper = XMLWorkerHelper.getInstance();
        InputStream cssStream = getClass().getResourceAsStream("/path/to/your/style.css");
        workerHelper.parseXHtml(pdfWriter, document, new ByteArrayInputStream(htmlContent.getBytes()), cssStream, Charset.forName("UTF-8"), this.fontProvider);

        document.close();
    }
}

class MyFontProvider implements IFontProvider { ... } // 自定义字体提供商的具体实现