读《JavaServer Faces 核心编程（第3版）》一书的记录—— 第 3 章 导航——案例 javaquiz-rest

All +All -
javaquiz-rest

+
-第一步：创建案例

使用随书源码在NetBeans中创建项目

+
-第二步：运行案例

在IDE中运行该案例
案例默认打开的首页页面是index.xhtml
+
-首页上显示的内容

+
-与案例javaquiz中的首页文件相比，区别是

该页面多一个链接：Skip

注意：在下面的阅读过程中，要重点关注它的区别点

+
-第三步：阅读案例结构

+
-第一层面：视图

与案例javaquiz的一致

+
-第二层面：控制

与案例javaquiz的一致

+
-第三层面：模型

与案例javaquiz的一致

+
-第四层面：配置

与案例javaquiz的一致

+
-第四步：阅读案例功能

+
-第一层面：视图

+
-页面文件

+
-index

+
-1，提供“视图参数”：

<f:metadata>

<f:viewParam name="q" value="#{quizBean.currentProblem}"/>

</f:metadata>

1）标签f:metadata
+
-2)子标签f:viewParam

（1）特性name用来指定视图参数的名称
（2）特性value用来指定视图参数的值

+
-2，提供链接组件Skip：

<h:link outcome="#{quizBean.skipOutcome}" value="Skip">

<f:param name="q" value="#{quizBean.currentProblem + 1}"/>

</h:link>

+
-1）标签h:link

（1）特性value用来指定该链接组件在页面上显示的“文本”
（2）特性outcome用来指定该链接组件的“结果”

+
-2）子标签f:param

（1）用来重写视图参数
（2）特性name用来指定参数的名称
（3）特性value用来指定参数的值

3，其余的与案例javaquiz中的同名文件内容相同

+
-success

1，提供链接组件Skip：代码与index中的相同
2，其余的与案例javaquiz中的同名文件内容相同

+
-again

1，提供链接组件Skip：代码与index中的相同
2，其余的与案例javaquiz中的同名文件内容相同

+
-failure

1，提供链接组件Skip：代码与index中的相同
2，其余的与案例javaquiz中的同名文件内容相同

+
-done

1，与案例javaquiz中的同名文件内容相同

+
-第二层面：控制

+
-页面控制器

+
-QuizBean功能

1）获取当前问题是问题集合中的哪一个：getCurrentProblem() : int
2）设置当前问题在问题集合中的下标：setCurrentProblem(int newValue)
3）获取链接“Skip”的“结果”：getSkipOutcome() : String
4）其余方法头同案例javaquiz的相同，但是方法体有些不同（这些内容超出了JSF范围，所以不做分析）

+
-数据控制器

+
-QuizBean功能

参见其作为“页面控制器”的功能描述

+
-第三层面：模型

与案例javaquiz的相同

+
-第四层面：配置

与案例javaquiz的一致

+
-发现新功能

+
-在页面文件中，除了done以外，都有一个链接“Skip”

作用是：跳过该问题，进入下一个问题
如果当前问题是问题集中的最后一个，那么就进入done页面

+
-第五步：案例中使用的新技术

+
-第一层面：视图

+
-index.xhtml

+
-1，“视图参数”标签：f:viewParam

*是元数据标签 f:metadata 的子标签
*必须放置在xhtml文件内部的顶部
+
-*视图参数的作用

这里的“参数名称与值对”相当于GET请求链接的参数，目的是传递参数到下一个视图

+
-2，该页面对视图参数的应用

在标签h:link中使用子标签f:param来重写视图参数

+
-3，“视图参数”的其他使用方式

+
-*不需要视图参数标签，而在“结果”字符串中指定参数

例如：

<h:link outcome="index?q=1" value="Skip">

+
-*在使用视图参数的标签中，应用该标签的特性includeViewParams="true"来包含所有的视图参数到查询字符串中

例如：

<h:link outcome="index" includeViewParams="true" value="Skip">

+
-其它页面

略

+
-第二层面：控制

+
-QuizBean

+
-*创建了一个int类型的数组

其size为问题集中存放问题的个数

+
-*计分方式

+
-在方法answerAction中

如果答案正确，将在数组中的某个下标处添加数值1，而这个下标数采用与当前问题在问题集中的下标数
如果答案错误，将在数组中的某个下标处添加数值0，而这个下标数采用与当前问题在问题集中的下标数

+
-*获取得分的方式

+
-在方法getScore中

轮询int数组中的元素，并且将其累加

+
-第三层面：模型

+
-Problem

与案例javaquiz相同

+
-第四层面：配置

与案例javaquiz相同