JSF入门实例

    Web应用程序的开发与传统的单机程序开发在本质上存在着太多的差异，Web应用程序开发人员至今不可避免的必须处理HTTP的细节，而HTTP无状态的（stateless）本质，与传统应用程序必须维持程序运行过程中的信息有明显的违背，再则Web应用程序面对网站上不同的使用者同时的存取，其执行线程安全问题以及数据验证、转换处理等问题，又是复杂且难以解决的。
另一方面，本质上是静态的HTML与本质上是动态的应用程序又是一项违背，这造成不可避免的，处理网页设计的美术人员与程序设计人员，必须被彼此加入至视图组件中的逻辑互相干扰，即便一些视图呈现逻辑以标签的方式呈现，试图展现对网页设计美术人员的亲切，但它终究必须牵涉到相关的流程逻辑。
有很多方案试着解决种种的困境，而各自的着眼点各不相同，有的从程序设计人员的角度来解决，有的从网页设计人员的角度来解决，各种的框架被提出，所造成的是各种不统一的标签与框架，为了促进产能的集成开发环境（IDE）难以整合这些标签与框架，另一方面，开发人员的学习负担也不断的加重，他们必须一人了解多个角色的工作。
JavaServer Faces的提出在试图解决这个问题，它试图在不同的角度上提供网页设计人员、应用程序设计人员、组件开发人员解决方案，让不同技术的人员可以彼此合作又不互相干扰，它综合了各家厂商现有的技术特点，由Java Community Process（JCP）团队研拟出来的一套标准，并在2004年三月发表了JavaServer Faces 1.0实现成果。
从网页设计人员的角度来看，JavaServer Faces提供了一套像是新版本的HTML标签，但它不是静态的，而是动态的，可以与后端的动态程序结合，但网页设计人员不需要理会后端的动态部份，网页设计人员甚至不太需要接触JSTL这类的标签，也可以动态的展现数据（像是动态的查询表格内容），JavaServer Faces提供标准的标签，这可以与网页编辑程序结合在一起，另一方面，JavaServer Faces也允许您自定义标签。
从应用程序设计人员的角度来看，JavaServer Faces提供一个与传统应用程序开发相类似的模型（当然因某些本质上的差异，模型还是稍有不同），他们可以基于事件驱动来开发程序，不必关切HTTP的处理细节，如果必须处理一些视觉组件的属性的话，他们也可以直接在整合开发环境上拖拉这些组件，点选设定组件的属性，JavaServer Faces甚至还为应用程序设计人员处理了对象与字符串（HTTP传送本质上就是字符串）间不匹配的转换问题。 

从UI组件开发人员的角度来看，他们可以设计通用的UI组件，让应用程序的开发产能提高，就如同在设计Swing组件等，UI开发人员可以独立开发，只要定义好相关的属性选项来调整细节，而不用受到网页设计人员或应用程序设计人员的干扰。
三个角色的知识领域原则上可以互不干扰，根据您的角色，您只要了解其中一个知识领域，就可以运用JavaServer Faces，其它角色的知识领域您可以不用了解太多细节。
当然，就其中一个角色单独来看，JavaServer Faces隐藏了许多细节，若要全盘了解，其实JavaServer Faces是复杂的，每一个处理的环境都值得深入探讨，所以学习JavaServer Faces时，您要选择的是通盘了解，还是从使用的角度来了解，这就决定了您学习时所要花费的心力。
要使用JSF，首先您要先取得JavaServer Faces参考实现（JavaServer Faces Reference Implementation），在将来，JSF会与Container整合在一起，届时您只要下载支持的Container，就可以使用JSF的功能。
请至 JSF 官方网站的 下载区 下载参考实现，在下载压缩文件并解压缩之后，将其 lib 目录下的 jar 文件复制至您的Web应用程序的/WEB-INF/lib目录下，另外您还需要 jstl.jar 与 standard.jar 文件，这些文件您可以在 sample 目录下，解压缩当中的一个范例，在它的/WEB-INF/lib目录下找到，将之一并复制至您的Web应用程序的/WEB-INF/lib目录下，您总共需要以下的文件：

* jsf-impl.jar
* jsf-api.jar
* commons-digester.jar
* commons-collections.jar
* commons-beanutils.jar
* jstl.jar
* standard.jar

 

接下来配置Web应用程序的web.xml，使用JSF时，所有的请求都通过FacesServlet来处理，您可以如下定义：

 

