一个Spring Boot @Controller示例程序的开发

最近要开发一个项目，用到Spring Boot技术，但由于我是这方面的新手，先找个例子入门学习一下，结果死活跑不通，在浏览器里面访问相应的资源，遇到了下面这样的错误：

Whitelabel Error Page
This application has no explicit mapping for /error, so you are seeing this as a fallback.

Thu Dec 29 22:48:01 CST 2022
There was an unexpected error (type=Not Found, status=404).

用的例子是这里的：Spring Boot @Controller|极客教程 (geek-docs.com)

不得不说，被垃圾教程，带入歧路，不能返归。

经过一番摸索，把里面的问题，修改了，这里上一个正确可用的教程，以求帮助和我一样刚入门的人。

------------------------------------------下面正文开始了------------------------------------------

Spring Boot @Controller示例

在以下应用中，我们演示@Controller的用法。 该应用将当前数据和时间返回给客户端。

$ tree
.
├── pom.xml
└── src
    ├── main
    │   ├── java
    │   │   └── com
    │   │       └── zetcode
    │   │           ├── Application.java
    │   │           └── controller
    │   │               └── MyController.java
    │   └── resources
    │       ├── static
    │       │   └── index.html
    │       └── templates
    │           └── showMessage.ftl
    └── test
        └── java

这是 Spring 应用的项目结构。

pom.xml

    4.0.0

    com.zetcode
    controllerex
    1.0-SNAPSHOT
    jar

    
        UTF-8
        11
        11
        1.8
    
    

    
        org.springframework.boot
        spring-boot-starter-parent
        2.7.7
         
    

    

        
            org.springframework.boot
            spring-boot-starter-web
        

        
            org.springframework.boot
            spring-boot-starter-freemarker
        

    

    
        
            
                org.springframework.boot
                spring-boot-maven-plugin
            
        
    

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

com/zetcode/MyController.java

package com.zetcode.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

import java.time.LocalDateTime;
import java.time.format.DateTimeFormatter;
import java.util.HashMap;

@Controller
public class MyController {

    @RequestMapping(value = "/getDateAndTime")
    public ModelAndView getDateAndTime() {

        LocalDateTime now = LocalDateTime.now();
        DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");
        String date_time = dtf.format(now);

        Map params = new HashMap();
        params.put("date_time", date_time);

        return new ModelAndView("showMessage", params);
    }
}

这是MyController。 它响应来自客户端的请求。 它找出当前日期和时间，并将处理过程解析为showMessage.ftl模板，并将其传递给数据。

@Controller
public class MyController {

MyController带有@Controller注解。

@RequestMapping(value = "/getDateAndTime")
public ModelAndView getDateAndTime() {

getDateAndTime()方法映射到getDateAndTime URL 模式； 它返回ModelAndView，它是 Web MVC 框架中 Model 和 View 的持有人。

LocalDateTime now = LocalDateTime.now();
DateTimeFormatter dtf = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss");
String date_time = dtf.format(now);

我们获取并格式化本地日期和时间。

Map params = new HashMap();
params.put("date_time", date_time);

日期和时间字符串将添加到参数映射中。

return new ModelAndView("showMessage", params);

我们返回ModelAndView。 由于 POM 文件中存在 Freemarker 依赖性，因此 Spring 将处理解析为showMessage.ftl模板文件，并将params对象传递给它。

resources/static/index.html

    
        
        
        
    
    
        

            Get date and time
        
    

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

resources/templates/showMessage.ftl

    
    
    



Date and time: ${date_time}    

showMessage.ftl是一个 Freemarker 模板文件。 它位于预定义的src/main/resources/templates目录中。 它使用${}语法输出日期和时间。

切记！在application.properties文件里加入这么一句：spring.freemarker.suffix=.ftl

不加的话就会出现页面“/getDateAndTime”访问不到的错误。

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。

$ mvn spring-boot:run 

应用运行后，我们可以导航到localhost:8080。

在本教程中，我们展示了如何在 Spring 应用中使用@Controller注解。