JSF PrimeFaces 项目教程

JSF PrimeFaces 项目教程

1. 项目的目录结构及介绍

jsf-primefaces/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── codenotfound/
│   │   │           └── jsf/
│   │   │               └── PrimeFacesApplication.java
│   │   ├── resources/
│   │   │   └── log4j.properties
│   │   └── webapp/
│   │       ├── WEB-INF/
│   │       │   └── faces-config.xml
│   │       ├── index.xhtml
│   │       └── template.xhtml
├── pom.xml
└── README.md

• src/main/java/：包含项目的Java源代码。
  • com/codenotfound/jsf/PrimeFacesApplication.java：项目的主启动类。
• src/main/resources/：包含项目的资源文件，如log4j.properties。
• src/main/webapp/：包含Web应用程序的文件。
  • WEB-INF/faces-config.xml：JSF配置文件。
  • index.xhtml：主页文件。
  • template.xhtml：模板文件。
• pom.xml：Maven项目的配置文件。
• README.md：项目的说明文档。

2. 项目的启动文件介绍

PrimeFacesApplication.java

package com.codenotfound.jsf;

import javax.faces.webapp.FacesServlet;
import javax.servlet.ServletContext;
import javax.servlet.ServletException;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;

@SpringBootApplication
public class PrimeFacesApplication {

    public static void main(String[] args) {
        SpringApplication.run(PrimeFacesApplication.class, args);
    }

    @Bean
    ServletRegistrationBean<FacesServlet> jsfServletRegistration(ServletContext servletContext) {
        //spring boot only works if this is set
        servletContext.setInitParameter("com.sun.faces.forceLoadConfiguration", Boolean.TRUE.toString());

        //registration
        ServletRegistrationBean<FacesServlet> srb = new ServletRegistrationBean<>();
        srb.setServlet(new FacesServlet());
        srb.setUrlMappings(Collections.singletonList("*.xhtml"));
        srb.setLoadOnStartup(1);
        return srb;
    }
}

• PrimeFacesApplication.java 是项目的启动类，使用Spring Boot框架。
• main 方法用于启动Spring Boot应用程序。
• jsfServletRegistration 方法用于注册JSF的FacesServlet。

3. 项目的配置文件介绍

pom.xml

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.codenotfound</groupId>
    <artifactId>jsf-primefaces</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>war</packaging>
    <name>JSF PrimeFaces Example</name>
    <description>JSF PrimeFaces Example</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.4.0</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>