1。在新建的工程中添加jsf框架,将自动生成一web.xml文件。内容如下:
2。在src中编写一个bean,不同于Struts的是这个bean将集合FormBean和ActionBean,这就和以前我们写java类十分相似了,而且不用继承任何特定类。写好这个bean以后在WEB-INF下的faces-config.xml中加入下列一段代码,将该bean转换成jsf的managed Bean。
<managed-bean>
<managed-bean-name>该bean的别名</managed-bean-name>
<managed-bean-class>
该bean所在位置(包名+类名)
</managed-bean-class>
<managed-bean-scope>该bean的存在范围(session,request,application,none四种)</managed-bean-scope>
</managed-bean>
跳转的映射是加入如下一段:
<navigation-rule>
<from-view-id>/输入的页面名</from-view-id>
<navigation-case>
<from-outcome>代表跳转到哪里的字符串(这里可以随便定义)</from-outcome>
<to-view-id>/跳转的页面名</to-view-id>
</navigation-case>
</navigation-rule>
3。新建一个带jsf标签的jsp页面,<body></body>中输入如下代码:
<f:view>
<h:outputText value="#{backing bean名.字段名}"></h:outputText> //要输出到页面的值
<h:form> //form
<h:inputText value="#{backing bean名.字段名}"></h:inputText><br/> //要输入的字段
<h:commandButton action="#{backing bean名.业务方法}" value="按钮文字"></h:commandButton>
</h:form>
</f:view>
4。使用jsf自带的验证组件
在输入框标签中加入required="true"表示该输入框必须输入。
JSF提供了三种标准验证器:<f:validateDoubleRange>、<f:validateLongRange>、<f:validateLength>
使用方法是将要验证的标签插入输入框标签中,即用<></>将其套在里面。具体使用参看帮助文档。
5。使用自定义验证
(1)先在src目录下创建一个验证类,要实现Validator接口的validate(FacesContext arg0, UIComponent arg1, Object arg2)方法并抛出ValidatorException异常,如下:
public void validate(FacesContext arg0, UIComponent arg1, Object arg2) throws ValidatorException {
if(验证不通过条件){
FacesMessage fm = new FacesMessage(FacesMessage.SEVERITY_ERROR, "数值不通过原因", "显示在页面上的信息");
throw new ValidatorException(fm);
}
}
(2)在faces-config.xml中加入以下一段:
<validator>
<validator-id>验证类的别名</validator-id>
<validator-class>验证类的包名+类名</validator-class>
</validator>
(3)把<f:validator validatorId="验证类别名" />用需要验证的标签套住,要输出错误信息使用<h:message for="输入框的ID号"></h:message>
6。jsf的国际化
(1)在src目录下创建xxx.properties文件,并在里面将国际化需要的内容输入,这个文件与struts的国际化文件相同。
(2)在faces-config.xml中加入如下代码:
<application>
<message-bundle>国际化文件的前缀名(不含_zh_CN之类)</message-bundle>
<locale-config>
<default-locale>en</default-locale>(默认国际化语言,只能有1个)
<supported-locale>zh_CN</supported-locale>(支持的国际化语言,可以多个)
</locale-config>
</application>
(3)在jsp页面中添加如下代码(为了支持多种语言,需要将html的编码改为utf-8):
<f:view locale="设置显示的语言,即后缀,如zh_CN">
<f:loadBundle basename="国际化文件前缀名" var="国际化文件别名" />
<h:outputLabel value="#{别名['键名']}"></h:outputLabel>
</f:view>
(4)也可通过使用一个属性来让用户自行选择所需的语言,jsp页面中的代码如下(该属性定为session):
<f:view locale="#{cl.language}"> //读出用户选择的语言
<f:loadBundle basename="message" var="m" />
<h:outputLabel value="#{m['label.showtext']}"></h:outputLabel>
<h:form>
<h:selectOneMenu value="#{cl.language}"> //使用下拉框取得用户选择值
<f:selectItem itemValue="en" itemLabel="#{m['select.en']}" />
<f:selectItem itemValue="zh_CN" itemLabel="#{m['select.zh']}" />
</h:selectOneMenu>
<h:commandButton type="submit" action="#{cl.change}" value="go"></h:commandButton> //只是跳转的方法
</h:form>
</f:view>
jsf标签说明:
标签 |
说明 |
view |
创建顶层视图 |
subview |
创建视图的子视图 |
facet |
向组件添加 facet |
param |
向组件添加参数 |
attribute |
向组件添加属性 |
actionListener |
在父组件上注册操作监听器 |
valueChangeListener |
向父组件注册值变更监听器 |
converter |
注册任意转换器 |
convertDateTime |
注册日期时间转换器 |
convertNumber |
注册数量转换器 |
validateLength |
验证组件值的长度 |
validateDoubleRange |
验证组件值的双精度范围 |
validateLongRange |
验证组件值的长整型范围 |
validator |
向组件添加验证器 |
loadBundle |
加载资源包 |
verbatim |
向页面中添加标签 |
selectItem |
指定 UISelectOne 或 UISelectMany 组件的一个项目 |
selectItems |
指定 UISelectOne 或 UISelectMany 组件的多个项目 |
组件 |
标签 |
说明 |
UIForm |
form |
表示 HTML表单元素 |
UIInput |
InputText |
单行文本输入控件 |
|
inputTextarea |
多行文本输入控件 |
|
InputSecret |
密码输入控件 |
|
inputHidden |
隐藏字段 |
UIOutput |
outputLabel |
显示文本 |
|
outputLink |
链接到另一页面或某页面上的特定位置 |
|
outputFormat |
显示格式化的信息 |
|
outputText |
当行文本输入 |
UICommand |
commandButton |
表示一个按钮 |
|
commandLink |
表示一个链接 |
UISelectOne |
SelectOneListbox |
单选列表框 |
|
selectOneMenu |
单选菜单 |
|
selectOneRadio |
单选按钮集 |
UISelectBoolean |
selectBooleanCheckbox |
单个复选框 |
UISelectMany |
selectManyListbox |
复选框集 |
|
selectManyCheckbox |
多行选择列表框 |
|
selectManyMenu |
多选菜单 |
UIPanel |
panelGrid |
表示一 个 HTML 表格 |
|
panelGroup |
组合一系列组件 |
UIMessage |
message |
显示一个组件的最近使用的消息 |
|
messages |
显示所有消息 |
UIGraphic |
graphicImage |
显示一个图像 |
UIData |
dataTable |
功能丰富的表格控件 |
UIColumn |
column |
表示表格中的列 |
表单 |
h:form |
产生 HTML form 元素 |
如何用JSF标签进行IF ELSE 判断?
<c:if test="${'true' == TestData.isDebug}"> //JSTL的IF标签
<h:outputText value="Begin local testing" /> //JSF的输出标签
</c:if>
<c:if test="${'false' == TestData.isDebug}">
<h:outputText value="End local testing" />
</c:if>
把上边的JSTL换成JSF做判断之后并显示写成:
<h:outputText value="Begin local testing" rendered="#{'true' == TestData.isDebug}"/>
<h:outputText value="End local testing" rendered="#{false== TestData.isDebug}"/>