让我们剖析几个简单的用例,并查看视图参数的工作原理(视图参数名称不是强制性的,以匹配通过URL查询字符串传递的请求参数,但在本文中,我们将重点讨论这种情况):
情况1
在index.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
...
<h:form>
Enter name:<h:inputText value="#{playersBean.playerName}"/>
Enter surname:<h:inputText value="#{playersBean.playerSurname}"/>
<h:commandButton value="Send" action="results?faces-redirect=true&includeViewParams=true"/>
</h:form>
在results.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
You requested name: <h:outputText value="#{playersBean.playerName}"/><br/>
You requested surname: <h:outputText value="#{playersBean.playerSurname}"/>
在PlayersBean
我们有:
@Named
@RequestScoped
public class PlayersBean {
private String playerName;
private String playerSurname;
...
}
当应用程序进入时发生了什么(设置查询字符串的方式并不重要;您可以手动进行操作,也可以通过
与
这里) index.xhtml?playernameparam=rafael&playersurnameparam=nadal
吗?
- 请求参数名称与视图参数的名称匹配,因此视图参数采用请求参数的值,最后将它们存储在
PlayersBean
管Bean中的playerName
和playerSurname
字段下。 因此,粗略地说,您可以通过视图参数设置托管bean字段。 - 视图将被渲染(生成HTML标记并将其发送到浏览器),因此您可以在文本输入中看到
rafael
和nadal
,因为它们是从托管Bean属性(即#{playersBean.playerName}
和#{playersBean.playerSurname}
)。 - 您(作为用户)可以在文本输入中手动修改这些值(文本)(或像这样保留它们)。 现在,当您单击
发送按钮,您实际上提交了具有当前值的表单(由<h:form>
分隔的部分
</h:form>
)。 因此,将提交名称和姓氏,并覆盖/初始化数据模型中的当前值(即使您没有修改它们)。 在对视图进行编码(渲染)期间,JSF还将针对PlayersBean
托管bean对视图参数进行编码。 - 此外,JSF注意到您想要在导航到下一个目标页面(
results.xhtml
)之前附加视图参数(将其信号告知:?faces-redirect=true&includeViewParams=true
)。 在此请求的前面,已经根据PlayersBean
托管bean评估了视图参数。 因此,JSF处理视图参数,并将根据视图参数名称和值计算出的相应查询字符串附加到操作URL。 - JSF导航到目标URL(现在包含查询字符串)。 这是可见的,多亏了
faces-redirect=true
。
案例2
在index.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
<h:form>
Enter name:<h:inputText value="#{playersBean.playerName}"/>
Enter surname:<h:inputText value="#{playersBean.playerSurname}"/>
<h:commandButton value="Send" action="results?faces-redirect=true&includeViewParams=true"/>
</h:form>
在results.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
You requested name: <h:outputText value="#{playersBean.playerName}"/><br/>
You requested surname: <h:outputText value="#{playersBean.playerSurname}"/>
在PlayersBean
我们有:
@Named
@RequestScoped
public class PlayersBean {
private String playerName = "roger";
private String playerSurname = "federer";
...
}
当应用程序到达index.xhtml时会发生什么? (无查询字符串)
- 没有查询字符串(没有请求参数)。 因此,无法从查询字符串初始化视图参数,并且它们在
PlayersBean
也未设置任何内容! - 呈现视图(生成HTML标记并将其发送到浏览器),并且文本输入反映了
roger和federer initalization
数据(这些是评估#{playersBean.playerName}
和#{playersBean.playerSurname}
)。 - 您(作为用户)可以在文本输入中(或不可以!)修改这些值。 现在,当您单击“
Send
按钮时,您实际上提交了表单(属于由<h:form>
界定的部分的数据
</h:form>
)。 因此,将提交名称和姓氏,并覆盖/初始化模型中的当前值(即使您没有修改它们)。 在对视图进行编码(渲染)期间,JSF还将针对PlayersBean
托管bean对视图参数进行编码。 - 此外,JSF注意到您想要在导航到下一个目标页面(
results.xhtml
)之前附加视图参数(将其信号告知:?faces-redirect=true&includeViewParams=true
)。 在此请求的前面,已经根据PlayersBean
托管bean评估了视图参数。 因此,JSF处理视图参数,并将根据视图参数名称和值计算出的相应查询字符串附加到操作URL。 - JSF导航到目标URL(现在包含查询字符串)。 这是可见的,多亏了
faces-redirect=true
。
案例3
在index.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
<h:link value="Send" outcome="results" includeViewParams="true"/>
在results.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
You requested name: <h:outputText value="#{playersBean.playerName}"/><br/>
You requested surname: <h:outputText value="#{playersBean.playerSurname}"/>
在PlayersBean
我们有:
@Named
@RequestScoped
public class PlayersBean {
private String playerName;
private String playerSurname;
...
}
当应用程序进入时发生了什么(设置查询字符串的方式并不重要;您可以手动进行操作,也可以通过 > 与 这里) index.xhtml?playernameparam=rafael&playersurnameparam=nadal
吗?
- 请求参数的名称与视图参数的名称匹配,因此视图参数采用请求参数的值,并将其存储在
playerName
和playerSurname
下的托管bean中。 因此,您可以通过视图参数设置托管bean字段。 - 视图将被渲染(生成HTML标记并将其发送到浏览器),因此在文本输入中,您可以看到
rafael
和nadal
文本,因为它们是从托管Bean提取的(这些是对#{playersBean.playerName}
和#{playersBean.playerSurname}
)。 在对视图进行编码(渲染)期间,JSF还将针对PlayersBean
托管bean对视图参数进行编码。 现在,检查页面的源代码,并注意,与<h:link>
相对应的<a href>
是按如下方式生成的(注意,这是已fix !
)。 因此,JSF将<h:link>
转换为<a href>
并从初始请求开始附加包含视图参数的查询字符串。includeViewParams="true"
属性会导致以下链接: - 当您单击链接时,您不会提交任何数据 (
<h:link>
绝不能在<h:form>
)。 您只需执行上面的静态HTML代码,这就是一个简单的GET请求! - JSF通过此GET(包含查询字符串)导航到目标URL。 不需要
faces-redirect=true
。
案例4
在index.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
<h:link value="Send" outcome="results" includeViewParams="true"/>
在results.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
You requested name: <h:outputText value="#{playersBean.playerName}"/><br/>
You requested surname: <h:outputText value="#{playersBean.playerSurname}"/>
在PlayersBean
我们有:
@Named
@RequestScoped
public class PlayersBean {
private String playerName = "roger";
private String playerSurname = "federer";
...
}
当应用程序到达index.xhtml时会发生什么? (无查询字符串)
- 没有请求参数。 因此,无法从查询字符串初始化视图参数。 view参数在托管bean中也没有设置任何内容!
- 视图已呈现(生成了HTML标记并将其发送到浏览器),因此您可以在文本输入中看到roger和
federer
,因为它们是从托管Bean提取的(这些是评估#{playersBean.playerName}
和#{playersBean.playerSurname}
)。 在对视图进行编码(渲染)期间,JSF还将针对PlayersBean
托管bean(获取roger
和federer
)对视图参数进行编码。 现在,检查页面的源代码,并注意,与<h:link>
相对应的<a href>
是按如下方式生成的(注意,这是已fix !
)。 因此,JSF将<h:link>
转换为<a href>
并从初始请求开始附加包含视图参数的查询字符串。includeViewParams="true"
属性会导致以下链接: - 单击链接时,您不会提交任何数据。 您只需执行上面的静态HTML代码,这就是一个简单的GET请求!
- JSF通过此GET(包含查询字符串)导航到目标URL。 不需要
faces-redirect=true
。
案例5
在index.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
<h:link value="Send" outcome="results" includeViewParams="true"/>
在results.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
You requested name: <h:outputText value="#{playersBean.playerName}"/><br/>
You requested surname: <h:outputText value="#{playersBean.playerSurname}"/>
在PlayersBean
我们有:
@Named
@RequestScoped
public class PlayersBean {
private String playerName; // this is null
private String playerSurname; // this is null
...
}
当应用程序到达index.xhtml时会发生什么? (无查询字符串)
- 没有请求参数。 因此,无法从查询字符串初始化视图参数。 view参数在bean中没有设置任何内容!
- 视图已呈现(生成了HTML标记并将其发送到浏览器),因此您无法在文本输入中看到任何内容,因为它们是从Bean中获取的(这些是
#{playersBean.playerName}
和#{playersBean.playerSurname}
均为null
–您不能期望看到文本为null!
)。 在对视图进行编码(渲染)期间,JSF还将针对PlayersBean
托管bean(获得null
)对视图参数进行编码。 现在,检查页面的源代码,并注意,与<h:link>
相对应的<a href>
是按如下方式生成的(注意,这是已fix !
)。 因此,JSF将<h:link>
转换为<a href>
,但是没有包含视图参数的查询字符串,因为JSF看到了includeViewParams="true"
属性,但是无法生成以下HTML:<a href =” /…/results.xhtml? playernameparam = null &amp; playersurnameparam = null “>发送</a>”因此,JSF将“忽略”null
值,并且没有要附加的查询字符串:<a href=”/…/results.xhtml”>发送</a> - 单击链接时,您不会提交任何数据。 您只需执行上面的静态HTML代码,这就是一个简单的GET请求!
- JSF通过此GET(包含查询字符串)导航到目标URL。 不需要faces-redirect = true。
案例6 –为了更好地理解
在index.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
<h:form>
Enter name:<h:inputText value="#{playersBean.playerName}"/>
Enter surname:<h:inputText value="#{playersBean.playerSurname}"/>
<h:commandButton value="Send" action="results?faces-redirect=true&includeViewParams=true"/>
</h:form>
在results.xhtml
页面中,我们有:
<f:metadata>
<f:viewParam name="playernameparam" value="#{playersBean.playerName}"/>
<f:viewParam name="playersurnameparam" value="#{playersBean.playerSurname}"/>
</f:metadata>
You requested name: <h:outputText value="#{playersBean.playerName}"/><br/>
You requested surname: <h:outputText value="#{playersBean.playerSurname}"/>
在PlayersBean
我们有:
@Named
@RequestScoped
public class PlayersBean {
private String playerName; // this is null
private String playerSurname; // this is null
...
}
当应用程序到达index.xhtml时会发生什么? (无查询字符串)
- 没有请求参数。 因此,无法从查询字符串初始化视图参数。 view参数在bean中也没有设置任何内容!
- 渲染视图(生成HTML标记并将其发送到浏览器),您可以看到两个空文本输入(这些是评估
#{playersBean.playerName}
和#{playersBean.playerSurname}
)。 您不能期望看到文本,为空! - 作为用户,请勿在这些文本输入中键入任何内容,然后按“
Send
按钮。 实际上,您将提交表单(属于由<h:form>
</h:form>
界定的部分的数据)。 因此,将提交名称和姓氏(它们是空白),并覆盖/初始化模型中的当前值。 在对视图进行编码(渲染)期间,JSF还将对PlayersBean
托管bean的视图参数进行编码(将获得空白)。 - 此外,JSF注意到您想要在导航到下一个目标页面(
results.xhtml
)之前附加视图参数(将其信号告知:?faces-redirect=true&includeViewParams=true
)。 在此请求的前面,已经根据PlayersBean
托管bean评估了视图参数。 因此,JSF处理视图参数,并将根据视图参数名称和值计算出的相应查询字符串附加到操作URL。 - JSF导航到目标URL(现在包含查询字符串)。 这是可见的,多亏了
faces-redirect=true
。
http://localhost:8080/.../results.xhtml?playernameparam=&playersurnameparam=
注意playernameparam
和playersurnameparam!
的值playersurnameparam!
由于您已提交空白区域,因此您将看到。 当然,这看起来“丑陋”且毫无用处。 也许您更喜欢将空白视为null
值。 为此,您可以在web.xml
设置以下上下文参数:
<context-param>
<param-name>javax.faces.INTERPRET_EMPTY_STRING_SUBMITTED_VALUES_AS_NULL</param-name>
<param-value>true</param-value>
</context-param>
现在,清理并构建应用程序,然后在相同的情况下再次运行它。 这次,当您按
发送按钮,您会注意到此链接:
- http:// localhost:8080 / ch2_6 / faces / results.xhtml
因此,没有查询字符串反映了视图参数的存在! 好吧,您只是指示JSF将提交的空字符串视为null
值。 但是,如您所知,附加了视图参数后,“ null
值”将被“忽略”。
注意
附加视图参数的方式可以在Mojarra的com.sun.faces.application.view.MultiViewHandler
看到。 特别是在:
// Mojarra 2.2.9, MultiViewHandler#addViewParameters()
protected void addViewParameters(FacesContext ctx,
String viewId,
Map<String,List<String>> existingParameters) {
UIViewRoot currentRoot = ctx.getViewRoot();
String currentViewId = currentRoot.getViewId();
Collection<UIViewParameter> toViewParams = Collections.emptyList();
Collection<UIViewParameter> currentViewParams;
boolean currentIsSameAsNew = false;
currentViewParams = ViewMetadata.getViewParameters(currentRoot);
if (currentViewId.equals(viewId)) {
currentIsSameAsNew = true;
toViewParams = currentViewParams;
} else {
ViewDeclarationLanguage pdl = getViewDeclarationLanguage(ctx, viewId);
ViewMetadata viewMetadata = pdl.getViewMetadata(ctx, viewId);
if (null != viewMetadata) {
UIViewRoot root = viewMetadata.createMetadataView(ctx);
toViewParams = ViewMetadata.getViewParameters(root);
}
}
if (toViewParams.isEmpty()) {
return;
}
for (UIViewParameter viewParam : toViewParams) {
String value = null;
// don't bother looking at view parameter if it's been overridden
if (existingParameters.containsKey(viewParam.getName())) {
continue;
}
if (paramHasValueExpression(viewParam)) {
value = viewParam.getStringValueFromModel(ctx);
}
if (value == null) {
if (currentIsSameAsNew) {
value = viewParam.getStringValue(ctx);
} else {
value = getStringValueToTransfer(ctx, viewParam, currentViewParams);
}
}
// SO, IF VALUE IS NULL, DON'T CONSIDER THIS A VIEW PARAM
if (value != null) {
List<String> existing = existingParameters.get(viewParam.getName());
if (existing == null) {
existing = new ArrayList<String>(4);
existingParameters.put(viewParam.getName(), existing);
}
existing.add(value);
}
}
}