服务容器 service-container
本文档中的示例和示例仅适用于JEE环境上的AEM Forms。
服务容器中的AEM Forms服务(包括标准服务,如加密服务、长生命周期和短生命周期进程)可以使用各种提供程序(如EJB提供程序)调用。 通过EJB提供程序,可以通过RMI/IIOP调用AEM Forms服务。 Web服务提供商使用SOAP/HTTP和SOAP/JMS等标准将服务公开为Web服务(WSDL生成)。
下表描述了以编程方式调用AEM Forms服务的各种方式。
AEM Forms支持SOAP/HTTP等Web服务标准。 服务可以公开为Web服务,WSDL遵循W3C定义的Web服务标准。
可以从任何Web服务栈调用服务,包括.NET Framework和Sun™ Web服务SDK。 (请参阅使用Web服务调用AEM Forms。)
下图直观地展示了AEM Forms服务可以通过各种方式以编程方式调用。
com.adobe.idp.BankAccount
。 然后,您可以在客户端应用程序中创建com.adobe.idp.BankAccount
实例。服务容器提供以下功能:
-
允许使用其他方法调用AEM Forms服务。 您可以通过设置端点来配置服务,以便可以使用所有方法调用该服务:远程处理、Java API、Web服务和REST。 (请参阅以编程方式管理端点。)
-
将消息转换为称为调用请求的规范化格式。 调用请求从客户端应用程序(或其他服务)发送到服务容器中的服务。 调用请求包含要调用的服务名称和执行操作所需的数据值等信息。 许多服务需要文档来执行操作。 因此,一个调用请求通常包含一份文档,其中可以是PDF数据、XDP数据、XML数据等。
-
将调用请求路由到适当的服务(要调用的服务的名称是调用请求的一部分)。
-
执行诸如确定调用方是否具有调用指定服务操作的权限之类的任务。 调用请求必须包含有效的AEM Forms用户名和密码。
有多种不同的方法可以将调用请求发送到服务。 此外,还有不同的方法可以将所需的输入值发送到服务。 例如,假设您使用Java API调用需要PDF文档的服务。 相应的Java方法包含一个接受PDF文档的参数。 在这种情况下,参数的数据类型为
com.adobe.idp.Document
。 (请参阅使用Java API将数据传递到AEM Forms服务。)如果您使用watched文件夹调用服务,则当您将文件置于配置的watched文件夹中时,会发送调用请求。 如果使用电子邮件调用服务,则当电子邮件到达配置的收件箱时,会向服务发送调用请求。
执行操作后,服务容器会发送回调用响应。 调用响应包含操作结果等信息。 例如,如果操作修改了PDF文档,则调用响应将包含修改后的PDF文档。 如果操作不成功,则调用响应将包含错误消息。
调用响应的检索方式与调用请求的发送方式相同。 也就是说,如果调用请求是使用Java API发送的,则调用响应可以使用Java API进行检索。 例如,假设某个操作修改了PDF文档。 您可以通过获取调用服务的Java方法的返回值来检索修改后的PDF文档。
在调用长期进程时,调用响应将包含与调用请求关联的标识符值。 使用此标识符值,您可以稍后检查进程的状态。 例如,以MortgageLoan长期服务为例。 使用标识符值,您可以检查以确定进程是否成功完成。 (请参阅调用以人为中心的长期进程。)
下图显示调用服务的客户端应用程序(使用Java API)。
当客户端应用程序调用服务时,会发生三个事件:
- 客户端应用程序向服务发送调用请求。
- 服务执行调用请求中指定的操作。
- 服务容器向客户端应用程序返回调用响应。
另请参阅
使用AEM Forms调用(已为AEM表单弃用) AEM Forms远程处理