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)

{

Application application =FacesContext.getCurrentInstance().getApplication();

List children = controlPanel.getChildren();

children.clear();

for (int count = 0; count < numControls; count++)

{

HtmlOutputText output = (HtmlOutputText)application.

createComponent(HtmlOutputText.COMPONENT_TYPE);

output.setValue(" " + count + " ");

output.setStyle("color: blue");

children.add(output);

}

}

JSF 的#{}比EL还多了到托管bean中查找的功能。