HTML5表单功能部署为嵌入的AEM实例中的包,并使用RESTful Apache Sling Architecture在HTTP/S上显示为REST端点。
Apache Sling以资源为中心。它使用请求URL首先解析资源。 每个资源都有sling:resourceType(或sling:resourceSuperType)属性。 根据此属性、请求方法和请求URL的属性,选择sling脚本来处理请求。 此sling脚本可以是JSP或servlet。 对于HTML5表单,用户档案节点充当sling资源,用户档案渲染器充当sling脚本,处理用特定用户档案渲染移动表单的请求。 用户档案渲染器是从请求中读取参数并调用FormsOSGi服务的JSP。
有关REST端点和支持的请求参数的详细信息,请参阅渲染表单模板。
当用户从客户端设备(如iOS或Android浏览器)发出请求时,Sling首先会根据请求URL解析用户档案节点。 从此用户档案节点中,它读取sling:resourceSuperType和sling:resourceType,以确定可处理此表单渲染请求的所有可用脚本。 然后,它使用Sling请求选择器和请求方法来标识最适合处理此请求的脚本。 请求到达用户档案渲染器JSP后,JSP将调用FormsOSGi服务。
有关sling脚本解析的详细信息,请参阅AEM Sling备忘单或Apache Sling Url分解。
HTML5表单缓存处理(再现或提交)表单时所需的所有中间对象。 它不会缓存依赖于数据的对象,因为此类对象可能会更改。
Mobile Form维护两个不同级别的缓存,PreRender缓存和Render Cache。 preRender缓存包含已解析模板的所有片段和图像,而Render缓存包含已渲染的内容(如HTML)。
作流程图: HTML5表单工作流程
HTML5表单不缓存缺少片段和图像引用的模板。 如果HTML5表单所用时间超过正常时间,请检查服务器日志中是否缺少引用和警告。 另外,请确保未达到对象的最大大小。
FormsOSGi服务通过两个步骤处理请求:
如果表单中或表单中使用的任何资产存在任何更新,表单缓存组件会检测到它,并且该特定表单的缓存将失效。 FormsOSGi服务完成处理后,用户档案渲染器jsp将JavaScript库引用和样式添加到此表单并返回对客户端的响应。 此处可将Apache等典型Web服务器与HTML压缩结合使用。 Web服务器将显着减小响应大小、网络流量以及在服务器和客户端计算机之间传输数据所需的时间。
当用户提交表单时,浏览器将JSON格式的表单状态发送给提交服务代理;然后,提交服务代理使用JSON数据生成数据XML,并提交该数据XML以提交端点。
您需要AEM Forms加载项包来启用HTML5表单。 有关安装AEM Forms加载项包的信息,请参阅安装和配置AEM Forms。
AdobeXFAForms渲染器(com.adobe.livecycle.adobe-lc-forms-core) 是从Felix管理控制台的Bundle视图(https://[ host]:[port]/system/console/bundles)查看HTML5表单OSGi捆绑的显示名称。
此组件包含用于渲染、缓存管理和配置设置的OSGi组件。
此OSGi服务包含将XDP渲染为HTML的逻辑,并处理表单的提交以生成数据XML。 此服务使用Forms服务容器。 Forms服务容器内部调用执行该处理的本机组件XMLFormService.exe
。
如果收到渲染请求,此组件将调用Forms服务容器生成布局和状态信息,然后进一步处理这些信息以生成HTML和JSON表单DOM状态。
此组件还负责从提交的表单状态JSON生成数据XML。
HTML5表单使用缓存优化吞吐量和响应时间。 您可以配置缓存服务的级别,以微调性能和空间利用率之间的平衡。
缓存策略 | 描述 |
---|---|
无 | 不缓存工件 |
保守派 | 仅缓存在表单呈现之前生成的中间伪像(如包含内联片段和图像的模板) |
攻击性 | 缓存已呈现的HTML内容 缓存在“保守”级别中缓存的所有对象。 注意:此策略可获得最佳性能,但会消耗更多内存来存储缓存的伪像。 |
HTML5表单使用LRU策略执行内存中缓存。 如果缓存策略设置为“无”缓存,则不会创建现有缓存数据(如果有),则清除现有缓存数据。 除缓存策略外,您还可以配置内存中缓存的总大小,这有助于达到缓存大小的最大限制,如果超出此限制,将使用LRU模式释放缓存资源。
内存中缓存未在群集节点之间共享。
Configuration Service支持调整HTML5表单的配置参数和缓存设置。
要更新这些设置,请转到“CQ Felix”Admin Console卡(位于https://[server]:[port]/system/console/configMgr
),搜索并选择“移动Forms配置”。
您可以配置缓存大小或使用配置服务禁用缓存。 您还可以使用“调试选项”参数启用调试。 有关调试表单的详细信息,请访问调试HTML5表单。
运行时包包含用于呈现HTML表单的客户端库。
作为运行时包的一部分提供的重要组件:
AdobeXFA实现支持两种脚本语言,以支持表单中的用户定义逻辑执行:JavaScript和FormCalc。
HTMLForms的脚本引擎使用JavaScript编写,以支持这两种语言的XFA脚本API。
在渲染时,FormCalc脚本将转换(并缓存)为服务器上对用户或设计人员透明的JavaScript。
此脚本引擎使用ECMAScript5的一些功能,如Object.defineProperty。 引擎/库以类别名xfaforms.用户档案的CQ客户端库的形式提供。 它还提供FormBridge API以使外部门户或应用程序能够与表单交互。 使用FormBridge,外部应用程序可以有计划地隐藏某些元素、获取或设置其值或更改其属性。
有关详细信息,请参阅表单桥接器文章。
HTML5表单的布局和可视方面基于SVG 1.1、jQuery、BackBone和CSS3功能。 表单的初始外观将在服务器上生成并缓存。 在客户端上管理初始布局的调整以及表单布局的任何进一步增量更改。 为此,运行时包包含一个以JavaScript编写并基于jQuery/Backbone的布局引擎。 此引擎处理所有动态行为,如“添加/删除”可重复实例、“可增长对象”布局。 此布局引擎一次只渲染一个表单页面。 最初,用户仅视图一页,而水平滚动条仅占第一页。 但是,当用户向下滚动时,下一页开始呈现。 此逐页再现减少了在浏览器中呈现第一页所需的时间,并增强了表单的可感知性能。 此引擎/库是类别名xfaforms.用户档案的CQ客户端库的一部分。
布局引擎还包含一组用于从用户捕获表单字段值的构件。 这些构件建模为jQuery UI构件,这些构件实施了特定的附加合同以与布局引擎无缝协作。
有关构件和相应合同的详细信息,请参阅HTML5表单的自定义构件。
与HTML元素关联的样式是内嵌的或基于嵌入的CSS块添加的。 某些不依赖表单的常见样式是CQ客户端库的一部分,其类别名为xfaforms.用户档案。
除了默认样式属性外,每个表单元素还包含基于元素类型、名称和其他属性的特定CSS类。 使用这些类,您可以通过指定元素自己的CSS来重新设置元素样式。
有关默认样式和类的详细信息,请参阅样式简介。
任何标记为在服务器上运行或标记为调用Web服务的脚本(无论其标记为执行的位置)始终在服务器上执行。
客户端脚本引擎:
HTML5表单支持意大利语(it)、西班牙语(es)、巴西葡萄牙语(pt_BR)、简体中文(zh_CN)、繁体中文(仅限支持)(zh_TW)、朝鲜语(ko_KR)、英语(en_US)、法语(fr_FR)、德语(de_DE)和日语(ja)语言。 根据请求标头中收到的区域设置,相应的资源包会发送到客户端。 此资源包作为用户档案JSP添加为类别名xfaforms.I18N的CQ客户端库。 您可以覆盖在用户档案中拾取区域设置包的逻辑。
Sling包包含与用户档案和用户档案渲染器相关的内容。
用户档案是sling中表示表单或Forms系列的资源节点。 在CQ级别,这些用户档案是JCR节点。 节点位于JCR存储库的/content文件夹下,可位于/content文件夹下的任意子文件夹内。
用户档案节点具有属性sling:resourceSuperType,其值为xfaforms/用户档案。 此属性在内部向位于/libs/xfaforms/用户档案文件夹中的用户档案节点的sling脚本发送转发请求。 这些脚本是JSP页,它们是将HTML表单和所需的JS/CSS对象组合在一起的容器。 页面包括对以下内容的引用:
这些库建模为CQ客户端库,它利用CQ框架JavaScript库的自动连接、缩小和压缩功能。
有关CQ客户端库的详细信息,请参阅CQ Clientlib文档。
如上所述,用户档案渲染器JSP通过sling include调用Forms服务。 此JSP还根据管理员配置或请求参数设置各种调试选项。
HTML5表单允许开发人员创建用户档案和用户档案渲染器以自定义表单的外观。 例如,HTML表单允许开发人员将表单集成到现有HTML门户的面板或<div>部分。
有关创建自定义用户档案的详细信息,请参阅创建自定义用户档案。