Stirling-PDF元数据编辑教程：修改PDF作者/标题/关键词技巧

你还在为PDF文件的作者信息错误、标题不规范或关键词缺失而烦恼吗？本文将详细介绍如何使用Stirling-PDF修改PDF元数据（Metadata），包括作者、标题、关键词等关键信息，让你的PDF文件更加专业和易于管理。读完本文后，你将能够熟练掌握元数据编辑的全部流程，并了解背后的技术实现原理。

元数据编辑功能概述

PDF元数据（Metadata）是嵌入在PDF文件中的关键信息，包括作者、标题、主题、关键词等，这些信息对于文件管理、搜索和版权保护至关重要。Stirling-PDF通过直观的界面和强大的后端服务，让用户可以轻松修改这些元数据。

Stirling-PDF的元数据编辑功能由PdfMetadataService提供核心支持，该服务位于app/common/src/main/java/stirling/software/common/service/PdfMetadataService.java。它主要负责元数据的提取、设置和转换，支持标准PDF元数据的全部字段。

元数据模型结构

在开始编辑元数据之前，我们先了解一下Stirling-PDF中元数据的数据结构。元数据信息被封装在PdfMetadata类中，定义如下：

@Data
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class PdfMetadata {
    private String author;        // 作者
    private String producer;      // 生产者
    private String title;         // 标题
    private String creator;       // 创建者
    private String subject;       // 主题
    private String keywords;      // 关键词
    private ZonedDateTime creationDate;      // 创建日期
    private ZonedDateTime modificationDate;  // 修改日期
}

该类位于app/common/src/main/java/stirling/software/common/model/PdfMetadata.java，使用Lombok注解简化了getter、setter和构造函数的编写。

编辑元数据的步骤

1. 提取现有元数据

在修改元数据之前，首先需要从PDF文件中提取当前的元数据。PdfMetadataService提供了extractMetadataFromPdf方法来完成这一操作：

public PdfMetadata extractMetadataFromPdf(PDDocument pdf) {
    Calendar creationCal = pdf.getDocumentInformation().getCreationDate();
    Calendar modificationCal = pdf.getDocumentInformation().getModificationDate();

    ZonedDateTime creationDate = creationCal != null ? 
        ZonedDateTime.ofInstant(creationCal.toInstant(), ZoneId.systemDefault()) : null;
    ZonedDateTime modificationDate = modificationCal != null ? 
        ZonedDateTime.ofInstant(modificationCal.toInstant(), ZoneId.systemDefault()) : null;

    return PdfMetadata.builder()
        .author(pdf.getDocumentInformation().getAuthor())
        .producer(pdf.getDocumentInformation().getProducer())
        .title(pdf.getDocumentInformation().getTitle())
        .creator(pdf.getDocumentInformation().getCreator())
        .subject(pdf.getDocumentInformation().getSubject())
        .keywords(pdf.getDocumentInformation().getKeywords())
        .creationDate(creationDate)
        .modificationDate(modificationDate)
        .build();
}

该方法通过PDFBox库获取PDF文档信息，并将其转换为PdfMetadata对象。

2. 修改元数据字段

提取元数据后，你可以根据需要修改各个字段。以下是可修改的主要字段及其含义：

字段名称	说明	示例值
author	文档作者	"张三"
title	文档标题	"2023年度报告"
subject	文档主题	"财务报告"
keywords	文档关键词	"财务,报告,2023"
creator	创建者	"Stirling-PDF"
producer	生产者	"Stirling-PDF 0.14.0"

3. 保存修改后的元数据

修改完成后，使用setMetadataToPdf方法将新的元数据写回PDF文件：

public void setMetadataToPdf(PDDocument pdf, PdfMetadata pdfMetadata) {
    setMetadataToPdf(pdf, pdfMetadata, false);
}

private void setCommonMetadata(PDDocument pdf, PdfMetadata pdfMetadata) {
    pdf.getDocumentInformation().setTitle(pdfMetadata.getTitle());
    pdf.getDocumentInformation().setSubject(pdfMetadata.getSubject());
    pdf.getDocumentInformation().setKeywords(pdfMetadata.getKeywords());
    
    // 处理修改日期
    Calendar modificationCal = pdfMetadata.getModificationDate() != null ? 
        toCalendar(pdfMetadata.getModificationDate()) : Calendar.getInstance();
    pdf.getDocumentInformation().setModificationDate(modificationCal);
    
    // 设置作者信息
    pdf.getDocumentInformation().setAuthor(pdfMetadata.getAuthor());
}

高级功能：批量修改与自动更新

对于专业版用户，Stirling-PDF还提供了元数据自动更新功能。通过配置applicationProperties，可以实现创建者、生产者等信息的自动填充：

if (applicationProperties.getPremium().getProFeatures().getCustomMetadata().isAutoUpdateMetadata() 
    && runningProOrHigher) {
    creator = applicationProperties.getPremium().getProFeatures().getCustomMetadata().getCreator();
    pdf.getDocumentInformation().setProducer(stirlingPDFLabel);
}

这段代码位于app/common/src/main/java/stirling/software/common/service/PdfMetadataService.java的setNewDocumentMetadata方法中，允许专业版用户自定义默认元数据模板。

常见问题解决

日期格式问题

如果遇到日期格式错误，可以使用parseToCalendar方法进行日期字符串解析：

public static Calendar parseToCalendar(String dateString) {
    if (dateString == null || dateString.trim().isEmpty()) {
        return null;
    }
    try {
        DateTimeFormatter formatter = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");
        ZonedDateTime zonedDateTime = LocalDateTime.parse(dateString, formatter)
            .atZone(ZoneId.systemDefault());
        return toCalendar(zonedDateTime);
    } catch (Exception e) {
        return null;
    }
}

该方法支持"yyyy/MM/dd HH:mm:ss"格式的日期字符串转换。

特殊字符处理

当元数据中包含特殊字符时，Stirling-PDF会自动进行转义处理，确保PDF文件兼容性。如果需要手动处理，可以使用GeneralUtils中的字符串处理工具，该工具位于app/common/src/main/java/stirling/software/common/util/GeneralUtils.java。

总结

通过本文介绍的方法，你可以轻松修改PDF文件的元数据信息，包括作者、标题、关键词等关键内容。Stirling-PDF的元数据编辑功能不仅操作简单，还提供了批量处理和自动更新等高级特性，满足不同用户的需求。

如果你在使用过程中遇到问题，可以参考官方文档HowToUseOCR.md或查看项目源码获取更多帮助。对于开发者，元数据服务的实现代码PdfMetadataService.java是学习PDF元数据处理的绝佳参考。

掌握PDF元数据编辑技巧，让你的文档管理更加高效和专业！