理解PrimeFaces进程/更新和JSF F：Ajax执行/呈现属性

Question

下面的例子很好用，但是我在基本概念上有点混乱。

<p:commandButton process="@parent"
                 update="@form"
                 action="#{bean.submit}" 
                 value="Submit" />

Answer 1

process属性是服务器端的，只能影响UIComponent实现EditableValueHolder（输入字段）或ActionSource（命令字段）。process属性使用一个以空格分隔的客户机ID列表告诉JSF，在（部分）表单提交时，在整个JSF生命周期中必须准确地处理哪些组件。

然后，JSF将应用请求值（根据组件自己的客户端ID查找HTTP请求参数，然后在EditableValueHolder组件的情况下将其设置为提交值，或者在ActionSource组件的情况下将新的ActionEvent排队），执行转换、验证和更新模型值（仅限EditableValueHolder组件），最后调用排队的ActionEvent（仅限ActionSource组件）。JSF将跳过process属性未覆盖的所有其他组件的处理。此外，在应用请求值阶段，其rendered属性计算结果为false的组件也将被跳过，作为防止被篡改请求的保护措施的一部分。

请注意，对于ActionSource组件（如 )来说，在process属性中包含组件本身非常重要，特别是如果您打算调用与组件关联的操作。因此，下面的示例在调用某个命令组件时只处理某个输入组件是行不通的：

<p:inputText id="foo" value="#{bean.foo}" />
<p:commandButton process="foo" action="#{bean.action}" />

它将只处理#{bean.foo}而不处理#{bean.action}。您还需要包含命令组件本身：

<p:inputText id="foo" value="#{bean.foo}" />
<p:commandButton process="@this foo" action="#{bean.action}" />

或者，正如您显然发现的，如果它们碰巧是唯一具有公共父级的组件，则使用@parent:

<p:panel><!-- Type doesn't matter, as long as it's a common parent. -->
    <p:inputText id="foo" value="#{bean.foo}" />
    <p:commandButton process="@parent" action="#{bean.action}" />
</p:panel>

或者，如果它们碰巧都是父UIForm组件的唯一组件，那么您也可以使用@form:

<h:form>
    <p:inputText id="foo" value="#{bean.foo}" />
    <p:commandButton process="@form" action="#{bean.action}" />
</h:form>

如果表单包含更多的输入组件，而您希望在处理过程中跳过这些组件，这有时是不希望的，而当您希望根据ajax侦听器方法中的当前输入组件更新另一个输入组件或某个UI部分时，这种情况就更多了。也就是说，您不希望其他输入组件上的验证错误阻止ajax侦听器方法的执行。

然后是@all。这在process属性中没有特殊效果，而只在update属性中有特殊效果。process=“@all”的行为与process=“@form”完全相同。HTML不支持同时提交多个表单。

顺便说一下，还有一个@none，在您完全不需要处理任何内容，而只想通过update更新某些特定部分的情况下，它可能很有用，特别是那些内容不依赖于提交的值或操作侦听器的部分。

需要注意的是，process属性对HTTP请求有效负载（请求参数的数量）没有影响。也就是说，发送 的HTML表示形式中包含的“所有内容”的默认HTML行为不会受到影响。如果您有一个很大的表单，并且希望将HTTP请求负载减少到仅有处理中绝对必需的这些，即仅有process属性覆盖的这些，那么您可以在PrimeFaces Ajax组件中设置PartialSubmit属性，如 或 。您还可以通过编辑web.xml并添加“全局”配置

<context-param>
    <param-name>primefaces.SUBMIT</param-name>
    <param-value>partial</param-value>
</context-param>

或者，您也可以使用OmniFaces 3.0+的 ，它默认为此行为。

与PrimeFaces特定的进程等效的标准JSF是 中的execute。它的行为完全相同，只是它不支持逗号分隔的字符串，而PrimeFaces则支持（尽管我个人建议坚持空格分隔的惯例），也不支持@parent关键字。此外，了解 默认为@form而 和 默认为@this可能是有用的。最后，了解process支持所谓的“PrimeFaces选择器”也很有用，请参见update=“@(.MyClass)”中的PrimeFaces选择器如何工作？

