PDF 生成模板编辑器
开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。
长期验证(LTV)使用文档中保存的证书及吊销信息,为后续验证提供材料。ComPDF 提供文档级材料评估、PAdES 签名及已签名文档的材料补充接口。
CPDFLtvService.assessReadiness(document) 检查已打开文档中的 DSS(文档安全存储)和 VRI(验证相关信息)材料,也包含尚未保存的内存状态。该操作应在后台线程执行。
import com.compdfkit.core.signature.CPDFLtvService;
import com.compdfkit.core.signature.CPDFLtvReadinessResult;
import com.compdfkit.core.signature.CPDFLtvReadinessInfo;
CPDFLtvReadinessResult result = CPDFLtvService.assessReadiness(document);
if (result != null && result.isSuccess()) {
CPDFLtvReadinessInfo info = result.getReadinessInfo();
if (info != null) {
boolean ready = info.isLtvReady();
String[] missingMaterials = info.getMissingMaterials();
// 根据 ready 和 missingMaterials 显示材料准备情况。
}
} else {
// 检查文档是否已打开,并读取非空 result 中的 errors 和 warnings。
}| 接口 | 用途 |
|---|---|
hasDss()、hasVri() | 检查 DSS 和 VRI 是否存在 |
hasCertificates()、hasRevocation() | 检查证书材料及 OCSP/CRL 材料是否存在 |
isLtvReady()、getMissingMaterials() | 读取准备情况及缺失材料 |
getDssInfo() | 获取 DSS 材料数量等信息 |
getErrors()、getWarnings() | 从评估结果读取错误与警告 |
材料就绪不代表证书可信、吊销证据有效或全部签名均符合 PAdES-LT。完整验证参见 验证数字签名,并启用 setCheckRevocation(true)。
CPDFPadesSigner.sign() 根据 CPDFPadesOptions 创建签名域和外观,并按所选配置生成输出文件。
Profile | 输出阶段 | 所需输出路径 |
|---|---|---|
B | 基础签名 | signedPath |
T | 带签名时间戳 | signedPath |
LT | 增加长期验证材料 | signedPath、ltvPath |
LTA | 进一步增加文档时间戳 | signedPath、ltvPath、ltaPath |
调用前保存所有待签内容。该接口从文件路径重新加载文档,不包含尚未保存的内存修改。所有输出路径应互不相同,并与源路径不同;先创建输出目录。网络请求应在后台线程执行,并配置 android.permission.INTERNET。
以下示例创建不可见的 LT 签名。trustedCertPath 为可信根证书 PEM 文件或 OpenSSL 格式的证书目录,tsaUrl 为可访问的 TSA 地址:
import com.compdfkit.core.signature.CPDFPadesOptions;
import com.compdfkit.core.signature.CPDFPadesResult;
import com.compdfkit.core.signature.CPDFPadesSigner;
CPDFPadesOptions options = new CPDFPadesOptions()
.setProfile(CPDFPadesOptions.Profile.LT)
.setCertificate(certificatePath, certificatePassword)
.setFieldName("ApprovalSignature")
.setVisible(false)
.setTsaUrl(tsaUrl)
.setTrustedCertPath(trustedCertPath);
CPDFPadesResult result = CPDFPadesSigner.sign(
sourcePath, signedPath, ltvPath, null, options);
if (result != null && result.isSuccess()) {
String finalPath = result.getFinalPath();
// 使用最终阶段的文件。
} else {
// 读取非空 result 中的 getErrors() 和 getWarnings()。
}如需可见签名,可使用 setField(pageIndex, rect) 指定签名域,再配置外观。签名域名称不能与已有域重复。sign() 创建自己的签名域,不对已有签名域签名,也不设置 DocMDP 认证引用;需要这些行为时,使用 writeSignature() 后再补充 LTV 材料。
prolongLtv() 为已签名文件增量补充或刷新证书链、OCSP/CRL 材料,保留原签名域、外观和 DocMDP 引用。
CPDFPadesOptions options = new CPDFPadesOptions()
.setTrustedCertPath(trustedCertPath);
CPDFPadesResult result = CPDFPadesSigner.prolongLtv(
signedPath, ltvPath, null, options);
if (result != null && result.isSuccess()) {
String finalPath = result.getFinalPath();
// 打开最终文件并重新验证签名。
}需要追加文档时间戳时,设置 setAppendDocumentTimestamp(true)、setLtaTsaUrl(tsaUrl) 并传入独立的 ltaPath。此流程读取信任、吊销材料与文档时间戳配置,不使用 profile、签名证书、签名域及外观设置。
Android 不为该接口提供默认 OpenSSL 信任库,应显式配置可信根证书。网络、证书链或材料获取失败时,读取结果中的错误与警告;不能只根据中间输出文件存在判断整个流程成功。