当前位置：首页 > Java > 正文

Java Server Faces 入门指南（零基础掌握 JSF 教程）

主机测评网
Java
2025-12-10
913

如果你正在学习 Java Web 开发，那么 Java Server Faces（JSF） 是一个非常值得了解的框架。本篇 JSF 教程 将从零开始，手把手带你搭建第一个 JSF 应用，即使你是编程小白也能轻松上手！

Java Server Faces 入门指南（零基础掌握 JSF 教程） JSF教程 JSF入门 Web开发第1张

什么是 JSF？

Java Server Faces（JSF） 是 Java EE（现 Jakarta EE）标准中用于构建用户界面的组件化 Web 框架。它采用“组件驱动”的方式开发 Web 页面，类似于桌面 GUI 编程，开发者可以使用标签库快速构建表单、按钮、表格等 UI 元素。

为什么选择 JSF？

标准化：由 Oracle 主导，是 Java EE 官方规范。
组件化：内置丰富的 UI 组件，支持自定义扩展。
事件驱动：类似 Swing 的事件处理机制，逻辑清晰。
与 Java 无缝集成：天然支持 CDI、EJB、JPA 等企业级技术。

准备工作

在开始之前，请确保你已安装以下工具：

JDK 8 或更高版本
Apache Tomcat 9（或其他支持 Jakarta EE 的服务器）
IDE（推荐 IntelliJ IDEA 或 Eclipse）
Maven（用于依赖管理）

创建你的第一个 JSF 项目

我们将使用 Maven 创建一个简单的 JSF 应用。

1. 创建 Maven 项目

在 IDE 中新建一个 Maven 项目，选择 war 打包类型。

2. 添加依赖（pom.xml）

在 pom.xml 中添加 JSF 和 Servlet API 依赖：

<dependencies>    <!-- JSF API 和实现（Mojarra）-->    <dependency>        <groupId>org.glassfish</groupId>        <artifactId>jakarta.faces</artifactId>        <version>4.0.0</version>    </dependency>    <!-- Servlet API -->    <dependency>        <groupId>jakarta.servlet</groupId>        <artifactId>jakarta.servlet-api</artifactId>        <version>6.0.0</version>        <scope>provided</scope>    </dependency></dependencies>

3. 配置 web.xml

在 src/main/webapp/WEB-INF/web.xml 中配置 Faces Servlet：

<?xml version="1.0" encoding="UTF-8"?><web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"         xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee                              https://jakarta.ee/xml/ns/jakartaee/web-app_6_0.xsd"         version="6.0">    <servlet>        <servlet-name>Faces Servlet</servlet-name>        <servlet-class>jakarta.faces.webapp.FacesServlet</servlet-class>        <load-on-startup>1</load-on-startup>    </servlet>    <servlet-mapping>        <servlet-name>Faces Servlet</servlet-name>        <url-pattern>*.xhtml</url-pattern>    </servlet-mapping>    <welcome-file-list>        <welcome-file>index.xhtml</welcome-file>    </welcome-file-list></web-app>

4. 创建 Managed Bean（后端逻辑）

在 src/main/java 下创建一个包，例如 com.example.jsf，然后新建一个 Java 类：

package com.example.jsf;import jakarta.enterprise.context.RequestScoped;import jakarta.inject.Named;@Named("helloBean")@RequestScopedpublic class HelloBean {    private String name = "World";    public String getName() {        return name;    }    public void setName(String name) {        this.name = name;    }    public String getGreeting() {        return "Hello, " + name + "!";    }}

5. 创建 XHTML 页面（前端）

在 src/main/webapp 目录下创建 index.xhtml：

<!DOCTYPE html><html xmlns="http://www.w3.org/1999/xhtml"      xmlns:h="http://xmlns.jcp.org/jsf/html"><h:head>    <title>JSF 入门示例</title></h:head><h:body>    <h2>欢迎使用 Java Server Faces！</h2>    <h:form>        <p>            <h:outputLabel value="请输入您的名字：" />            <h:inputText value="#{helloBean.name}" />        </p>        <p>            <h:commandButton value="打招呼" action="index" />        </p>        <h2 style="color: green;">#{helloBean.greeting}</h2>    </h:form></h:body></html>