update属性是客户端的，可以影响所有UIComponent的HTML表示形式。update属性告诉JavaScript（负责处理ajax请求/响应的人），使用一个用空格分隔的客户机ID列表，需要更新HTML DOM树中的哪些部分作为对表单submit的响应。

然后，JSF将为此准备正确的ajax响应，只包含需要更新的部分。JSF将跳过ajax响应中update属性未覆盖的所有其他组件，从而使响应负载保持较小。此外，在呈现响应阶段，其rendered属性计算结果为false的组件将被跳过。请注意，即使它返回true，但如果它最初是false，JavaScript也不能在HTML DOM树中更新它。您需要换行它或更新它的父级。另请参见Ajax update/render不能在具有rendered属性的组件上工作。

通常情况下，您只希望在提交（部分）表单时更新客户端中真正需要“刷新”的组件。下面的示例通过@form更新整个父表单：

<h:form>
    <p:inputText id="foo" value="#{bean.foo}" required="true" />
    <p:message id="foo_m" for="foo" />
    <p:inputText id="bar" value="#{bean.bar}" required="true" />
    <p:message id="bar_m" for="bar" />
    <p:commandButton action="#{bean.action}" update="@form" />
</h:form>

（请注意，省略了process属性，因为该属性已默认为@form)

虽然这可能工作良好，但在这个特定示例中，输入和命令组件的更新是不必要的。除非更改action方法中的模型值foo和bar（这在UX透视图中是不直观的），否则更新它们是没有意义的。消息组件是唯一真正需要更新的：

<h:form>
    <p:inputText id="foo" value="#{bean.foo}" required="true" />
    <p:message id="foo_m" for="foo" />
    <p:inputText id="bar" value="#{bean.bar}" required="true" />
    <p:message id="bar_m" for="bar" />
    <p:commandButton action="#{bean.action}" update="foo_m bar_m" />
</h:form>

然而，当你有很多人的时候，这就变得很乏味了。这是PrimeFaces选择器存在的原因之一。这些消息组件在生成的HTML输出中具有ui-message的公共样式类，因此还应执行以下操作：

<h:form>
    <p:inputText id="foo" value="#{bean.foo}" required="true" />
    <p:message id="foo_m" for="foo" />
    <p:inputText id="bar" value="#{bean.bar}" required="true" />
    <p:message id="bar_m" for="bar" />
    <p:commandButton action="#{bean.action}" update="@(.ui-message)" />
</h:form>

@parent仅更新父组件，从而覆盖当前组件和所有同级组件及其子组件。如果您已经将表单在正常的组中分开，并且每个组都有自己的责任，那么这会更有用。@this显然只更新当前组件。通常情况下，只有当您需要在action方法中更改组件自己的HTML属性之一时，才需要这样做。例如。

<p:commandButton action="#{bean.action}" update="@this" 
    oncomplete="doSomething('#{bean.value}')" />

假设oncomplete需要与action中更改的value一起工作，那么如果组件没有更新，这个构造就不会工作，原因很简单，因为oncomplete是生成的HTML输出的一部分（因此在呈现响应期间会计算其中的所有EL表达式）。

@all更新整个文档，使用时应小心。通常，您希望使用true GET请求，而不是通过普通链接(或 )或通过？faces-redirect=true或externalcontext#redirection()执行post后的重定向。在效果方面，process=“@form”update=“@all”与非Ajax（非部分）提交的效果完全相同。在我的整个JSF生涯中，我遇到的@all唯一明智的用例是在ajax请求期间发生异常时完整地显示错误页面。另请参见处理AJAXified组件的JSF2.0异常的正确方法是什么？

与PrimeFaces特定的update等效的标准JSF是来自 的render。它的行为完全相同，只是它不支持逗号分隔的字符串，而PrimeFaces则支持（尽管我个人建议坚持空格分隔的惯例），也不支持@parent关键字。update和render默认为@none（即“nothing”）。

另见：

• 如何查找ajax更新/呈现组件的客户端ID？找不到从“bar”引用表达式“foo”的组件
• 按PrimeFaces P：CommandButton时事件的执行顺序
• 如何在例如p：dataTable分页过程中减少p：ajax的请求负载
• 如何在p：对话框中显示p：dataTable中当前行的详细信息，并在保存后更新
• 如何在JSF页面中使用 ？单一形式？多种形式？嵌套窗体？