springboot 微服务项目如何集成 html 页面

忘是亡心i 2024-03-25 10:04 57阅读 0赞

Spring Boot 微服务项目通常是通过 REST API 来提供服务的，而不是直接集成 HTML 页面。

如果在 Spring Boot 项目中集成 HTML 页面，简单整理了一下，可以采用以下常用的方法：

1.  \*\***Thymeleaf**：\*\*Thymeleaf 是一款用于在 web 和独立环境中创建可扩展的 XML/HTML/文本模板的 Java 模板引擎。它可以轻松地与 Spring Boot 集成，使用简单，支持模板继承和表达式语言等功能。
2.  \*\***FreeMarker**：\*\*FreeMarker 是一款基于模板的视图渲染引擎，支持动态 HTML、XML、JSON、JavaScript、CSS 等文件的生成。它也可以轻松地与 Spring Boot 集成，使用简单，支持模板继承和自定义指令等功能。
3.  \*\***JSP**：\*\*JSP 是一种基于 Java 技术的动态网页开发技术，可以方便地嵌入 Java 代码，并生成 HTML 页面。它也可以与 Spring Boot 集成，但需要额外配置一些依赖和插件。  
    举例来说，如果你选择使用 Thymeleaf，可以按照以下步骤来实现：

##### 1， 在 pom.xml 中添加以下依赖： #####

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-thymeleaf</artifactId>
    </dependency>

##### 2， 在 application.properties 中添加以下配置： #####

###### 2.1 配置 Thymeleaf 模板文件所在路径 ######

spring.thymeleaf.prefix=classpath:/templates/

###### 2.2 配置 Thymeleaf 模板文件后缀名 ######

spring.thymeleaf.suffix=.html

###### 2.3 配置 Thymeleaf 模板文件字符集 ######

spring.thymeleaf.encoding=UTF-8

###### 2.4 开启缓存 ######

spring.thymeleaf.cache=true

##### 3，创建 HTML 模板文件 #####

在src/main/resources/templates 目录下创建 HTML 模板文件，并使用 Thymeleaf 标签进行动态数据绑定和条件渲染等操作。

例如，以下是一个简单的 HTML 模板文件 index.html：

<!DOCTYPE html>
    <html>
    <head>
        <title>Spring Boot + Thymeleaf</title>
    </head>
    <body>
        <h1>Welcome to Spring Boot</h1>
        <p th:text="${message}">This is a placeholder text.</p>
    </body>
    </html>

##### 4，创建控制器 #####

在 Spring Boot 应用程序的控制器中，使用 @GetMapping 注解定义一个返回 ModelAndView 对象的请求处理方法，并将模板文件名和动态数据传递给 ModelAndView 对象。

例如，以下是一个简单的控制器类 HomeController：

@Controller
    public class HomeController {
        
        
        @GetMapping("/")
        public ModelAndView index() {
        
            ModelAndView modelAndView = new ModelAndView("index");
            modelAndView.addObject("message", "Hello, world!");
            return modelAndView;
        }
        
    }

这样，在浏览器中访问 http://localhost:8080 就可以看到渲染后的 HTML 页面了。

再举一个FreeMarker的例子来简单说一下：

当使用Spring Boot构建Web应用程序时，可以使用FreeMarker作为模板引擎来渲染HTML页面。FreeMarker是一个开源的Java模板引擎，它允许您通过定义模板来生成HTML等文档。下面是在Spring Boot项目中集成FreeMarker的一些常用方法：

##### 5， 添加依赖：在项目的pom.xml文件中添加FreeMarker的依赖项： #####

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-freemarker</artifactId>
    </dependency>

##### 6，配置视图解析器：在application.properties文件中添加以下配置，以告诉Spring Boot使用FreeMarker作为模板引擎来解析视图： #####

spring.mvc.view.prefix=/WEB-INF/views/  
spring.mvc.view.suffix=.ftl

##### 7，创建模板文件： #####

在src/main/resources/templates目录下创建.ftl文件，该文件将用于渲染HTML页面。在模板文件中，您可以使用FreeMarker的模板语言来定义HTML页面的内容。

例如，以下是一个简单的模板文件，它将渲染一个包含“Hello World”的HTML页面：

<!DOCTYPE html>
    <html>
    <head>
        <title>Hello World</title>
    </head>
    <body>
        <h1>${
        message}</h1>
    </body>
    </html>

在上面的模板中，$\{message\}将被替换为实际的值。您可以在Java代码中使用模型来设置这个值。

##### 8，创建控制器：在Spring Boot应用程序中创建一个控制器，以处理HTTP请求并返回模板的名称和模型。以下是一个示例控制器： #####

@Controller
    public class HomeController {
        
        @GetMapping("/")
        public String home(Model model) {
        
            model.addAttribute("message", "Hello World!");
            return "home";
        }
    }

在上面的示例中，控制器返回了“home”字符串，这将作为模板文件的名称。它还将模型添加到视图中，该模型包含名为“message”的属性和“Hello World！”的值。

这是在Spring Boot项目中使用FreeMarker作为模板引擎的一些常用方法。当您使用FreeMarker时，还可以使用一些高级特性，例如条件语句、迭代器和宏，来更好地控制生成的HTML页面。