<?xml version="1.0" encoding="ISO-8859-1"?>
<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd"
version="2.4">
<description>
JSF Demo
</description>
<display-name>JSF Demo</display-name>
<servlet>
<servlet-name>Faces Servlet</servlet-name>
<servlet-class>
javax.faces.webapp.FacesServlet
</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>Faces Servlet</servlet-name>
<url-pattern>*.faces</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.html</welcome-file>
</welcome-file-list>
</web-app>

 

在上面的定义中，我们将所有.faces的请求交由FaceServlet来处理，FaceServlet会唤起相对的.jsp网页，例如请求是/index.faces的话，则实际上会唤起/index.jsp网页，完成以上的配置，您就可以开始使用JSF了。

 

现在可以开发一个简单的程序了，我们将设计一个简单的登入程序，使用者提交名称，之后由程序显示使用者名称及欢迎信息。
程序开发人员
先看看应用程序开发人员要作些什么事，我们编写一个简单的JavaBean：

 

package onlyfun.caterpillar;
public class UserBean ...{
private String name;
public void setName(String name) ...{
this.name = name;
}
public String getName() ...{
return name;
}
}

 

这个Bean将存贮使用者的名称，编译好之后放置在/WEB-INF/classes下。
接下来设计页面流程，我们将先显示一个登入网页/pages/index.jsp，使用者填入名称并提交表单，之后在/pages/welcome.jsp中显示Bean中的使用者名称
为了让JSF知道我们所设计的Bean以及页面流程，我们定义一个/WEB-INF/faces-config.xml：

 

<?xml version="1.0"?>
<!DOCTYPE faces-config PUBLIC
"-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN"
"http://java.sun.com/dtd/web-facesconfig_1_0.dtd">
<faces-config>
<navigation-rule>
<from-view-id>/pages/index.jsp</from-view-id>
<navigation-case>
<from-outcome>login</from-outcome>
<to-view-id>/pages/welcome.jsp</to-view-id>
</navigation-case>
</navigation-rule>
<managed-bean>
<managed-bean-name>user</managed-bean-name>
<managed-bean-class>
onlyfun.caterpillar.UserBean
</managed-bean-class>
<managed-bean-scope>session</managed-bean-scope>
</managed-bean>
</faces-config>

 

在<navigation-rule>中，我们定义了页面流程，当请求来自<from-view- id>中指定的页面，并且指定了<navigation-case>中的<from-outcome>为login时，则会将请求导向至<to-view-id>所指定的页面。
在<managed-bean>中我们可以统一管理我们的Bean，我们设定Bean对象的存活范围是session，也就是使用者开启浏览器与程序互动过程中都存活。
接下来要告诉网页设计人员的信息是，他们可以使用的Bean名称，即<managed-bean-name>中设定的名称，以及上面所定义的页面流程。
网页设计人员
首先网页设计人员编写index.jsp网页：

 

<%...@taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<%...@taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%...@page contentType="text/html;charset=GB2312"%>
<html>
第 5 页 共 55 页
JSF 入门
<head>
<title>第一个JSF程序</title>
</head>
<body>
<f:view>
<h:form>
<h3>请输入您的名称</h3>
名称: <h:inputText value="#{user.name}"/><p>
<h:commandButton value="送出" action="login"/>
</h:form>
</f:view>
</body>
</html>

 

我们使用了JSF的core与html标签库，core是有关于UI组件的处理，而html则是有关于HTML的进阶标签。
<f:view>与<html>有类似的作用，当您要开始使用JSF组件时，这些组件一定要在<f: view>与</f:view>之间，就如同使用HTML时，所有的标签一定要在<html>与< /html>之间。
html标签库中几乎都是与HTML标签相关的进阶标签，<h:form>会产生一个表单，我们使用<h: inputText>来显示user这个Bean对象的name属性，而<h:commandButton>会产生一个提交按钮，我们在action属性中指定将根据之前定义的login页面流程中前往welcome.jsp页面。
网页设计人员不必理会表单传送之后要作些什么，他只要设计好欢迎页面就好了：

 

<%...@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<%...@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%...@page contentType="text/html;charset=GB2312"%>
<html>
<head>
<title>第一个JSF程序</title>
</head>
<body>
<f:view>
<h:outputText value="#{user.name}"/> 您好！
<h3>欢迎使用 JavaServer Faces！</h3>
</f:view>
</body>
</html>

 

这个页面没什么需要解释的了，如您所看到的，在网页上没有程序逻辑，网页设计人员所作的就是遵照页面流程，使用相关名称取出数据，而不用担心实际上程序是如何运行的。
接下来启动Container，连接上您的应用程序网址，例如：http://localhost:8080/jsfDemo/pages/index.faces，填入名称并提交表单，您的欢迎页面就会显示了。