文档AEM 6.5用户指南

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

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • undefined

本文档中的示例和示例仅适用于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服务调用AEM Forms中的“使用Web服务访问新功能”。)

引用要转换为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
有关可设置的运行时值的信息，请参阅AEM Forms API引用中的ToPSOptionsSpec类引用。

将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对象。 传递包含PDF文档的java.io.FileInputStream对象。

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

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

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

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

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

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

  6. 保存PostScript文件。

    • 创建java.io.File对象并确保文件扩展名为.ps。
    • 调用Document对象的copyToFile方法以将Document对象的内容复制到文件中（确保您使用toPS2方法返回的Document对象）。

另请参阅

步骤摘要

快速入门(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对象。

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

    • 通过获取ConvertPdfServiceClient.Endpoint.Binding字段的值创建一个System.ServiceModel.BasicHttpBinding对象。 将返回值强制转换为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方法并传递要读取的字节数组、起始位置和流长度，使用流数据填充字节数组。
    • 使用字节数组的内容分配其MTOM字段以填充BLOB对象。

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

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

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

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

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

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

  6. 保存PostScript文件。

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

另请参阅

步骤摘要

使用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文档。)

设置运行时选项

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

将PDF转换为图像

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

从收藏集中检索图像文件

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

图像文件的格式依赖于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方法并传递以下值：

    • 表示要转换的PDF文件的com.adobe.idp.Document对象。
    • 包含有关目标图像格式的各种首选项的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对象。

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

    • 通过获取ConvertPdfServiceClient.Endpoint.Binding字段的值创建一个System.ServiceModel.BasicHttpBinding对象。 将返回值强制转换为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方法，使用流数据填充字节数组。 传递字节数组、起始位置和要读取的流长度。
    • 使用字节数组的内容分配其MTOM字段以填充BLOB对象。

  4. 设置运行时选项。

    • 使用构造函数创建ToImageOptionsSpec对象。
    • 根据需要调用属于此对象的方法。 例如，通过调用setImageConvertFormat方法并传递指定格式类型的ImageConvertFormat枚举值来设置图像类型。
    note note
    NOTE
    必须设置ImageConvertFormat枚举值。

  5. 将PDF转换为图像。

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

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

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

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

    • 通过获取其Count字段的值确定MyArrayOfBLOB对象中的元素数。 每个元素都是包含图像的BLOB对象。
    • 循环访问MyArrayOfBLOB对象并保存每个图像文件。

另请参阅

使用MTOM调用AEM Forms

使用SwaRef调用AEM Forms

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