将Postscript转换为PDF文档 converting-postscript-to-pdf-documents
本文档中的示例和示例仅适用于JEE环境上的AEM Forms 。
关于Distiller服务 about-the-distiller-service
Distiller®服务可将PostScript®、封装的PostScript (EPS)和PRN文件转换为小巧、可靠且更安全的PDF文件。 Distiller服务通常用于将大量打印文档转换为电子文档,如发票和报表。 将文档转换为PDF还允许企业向客户发送文档的纸质版本和电子版本。
将PostScript转换为PDF文档 converting-postscript-to-pdf-documents-inner
本主题介绍如何使用Distiller服务API(Java和Web服务)以编程方式将PostScript (PS)、封装的PostScript (EPS)和PRN文件转换为PDF文档。
步骤摘要 summary-of-steps
要将任何受支持的类型转换为PDF文档,请执行以下步骤:
- 包括项目文件。
- 创建Distiller服务客户端。
- 检索要转换的文件。
- 调用PDF创建操作。
- 保存PDF文档。
包含项目文件
在开发项目中包含必要的文件。 如果使用Java创建客户端应用程序,请包含必要的JAR文件。 如果您使用的是Web服务,请确保包含代理文件。
创建Distiller服务客户端
您必须先创建Distiller服务客户端,然后才能以编程方式执行Distiller服务操作。 如果您使用的是Java API,请创建 DistillerServiceClient
对象。 如果您使用的是Web服务API,请创建 DistillerServiceService
对象。
检索要转换的文件
检索要转换的文件。 例如,要将PS文件转换为PDF文档,必须检索PS文件。
调用PDF创建操作
创建服务客户端后,可以调用PDF创建操作。 此操作将需要有关要转换的文档的信息,包括目标文档的路径。
保存PDF文档
可以将PDF文档另存为PDF文件。
另请参阅
使用Java API将PostScript文件转换为PDF convert-a-postscript-file-to-pdf-using-the-java-api
使用Distiller服务API (Java)将PostScript文件转换为PDF文档:
-
包括项目文件。
在您的Java项目的类路径中包含客户端JAR文件,例如adobe-distiller-client.jar。
-
创建Distiller服务客户端。
- 创建
ServiceClientFactory
包含连接属性的对象。 - 创建
DistillerServiceClient
对象,使用它的构造函数传递ServiceClientFactory
对象。
- 创建
-
检索要转换的文件。
- 创建
java.io.FileInputStream
对象,表示要转换的文件,转换方法是使用其构造函数并传递一个指定文件位置的字符串值。 - 创建
com.adobe.idp.Document
对象,使用它的构造函数传递java.io.FileInputStream
对象。
- 创建
-
调用PDF创建操作。
调用
DistillerServiceClient
对象的createPDF
方法并传递以下值:- 此
com.adobe.idp.Document
表示要转换的PS、EPS或PRN文件的对象 - A
java.lang.String
包含要转换的文件名的对象 - A
java.lang.String
包含要使用的Adobe PDF设置名称的对象 - A
java.lang.String
包含要使用的安全设置的名称的对象 - 可选
com.adobe.idp.Document
包含生成PDF文档时要应用的设置的对象 - 可选
com.adobe.idp.Document
包含要应用于PDF文档的元数据信息的对象
此
createPDF
方法返回CreatePDFResult
包含新PDF文档和可生成的日志文件的对象。 日志文件通常包含转换请求生成的错误或警告消息。 - 此
-
保存PDF文档。
要获取新创建的PDF文档,请执行下列操作:
- 调用
CreatePDFResult
对象的getCreatedDocument
方法。 这会返回com.adobe.idp.Document
对象。 - 调用
com.adobe.idp.Document
对象的copyToFile
用于提取PDF文档的方法。
同样,要获取日志文档,请执行下列操作。
- 调用
CreatePDFResult
对象的getLogDocument
方法。 这会返回com.adobe.idp.Document
对象。 - 调用
com.adobe.idp.Document
对象的copyToFile
提取日志文档的方法。
- 调用
另请参阅
快速入门(SOAP模式):使用Java API将PostScript文件转换为PDF文档
使用Web服务API将PostScript文件转换为PDF converting-a-postscript-file-to-pdf-using-the-web-service-api
使用Distiller服务API(Web服务)将PostScript文件转换为PDF文档:
-
包括项目文件。
创建使用MTOM的Microsoft .NET项目。 确保使用以下WSDL定义:
http://localhost:8080/soap/services/DistillerService?WSDL&lc_version=9.0.1
.note note NOTE 替换 localhost
,其中包含托管AEM Forms的服务器的IP地址。 -
创建Distiller服务客户端。
-
创建
DistillerServiceClient
对象使用默认构造函数。 -
创建
DistillerServiceClient.Endpoint.Address
对象System.ServiceModel.EndpointAddress
构造函数。 将指定WSDL的字符串值传递给AEM Forms服务(例如,http://localhost:8080/soap/services/DistillerService?blob=mtom
.) 您无需使用lc_version
属性。 此属性在创建服务引用时使用。 但是,请指定?blob=mtom
使用MTOM。 -
创建
System.ServiceModel.BasicHttpBinding
对象,方法是获取DistillerServiceClient.Endpoint.Binding
字段。 将返回值强制转换为BasicHttpBinding
. -
设置
System.ServiceModel.BasicHttpBinding
对象的MessageEncoding
字段至WSMessageEncoding.Mtom
. 此值可确保使用MTOM。 -
通过执行以下任务启用基本HTTP身份验证:
- 将AEM表单用户名分配给字段
DistillerServiceClient.ClientCredentials.UserName.UserName
. - 将相应的密码值分配给字段
DistillerServiceClient.ClientCredentials.UserName.Password
. - 分配常量值
HttpClientCredentialType.Basic
到字段BasicHttpBindingSecurity.Transport.ClientCredentialType
. - 分配常量值
BasicHttpSecurityMode.TransportCredentialOnly
到字段BasicHttpBindingSecurity.Security.Mode
.
- 将AEM表单用户名分配给字段
-
-
检索要转换的文件。
- 创建
BLOB
对象。 此BLOB
对象用于存储要转换为PDF文档的文件。 - 创建
System.IO.FileStream
对象,方法是:调用其构造函数,并传递一个字符串值,该值表示文件位置和打开文件的模式。 - 创建一个字节数组,用于存储
System.IO.FileStream
对象。 您可以通过获取System.IO.FileStream
对象的Length
属性。 - 通过调用
System.IO.FileStream
对象的Read
方法,并传递字节数组、起始位置和要读取的流长度。 - 填充
BLOB
对象,通过指定其MTOM
属性与字节数组的内容。
- 创建
-
调用PDF创建操作。
调用
DistillerServiceService
对象的CreatePDF2
方法,并传递以下必需值:- 此
BLOB
表示要转换的PS文件的对象 - 一个字符串,其中包含要转换的文件的路径名称
- 包含要使用的Adobe PDF设置的字符串对象(例如,
Standard
) - 包含要使用的安全设置的字符串对象(例如,
No Securit
y) - 可选
BLOB
包含生成PDF文档时要应用的设置的对象 - 可选
BLOB
包含要应用于PDF文档的元数据信息的对象 - A
BLOB
用于存储PDF文档的输出参数 - A
BLOB
用于存储日志的输出参数
- 此
-
保存PDF文档。
- 创建
System.IO.FileStream
对象通过调用其构造函数。 传递一个字符串值,该值表示已签名PDF文档的文件位置以及打开文件的模式。 - 创建一个字节数组,用于存储
BLOB
返回的对象CreatePDF2
方法(输出参数)。 通过获取的值,填充字节数组BLOB
对象的MTOM
数据成员。 - 创建
System.IO.BinaryWriter
对象通过调用其构造函数并传递System.IO.FileStream
对象。 - PDF通过调用
System.IO.BinaryWriter
对象的Write
和传递字节数组。
- 创建
另请参阅