创建 Facelets 视图和映射 Faces Servlet

2024 年 8 月 29 日 | 阅读 2 分钟

Facelets 视图是 XHTML 页面。您可以通过向页面添加组件、将组件连接到后台 Bean 值和属性，以及在组件上注册转换器、验证器或侦听器来创建网页或视图。

XHTML 网页充当前端。您的应用程序的第一页默认为 index.xhtml。

网页的第一部分声明页面的内容类型，即 XHTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

下一部分指定 XHTML 页面的语言，然后声明用于在网页中使用的标签库的 XML 命名空间。

<html lang="en"
xmlns="http://www.w3.org/1999/xhtml"
xmlns:h="http://xmlns.jcp.org/jsf/html"
xmlns:f="http://xmlns.jcp.org/jsf/core">

// index.xhtml

<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:h="http://xmlns.jcp.org/jsf/html"
xmlns:f="http://xmlns.jcp.org/jsf/core">
<h:head>
<title>Jsf Form</title>
</h:head>
<h:body>
<h:form id="form">
<h:outputLabel for="username">User Name</h:outputLabel>
<h:inputText id="name" value="#{user.name}" required="true">
<f:validateRequired for="name" />
</h:inputText><br/>
<h:commandButton value="OK" action="response.xhtml"></h:commandButton>
</h:form>
</h:body>
</html>

Facelets HTML 标签以 h: 开头，用于在网页上添加组件，核心标签 f:validateRequired 用于验证用户输入。

h:inputText 标签接受用户输入，并通过 EL 表达式 #{user.name} 设置托管 Bean 属性 name 的值。

运行 index.xhtml 文件后，JSF 呈现一个 HTML 索引页面。输出如下所示。

// 输出：索引页面

这是创建 Facelets 视图的过程。现在，您可以创建第二个 xhtml 页面，例如 response.xhtml，如下所示。

// response.xhtml

<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN""http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"
xmlns:h="http://xmlns.jcp.org/jsf/html">
<h:head>
<title>Response Page</title>
</h:head>
<h:body>
<h1>
Hello #{user.name}
</h1>
</h:body>
</html>

运行索引文件后，将显示以下输出。

输出

// 首页

// 响应页面

映射 Faces Servlet

JavaServer Faces 应用程序的配置是通过在 web 部署描述符文件 web.xml 中映射 Faces Servlet 来完成的。

在 NetBeans IDE 中，将自动为您创建一个 web 部署描述符文件。下面给出一个自动生成的 web.xml 文件。

// web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app version="3.1" xmlns="http://xmlns.jcp.org/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd">
<context-param>
<param-name>javax.faces.PROJECT_STAGE</param-name>
<param-value>Development</param-value>
</context-param>
<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>
<session-config>
<session-timeout>
30
</session-timeout>
</session-config>
<welcome-file-list>
<welcome-file>faces/index.xhtml</welcome-file>
</welcome-file-list>
</web-app>

下一主题Facelets 模板