读《JavaServer Faces 核心编程（第3版）》一书的记录—— 第 4 章 标准 JSF 标签——案例 flags

All +All -
flags

+
-第一步：创建案例

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

+
-第二步：运行案例

在IDE中运行该案例

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

+
-Web

+
-页面文件

index.xhtml
thankYou.xhtml

+
-资源文件夹resources

+
-子文件夹images

图像文件de_flag.gif
图像文件en_flag.gif

+
-源包

+
-java包com.corejsf

LocaleChanger.java
UserBean.java
messages.properties
messages_de.properties

+
-库

JDK 1.7
GlassFish Server 3.1.2

+
-配置文件

beans.xml
faces-config.xml
web.xml

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

+
-第一层面：视图

+
-页面文件

+
-index.xhtml

*标题显示内容：Using Command Linke
*上部显示：德国旗帜和英国旗帜图案的“链接”组件
*当单击德国旗帜图案的链接时，页面显示的文本，由英文改变为德文
*当单击英国旗帜图案的链接时，页面显示的文本，由德文改变为英文

+
-thankYou.xhtml

与案例personalData相同

+
-第二层面：控制

+
-页面控制器

+
-UserBean

+
-*属性

保存用户名、密码和自我介绍信息的3个String类型的属性

+
-*方法

上述3个属性的读写方法

+
-LocaleChanger

*germanAction()
*englishAction()

+
-数据控制器

UserBean

+
-第三层面：模型

UserBean

+
-第四层面：配置

无新内容

+
-第五步：详解新技术--使用命名链接组件

+
-第一层面：视图

+
-视图文件

+
-index.xhtml

+
-*关于德国和英国旗帜的图案

+
-1，旗帜图案的文件在哪里？

在web根下的resources目录下（该目录是JSF2.0对页面资源的引用规定的一个固定目录）的子目录images内
+
-文件

en_flag.gif（是英国国旗图像文件）
de_flag.gif（是德国国旗图像文件）

+
-2，在哪个组件上应用了这些图案文件？

在组件h:commandLink的子组件h:graphicImage中应用了图像文件

*用组件h:graphicImage，来引入图像文件，在该组件出现的地方
*用组件h:graphicImage的特性library，来指定图像文件所在（在固定文件夹resources下）的能够文件夹，例如：library="images"

*用组件library的特性name，来指定图像文件的名称，例如：name="en_flag.gif"

+
-*关于德国和英国旗帜图案上的链接

+
-1，点击旗帜图案后页面上如何能够显示对应国家的语言文字呢？

（1）旗帜图案所在的组件，是个链接组件h:commandLink
（2）链接组件上的动作事件，由该组件的特性action指定的方法来处理

*这里指定的是一个JSF表达式

#{localeChanger.germanAction}
#{localeChanger.englishAction}

*表达式是页面后台控制器LocaleChanger实例对象的一个方法

germanAction()
englishAction()

（3）处理事件的方法都干了哪些事儿？

*这两个方法返回的都是null，因为这里不需要导航到其它也没去
*方法中设置了本地语言为链接所代表的那个国家的语言

英文为：Locale.ENGLISH
德文为：Locale.GERMAN

2，具体后台管理器的功能，参见类LocaleChanger

+
-thankYou.xhtml

无新内容

+
-视图资源

JSF2.0资源规定目录：resource
存放资源文件的子目录：images
+
-图像文件

德国国旗图像文件de_flag.gif
英国国旗图像文件en_flag.gif

+
-第二层面：控制

+
-页面控制器

+
-UserBean

无新内容

+
-LocaleChanger

+
-方法

处理设置应用场所为英国的方法：englishAction；返回null
处理设置应用场所为德国的方法：germanAction；返回null

+
-数据控制器

+
-UserBean

无新内容

+
-第三层面：模型

+
-UserBean

无新内容

+
-第四层面：配置

无新内容

+
-第五层面：国际化

+
-英文消息文件

com.corejsf.messages.properties

+
-德文消息文件

com.corejsf.messages_de.properties

+
-不同语言的消息文件的命名

在英文消息文件的基础上，添加下划线“_”和类Locale中对国家声明的常量字符，

例如：对英国的消息文件如果命名为messages

那么，对德国的消息文件必须命名为messages_de

对简体中文的消息文件必须命名为messages_zh_CN

对台湾中文的消息文件必须命名为messages_zh_TW

注意：这里不讨论太多国际化问题，它超出了该案例的主要问题

+
-第六步：应用JSF API

+
-1，找出英国英文的“本地对象”

Locale.ENGLISH

+
-2，找出德国德文的“本地对象”

Locale.GERMAN

+
-3，找的Faces的上下文对象

FacesContext context = FacesContext.getCurrentInstance();

+
-4，从Faces上下文对象中，找出“用户界面视图的根组件”，然后在根视图中设置“本地对象”

context.getViewRoot().setLocale(Locale.ENGLISH);

5，设置英国的本地对象的代码可以如下所示：

FacesContext context = FacesContext.getCurrentInstance();

UIViewRoot viewRoot=context.getViewRoot();

viewRoot.setLocale(Locale.ENGLISH);

6，设置德国的本地对象的代码可以如下所示：

FacesContext context = FacesContext.getCurrentInstance();

UIViewRoot viewRoot=context.getViewRoot();

viewRoot.setLocale(Locale.GERMAN);