文档AEM 6.5用户指南

将PDF转换为Postscript和图像文件 converting-pdf-to-postscript-andimage-files

Last update: Wed Mar 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

  • Developer

本文档中的示例和示例仅适用于JEE环境上的AEM Forms 。

关于转换PDF服务

转换PDF服务将PDF文档转换为PostScript和多种图像格式(JPEG、JPEG2000、PNG和TIFF)。 将PDF文档转换为PostScript对于任何PostScript打印机上基于服务器的自动打印很有用。 在不支持PDF文档的内容管理系统中归档文档时，将PDF文档转换为多页TIFF文件是切实可行的。

您可以使用转换PDF服务完成以下任务：

  • 将PDF文档转换为PostScript。
  • 将PDF文档转换为图像格式。
NOTE
有关ConvertPDF服务的详细信息，请参见 AEM Forms的服务参考.

将PDF文档转换为PostScript converting-pdf-documents-to-postscript

本主题介绍如何使用转换PDF服务API（Java和Web服务）以编程方式将PDF文档转换为PostScript文件。 转换为PostScript文件的PDF文档必须是非交互式PDF文档。 也就是说，如果尝试将交互式PDF文档转换为PostScript文件，则会引发异常。

NOTE
有关ConvertPDF服务的详细信息，请参见 AEM Forms的服务参考.

步骤摘要 summary-of-steps

要将PDF文档转换为PostScript文件，请执行以下步骤：

  1. 包括项目文件。
  2. 创建转换PDF服务客户端。
  3. 引用要转换为PostScript文件的PDF文档。
  4. 设置转换运行时选项。
  5. 将PDF文档转换为PostScript文件。
  6. 保存PostScript文件。

包含项目文件

将必要的文件包含在开发项目中。 如果使用Java创建客户端应用程序，请包含必要的JAR文件。 如果您使用的是Web服务，请确保包含代理文件。

创建转换PDF客户端

您必须先创建转换PDF服务客户端，然后才能以编程方式执行转换PDF服务操作。 如果您使用的是Java API，请创建 ConvertPdfServiceClient 对象。 如果您使用的是Web服务API，请创建 ConvertPDFServiceService 对象。

本节使用AEM Forms中引入的Web服务功能。 要访问新功能，您必须使用 lc_version 属性。 (请参阅中的“使用Web服务访问新功能” 使用Web服务调用AEM Forms.)

引用要转换为PostScript文件的PDF文档

引用要转换为PostScript文件的PDF文档。 如本主题前面所述，PDF文档必须是非交互式PDF文档。 如果尝试将交互式PDF文档转换为PostScript文件，则会引发异常。

设置转换运行时选项

将PDF文档转换为PostScript文件时，您可以定义运行时选项，以指定创建的PostScript类型。 例如，您可以定义一个级别3的PostScript文件。

通常，生成的PostScript文件将反映输入PDF文档的大小。 如果您选择 ShrinkToFit 选项（缩小PostScript文件的输出以适合页面），您将看不到输入PDF文档与生成的PostScript文件之间的差异。 此 ShrinkToFit 仅当选择在比输入PDF文档小的页码上打印时，选项才生效。 要选择较小的页面大小，请定义 PageSize 选项。 此外，建议您设置 RotateAndCenter 选项至 true 以获取正确的PostScript输出。

同样，如果您选择 ExpandToFit 选项（用于扩展PostScript文件的输出以适合页面），仅当选择在比输入PDF文档大的页面尺寸上打印时，它才会生效。 要选择较大的页面大小，请定义 PageSize 选项。 此外，建议您设置 RotateAndCenter 选项至 true 以获取正确的PostScript输出。

NOTE
有关可设置的运行时值的信息，请参见 ToPSOptionsSpec 中的类引用 AEM Forms API参考.

将PDF文档转换为PostScript文件

创建服务客户端并设置运行时选项后，可以调用PostScript转换操作。 此操作将需要有关要转换的文档的信息，包括目标文档的首选PostScript级别。

保存PostScript文件

将PDF文档转换为PostScript后，可以将输出保存为PostScript文件。

另请参阅

使用Java API将PDF文档转换为PS

使用Web服务API将PDF文档转换为PS

包括AEM Forms Java库文件

设置连接属性

转换PDF服务API快速启动

使用Java API将PDF文档转换为PS convert-a-pdf-document-to-ps-using-the-java-api

