JSF标签的使用2

总结：

n 事件监听器是用于解决只影响用户界面的事件

Ø 特别地，在beans的form数据被加载和触发验证前被调用

• 用immediate=“true”指明这个行为不触发验证

Ø 在监听器调用后，会重新显示表单

• 不应用导航规则，不重定向页面

n ActionListener

Ø 隶属于按钮、超链接和图形映射控件

Ø 自动提交对应表单

n ValueChangeListener

Ø 隶属于单选框、组合框、列表框、复选框、文本框等控件

Ø 需要用onclick=“submit()”或onchange=“submit()”的方式提交表单

• 请在各种不同的浏览器上小心测试

h:inputText

Ø valueChangeListener. 当表单中的内容被改变，提交表单时就会触发方法

触发形式为 onchange=“submit()“ 并且附带有immediate 的标记值

Ø onchange. 当value发生变化时，就运行JavaScript

Ø immediate. 用于指定无需验证

Ø required. 指出使用的时候必须提供一个value

h:commandButton (with value)

n 相当于HTML中的 <INPUT TYPE=“SUBMIT”…>

n 属性

Ø value. 按钮的标签，通常是一个静态的字符串，也可以使用动态的变量

Ø action.当表单提交时运行相应的方法，前提是所有的监听器已经作用完毕

Ø actionListener. 当表单提交时运行该方法

运行方法，然后再次显示表单，没有事务逻辑，返回值以及导航规则

Ø immediate. 指定绕过setter方法和验证器

通常用于actionListener

h:commandLink

n 相当于HTML中附带有JavaScript <A HREF=“… “>

Ø 当链接被点击时， JavaScript提交表单

Ø 在JSF中JavaScript被自行插入

n 属性

Ø value. 链接文本，通常是一个静态的字符串，也可以使用动态的变量

Ø action.当表单提交时运行相应的方法

Ø actionListener.当表单提交时运行该监听方法

n 注意

Ø 必须写在<h:form>中

f:selectItems的value应该是java.faces.model.SelectItem的一个列表或数组

n 选项的两种主要构造方法

Ø 一种仅仅指定一个字符串

同字符串一样的value被页面显示同时传给set方法

Ø 另一种指定一个Java对象和一个字符串

显示在页面上的是字符串，但提供给set方法的value是这个Java对象(这种参数的映射是被JSF自动执行)

SelectItem[] listboxItems =

{ new SelectItem(realValue1, "DisplayVal1"),

new SelectItem(realValue2, "DisplayVal2"),

...

}

校验方式：

手工校验

Ø 使用bean的string类型属性

Ø 在setter方法或action控制器中做校验

Ø 返回null值时重显form

Ø 创建自定义的错误信息

n 隐式自动校验

Ø 使用int, double等bean属性，或添加required标识

Ø 如果有转换错误，则系统重显form

Ø 使用h:message显示特定字段的错误信息

n 显式自动校验

Ø 使用f:convertNumber, f:convertDateTime, f:validateLength, f:validateDoubleRange 或f:validateLongRange

Ø 如果失败系统重现页面，同样我们可以使用h:message

n 自定义校验器

Ø 创建以ValidatorException包装的FacesMessage,在faces-config.xml中注册，Validator覆盖validate

在action控制器中做校验－手工校验

n Setter方法接收字符串并转换

Ø 使用try/catch语句

Ø 使用应用程序特定的逻辑

n action控制器检查赋值

Ø 如果值正确

• 返回正常的结果

Ø 如果值丢失或非法

• 在bean中储存错误信息

• 返回null

n 输入页面

Ø 显示错误信息

• 默认的错误信息应该是一个空字符串

• 如果错误信息中包含html tags, 在h:outputText中使用escape=”false”

使用escape，意味着不会过滤掉 “<“、 “>”等字符

构造自定义错误信息

1. 创建一个FacesMessage

2. 通过facesContext.addMessage将FacesMessage保存在全局消息列表中

3. 返回空重显输入页面

4. 使用h:messages或者h:message在输入页面显示错误消息

优点：

1. 程序员不需要自己去保存消息

2. 不需要写HTML代码或者使用escape=”false”

3. 符合标准JSF校验

缺点：

4. 对于错误信息的格式缺少控制

————————————

转换 vs. 校验

n f:convertBlah和f:validateBlah都会校验输入格式，并且在输入不合法的情况下重显页面

Ø 但f:convertBlah还会改变显示字段的格式

Ø f:validateBlah只有对h:inputText有效

Ø f:convertBlah对h:inputText和h:outputText都有效

n 例如

<h:inputText value="#{orderBean.discountCode}">

<f:convertNumber maxFractionDigits="2" />

</h:inputText>

Ø 显示0.75或类似的数字(而不是0.749)

n f:convertNumber

– currencyCode, currencySymbol

– groupingUsed

– integerOnly

– locale

– max(min)FractionDigits

– max(min)IntegerDigits

– pattern (ala DecimalFormat)

– type

• number, currency, percentage

n f:validateLength

– minimum

– maximum

n f:validateLongRange

– minimum

– maximum

n f:validateDoubleRange

– minimum

– maximum

n f:convertDateTime

– type

• date, time, both

– dateStyle, timeStyle

• default, short, medium, long,full

– pattern (ala SimpleDateFormat)

– locale

– timeZone

转换器和校验器属

n Converters

– Implement Converter

interface

– getAsObject

• Takes String; returns

Object

– getAsString

• Takes Object; returns

String

– Conversion errors

• Throw

ConverterException with

FacesMessage

– Register in faces-config.xml

• converter, converter-id,

converter-class

– Use converter attribute

<h:inputText value="#{…}" converter="someID"/>

<p>

<h:panelGrid id="controlPanel"

binding="#{helloBean.controlPanel}"

columns="20" border="1" cellspacing="0"/>

</p>

<h:commandButton id="redisplayCommand" type="submit"

value="Redisplay"

actionListener="#{helloBean.addControls}"/>

public void addControls(ActionEvent actionEvent)

{