3. 编写测试文件
通过以上两步,已经把开发所需的环境搭建完成了。现在可以开始JSF页面文件和Manage Bean类的编写了.在本文中会介绍几种简单的JSF标签.
JSF标签由两部分组成,一部分是html标签,另一部分是core标签,它们的URI分别是:http://java.sun.com/jsf/html和http://java.sun.com/jsf/html .下面是JSP和JAVA示例代码,我先把代码贴出来再对进行说明(文件名为UserBean.java和index.jsp):
/*ManageBean:UserBean.java*/
package src.com.corejsf;
public class UserBean {
private String name;
private String password;
public UserLogin() {}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
}
/*JSP Page:index.jsp*/
<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<%@taglib prefix="f" uri="http://java.sun.com/jsf/core"%>
<%@taglib prefix="h" uri="http://java.sun.com/jsf/html"%>
<html>
<f:view>
<head>
<f:loadBundle basename="src.com.corejsf.textResource" var="msg" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>JSP Page</title>
<style>
.error{
color:red;
font-size: 14pt ;
font-style:italic;
}
</style>
</head>
<body>
<h:form>
<table>
<tr>
<td>
<h:outputLabel value="#{msg.textName}" />
</td>
<td>
<h:inputText value="#{login.name}" />
</td>
</tr>
<tr>
<td>
<h:outputLabel value="#{msg.textPassword}" />
</td>
<td>
<h:inputSecret value="#{login.password}" />
</td>
</tr>
<tr>
<td>
MESSAGES:
</td>
<td>
<h:inputText value="#{login.name}" id="name" />
</td>
</tr>
<tr>
<td><h:commandButton action="usrLogin" value="Login"/></td>
<td>
<h:commandLink action="usrLogin">
<f:param name="para" value="paraValue" />
<h:outputText value="LinkToNextPage" />
</h:commandLink>
</td>
</tr>
</table>
</h:form>
</body>
</f:view>
</html>
/*JSP Page: responsePage.jsp*/
<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<%@taglib prefix="f" uri="http://java.sun.com/jsf/core"%>
<%@taglib prefix="h" uri="http://java.sun.com/jsf/html"%>
<html>
<f:view>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>JSP Page</title>
</head>
<body>
<h:outputFormat value="welcome {0} ,your password is {1}" >
<f:param value="#{login.name}" />
<f:param value="#{login.password}" />
</h:outputFormat>
<br/>
<%=request.getParameter("para")%>
</body>
</f:view>
</html>
说明:文件最上面两行红色的代码作用是导入JSF开发所需的标签库.整个代码中绿色的部分就是应用的JSF标签,在这个JSP文件中所应用到的JSF html标签有:
<h:outputLabel />
<h:outputText />
<h:inputText />
<h:inputSecret />
<h:commandButton action="usrLogin" value="Login"/>
<h:commandLink action="usrLogin">
<h:outputFormat value="welcome {0} ,your password is {1}" >
JSF core标签有:
<f:view>
<h:form>
<f:loadBundle basename="src.com.corejsf.textResource" var="msg" />
<f:param name="para" value="paraValue" />
JSF页面都被包含在<f:view></f:view>之间,表单域包含在<h:form></h:form>之间,以上的html标签都有一个共同的属性value,这个value可以是一个给定的字符串,也可以是绑定到ManageBean的一个字段.第二种用法更加灵活和广泛,也是我要说明的方法.
上面的UserBean.java就是一个受管Bean,其实它就是一个普通的JAVA类,或者说它是一个普通的Bean类.那么为什么有是受管Bean呢?其原因是在faces-config.xml中对其进行了配置,现在回过头去看第二步中展示的受管Bean的配置信息格式(如下):
<managed-bean>
<managed-bean-name>login</managed-bean-name> <managed-bean-class>
src.com.corejsf.UserBean
</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
</managed-bean>
其中<managed-bean-name>指定了受管Bean的名称,这里是user; <managed-bean-class>指定了受管Bean的完整类路径.根据上面我建立的目录结构可知这里的完整类路径是src.com.corejsf.UserBean; <managed-bean-scope>指定了这个类的生存期,可设置为session,request,application,none之一.在TOMCAT启动的时候会读取 faces-config.xml文件,这时就会把已配置好的UserBean类作为受管Bean.
现在,就可以把UserBean的字段和JSF标签中的value属性绑定了.方法是:value=#{login.name},这个绑定表达式就是把value的值和UserBean的name字段绑定.在页面显示的时候就会自动调用getter/setter方法.注意,在页面上进行绑定的时候引用的是在faces-config.xml中配置的<managed-bean-name>,因为在上面我用的是login,所以在页面上就是用的#{login.name},在运行的时候就会自动调用getName/setName方法.
另外,在上面的index.jsp文件中有一个core标签是<f:loadBundle basename="src.com.corejsf.textResource" var="msg" />,这个标签的作用是引用一个资源文件,这个文件是一个属性文件(*.properties),basename指定了文件的完整类路径,var属性说明在当前页面中用msg这个名称在引用资源.这种资源也可以绑定到标签的value属性中,方法和受管Bean的绑定方法一样.
标签应用说明:
<h:outputLabel value="#{msg.textName}" />:显示资源文件中textName字段的值
<h:outputText value="#{msg.textName}"/>:同outputLabel
<h:inputText value="#{login.name}" />:产生一个输入框,并和login.name绑定,输入的值存到name字段中.
<h:inputSecret value="#{login.password}" />:产生一个密码输入框,并和login.password绑定, 输入的值存到password字段中.
<h:commandButton action="usrLogin" value="Login"/>:产生一个命令按钮,当按下的时候激发usrLogin事件.
说明:在按钮和超级连接中都有一个action属性,这个属性是用来产生页面导航的.下面是上文所讲的页面导航配置格式,其含义是当在index.jsp页面产生了一个usrLogin事件时,就跳转到responsePage.jsp:
<navigation-rule>
<from-view-id>/index.jsp</from-view-id>
<navigation-case>
<from-outcome>usrLogin</from-outcome>
<to-view-id>/responsePage.jsp</to-view-id>
</navigation-case>
</navigation-rule>
<h:commandLink action="usrLogin">:作用如上面所说,另外,这个标签还可以和<f:param name="para" value="paraValue" />标签组合使用, <f:param name="para" value="paraValue" />标签就是传到下一个页面的参数,这个标签的功能就如同在URL后添加?para=paraValue这样的参数.根据配置,index.jsp页面中:
<h:commandLink action="usrLogin">
<f:param name="para" value="paraValue" />
<h:outputText value="LinkToNextPage" />
</h:commandLink>
这一段的功能同
<a href=”http://localhost:8888/JSFApp/faces/responsePage.jsp?para=paraValue”>LinkToNextPage</a>
把上面的JSP文件内容复制到工程文件夹的/web/index.jsp中,JAVA文件复制到/src/com/corejsf/UserBean.java中.再在faces-config.xml中添加如下的配置信息:
<navigation-rule>
<from-view-id>/index.jsp</from-view-id>
<navigation-case>
<from-outcome>usrLogin</from-outcome>
<to-view-id>/responsePage.jsp</to-view-id>
</navigation-case>
</navigation-rule>
<managed-bean>
<managed-bean-name>login</managed-bean-name>
<managed-bean-class>src.com.corejsf.UserBean</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
</managed-bean>