使用转换PDF服务API (Java)将PDF文档转换为PostScript：

  1. 包括项目文件。

    在您的Java项目的类路径中包含客户端JAR文件，例如adobe-convertpdf-client.jar。

  2. 创建转换PDF客户端。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 ConvertPdfServiceClient 对象，使用它的构造函数传递 ServiceClientFactory 对象。

  3. 引用要转换为PostScript文件的PDF文档。

    • 创建 java.io.FileInputStream 对象，并传递一个字符串值，该值指定要转换的PDF文档的位置。
    • 创建 com.adobe.idp.Document 使用存储PDF文档的对象 com.adobe.idp.Document 构造函数。 传递 java.io.FileInputStream 包含PDF文档的对象。

  4. 设置转换运行时选项。

    • 创建 ToPSOptionsSpec 对象通过调用其构造函数。
    • 通过调用属于 ToPSOptionsSpec 对象。 例如，要定义创建的PostScript级别，请调用 ToPSOptionsSpec 对象的 setPsLevel 方法和传递 PSLevel 指定PostScript级别的枚举值。 有关可设置的所有运行时值的信息，请参见 ToPSOptionsSpec 中的类引用 AEM Forms API参考.

  5. 将PDF文档转换为PostScript文件。

    调用 ConvertPdfServiceClient对象的 toPS2 方法并传递以下值：

    • A com.adobe.idp.Document 表示要转换为PostScript文件的PDF文档的对象。
    • A ToPSOptionsSpec 对象指定PostScript运行时选项。

    此 toPS2 方法返回 Document 包含新PostScript文档的对象。

  6. 保存PostScript文件。

    • 创建 java.io.File 对象并确保文件扩展名为.ps。
    • 调用 Document 对象的 copyToFile 用于复制 Document 对象到文件(确保您使用 Document 返回的对象 toPS2 方法)。

另请参阅

步骤摘要

快速入门（SOAP模式）：使用Java API将PDF文档转换为PostScript

包括AEM Forms Java库文件

设置连接属性

使用Web服务API将PDF文档转换为PS convert-a-pdf-document-to-ps-using-the-web-service-api

