JavaServer Pages(JSF) 在 Java 的 WEB 编程中已经被认为是下一个重大的事件通过 JSF 你可以在网页上使用 WEB 组件来捕获用户行为产生的事件不远的将来Java 工具将支持这个技术开发 WEB 应用程序将与我们现在开发 SWING 程序类似拖放控件写事件侦听器本文是一个 JSF 的简要介绍并且提供一个 JSF 的例子用来展示 JSF 的事件驱动特性要理解本文您需要对 servlets JSP JavaBeans 与标签库有一定的理解
首先一个 JSF 应用就是一个 servlet/JSP 应用它有一个配置描述符有 JSP 页面客户定制标签静态资源等等不同的是JSF 应用是事件驱动的你通过写一个事件侦听类来决定应用程序的行为以下建立一个 JSF 应用所需要的几个步骤
建立 JSP 页面用 JSF 组件包装 HTML 元素
写一个 JavaBean 用来保持用户输入与组件数据的状态
写一个事件侦听器来决定当某事件发生时应该有什么反映比如用户点击了一个按钮或者提交了表单JSF 支持两个事件ActionEvent 与 valueChangeEvent ActionEvent 是针对用户提交表单与点击按钮的而 valueChangeEvent 是当一个 JSF 组件改变了时触发
现在让我们来看一下 JSF 动作的细节
JSF 怎样工作
JSP 页面是 JSF 应用的用户接口每个页面包括一些 JSF 组件用来描述 WEB 控件如表单输入框按钮等等组件可以嵌入另一个组件中正如输入框可以在表单中每个 JSP 页面就这样表示为组件树JaveBeans 从用户的请求中获取数据并存储
这是有意思的部分每当用户做任何事情如点击按钮或者提交表单都有事件产生然后事件消息通过 HTTP 传到服务器在服务器端是一个配置了叫做 Faces servlet 的特殊 servlet 的 WEB 容器Faces servlet(javaxfaceswebappFacesServlet)是所有 JSF 应用的引擎每个 JSF 应用在 WEB 容器中都有独立的 Faces servlet 另一个重要的对象是 ntextFacesContext 它包括了所有关于当前用户请求的必要信息
Faces servlet 的后台处理是相当复杂的然而你没有必要了解这些细节只需要记住Faces servlet 为 JSP 页面创建了组件树对组件树的控制又对应着事件Faces servlet 知道怎么去创建组件树因为它已经访问了当前应用中所有的 JSP 页面Faces servlet 还会创建一个 Event 对象并把它传递给所有注册过的侦听器你可以通过与当前请求相对应的 FacesContext 得到这个页面的组件树
客户端浏览器上 WEB 控件产生的事件被包含在一个 HTTP 请求中放在一起还有如浏览器类型请求地址等其它信息因此所有需要 Faces servlet 处理的请求必须指向这个 servlet 那你怎样通过调用 Faces servelt 来处理每个 HTTP 请求呢?很容易只需要在配置描述符里用一个 servletmapping 元素把一个特殊的 URL 式样映射到 Faces servlet通常你会用到 /faces/* 样式如下所示
<! Faces Servlet >
<servlet>
<servletname>Faces Servlet</servletname>
<servletclass>javaxfaceswebappFacesServlet</servletclass>
<loadonstartup></loadonstartup>
</servlet>
<! Faces Servlet Mapping >
<servletmapping>
<servletname>Faces Servlet</servletname>
<urlpattern>/faces/*</urlpattern>
</servletmapping>
请求地址必须包含有在 <urlpattern> 元素中描述的样式这个要求不容易达到另外也需要注意的是 <servlet> 元素它包含 Faces servlet 有一个 <loadonstartup> 元素用来确是否应用程序第一次启动时 servlet 是否加载
为了捕获组件产生的事件你需要为这个组件写一个侦听器并把它注册给这个组件通过在表示组件的客户端标签中嵌入 <action_listener> 元素能做到这一点例如为了让一个名叫 jsfAppMyActionListener 的事件侦听器来捕获一个名叫 submitButton 的命令按钮产生的事件在你的 JSP 页面中写如下的代码即可
<h:command_button id=submitButton label=Add commandName=submit >
<f:action_listener type=jsfAppMyActionListener />
</h:command_button>
一个 action listener 必须实现 javaxfaceseventActionListener 接口而一个 valuechanged listener 必须实现 javafaceseventvalueChangedLister 接口下面让我们来创建一个简单的 JSF 应用以展现 JSF 是怎么样事件驱动的
一个简单的 JSF 应用
我们将创建一个简单的应用它可以实现对二个数字相加为了运行这个应用你需要准备 TOMCAT 与 JSF v EA(包含在 Java Web Services Developer Pack (JWSDP) 中)这个应用程序包括
adderjspJSP 页面
NumberBean 存放用户数据的 JavaBean
MyActionListener 事件侦听器
webxml 配置描述文件
为了使这个应用能正常工作还需要几个 jar 文件包括 JSF 标准实现与其它类库如果你安装了 JWSDP 你就可以在 jsflib 目录下找到所需要的这些文件把这些 jar 文件拷贝到 WEBINF/lib 目录下下面是整个的 jar 与 tld 文件列表
jsfapijar 包含有 Faces servlet 与其它相关 javaxfaces 包下面的类
jfsrijar 是 JSF 的参考实现
jstl_eljar
standardjar
此外一个 JSF 的应用还需要如下的类库它们是 Apache Jakarta 项目的一部分
commonsbeanutilsjar
commonsdigesterjar
commonsloggingjar is
以下的几小段讨论这个 JSF 示例的每个部分最后的一小段编译与运行解释 JSF 应用怎么样运行
创建目录结构
首先为你的 JSF 应用创建一个目录结构在 TOMCAT 中它在 webapps 目录下图描述了叫做 myJSFApp 的应用程序的目录结构
写配置描述符
与其它的 servlet/JSP 应用一样这个应用程序也需要一个配置描述文件如清单表示
Listing The deployment descriptor (the webxml file)
<?xml version=?>
<!DOCTYPE webapp PUBLIC
//Sun Microsystems Inc//DTD Web Application //EN
app__dtd;;>
<webapp>
<! Faces Servlet >
<servlet>
<servletname>Faces Servlet</servletname>
<servletclass>javaxfaceswebappFacesServlet</servletclass>
<loadonstartup> </loadonstartup>
</servlet>
<! Faces Servlet Mapping >
<servletmapping>
<servletname>Faces Servlet</servletname>
<urlpattern>/faces/*</urlpattern>
</servletmapping>
</webapp>
在这个配置描述文件中有二个部分 <servlet> 元素注册 Faces servlet <servletmapping> 元素声明任何包含有 /faces/ 式样的请求地址必须传递给 Faces servlet
创建 JSP 页面
一个叫做 adderjsp 的 JSP 页面提供用户接口如清单所示
Listing The adderjsp page
<%@ taglib uri=;; prefix=h %>
<%@ taglib uri=;; prefix=f %>
<html>
<head>
<title>Add numbers</title>
</head>
<body>
<jsp:useBean id=NumberBean class=jsfAppNumberBean scope=session />
<f:use_faces><br />
<h:form id=addForm formName=addForm ><br />
First Number:<br />
<h:input_number id=firstNumber valueRef=NumberBeanfirstNumber /><br />
Second Number:
<h:input_number id=secondNumber valueRef=NumberBeansecondNumber /><br />
Result:
<h:output_number id=output valueRef=NumberBeanresult/><br>
<h:command_button id=submitButton label=Add commandName=submit >
<f:action_listener type=jsfAppMyActionListener />
</h:command_button>
</h:form>
</f:use_faces>
</body>
</html>
我们首先定义了俩个标签它用到 JSF 的两个标签库html 与 core 这俩个标签库的定义可以在 jsfrijar 文件中找到所以你不用为它担心它们的前缀分别是 h / f
<%@ taglib uri=;; prefix=h %>
<%@ taglib uri=;; prefix=f %>
<jsp:useBean> 这个动作元素定义 NumberBean JavaBean 为 session scope
<jsp:useBean id=NumberBean class=jsfApp