使用JSF(Java Server Faces)开发(四)
处理表单数据
类PBuilder包含一个静态方法以PBean实例为参数并且根据JavaBean对象的属性生成HTML:
package com.devsphere.articles.usingjsf;
public class PBuilder {
public static String toHTML(PBean pbean) {
StringBuffer buf = new StringBuffer();
buf.append("<p align=\"");
buf.append(pbean.getAlign());
buf.append("\">");
buf.append("<font size=\"");
buf.append(pbean.getSize());
buf.append("\" color=\"");
buf.append(pbean.getColor());
buf.append("\"");
Object font[] = pbean.getFont();
if (font != null && font.length > 0) {
buf.append(" face=\"");
for (int j = 0; j < font.length; j++) {
if (j > 0)
buf.append(',');
buf.append(font[j]);
}
buf.append("\"");
}
buf.append(">");
if (pbean.isBold())
buf.append("<b>");
if (pbean.isItalic())
buf.append("<i>");
if (pbean.isUnderline())
buf.append("<u>");
String s = pbean.getText();
int n = s.length();
for (int i = 0; i < n; i++) {
char ch = s.charAt(i);
switch (ch) {
case '<':
buf.append("<");
break;
case '>':
buf.append(">");
break;
case '&':
buf.append("&");
break;
case '"':
buf.append(""");
break;
default:
buf.append(ch);
}
}
if (pbean.isUnderline())
buf.append("</u>");
if (pbean.isItalic())
buf.append("</i>");
if (pbean.isBold())
buf.append("</b>");
buf.append("</font>");
buf.append("</p>");
return buf.toString();
}
}
文件view.jsp用<jsp:useBean>获得JSF管理的JavaBean实例,调用PBuilder的toHTML()方法,并输出HTML结果。JSF的<h:command_hyperlink>标记用于提供一个返回edit.jsp页的超联接:
<%@ taglib prefix="f" uri="http://java.sun.com/jsf/core"; %>
<%@ taglib prefix="h" uri="http://java.sun.com/jsf/html"; %>
<html>
<head>
<title>View</title>
</head>
<body>
<jsp:useBean id="pbean" scope="session"
class="com.devsphere.articles.usingjsf.PBean"/>
<%= com.devsphere.articles.usingjsf.PBuilder.toHTML(pbean) %>
<f:use_faces>
<h:command_hyperlink label="Back to Editing" href="edit.jsp"/>
</f:use_faces>
</body>
</html>
应用配置
JSF框架有一个用于实现控制器(controller)的服务端小程序(servlet)叫FacesServlet,该小程序必须截取所有包含JSF标记的JSP页面的请求。这个小程序在应用描述器文件web.xml中进行配置,并且映射为 /faces/* 的URL模式。要激活这个小程序,JSP程序中的路径必须以“faces”开头。应用的主页index.jsp调用response.sendRedirect()使浏览器转移到faces/edit.jsp页面:
<% response.sendRedirect("faces/edit.jsp"); %>
文件faces-config.xml的路径在描述器文件web.xml中用环境参数进行说明,该描述器文件中还包含了监听器注册以及其他一些用于JSF实现的引用说明。文件web.xml的内容如下所示:
<?xml version="1.0"?>
<!DOCTYPE web-app PUBLIC
"-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
"http://java.sun.com/dtd/web-app_2_3.dtd";>
<web-app>
<context-param>
<param-name>javax.faces.application.CONFIG_FILES</param-name>
<param-value>/WEB-INF/faces-config.xml</param-value>
</context-param>
<context-param>
<param-name>com.sun.faces.saveStateInClient</param-name>
<param-value>false</param-value>
</context-param>
<context-param>
<param-name>com.sun.faces.validateXml</param-name>
<param-value>true</param-value>
</context-param>
<listener>
<listener-class>com.sun.faces.config.ConfigListener</listener-class>
</listener>
<servlet>
<servlet-name>FacesServlet</servlet-name>
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>FacesServlet</servlet-name>
<url-pattern>/faces/*</url-pattern>
</servlet-mapping>
</web-app>
当第一次生成一个表单时,JSF创建一个称之为组件树(component tree)的对象结构,其中包含用户界面组件以及验证器(validator)注册这些组件等等相关信息。用户提交表单数据时,JSF根据组件树中的信息进行一些操作,如验证用户输入。默认情况下,JSF将组件树作为一个属性存储在session中。一旦应用完成,这种方式能够正常的运行。但是,在进一步开发时,只要你改变了JSF表单(包括添加或者删除界面组件),JSF就会抛出异常,因为在JSP文件被修改时JSF没有废弃过期的组件树。应该把在web.xml中声明的标记saveStateInClient设置为真(true)。做了这个修改之后,JSF将序列化组件树并将其存入HTML表单的隐藏区域中而不再存储在session中。
总结
本文已经介绍了JSF框架的基本特性,演示了如何用JSF标记建立表单。作为预览包,JSF的实现引用EA4还不能部署,但大部分功能是可用的。在JCP组织(Java Community Process)两年多的研究表明,JSF会受到广泛的欢迎,Java开发者确实需要一种建立web用户界面的标准标记库和建立定制web组件的标准API