使用转换PDF服务API（Web服务）将PDF文档转换为PostScript：

  1. 包括项目文件。

    创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义： http://localhost:8080/soap/services/ConvertPDFService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。

  2. 创建转换PDF客户端。

    • 创建 ConvertPdfServiceClient 对象使用默认构造函数。

    • 创建 ConvertPdfServiceClient.Endpoint.Address 对象 System.ServiceModel.EndpointAddress 构造函数。 将指定WSDL的字符串值传递给AEM Forms服务(例如， http://localhost:8080/soap/services/ConvertPDFService?blob=mtom.) 您无需使用 lc_version 属性。 但是，请指定 ?blob=mtom.

    • 创建 System.ServiceModel.BasicHttpBinding 对象，方法是获取 ConvertPdfServiceClient.Endpoint.Binding 字段。 将返回值强制转换为 BasicHttpBinding.

    • 设置 System.ServiceModel.BasicHttpBinding 对象的 MessageEncoding 字段至 WSMessageEncoding.Mtom. 此值可确保使用MTOM。

    • 通过执行以下任务启用基本HTTP身份验证：

      • 将AEM表单用户名分配给字段 ConvertPdfServiceClient.ClientCredentials.UserName.UserName.
      • 将相应的密码值分配给字段 ConvertPdfServiceClient.ClientCredentials.UserName.Password.
      • 分配常量值 HttpClientCredentialType.Basic 到字段 BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • 分配常量值 BasicHttpSecurityMode.TransportCredentialOnly 到字段 BasicHttpBindingSecurity.Security.Mode.

  3. 引用要转换为PostScript文件的PDF文档。

    • 创建 BLOB 对象。 此 BLOB 对象用于存储转换为PostScript文件的PDF文档。
    • 创建 System.IO.FileStream 对象，方法是调用其构造函数并传递一个字符串值，该字符串值表示要转换的PDF文档的文件位置以及用于打开文件的模式。
    • 创建一个字节数组，用于存储 System.IO.FileStream 对象。 您可以通过获取 System.IO.FileStream 对象的 Length 属性。
    • 通过调用 System.IO.FileStream 对象的 Read 方法，并传递字节数组、起始位置和流长度以供读取。
    • 填充 BLOB 对象，通过指定其 MTOM 包含字节数组内容的字段。

  4. 设置转换运行时选项。

    • 创建 ToPSOptionsSpec 对象通过调用其构造函数。
    • 通过将值分配给 ToPSOptionsSpec 对象的数据成员。 例如，要定义创建的PostScript级别，请分配 PSLevel 枚举值 ToPSOptionsSpec 对象的 psLevel 数据成员。

  5. 将PDF文档转换为PostScript文件。

    调用 GeneratePDFServiceService 对象的 toPS2 方法并传递以下值：

    • A BLOB 表示要转换为PostScript文件的PDF文档的对象
    • A ToPSOptionsSpec 指定运行时选项的对象

    转换完成后，通过访问代表PostScript文档的二进制数据 BLOB 对象的 MTOM 属性。 这会返回一个字节数组，您可以将该数组写出到PostScript文件中。

  6. 保存PostScript文件。

    • 创建 System.IO.FileStream 对象通过调用其构造函数。 传递一个表示PS文件位置的字符串值。
    • 创建一个字节数组，用于存储 BLOB 返回的对象 encryptPDFUsingPassword 方法。 通过获取的值，填充字节数组 BLOB 对象的 MTOM 字段。
    • 创建 System.IO.BinaryWriter 对象通过调用其构造函数并传递 System.IO.FileStream 对象。
    • 通过调用 System.IO.BinaryWriter 对象的 Write 和传递字节数组。

另请参阅

步骤摘要

使用MTOM调用AEM Forms

使用SwaRef调用AEM Forms

将PDF文档转换为图像格式 converting-pdf-documents-to-image-formats

您可以使用转换PDF服务以编程方式将PDF文档转换为图像格式，包括JPEG、JPEG2000、TIFF和PNG。 通过将PDF文档转换为图像文件，可以将PDF文档用作图像文件。 例如，可以将映像放入企业内容管理系统进行存储。

将PDF文档转换为图像时，转换PDF服务会为文档中的每个页面创建单独的图像。 也就是说，如果文档有20页，则ConvertPDF服务将创建20个图像文件。 将PDF文档转换为图像格式时，您可以为PDF文档中的每个页面创建单个图像，或者为整个PDF文档创建单个图像文件。

NOTE
有关ConvertPDF服务的详细信息，请参见 AEM Forms的服务参考.

步骤摘要 summary_of_steps-1

要将PDF文档转换为任何支持的类型，请执行以下步骤：

  1. 包括项目文件。
  2. 创建转换PDF服务客户端。
  3. 检索要转换的PDF文档。
  4. 设置运行时选项。
  5. 将PDF转换为图像。
  6. 从收藏集中检索图像文件。

包含项目文件

将必要的文件包含在开发项目中。 如果使用Java创建客户端应用程序，请包含必要的JAR文件。 如果您使用的是Web服务，请确保包含代理文件。

创建转换PDF客户端

您必须先创建转换PDF服务客户端，然后才能以编程方式执行转换PDF服务操作。 如果您使用的是Java API，请创建 ConvertPdfServiceClient 对象。 如果您使用的是Web服务API，请创建 ConvertPDFServiceService 对象。

检索要转换的PDF文档

检索要转换为图像的PDF文档。 无法将交互式PDF文档转换为图像。 如果尝试这样做，则会引发异常。 要将交互式PDF文档转换为图像文件，必须先拼合该PDF文档，然后才能将其转换。 (请参阅 拼合PDF文档.)

设置运行时选项

设置运行时选项，如图像格式和分辨率值。 有关运行时值的信息，请参见 ToImageOptionsSpec 中的类引用 AEM Forms API参考.

将PDF转换为图像

创建服务客户端并设置运行时选项后，可以将PDF文档转换为图像。 将返回包含图像的收藏集对象。

从收藏集中检索图像文件

您可以从ConvertPDF服务返回的集合对象中检索图像文件。 收藏集中的每个元素都是一个 com.adobe.idp.Document 实例(或 BLOB （例如，如果您使用的是Web服务）可以另存为图像文件，如JPG文件。

图像文件的格式取决于 ImageConvertFormat 运行时选项。 也就是说，如果您设置 ImageConvertFormat 运行时选项用于 ImageConvertFormat.JPEG，则可以将图像文件另存为JPG文件。

另请参阅

包括AEM Forms Java库文件

设置连接属性

转换PDF服务API快速启动

使用Java API将PDF文档转换为图像文件 convert-a-pdf-document-to-image-files-using-the-java-api

使用转换PDF服务API (Java)将PDF文档转换为图像格式：

  1. 包括项目文件。

    在您的Java项目的类路径中包含客户端JAR文件，例如adobe-convertpdf-client.jar。

  2. 创建转换PDF客户端。

    • 创建 ServiceClientFactory 包含连接属性的对象。
    • 创建 ConvertPdfServiceClient 对象，使用它的构造函数传递 ServiceClientFactory 对象。

  3. 检索要转换的PDF文档。

    • 创建 java.io.FileInputStream 表示要转换的PDF文档的对象，转换方法是使用其构造函数并传递一个指定PDF文档位置的字符串值。
    • 创建 com.adobe.idp.Document 对象，使用它的构造函数传递 java.io.FileInputStream 对象。

  4. 设置运行时选项。

    • 创建 ToImageOptionsSpec 对象。
    • 根据需要调用属于此对象的方法。 例如，通过调用 setImageConvertFormat 方法和传递 ImageConvertFormat 指定格式类型的枚举值。
    note note
    NOTE
    设置 ImageConvertFormat 枚举值是必需的。

  5. 将PDF转换为图像。

    调用 ConvertPdfServiceClient 对象的 toImage2 方法并传递以下值：

    • A com.adobe.idp.Document 表示要转换的PDF文件的对象。
    • A com.adobe.livecycle.converpdfservice.client.ToImageOptionsSpec 包含有关目标图像格式的各种首选项的对象。

    此 toImage2 方法返回 java.util.List 包含图像的对象。 收藏集中的每个元素都是一个 com.adobe.idp.Document 实例。

  6. 从收藏集中检索图像文件。

    循环访问 java.util.List 用于确定图像是否存在的对象。 每个元素都是一个 com.adobe.idp.Document 实例。 通过调用 com.adobe.idp.Document 对象的 copyToFile 方法和传递 java.io.File 对象。

另请参阅

快速入门（SOAP模式）：使用Java API将PDF文档转换为JPEG文件

使用Web服务API将PDF文档转换为图像文件 convert-a-pdf-document-to-image-files-using-the-web-service-api

使用转换PDF服务API（Web服务）将PDF文档转换为图像格式：

  1. 包括项目文件。

    创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义： http://localhost:8080/soap/services/ConvertPDFService?WSDL&lc_version=9.0.1.

    note note
    NOTE
    替换 localhost ，其中包含托管AEM Forms的服务器的IP地址。

  2. 创建转换PDF客户端。

    • 创建 ConvertPdfServiceClient 对象使用默认构造函数。

    • 创建 ConvertPdfServiceClient.Endpoint.Address 对象 System.ServiceModel.EndpointAddress 构造函数。 将指定WSDL的字符串值传递给AEM Forms服务(例如， http://localhost:8080/soap/services/ConvertPDFService?blob=mtom.) 您无需使用 lc_version 属性。 但是，请指定 ?blob=mtom.

    • 创建 System.ServiceModel.BasicHttpBinding 对象，方法是获取 ConvertPdfServiceClient.Endpoint.Binding 字段。 将返回值强制转换为 BasicHttpBinding.

    • 设置 System.ServiceModel.BasicHttpBinding 对象的 MessageEncoding 字段至 WSMessageEncoding.Mtom. 此值可确保使用MTOM。

    • 通过执行以下任务启用基本HTTP身份验证：

      • 将AEM表单用户名分配给字段 ConvertPdfServiceClient.ClientCredentials.UserName.UserName.
      • 将相应的密码值分配给字段 ConvertPdfServiceClient.ClientCredentials.UserName.Password.
      • 分配常量值 HttpClientCredentialType.Basic 到字段 BasicHttpBindingSecurity.Transport.ClientCredentialType.
      • 分配常量值 BasicHttpSecurityMode.TransportCredentialOnly 到字段 BasicHttpBindingSecurity.Security.Mode.

  3. 检索要转换的PDF文档。

    • 创建 BLOB 对象。 此 BLOB 对象用于存储PDF表单。
    • 创建 System.IO.FileStream 对象通过调用其构造函数。 传递一个字符串值，该值指定PDF表单的位置和打开文件的模式。
    • 创建一个字节数组，用于存储 System.IO.FileStream 对象。 通过获取 System.IO.FileStream 对象的 Length 属性。
    • 通过调用 System.IO.FileStream 对象的 Read 方法。 传递字节数组、起始位置和要读取的流长度。
    • 填充 BLOB 对象，通过指定其 MTOM 包含字节数组内容的字段。

  4. 设置运行时选项。

    • 创建 ToImageOptionsSpec 对象。
    • 根据需要调用属于此对象的方法。 例如，通过调用 setImageConvertFormat 方法和传递 ImageConvertFormat 指定格式类型的枚举值。
    note note
    NOTE
    设置 ImageConvertFormat 枚举值是必需的。

  5. 将PDF转换为图像。

    调用 ConvertPDFServiceService 对象的 toImage2 方法并传递以下值：

    • A BLOB 表示要转换的文件的对象
    • A ToImageOptionsSpec 包含有关目标图像格式的各种首选项的对象

    此 toImage2 方法返回 MyArrayOfBLOB 包含新创建的图像文件的对象。

  6. 从收藏集中检索图像文件。

    • 确定 MyArrayOfBLOB 对象，方法是获取其 Count 字段。 每个元素都是一个 BLOB 包含图像的对象。
    • 循环访问 MyArrayOfBLOB 对象并保存每个图像文件。

另请参阅

使用MTOM调用AEM Forms

使用SwaRef调用AEM Forms

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2