Spring Boot Model|极客教程

Spring Boot Model教程展示了如何在 Spring Boot 应用中使用模型。在春季，模型由Model，ModelMap和ModelAndView表示。

Spring 是流行的 Java 应用框架，而 Spring Boot 是 Spring 的演进，可以帮助轻松地创建独立的，生产级的基于 Spring 的应用。

MVC

MVC（模型-视图-控制器）是一种软件体系结构模式，它将应用分为三个部分：模型，视图和控制器。该模型表示一个携带数据的 Java 对象。该视图使模型包含的数据可视化。控制器管理流入模型对象的数据流，并在数据更改时更新视图。它使视图和模型分离。

Spring MVC

Spring MVC 是基于 Servlet API 构建的原始 Web 框架。它基于 MVC 设计模式。 Spring Framework 5.0 引入了一个名为 Spring WebFlux 的并行 Reactor栈 Web 框架。

`Model`，`ModelMap`，`ModelAndView`

Model，ModelMap和ModelAndView用于在 Spring MVC 应用中定义模型。 Model定义了模型属性的持有者，并且主要用于向模型添加属性。 ModelMap是Model的扩展，具有在映射和链式方法调用中存储属性的能力。 ModelAndView是模型和视图的支架；它允许在一个返回值中返回模型和视图。

Spring Boot `Model`示例

以下简单的 Web 应用在控制器方法中使用Model，ModelMap和ModelAndView。该模型保存应用数据，该数据显示在视图中。我们将 Freemaker 库用于视图层。

pom.xml
src
    ├── main
    │   ├── java
    │   │   └── com
    │   │       └── zetcode
    │   │           ├── Application.java
    │   │           └── controller
    │   │               └── MyController.java
    │   └── resources
    │       ├── application.properties
    │       ├── static
    │       │   └── index.html
    │       └── templates
    │           └── show.ftl
    └── test
        └── java

这是 Spring 应用的项目结构。

pom.xml

<?xml version="1.0" encoding="UTF-8"?>
<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.zetcode</groupId>
    <artifactId>springbootmodelex</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
    </properties>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.1.RELEASE</version>
    </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-freemarker</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

这是 Maven pom.xml文件。 spring-boot-starter-parent是父 POM，它为使用 Maven 构建的应用提供依赖关系和插件管理。 spring-boot-starter-freemarker是 Freemarker 模板引擎的依赖项。此依赖项还将在项目中包含 Spring MVC。 spring-boot-maven-plugin将 Spring 应用打包到可执行的 JAR 或 WAR 归档文件中。

resources/application.properties

spring.main.banner-mode=off
logging.level.org.springframework=ERROR

mymessage=Hello there

application.properties是 Spring Boot 中的主要配置文件。我们通过选择错误消息来关闭 Spring 横幅，并减少 Spring 框架的日志记录量。 mymessage属性包含该消息。

com/zetcode/MyController.java

package com.zetcode.controller;

import java.time.LocalDateTime;
import java.time.ZoneId;
import java.time.format.DateTimeFormatter;
import java.time.format.FormatStyle;
import java.util.Locale;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class MyController {

    @Value("${mymessage}")
    private String message;

    @GetMapping("/getMessage")
    public String getMessage(Model model) {

        model.addAttribute("message", message);

        return "show";
    }

    @GetMapping("/getMessage2")
    public ModelAndView getMessage() {

        var mav = new ModelAndView();

        mav.addObject("message", message);
        mav.setViewName("show");

        return mav;
    }

    @GetMapping("/getMessageAndTime")
    public String getMessageAndTime(ModelMap map) {

        var ldt = LocalDateTime.now();

        var fmt = DateTimeFormatter.ofLocalizedDateTime(
                FormatStyle.MEDIUM);

        fmt.withLocale(new Locale("sk", "SK"));
        fmt.withZone(ZoneId.of("CET"));

        var time = fmt.format(ldt);

        map.addAttribute("message", message).addAttribute("time", time);

        return "show";
    }
}

这是MyController。它具有三种响应客户端请求的方法。

@Controller
public class MyController {

MyController带有@Controller注解。

@Value("${mymessage}")
private String message;

使用@Value注解，我们将application.properties文件中的mymessage属性插入到message属性中。

@GetMapping("/getMessage")
public String getMessage(Model model) {

    model.addAttribute("message", message);

    return "show";
}

@GetMapping将/getMessage URL 模式映射到getMessage()方法。在getMessage()方法中，我们使用Model。它使用addAttribute()方法接收message属性。 return 关键字返回视图的名称，该名称将解析为show.ftl，因为我们使用的是 Freemarker 模板系统。

@GetMapping("/getMessage2")
public ModelAndView getMessage() {

    var mav = new ModelAndView();
    mav.addObject("message", message);
    mav.setViewName("show");

    return mav;
}

在第二种情况下，我们使用ModelAndView。我们使用addObject()和setViewName()添加模型数据和视图名称。该方法返回ModelAndView对象。

@GetMapping("/getMessageAndTime")
public String getMessageAndTime(ModelMap map) {

    var ldt = LocalDateTime.now();

    var fmt = DateTimeFormatter.ofLocalizedDateTime(FormatStyle.MEDIUM);

    fmt.withLocale(new Locale("sk", "SK"));
    fmt.withZone(ZoneId.of("CET"));

    var time = fmt.format(ldt);

    map.addAttribute("message", message).addAttribute("time", time);

    return "show";
}

在getMessageAndTime()方法中，我们使用ModelMap。模型图接收两个属性：消息和时间。

resources/static/index.html

<!DOCTYPE html>
<html>
    <head>
        <title>Home page</title>
        <meta charset="UTF-8"/>
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
    </head>
    <body>
        <ul>
            <li><a href="getMessage">Get message</a></li>
            <li><a href="getMessage2">Get message 2</a></li>
            <li><a href="getMessageAndTime">Get message and time</a></li>
        </ul>
    </body>
</html>

这是主页。它包含三个调用 Spring 控制器方法的链接。它是静态资源，位于预定义的src/main/resources/static目录中。

resources/templates/show.ftl

<!DOCTYPE html>
<html>
    <head>
        <title>Message</title>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1.0">
    </head>
    <body>
        <p>
            Message:  ${message} </p> <#if time??> <p>Date and time:$ {time}</p>
        </#if>

    </body>
</html>

show.ftl是一个 Freemarker 模板文件。它位于预定义的src/main/resources/templates目录中。它使用${}语法输出消息和时间（可选）。

com/zetcode/Application.java

package com.zetcode;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class Application  {

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

Application是设置 Spring Boot 应用的入口。 @SpringBootApplication注解启用自动配置和组件扫描。在扫描过程中，将查找@Controller注解，并从MyController类创建一个 Spring bean。