ColdFusion 2021生成WCAG 2.1合规PDF的解决方案咨询

针对你在求职平台动态生成合规PDF遇到的问题（cfdocument无法生成标记PDF、保留元数据，cfhtmltopdf页眉页脚效果差），以下是两种可靠的解决方案，均支持直接下载或生成物理文件：

方案一：使用iText 7（推荐，原生Java集成） #

iText 7是专业的PDF生成库，完全支持生成标记PDF（Tagged PDF）、设置文档元数据、添加图片alt文本，且能灵活控制页眉页脚，完全符合WCAG 2.1标准。ColdFusion作为Java平台可以直接调用其API。

步骤： #

1. 下载iText 7核心库（itext-core）和布局模块（itext-layout）的jar包，放入ColdFusion安装目录的lib文件夹，重启ColdFusion服务。
2. 用ColdFusion的Java对象调用iText API构建合规PDF：

<cfscript>
    // 初始化iText核心类
    PdfWriter = createObject("java", "com.itextpdf.kernel.pdf.PdfWriter");
    PdfDocument = createObject("java", "com.itextpdf.kernel.pdf.PdfDocument");
    Document = createObject("java", "com.itextpdf.layout.Document");
    Paragraph = createObject("java", "com.itextpdf.layout.element.Paragraph");
    Image = createObject("java", "com.itextpdf.layout.element.Image");
    PdfImageXObject = createObject("java", "com.itextpdf.kernel.pdf.xobject.PdfImageXObject");
    PageSize = createObject("java", "com.itextpdf.kernel.geom.PageSize");
    TextAlignment = createObject("java", "com.itextpdf.layout.properties.TextAlignment");

    // 自定义页面尺寸（8.5x10.75英寸，转换为PDF点：1英寸=72点）
    customPage = PageSize.AUTO.createCustomPageSize(8.5 * 72, 10.75 * 72);

    // 生成PDF到字节数组流（支持直接下载）
    baos = createObject("java", "java.io.ByteArrayOutputStream").init();
    writer = PdfWriter.init(baos);
    pdfDoc = PdfDocument.init(writer);

    // 启用标记PDF（满足WCAG核心要求）
    pdfDoc.setTagged();

    // 设置文档元数据
    pdfInfo = pdfDoc.getDocumentInfo();
    pdfInfo.setTitle(returnStruct.JobDetails.title);
    pdfInfo.setLanguage("EN-US");
    pdfInfo.setAuthor(returnStruct.JobDetails.anonymous ? "Employment Agency Name" : returnStruct.JobDetails.Organization);

    // 初始化文档，设置边距（上1in、左右0.25in、下1.5in）
    doc = Document.init(pdfDoc, customPage);
    doc.setMargins(72, 18, 108, 18);

    // 添加页眉（如需每页重复，需实现IPdfPageEvent接口）
    doc.add(Paragraph.init("职位招聘信息").setFontSize(12).setTextAlignment(TextAlignment.CENTER));

    // 添加职位核心内容
    doc.add(Paragraph.init("职位：#returnStruct.JobDetails.title#").setFontSize(16).setBold());

    // 添加带alt文本的图片（屏幕阅读器可识别）
    if (FileExists(expandPath("job_logo.png"))) {
        imgXObj = PdfImageXObject.createFromFile(expandPath("job_logo.png"));
        jobImg = Image.init(imgXObj);
        jobImg.getAccessibilityProperties().setAlternateDescription("公司官方Logo");
        doc.add(jobImg);
    }

    // 添加职位描述等更多内容
    doc.add(Paragraph.init("职位描述：").setBold());
    doc.add(Paragraph.init(returnStruct.JobDetails.description));

    // 添加页脚
    doc.add(Paragraph.init("© 2024 求职平台").setFontSize(10).setTextAlignment(TextAlignment.RIGHT));

    // 关闭资源
    doc.close();
    pdfDoc.close();
    writer.close();

    // 输出PDF供用户下载
    cfheader(name="Content-Disposition", value="attachment;filename=#returnStruct.JobDetails.title#.pdf");
    cfcontent(type="application/pdf", reset=true, variable=toBinary(baos.toByteArray()));
</cfscript>

方案二：使用wkhtmltopdf（命令行工具，适合HTML模板场景） #

wkhtmltopdf通过HTML/CSS生成PDF，支持标记PDF、图片alt文本，且页眉页脚控制能力远超cfhtmltopdf，适合已有HTML内容模板的场景。

步骤： #

1. 在服务器上安装wkhtmltopdf，记录其安装路径。
2. 生成符合WCAG的HTML内容（包含语义化标签、图片alt），调用命令行生成PDF：

<cfscript>
    // 生成合规HTML内容
    htmlContent = '<!DOCTYPE html>' &
        '<html lang="EN-US">' &
        '<head>' &
        '<meta charset="UTF-8">' &
        '<title>#returnStruct.JobDetails.title#</title>' &
        '<style>' &
        '@page { size: 8.5in 10.75in; margin: 1in 0.25in 1.5in 0.25in; }' &
        '@page { @top-center { content: "职位招聘信息"; font-size:12px; } }' &
        '@page { @bottom-right { content: "© 2024 求职平台"; font-size:10px; } }' &
        '.job-title { font-size:16px; font-weight:bold; margin:1em 0; }' &
        '</style>' &
        '</head>' &
        '<body>' &
        '<h1 class="job-title">#returnStruct.JobDetails.title#</h1>' &
        '<img src="#expandPath("job_logo.png")#" alt="公司Logo">' &
        '<h2>职位描述</h2>' &
        '<p>#returnStruct.JobDetails.description#</p>' &
        '</body>' &
        '</html>';

    // 创建临时HTML文件
    tempHtml = getTempDirectory() & "job_temp.html";
    FileWrite(tempHtml, htmlContent);

    // 设置wkhtmltopdf路径（根据服务器环境调整）
    wkPath = "C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe";
    // 生成临时PDF文件
    tempPdf = getTempDirectory() & "job_temp.pdf";

    // 构建命令：启用标记PDF，设置元数据
    cmd = '""#wkPath#"" --enable-tagged-pdf --title ""#returnStruct.JobDetails.title#"" --author ""#(returnStruct.JobDetails.anonymous ? "Employment Agency Name" : returnStruct.JobDetails.Organization)#"" --language "EN-US" ""#tempHtml#"" ""#tempPdf#""';

    // 执行命令生成PDF
    execResult = execute(name=cmd, timeout=30);

    // 输出下载并清理临时文件
    if (FileExists(tempPdf)) {
        cfheader(name="Content-Disposition", value="attachment;filename=#returnStruct.JobDetails.title#.pdf");
        cfcontent(type="application/pdf", reset=true, file=tempPdf);
        FileDelete(tempHtml);
        FileDelete(tempPdf);
    } else {
        writeOutput("PDF生成失败：#execResult.errorOutput#");
    }
</cfscript>

方案对比 #

• iText 7：完全控制PDF生成过程，集成度高，功能全面，适合复杂动态内容场景，是合规PDF生成的首选。
• wkhtmltopdf：学习成本低，利用HTML/CSS技能快速构建内容，适合已有模板的场景，依赖外部工具但配置简单。

内容的提问来源于stack exchange，提问作者Archer1980